SuperAPI AI 工具集

project-auditor

智能体与模型

查看项目

更新于 10-15 19:50

技能介绍

用途:对指定项目目录执行 Grok Build 就绪度审计,评估代码库是否适合与 Grok Build 及类似智能体编程工具配合使用,输出 0-100 的 Grok Readiness Score、具体优势与差距,以及按优先级排列的可执行建议。支持人类可读与机器可读两种输出。

主要能力:接受目录路径(默认当前工作目录或 .),确认路径存在;读取 .grokignore 与 .gitignore 并构建忽略匹配器,.grokignore 对智能体读取优先,且不读取被忽略的文件(如 node_modules、dist、.grok/sessions、大型二进制、日志)。扫描项目规则文件(优先级 AGENTS.md、Agents.md、AGENT.md、CLAUDE.md 等);统计并检查 .grok/skills/*/SKILL.md,读取 frontmatter 验证 name 与 description 是否存在且具体;检测测试框架(package.json 中的 vitest、jest、mocha、ava、tap、scripts.test,pyproject.toml/pytest.ini/setup.cfg 中的 pytest,go.mod 与 _test.go 等);检测 CI(.github/workflows/、.gitlab-ci.yml、Jenkinsfile、circle.yml、buildkite.yml 等);检查 Git 卫生(是否仓库、近期提交、干净/脏状态、分支名);识别其他正向信号(README 提及 Grok、agent、Plan Mode,CONTRIBUTING.md,.grok/ 下 hooks、agents 等)。

评分:按加权信号计分,如 AGENTS.md 存在且充实(≥800 字符、多清晰章节)+25,.grok/skills/ 中至少 2-3 个规范技能 +20,真实测试设置 +20,CI 配置 +10,忽略卫生 +8,近期干净 Git 历史 +7,显式验证语言 +5-10,并对反模式扣分。无任何 Grok 信号但测试、CI、Git 优秀的项目仍可获 30-40 分。

使用方式:默认输出格式化报告,含分数、✓/△/✗ 条目与建议列表;--json 输出含 score、findings[]、recommendations[] 的对象;--md 输出适合粘贴到 issue 或 PR 的 Markdown。工具使用上优先 list_dir、read_file、grep 与针对性的 run_terminal_command(用于 git),大树从根开始再深入有希望的子目录。

适用场景:项目就绪度评估、改进规划、CI/PR 集成,以及作为 gbs CLI 实现的一部分。

限制:资料未提供具体安装命令、价格、平台支持范围或实际运行效果;评分权重为技能内定义,可能需按项目类型合理调整。