SuperAPI AI 工具集

skill-review

智能体与模型

查看项目

更新于 10-16 10:12

技能介绍

Skill Review 是一个面向 Codex、Qoder 或仓库本地技能(skill)及其提示链(prompt chain)的审查工具,关注触发质量、工作流清晰度、渐进式披露、职责重复等问题。它的核心立场是:将技能作为一份执行契约来审查,而不是当作普通说明文。审查者需要追踪智能体如何进入、加载、委派、产出工件并验证结果,然后报告能改善这条链的最小改动。

主要能力与审查视角

审查流程会先定位目标技能或提示链;如果用户指定了路径,则停留在该路径及其直接链接的资源上。随后先读取仓库指令,包括最近的 AGENTS.md、插件清单,以及目标 SKILL.md 的 frontmatter 和正文。接着从入口点追踪到引用、模板、脚本、检测器、测试、生成工件和验证命令,并建立所有权映射,明确哪些文件拥有工作流、输出结构、运行时规则、风格和测试。

审查会在编辑之前先审计契约,使用 Audit Checklist 与 Reference Patterns 作为视角。Audit Checklist 涵盖触发契约、渐进式披露、工作流与委派、模板所有权、可读性和证据。Reference Patterns 提供可复用的设计视角,例如 Trigger/Protocol 分离、Gate Function 和 Output Contract Slots。Fast Inspection Commands 提供根据仓库调整的 rg、wc 和 git diff --check 探测命令。

使用方式

如果用户要求更改,只补丁最小范围内的负责文件。生成的辅助脚本、冒烟脚本和本地实验不应放入 SKILL.md,除非它们是该技能必须使用的持久资源。验证时应使用可用的最轻真实关卡,例如技能验证器、仓库测试、插件验证或有边界的智能体冒烟测试,并说明任何无法运行的关卡。子智能体仅作为评估面或用于独立的广泛研究;主导智能体负责审查、最终校准和文件编辑。应传入原始工件和任务局部范围,而不是预期答案。

严重程度与报告结构

发现的问题按严重程度排序:P0 表示技能指向缺失、为空、矛盾或无效的资源,智能体照做会失败;P1 表示技能可用但浪费上下文、重复所有权、隐藏关键约束或产出不可读输出;P2 表示风格、命名、措辞或组织问题,降低可扫描性但不破坏工作流。报告以发现的问题开头,按严重程度排序,每条发现包含简短标题、文件路径与行号、为何重要、证据、最小修复和验证方式。只有在阻碍安全更改时才添加开放问题;若用户要求编辑,则在发现之后附上变更文件与验证结果。默认使用用户的语言。

适用场景与限制

它适用于审查 Codex、Qoder 或仓库本地技能及其提示链,尤其是需要检查触发质量、工作流清晰度、渐进式披露和职责重复的场景。资料未提供具体的安装命令、价格、支持的平台范围或性能数据,这些信息暂未提供。