用途:定期或在重大规划周期前,判断项目是否仍与预期设计、已记录行为、已交付功能历史及实时 Beads 状态一致。执行前须读取并遵循 ../dstack-core/references/TRUST-AND-AUTHORITY.md;若与本技能冲突,采用更严格规则并报告冲突。首次变更前遵循 ../dstack-core/references/SKILL-VERSION.md 记录版本证据。
权限:自动纠正仅限无歧义的本地文档、导航与工作流状态核对。涉及代码、API、安全边界、架构策略或破坏性变更须用户明确批准或建立纠正性 Beads 问题;审计子代理为只读。
执行:先盘点来源,运行 bd prime、bd list --all --label workflow:feature --json、bd ready --json、bd blocked --json、uv run --no-project python scripts/check-docs.py,为每个 workflow:feature 根建立清单,检查关联产物、SUMMARY.md 持久页、代码、测试、配置、迁移及上次审计以来的提交。必须用只读 Git 检查(git status、git log、git show、git diff)获取近期提交证据,禁止任何 Git 写操作;若确实无法执行只读 Git,须报告 audit state: incomplete。随后比对 Beads 与设计、交付记录、文档、边界、不变量、命令、测试、迁移等是否漂移,并按类型分类。对无歧义文档直接修正,其余用 bd create "Reconcile <finding>" --type task --deps discovered-from:<feature-root-or-task> --labels audit:drift --json 建立问题。修正后使旧验证结果失效,重跑 check-docs.py 及受影响格式化、lint、构建、测试、迁移与功能检查,记录命令与结果。当 Beads 记录有变动时,可执行 bd dolt remote list --json 与 bd dolt push 进行一次常规非强制发布;不授权创建/替换远程、强制推送或 Git 分支推送,未变更则不推送。
输出:按严重度返回发现、有意与意外分类、文件与 Beads ID、已应用修正、新建问题、受阻工作、发布证据、Git 比较范围与建议下一步,并给出唯一状态行。仅在所需证据全部检查且每项发现均已修正、关联纠正问题或明确接受为残余风险时,才标记 audit state: complete;否则为 audit state: incomplete。资料未提供具体平台、收费或运行环境信息。