用途:在向代码库引入自主智能体前做就绪度审计,或用于排查因架构不清、约定薄弱导致的开发者上手缓慢问题,输出可提升代码可导航性与变更安全性的优先修复项。不适用于窄范围缺陷排查、编译错误处理,或直接实现某个具体功能;仓库范围过小也无法可靠评估。
主要能力:输入项目文件(可全量或部分),可选项目指南、CI/CD 配置、问题跟踪或路线图、目标智能体能力,以及 AGENTS.md、AGENTS.yaml、CLAUDE.md 等智能体元数据文件。输出结构化报告,含摘要、差距分析(结构缺失、抽象不完整、命名与可发现性差、隐藏耦合、模式不一致)、智能体摩擦点(意图不清、需跨文件推理、缺少类型安全或契约、动态隐式行为、测试覆盖弱、副作用与状态流不清)、文档缺陷、工具与自动化缺口,以及按影响与成本排序的建议(问题、对智能体的影响、具体修复、示例),并区分快速见效项与长期改进。
评估维度:清晰与显式、一致性、可组合性、可发现性、确定性、可测试性、类型安全与契约、文档质量、渐进式披露、模块 API 边界。检测模式包括逻辑跨无关文件、魔法字符串、动态类型、隐藏副作用、复杂度过高、抽象不一致、核心逻辑缺测试、命名不达意。核心检查涵盖智能体元数据文件是否存在、关注点分离、模块公开 API 与深层导入、渐进式披露。
使用方式与限制:资料未提供具体安装命令或调用步骤,仅说明其作为技能使用。建议保持务实、避免过度设计,以智能体可理解性为目标,假设目标是低上下文下的自主修改。