story-check

阶段6a: Story 校验

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

读取：docs/story-$ARGUMENTS-*.md、docs/GLOBAL-CONTEXT.md（只读）、docs/PRD.md（只读） | 写入：无（只输出 FAIL/DECISION/PASS；不修改文件） | 模板：N/A

校验单个 Story 并输出 FAIL/DECISION/PASS 清单；不修改任何文件。

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

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

1. 读取 Story：仅解析 YAML front-matter + 定位章节边界（不摘抄正文）
2. 读取 GC：仅第 4 节业务规则表（抽取合法 BR-### 集合）
3. 读取 PRD（只读；按索引定向读取）：
   • ### 9.2 接口清单（必填）：按 N/A_STRICT 判定 PRD_HAS_API；抽取 API-### 集合（如适用）
   • ### 8.0 功能点→落点映射（必填）：抽取本 Story fp_ids 对应行（用于 FP 存在性 + 落点闭合）
   • ### 8.1 表清单：抽取 TBL-### 集合
   • 第 6 节规则表：抽取 BR-### 集合
   • 若 refs.prd_api 非空：按锚点 <!-- PRD#API-### --> 定向校验 PRD 9.3 接口详情存在性
   • 若 refs.prd_tbl 非空：按锚点 <!-- PRD#TBL-### --> 定向校验 PRD 8.2 表定义存在性

输出规则（只读）

• 不输出任何原文（只输出清单）
• 若存在任何 FAIL：
  • 输出 FAIL 清单（F-001 起编号；每条必须包含以下字段）：
    • 定位：目标 Story 文件（docs/story-N-<slug>.md）+ YAML front-matter key / Markdown 章节名 / 门禁项；避免行号
    • 问题：1 句
    • 期望：可机械执行的“替换目标/格式”（能推导就写出来）
    • 影响：H/M/L
    • 修复：只给 1 个动作（通常是“按定位修正 docs/story-$ARGUMENTS-*.md”）
  • 末尾追加：
    • 修正：按 FAIL 清单逐条修复 docs/story-$ARGUMENTS-*.md 后重跑 /story-check $ARGUMENTS
    • 重跑：/story-check $ARGUMENTS
  • 然后结束
• 仅当无 FAIL：
  • 若存在任何 DECISION：输出 DECISION 清单（D-001 起编号；每条必须包含：定位 / 问题 / 影响 / 建议动作），并在末尾追加：下一步：/story-pack $ARGUMENTS
  • 否则：输出 PASS，并在末尾追加：下一步：/story-pack $ARGUMENTS

FAIL 校验项（严格拦截）

0) 基础门禁

• docs/PRD.md 必须存在
• docs/GLOBAL-CONTEXT.md 必须存在
• docs/story-$ARGUMENTS-*.md 必须存在且仅匹配 1 个

1) YAML front-matter（必须可解析且字段齐全）

对 Story 文件首部 --- ... ---：

• 必须存在且可解析为 YAML
• 根键必须为 STORY: v1
• 必须存在键：story、n、slug、title、modules、prereq_stories、fp_ids、refs、artifacts
• 一致性（任一不满足即 FAIL）：
  • n 必须等于 $ARGUMENTS，且 story 必须严格等于 "Story {n}"
  • 文件名必须匹配：docs/story-{n}-{slug}.md（slug 与 front-matter 一致）
  • slug 必须为 kebab-case
• modules：
  • 必须为非空数组；每项必须为 M-01（2 位数字）形式；不得出现 M-xx/模块名
  • 去重后不得为空；不得重复
• prereq_stories：
  • 必须为数组；每项必须严格匹配 Story <number>；不得重复
  • 不得包含自身；每个 <number> 必须 < n
• fp_ids：
  • 必须为非空数组；每项必须为 FP-001（3 位数字）形式；不得重复；不得出现 FP-###
• title：
  • 必须为非空字符串；不得为 TBD / 功能名称
• refs 必须存在且包含 4 个键，且每个都必须为数组：
  • refs.gc_br[]：每项必须为 BR-001（3 位数字）形式；不得包含 GC# 前缀
  • refs.prd_br[]：每项必须为 BR-001（3 位数字）形式；不得包含 PRD# 前缀
  • refs.prd_tbl[]：每项必须为 TBL-001（3 位数字）形式；不得包含 PRD# 前缀
  • refs.prd_api[]：每项必须为 API-001（3 位数字）形式；不得包含 PRD# 前缀
• artifacts 必须存在且包含 3 个键，且每个都必须为数组：
  • artifacts.file[]：每项必须匹配 ART:FILE:<path>
  • artifacts.cfg[]：每项必须匹配 ART:CFG:<key>
  • artifacts.ext[]：每项必须匹配 ART:EXT:<system>