SuperAPI AI 工具集

review-agentic-setup

编程与开发

查看项目

更新于 10-16 06:16

技能介绍

review-agentic-setup 用于检测和评估项目中的智能体编码基础设施,帮助发现配置缺口与跨工具兼容性问题。它只做分析,不会安装或配置任何内容。该审查始终在项目级别进行,diff 命令、文件列表等范围参数会被接受但忽略;独立调用时以 git 仓库根目录为项目根,不在 git 仓库中则回退到当前工作目录。

第一步检测五类基础设施。智能体指令方面:检查项目根及子目录的 CLAUDE.md(由 Claude Code 读取)、根及子目录的 AGENTS.md 与 AGENTS.override.md(由 Codex 读取),以及 README.md 是否提及 AI 辅助开发;并检查跨工具共享模式,即 CLAUDE.md 通过 @AGENTS.md 导入内容,或 CLAUDE.md 与 AGENTS.md 互为符号链接。已安装技能方面:检查 .claude/skills/ 与 .agents/skills/,读取每个 SKILL.md 的 YAML frontmatter 获取名称与描述,将技能分为分析、工作流、流水线、工具四类,并检查目录是否为符号链接。MCP 服务器方面:检查 .mcp.json、.claude/settings.json、.claude/settings.local.json 以及 .codex/config.toml 中的 [mcp_servers],列出名称、类型与所属工具。Hooks 方面:检查 Claude Code 的 settings.json 与 settings.local.json、以及 Codex 的 .codex/hooks.json,列出触发事件、命令与所属工具。文档引用方面:查看指令文件中引用的路径、URL、章节标题,并检查 docs/、CONTRIBUTING.md、TROUBLESHOOTING.md、ARCHITECTURE.md 及 API 文档或 schema 文件。

第二步分析缺口与兼容性。每类状态分为已配置、部分配置、缺失,判断会考虑项目复杂度。跨工具兼容性判断依据:只有 AGENTS.md 则仅支持 Codex;只有 CLAUDE.md 则仅支持 Claude Code;两者都有但 CLAUDE.md 未导入 @AGENTS.md 则指令被隔离;有导入或符号链接则两工具均支持;技能目录或 MCP 配置只覆盖单一工具时也会标记为兼容性缺口。

输出格式:每条发现以标题(命令式,不超过 80 字符)、类别和一段说明呈现,并附带智能体设置摘要表、工具支持表和总体结论(装备完善、发现缺口或未配置),发现按 P0 至 P3 分级。