메뉴
Sprint 完成度审查 — 计划 vs 实际对比、AC 覆盖验证、范围偏移检测 (gold-plating / drift / 缺失)。当一个 Sprint 全部任务卡完成、需要进入下一 Sprint 或发布前的完成度评估时使用此 skill。本 skill 做 Sprint 级聚合：单任务 code-review 由 code-review review 负责，项目级腐化扫描由 code-review scan 负责，文档评审由 doc-review 负责。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
项目走查 — 在隔离沙盒中以指定执行模式（缺省 standard 全阶段）把一个小型示例项目跑通整条 SDLC 工作流（初始化→核心执行链路→分支→异常→终止清理），逐路径观察各阶段/门禁/降级/恢复的真实行为，产出『框架本身 + 走查流程本身』两类改进建议，并把走查流程自身的改进经自更新协议回灌本 skill 迭代。与 framework-review 形成动静对偶：后者静态审元资产，本 skill 动态端到端自测。当用户想验证一次框架部署是否真能跑通、为非 Claude-Code 平台做行为级冒烟、或自测 workflow-framework-generator 生成的框架时使用。
测试 — 测试策略规划、测试编写与执行、覆盖率分析、缺陷记录。当需要规划测试策略、编写或执行测试套件、分析覆盖率或记录缺陷时使用。本 skill 不改源码（缺陷修复由 debug 负责），单任务 RED/GREEN 单元测试由 tdd-engine 负责，testing 聚焦集成/E2E 与覆盖盲区补充。
代码评审 — 任务粒度评审 (review) 与项目级健康度扫描 (scan) 双入口；代码质量检查、规范合规验证、安全漏洞检测、腐化指标扫描。当任务卡 GREEN 完成 / Sprint 发布前 / 用户要求扫描代码腐化时使用此 skill。审查范围限 src/ 业务代码：文档审查由 doc-review 负责；框架元资产 (.cataforge/) 审查由 framework-review 负责；Sprint 完成度由 sprint-review 负责。
统一上下文 I/O — 按需读取章节/实体、查询追溯关系、生成与写入、门禁校验。文档生命周期的单一入口；后端(知识图谱/文件)由框架按配置方案透明路由,调用方只表达意图。按操作分支见 references/。
功能走查 — 对交付项目的功能实现做验收式动态走查，两层正交判定：①功能是否兑现 spec（missing/drift/bug/pass）；②代码本身是否健康（复用 COMMON-RULES §统一问题分类体系的 code category）。用真实数据路径起真实服务复现，专捞门禁全绿仍漏的跨模块集成缝隙。当项目功能交付后需验收、Sprint 发布前做功能级复核、或用户要求走查某功能域时使用。与 framework-walkthrough 动静对偶：后者在沙盒自测框架 SDLC，本 skill 验收交付项目的功能实现。
框架元资产审查 — 对 .cataforge/ 下的 agents/skills/hooks/rules + workflow 拓扑做内容质量与一致性审查。与 platform-audit 形成内审/外审对偶；与 code-review/doc-review 服务于业务产物不同，本 skill 专审框架自身配置。当用户提到框架腐化、SKILL.md/AGENT.md 质量、agent 引用孤立、SKILL/MANIFEST 漂移、Workflow 完整性、model_tier 合规时使用。
| name | sprint-review |
| description | Sprint 完成度审查 — 计划 vs 实际对比、AC 覆盖验证、范围偏移检测 (gold-plating / drift / 缺失)。当一个 Sprint 全部任务卡完成、需要进入下一 Sprint 或发布前的完成度评估时使用此 skill。本 skill 做 Sprint 级聚合：单任务 code-review 由 code-review review 负责，项目级腐化扫描由 code-review scan 负责，文档评审由 doc-review 负责。 |
| argument-hint | <sprint_number: 1|2|3...> |
| suggested-tools | file_read, file_glob, file_grep, shell_exec |
| depends | ["context"] |
| disable-model-invocation | false |
| user-invocable | true |
| 档位 | 触发 | per-task code-review | 适用 |
|---|---|---|---|
| standard | 默认 | 每任务一份 docs/reviews/code/CODE-REVIEW-T-NNN-*.md | 大多数 sprint，任务异质（feature / fix / docs / config 混合） |
| merged-review | dev-plan frontmatter project_features.merged_review: true | 跳过 per-task CODE-REVIEW；sprint-review 报告承担 per-task Layer 2 职责 | 任务同质（如同模块批量路由 / 同 adapter 系列），N 个任务的 N 份 CODE-REVIEW 冗余 |
启用 merged_review: true 后：Layer 1 code_review_present 自动短路（缺 CODE-REVIEW 不 FAIL）；单任务 CODE-REVIEW 可省略，亦可按需混合补充。sprint-review 报告必须包含 §per-task L2 维度表（structure / error-handling / test-quality / duplication / dead-code / complexity / coupling / security 八列，每任务一行），作为 per-task Layer 2 的等价交付。跨任务模式（重复 helper / 同型 bug）天然进入横截面视角，比 N 份独立 CODE-REVIEW 更易识别。
project_features 块（详见 §project_features schema），影响 Layer 1 行为SPRINT-REVIEW-s{N}-r{M}.md (问题列表 + 严重等级: CRITICAL/HIGH/MEDIUM/LOW)cataforge skill run sprint-review -- {N} \
--dev-plan docs/dev-plan/ --src-dir src/ \
--test-dir tests/ --reviews-dir docs/reviews/code/
入口与返回码语义按 COMMON-RULES §Layer 1 调用协议；--src-dir 可重复用于 monorepo 缩范围。
可选参数（gold-plating 噪声治理）：
| 参数 | 默认 | 作用 |
|---|---|---|
--ignore PAT / --ignore-file PATH | — | 追加 gitignore 风格规则（可重复） |
--no-respect-gitignore | off | 关闭 git ls-files --exclude-standard 集成，回落 os.walk |
--no-default-ignores | off | 关闭内建忽略（node_modules/ dist/ build/ .next/ *.tsbuildinfo *.map __pycache__/ .venv/ 等） |
--warn-cap N | 50 | unplanned WARN 超出折叠为 top-dir 摘要；0 不折叠 |
--unplanned-log PATH | — | 完整 unplanned 列表落盘（配合 --warn-cap 审计） |
--format {text,json} | text | json：结构化 issues，供 framework-review / CI 机读 |
通过context加载dev-plan Sprint任务详情、arch接口契约、CODE-REVIEW报告，审查:
test-and-e2e-apis.md）；AC 验证依据为外部系统模拟器/mock 结论时按保真度契约核对（external-truth-first.md），placeholder / 未声明者该 AC 视为未验证user_facing_critical_path: true 或 consumer_components 非空时，验证 deliverable 真实挂载到至少一个消费点（路由 / app shell / 父组件 prop），而非仅"组件存在"。读取 implementer self-report 的 wiring_complete / wiring_evidence 字段（定义见 agent-result.schema）做交叉核对；缺失 evidence 但任务声称 wiring_complete=true 时升 HIGH报告编号按 .cataforge/references/review-report-spec.md §报告编号规则，前缀 SPRINT-REVIEW-s{N}，目录 docs/reviews/sprint/。
产出 SPRINT-REVIEW-s{N}-r{M}.md，问题前缀使用 [SR-{NNN}]，category 和 root_cause 枚举见 COMMON-RULES §统一问题分类体系 / §归因分类。
Sprint审查额外 category（各维度定义以 §Step 2 为准）: ac-coverage / wiring-completeness / scope-drift / gold-plating / missing-deliverable / drift-rate。
三态判定按 COMMON-RULES §三态判定逻辑。Sprint needs_revision 标记具体任务 ID 以便重入 TDD。
权威清单见
cataforge.runtime.skill.builtins.sprint_review.CHECKS_MANIFEST（framework-review 自动对账，本段与 manifest 不一致即 FAIL）。anchor 模式：每条 manifest 项必须在本段以 HTML check_id 注释形式出现（见下方各条），反之亦然。
dev-plan frontmatter 可选 project_features 块，按项目特征声明 Layer 1 行为开关。所有键默认关闭：
---
id: dev-plan-{project}
project_features:
merged_review: true # 启用 §审查档位 的 merged-review 档
deliverables_accept_alternation: true # deliverables 行支持 "A | B" 语法（任一存在即过）
unplanned_glob_patterns: # fnmatch 模式列表，匹配的文件不算 gold-plating
- "**/*.test.ts"
- "**/*.spec.ts"
- "**/helpers/*.ts"
- "**/fixtures/**"
---
| 字段 | 类型 | 默认 | 行为 |
|---|---|---|---|
merged_review | bool | false | true 时启用 merged-review 档（见 §审查档位） |
deliverables_accept_alternation | bool | false | true 时 check_deliverables 把 A | B 视为或关系（任一存在即过），同时 check_unplanned_files 把两候选都标为 planned（避免 gold-plating 误报） |
unplanned_glob_patterns | list[str] | [] | 每条 fnmatch 模式应用于 check_unplanned_files 输出；匹配的文件被滤掉。典型用途：项目级测试/fixture/helper 命名约定 |
读取由 cataforge.runtime.skill.builtins.sprint_review.sprint_check.load_project_features() 完成；读第一个含 project_features: 的 dev-plan 文件。
docs/reviews/code/ —— 必须写 docs/reviews/sprint/（.cataforge/references/review-report-spec.md §报告编号规则）