SuperAPI AI 工具集

gsd-path-docs-audit

写作与研究

查看项目

更新于 10-16 07:25

技能介绍

用途:回答“项目是否真的做到了文档所写的事”,并给出带证据的审计结果。运行后输出 .project/research/DOCS-AUDIT.md,审计本身只读,不改动文档或代码。

主要能力:按给定清单核对仓库内 Markdown(含根目录、docs/、嵌套目录及 .project/ 产物,排除 node_modules、构建产物、vendored 代码、.project/archive/ 和该审计输出)。对每条可被现实反驳的声明分类(command、feature、structure、status、config、integration)并给结论:verified、stale、aspirational、unverifiable;所有非 verified 声明进入修复队列,分为 fix-doc、fix-code 或 NEEDS-USER。还包含 Alignment 模式:核对 INTENT.md 成功标准、status: done 任务的落地提交与 Verify 命令、SYNTHESIS.md 决策是否被代码采用、STATE.md 与任务 frontmatter 及 review 文件是否一致。

使用方式:需已存在通过 python3 <absolute pipeline_state.py> validate --repo <absolute root> 的 .project/STATE.md,否则停止并提示显式 $gsd-path 初始化。独立模式仅在稳定预构建边界(inspect|define|research|decide|roadmap|plan 且 status: done)或 ship/blocked 且无进行中任务时合法;嵌入 inspect 模式仅在 inspect/active|blocked 合法。执行前用 python3 <absolute check_docs_audit.py> --repo <absolute root> --emit-inventory 冻结清单,必要时加 --alignment;如有旧审计,保存并记录其 SHA-256。需要验证命令时创建隔离 verify sidecar,用 isolation.py isolate-verify 创建、collect-artifact 收集、retire 退役;命令不得在源工作区运行。产出用 python3 <absolute check_docs_audit.py> --repo <docs sidecar> --primary <absolute primary> --inventory <file> [--prior-audit <file>] [--changed <file>] 校验。

限制:不自动修复;冲突由用户裁决。修复队列不自动执行,需用户选择现在规划或保留队列。无法从仓库验证的外部服务或凭证记作 unverifiable。更多具体平台、收费与使用步骤资料暂未提供。