story-pack

阶段6b: Story 执行包生成

• $ARGUMENTS: Story 编号（如: 1）

读取：docs/story-$ARGUMENTS-*.md、docs/GLOBAL-CONTEXT.md（只读）、docs/PRD.md（只读） | 写入：docs/story-$ARGUMENTS-exec-pack.yaml（仅 PASS 时写入；纯 YAML；不包含 ```） | 模板：N/A

生成 1 个 STORY_EXEC_PACK，写入 docs/story-$ARGUMENTS-exec-pack.yaml，作为该 Story 的最小执行输入。

最小读取（必须；避免通读）

只允许引用本节列出的内容范围；其余一律视为不可用。

1. 读取 Story：仅解析 YAML front-matter 作为索引
2. 读取 GC：按索引抽取片段（固定章节 + 规则表行 + 验证命令表）
3. 读取 PRD：仅按索引/锚点抽取块（必须逐字原文复制）

前置条件（必须满足）

• docs/PRD.md、docs/GLOBAL-CONTEXT.md、docs/story-$ARGUMENTS-*.md 均存在且 Story 文件仅匹配 1 个
• Story YAML front-matter 必须可解析，且 n == $ARGUMENTS

机械抽取规则（必须遵守）

A) 从 Story 抽取索引（只看 YAML front-matter）

对 docs/story-$ARGUMENTS-*.md 文件首部 --- ... ---：

• 抽取并去重排序（按编号升序）：
  • S_fp = fp_ids[]（FP-001）
  • S_gc_br = refs.gc_br[]（BR-001）
  • S_prd_br = refs.prd_br[]（BR-001）
  • S_tbl = refs.prd_tbl[]（TBL-001）
  • S_api = refs.prd_api[]（API-001）
  • S_art = artifacts.file + artifacts.cfg + artifacts.ext（ART:* token）

B) 从 GC 抽取（避免通读）

• 必须逐字原文复制
• 固定复制以下 整段章节（按标题边界截取，## X. 到下一个 ## 之前）：
  • ## 2. 项目结构（必填）
  • ## 3. 枚举值定义（必填；无则写 N/A）
  • ## 5. 权限矩阵（必填）
  • ## 8. API规范（必填）
• 对于业务规则：仅从第 4 节规则表中复制被引用的 BR-### 行（连同表头与分隔行；无引用写 N/A）
• 对于项目验证命令：从 GC 第 2 节 ### 项目验证命令（如适用；否则写 N/A） 的表格逐行抽取到 pack 的 verification.commands（按表格顺序；不改写）
  • 若该小节为 N/A 或表格不存在：verification.commands 只写 1 行 type/command/note 均为 N/A
  • 否则：对表格每一行数据，原文复制三列到 type / command / note
    • 若 command = N/A：该行 type 与 note 也必须为 N/A
    • 若 command != N/A：该行 type 必须以 gate: 或 opt: 开头；不得为 N/A

C0) FP→落点映射预检查（必须；兜底防硬违约）

1. 在 PRD 中定位 ### 8.0 功能点→落点映射（必填） 表，抽取本 Story S_fp 对应行（表头 + 分隔行 + 行；按 FP-001 升序）
2. 对每个 FP-001 的“落点”列：解析为集合（N/A 或逗号分隔多项），允许项前缀仅：DB: / FILE: / CFG: / EXT: / N/A
3. 计算期望覆盖集合（去重）：
   • E_tbl = 所有 DB:TBL-### 转换为 TBL-###（必须为具体数字）
   • E_art = 所有 FILE: / CFG: / EXT: 转换为 ART:FILE: / ART:CFG: / ART:EXT:（token 精确匹配）
4. 校验（任一不满足即 FAIL 并停止，不输出 pack）：
   • E_tbl 必须是 S_tbl 的子集（缺失则列出缺失项）
   • E_art 必须是 S_art 的子集（缺失则列出缺失项）