SuperAPI AI 工具集

project-health

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:从 AI 智能体视角评估项目健康度,判断文档是否可被无歧义理解、工作流能否按字面执行、多会话工作能否顺利交接。适用于把项目交给另一个 AI 会话前、让 AI 智能体参与代码库前、大重构后、工作流因智能体“没看懂”而失败时,以及 AI 维护项目的定期检查。

主要能力:包含三个智能体。context-auditor 检查文档的 AI 可读性,如是否使用祈使动词、文件路径是否明确、成功标准是否可度量、有无歧义引用、代码示例是否完整、依赖与前置条件是否写明、错误处理是否记录,输出 AI 可读性评分(0-100)及具体问题。workflow-validator 验证流程按字面执行是否可行,检查步骤是否离散有序、每步输入输出是否清晰、是否无需隐含知识、环境假设是否记录、每步后是否有验证、失败模式与恢复是否记录、有无省略“显然”步骤,输出可执行性评分(0-100)及逐步分析。handoff-checker 确保多会话工作的连续性,检查是否存在 SESSION.md 或等价文件、当前阶段与状态是否清晰、后续动作是否记录、阻塞与待决策项是否列出、上下文是否保留、是否使用 Git 检查点模式、架构决策及理由是否记录,输出交接质量评分(0-100)及连续性缺口。

使用方式:可运行全部智能体做完整审计,例如“Run all project-health agents on this repo”;也可单独检查某一方面,如“Use context-auditor to check AI-readability”;交接前可用“Use handoff-checker before I end this session”。技能提供 AI 可读文档模板(templates/AI_READABLE_DOC.md)与交接清单模板(templates/HANDOFF_CHECKLIST.md)。

关键原则:智能体按字面解释指令,人类可自行补全的模糊文档对智能体可能失败;应显式而非隐含,不假设智能体知道指哪个文件、下一步是什么、环境状态或成功标准;每步都要有验证,包括预期输出、成功判断与失败处理。

限制与说明:资料未提供安装命令、收费方式、支持平台及与其他工具的具体集成细节。健康项目参考阈值为 context-auditor 80+、workflow-validator 90+、handoff-checker 85+,低于阈值表示存在文档债。