ln-162-skill-reviewer

**路径：**文件路径（references/、../ln-*）均相对于此技能目录。

ln-162-skill-reviewer

**类型：**L3 Worker（可独立运行） **类别：**1XX 文档流水线

通用审查器，支持两种模式：

• SKILL，用于 ln-*/SKILL.md
• COMMAND，用于 .claude/commands/*.md
• 当请求 repo / repo-checks，或当前仓库为 claude-code-skills 时，运行此技能仓库的套件

**计划模式行为：**阶段 1-4 和 6-7 属于研究工作。在计划模式下完整执行，将报告和修复清单写入计划，并仅在获批后应用编辑。

---

模式检测

条件	模式	审查配置
CWD 中存在 ln-*/SKILL.md 文件	SKILL	完整 D1-D11 + M1-M6
存在 .claude/commands/*.md 文件	COMMAND	结构审查 + 可执行性审查
两者都存在	SKILL	使用 $ARGUMENTS=commands 覆盖

输入

$ARGUMENTS 选项：

• 为空 -> 自动检测模式和范围
• ln-400 ln-500 -> SKILL 模式，指定技能
• repo 或 repo-checks -> 通用审查后，运行规范的仓库专属检查
• commands -> COMMAND 模式，审查所有 .claude/commands/*.md
• deploy.md run-tests.md -> COMMAND 模式，审查指定文件

由其他技能调用时，可能会直接传入文件路径。

---

SKILL 模式

阶段 1：范围检测

如果提供了 $ARGUMENTS：

• 将每个词元视为技能目录前缀
• 对 {prefix}*/SKILL.md 执行 glob

如果 $ARGUMENTS 为空：

• 检查 git diff、已暂存文件和未跟踪文件
• 收集主要技能目录
• 收集引用了已更改共享文件的受影响技能
• 收集工作器表格和 Skill() 调用中的依赖技能

报告： 范围：{N} 个主要技能，{M} 个受影响技能，{K} 个依赖技能。

阶段 2：自动验证

运行：

# Never pass a giant mixed scope in one invocation.
# Split by `ln-NXX` family or by coordinator/worker group.
bash references/scripts/run_checks.sh {batch_1 SKILL.md files}
bash references/scripts/run_checks.sh {batch_2 SKILL.md files}

分批规则：

• 尽可能让每次调用只涉及一个 ln-NXX 系列
• 如果范围同时包含协调器和工作器，拆分为不同调用
• 如果单个系列仍然很大，每次调用分成 5-10 个文件

自动化检查失败均已预先验证。记录每一项。

阶段 3：结构审查

**必须阅读：**加载 references/structural_review.md、references/skill_contract.md、references/procedural_skill_sop_guide.md、references/mcp_applicability_matrix.md 和 references/mcp_tool_preferences.md

针对范围内的每项技能审查 D1-D11。

以下情况应视为结构问题，而非风格瑕疵：

• 当依赖角色的检查需要 **Type:** 时缺少该字段
• L3 工作器违反独立性要求
• 共享路径失效
• 根文档假设过时——CLAUDE.md 重复 AGENTS.md 的内容，而不是使用带有受限 harness 差异的 @AGENTS.md 导入占位内容
• Markdown 分析技能缺少 markdown_read_protocol.md
• 提取或审计技能与共享文档质量契约相矛盾
• 技能与共享技能契约相矛盾
• 应将 hex-line 作为首选工具，却只描述内置文件工具的技能
• 应将 hex-graph 作为首选工具，却仍将 grep / 手动分析描述为默认路径的技能
• 根据共享矩阵，加入 hex-graph 或 hex-line 并无实际适用性的技能
• MCP 命名空间错误，例如 mcp__hex_graph__...
• 程序性技能使用含糊的情态词、包含复合高风险步骤、缺少操作点检查清单、未说明高风险步骤的原因、缺少可执行的预检或缺少证据

阶段 4：意图审查

**必须阅读：**加载 references/intent_review.md

仅对主要技能应用 M1-M6。阅读每项主要技能的 git diff。

阶段 5：修复

自动修复确定性问题：

• 路径错误
• 过时引用
• 重复措辞
• 可精确删除内容的工作器独立性违规
• 命令文件中复制的文档外壳章节

对于含糊的行为，不要猜测。

修复后，端到端重新阅读每项主要技能，并在不改变行为的前提下压缩冗余措辞。

阶段 6：报告

判定规则：

• 任何未自动修复的结构性违规 -> FAIL
• 仅剩提示性意图问题 -> PASS with CONCERNS
• 零项发现 -> PASS

报告格式：

## Skill Coherence Review -- {PASS|PASS with CONCERNS|FAIL}

**Scope:** {reviewed skills}
**Verdict:** {verdict}

阶段 7：清理易变数字

从 SKILL.md 文件中移除过时的汇总计数。仅保留评审文件本身固有的局部计数。

---

仓库套件模式

在此仓库中运行，或当 $ARGUMENTS 包含 repo / repo-checks 时使用。

阶段 1：通用评审

先运行适用的 SKILL 或 COMMAND 模式。不得跳过通用评审。

阶段 2：仓库专属检查

运行规范的仓库套件：

node plugins/documentation-pipeline/skills/ln-162-skill-reviewer/references/scripts/repo_review_suite.mjs

仓库套件的默认运行时策略：

• 默认：--runtime quick（隐式）仅运行有界冒烟测试
• 仅检查结构：--runtime skip
• 发布/CI：--runtime full

node plugins/documentation-pipeline/skills/ln-162-skill-reviewer/references/scripts/repo_review_suite.mjs --runtime full

该套件负责 R1-R27。不要将这些检查复制到特定宿主的命令文件中。不要将完整运行时套件用作默认的交互式评审门槛；它专为发布级检查设计，耗时可能超过常规评审的延迟要求。

阶段 3：合并报告

合并通用评审判定和仓库套件判定：

| Source | Verdict | Details |
|--------|---------|---------|
| Universal review | {PASS|PASS with CONCERNS|FAIL} | {summary} |
| Repo suite | {PASS|PASS with WARNINGS|FAIL} | {R1-R27 summary} |
| Combined | {worst verdict} | |

列出所有 FAIL 和 WARN 项，并注明文件路径和修复说明。

---

COMMAND 模式

必须阅读： 加载 references/command_review_criteria.md

阶段 1：范围检测

• 明确指定文件路径 -> 评审这些文件
• commands -> 对 .claude/commands/*.md 使用 glob 匹配
• 协调器提供的文件列表 -> 评审这些文件

阶段 2：评审

针对每个命令文件：

• 应用所有命令评审标准
• 验证源文件出处
• 验证没有遗留复制的文档 shell 章节

阶段 3：修复

在安全的情况下自动修复：

• 缺少 frontmatter
• 缺少 allowed-tools
• 描述过长
• 缺少 Last Updated
• 完全照搬的文档 shell 章节

阶段 4：报告

## Command Review -- {N} files

| File | Verdict | Issues |
|------|---------|--------|

Verdicts: PASS / FIXED / WARN / FAIL
Pass rate: {X}%

---

规则

• 自动化检查不可妥协。
• 报告前阅读所有范围内的文件。
• 立即修复可确定的问题。
• 除非用户明确要求，否则不要更新版本或日期。
• shared/ 中的更改会影响所有引用它的技能。
• L3 worker 必须独立运行：
  • 不得包含 **Coordinator:**
  • 不得包含 **Parent:**
  • 不得要求调用方声明
• 文档模型偏差属于结构性缺陷，不是偏好问题。
• 除非明确标注为历史引用，否则禁止使用不受支持的平台 API。

参考文件

• references/structural_review.md
• references/intent_review.md
• references/automated_checks.md
• references/scripts/run_checks.sh
• references/scripts/run_runtime_suite.mjs
• references/scripts/repo_review_suite.mjs
• references/command_review_criteria.md
• references/scripts/check_marketplace.mjs

完成定义

• 已检测范围
• 已执行自动化检查
• 已评审所有范围内技能的 D1-D11
• 已评估主要技能的 M1-M6
• 已自动修复可修复的问题
• 已完成修复后的整体精简
• 已生成最终判定报告

---

版本： 1.0.0 最后更新： 2026-03-26