traceability-gate-checker

name	traceability-gate-checker
description	校验 REQ→DEC→FT→commit→review 的双向追溯链，是 3.3 和 4.2 门禁的核心组件。
allowed-tools	Read, Glob, Grep, Bash

Skill: traceability-gate-checker

把"追溯链规范"context/harness-framework/traceability-spec.md 落地为可执行检查。

检查项（机读）

T1. 需求→设计（REQ-* → DEC-*）

• 扫描 requirement.md 提取所有 REQ-\d{3}
• 扫描 detail-design.md 中 DEC 块的 traces_to: 字段
• 失败条件：存在 REQ-X 没有任何 DEC traces_to 它

T2. 设计→任务（DEC-* → FT-*）

• 扫描 detail-design.md 提取所有 DEC-\d{3}
• 读 tasks/features.json，遍历 features[].traces_to
• 失败条件：存在 DEC-X 没有 FT 引用它（除非该 DEC 显式标 no_implementation: true）

T3. 任务→代码（FT-* → commit）

• 读 features.json 中 status: done 的 features
• git log --grep="(FT-XXX)" --branches=feature/*
• 失败条件：done 状态的 feature 找不到对应 commit

T4. 任务→Review（FT-* → reviews/*.md）

• 扫描 reviews/*.md 文件头部 covers: 字段
• 失败条件：done 状态的 feature 未被任何 review 覆盖

T5. 反向断链检查

• features.json 中引用的 DEC/REQ 必须存在
• review 中 covers 的 FT 必须存在

输出格式

[T1 REQ→DEC]   PASS: 5/5 needs covered
[T2 DEC→FT]    FAIL: DEC-003 has no feature
[T3 FT→commit] PASS
[T4 FT→review] PARTIAL: FT-002 missing review
[T5 reverse]   PASS

OVERALL: FAIL

调用方

• requirement-quality-reviewer（门禁 2.2，只跑 T1 子集）
• detail-design-quality-reviewer（门禁 3.3，跑 T1 + T2）
• managing-requirement-lifecycle（门禁 4.2，跑 T1~T5）
• 阶段 4.4 编码循环中 traceability-consistency-checker Agent

实现思路（最小可用）

可以用 Python 或 Node 脚本实现，放在 scripts/traceability-check.sh：

#!/usr/bin/env bash
# scripts/traceability-check.sh <req-dir>
REQ_DIR=$1
python3 scripts/traceability_check.py "$REQ_DIR"

或者作为 Skill 内的提示词指令，直接让模型 grep 后做匹配。