SuperAPI AI 工具集

coherence-auditor

智能体与模型

查看项目

更新于 10-15 21:54

技能介绍

用途:对仓库文档进行一致性、链接完整性与 Git 状态审计,按需运行以发现失效链接、映射不同步、未跟踪杂乱文件与未解决 TODO。

主要能力:审计脚本执行以下检查——Git 状态(工作树是否干净、是否直接在 main 分支工作)、根目录杂乱(未跟踪或非规范 Markdown 文件)、链接完整性(扫描除 dist/ 与 node_modules/ 外的 Markdown,验证相对链接指向存在的文件)、功能映射同步(guides/features-and-use-cases.md 与仓库实际指南是否一致)、TODO/TBD 扫描、技能配置检查(skills-src/ 中技能是否在 lib/skills-config.ts 配置)、CONTEXT.md 与 project-* 技能的一致性提示、指南完整性测试(guides/guides-integrity.test.ts)。

使用方式:定义并调用 document-coherence-auditor 子代理,运行命令 node --experimental-strip-types scripts/coherence-audit.ts;完整预检(构建、类型检查、lint 与全部测试)运行 node --experimental-strip-types scripts/coherence-audit.ts --preflight。子代理需捕获分析输出,进行语义一致性检查(阅读 CONTEXT.md 与 .agents/skills/ 中所有 project-* 技能,核对工作流阶段、检查点、角色与技术需求是否一致),以结构化格式报告发现、警告与错误,指出失效链接的文件与行并建议修复,报告功能映射不同步及术语漂移。

限制:该审计为只读,不得自行修改仓库文件;修复需由调用方在审阅报告后进行。其他平台、收费与效果信息暂未提供。