SuperAPI AI 工具集

ln-162-skill-reviewer

智能体与模型

查看项目

更新于 10-16 06:23

技能介绍

用途:在发布前验证技能(skill)或 .claude/commands 命令文件的质量,属于 1XX Documentation Pipeline 分类,类型为 L3 Worker(可独立运行)。

两种模式:SKILL 模式审查 ln-/SKILL.md,采用完整 D1-D11 结构标准加 M1-M6 意图标准;COMMAND 模式审查 .claude/commands/.md,关注结构与可执行性。两者都存在时默认 SKILL 模式,可用 $ARGUMENTS=commands 覆盖。输入参数:留空则自动探测模式与范围;传 ln-400 ln-500 表示审查指定技能;传 repo 或 repo-checks 在通用审查后运行仓库专属检查;传 commands 表示 COMMAND 模式审查全部命令文件;传具体文件名表示审查指定文件。被其他技能调用时可直接传入文件路径。

SKILL 模式流程:阶段1 探测范围(依据参数前缀、git diff、暂存与未跟踪文件,收集主技能、受共享文件影响的技能及依赖技能);阶段2 运行 references/scripts/run_checks.sh 做自动化验证,须按 ln-NXX 家族或协调者/工作者分组分批调用,单次不超过 5-10 个文件,自动化失败视为预验证并逐条记录;阶段3 结构审查,须先读 references/structural_review.md、skill_contract.md、procedural_skill_sop_guide.md、mcp_applicability_matrix.md 与 mcp_tool_preferences.md,覆盖 D1-D11(如缺失 Type、L3 工作者独立性违规、路径失效、缺失 markdown_read_protocol.md、MCP 命名空间错误、流程技能模糊措辞等);阶段4 意图审查,加载 references/intent_review.md 并对主技能应用 M1-M6;阶段5 自动修复确定性问题(错误路径、过时引用、重复措辞等),不做模糊行为猜测,修复后重读并压缩冗余;阶段6 输出结论(存在未修复结构违规为 FAIL,仅剩建议性意图问题为 PASS with CONCERNS,无问题为 PASS);阶段7 清理过时聚合计数,只保留该文件固有的局部计数。

仓库套件模式:先完成通用审查,再运行 node plugins/documentation-pipeline/skills/ln-162-skill-reviewer/references/scripts/repo_review_suite.mjs 执行 R1-R27 检查;运行时策略默认为 --runtime quick(有界冒烟),--runtime skip 仅结构,发布/CI 用 --runtime full。该完整套件不是默认交互式审查门槛,可能超出常规审查延迟。最后合并通用审查与仓库套件结论,取最差判定并列出 FAIL/WARN 项及文件路径与修复说明。

COMMAND 模式:须读 references/command_review_criteria.md,探测范围后逐文件套用命令审查标准、验证来源与无残留复制的文档外壳段落;可自动修复缺失 frontmatter、缺失 allowed-tools、过长的 description、缺失 Last Updated 及完全复制的外壳段落;报告给出每个文件的 PASS/FIXED/WARN/FAIL 与通过率。

规则与限制:自动化检查不可协商;报告前须读完全部范围内文件;确定性可修复问题立即处理;除非用户明确要求,不更新版本或日期;shared/ 变更影响所有引用技能;L3 工作者必须独立(不出现 Coordinator、Parent、必需调用者声明);文档模型漂移按结构缺陷处理;禁止使用不受支持的平台 API(明确标注的历史引用除外)。计划模式下阶段1-4、6-7 为研究性工作,可完整执行并把报告与修复清单写入计划,批准后才应用修改。技能版本 1.0.0,最后更新 2026-03-26。其他具体验证规则、脚本内部逻辑与输出细节暂未提供。