Merge pull request 'feat/plan-analyze-timing/main' (#63) from feat/plan-analyze-timing/main into master

Reviewed-on: #63
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>

test/helpers/prompt-doc.js

@@ -66,6 +66,22 @@ export function assertNeutralPrompt(prompt, command) {
   }
 }
 
+/**
+ * 取出正本裡某一個編號步驟的內容，**以名字取而不是以編號取**。
+ * 步驟會增刪、編號會整批位移，名字不會；用編號寫的測試會在別人插一步時無聲地
+ * 框到另一段內容上，而那種失敗看起來像是正本掉了東西。
+ * @param {string} prompt 正本內容
+ * @param {string} name 步驟名，例如 '產生圖解版總覽'
+ * @returns {string} 該步驟的標題與內文，到下一個 `### ` 為止
+ */
+export function promptStep(prompt, name) {
+  const start = prompt.search(new RegExp(`^### \\d+\\. ${name}$`, 'm'));
+  assert.ok(start >= 0, `正本裡找不到「${name}」這一步`);
+  const rest = prompt.slice(start);
+  const end = rest.slice(1).search(/^### /m);
+  return end === -1 ? rest : rest.slice(0, end + 1);
+}
+
 /**
  * 斷言模板的 `## 標題` 就是這組段落，順序一致。
  * 段落順序即下游抽取契約的解析依據，兩邊必須一起改。