yy-check-agents-consistency

name	yy-check-agents-consistency
description	检查 AGENTS.md 中的通用章节与 yy-create-agents 生成模板的一致性。当路径格式规范或终端命令能力识别发生改动时使用，确保 yy-create-agents 后续生成的 AGENTS.md 同步包含相同内容。 不用于检查 README、规则列表或技能列表的一致性，也不用于初次生成或重写 AGENTS.md。

yy-check-agents-consistency

描述

检查项目根目录 AGENTS.md 中与通用代理行为相关的章节是否已同步到 skills/yy-create-agents，并修复发现的不一致问题。

使用场景

• AGENTS.md 中的 路径格式规范 章节发生改动
• AGENTS.md 中的 终端命令能力识别 章节发生改动
• 需要确认 yy-create-agents 生成的 AGENTS.md 是否与当前项目规范保持一致

不应触发：

• 只修改 AGENTS.md 中的项目简介、项目结构或关键参考
• 只修改 AI 能力模型内容
• 只检查 README.md、rules/ 或技能列表一致性

指令

步骤 1. 读取权威来源

• 读取项目根目录 AGENTS.md
• 将 AGENTS.md 作为通用章节的权威来源
• 提取以下章节的完整内容：
  • 路径格式规范
  • 终端命令能力识别

步骤 2. 读取 yy-create-agents 关联文件

• 读取 skills/yy-create-agents/SKILL.md
• 读取 skills/yy-create-agents/templates/agents-minimal-template.md
• 读取 skills/yy-create-agents/examples/output.md

步骤 3. 检查章节清单一致性

检查 skills/yy-create-agents/SKILL.md 是否满足以下要求：

• 必须包含的章节 列表包含 路径格式规范
• 必须包含的章节 列表包含 终端命令能力识别
• 保存并输出结果 的章节清单包含 路径格式规范
• 保存并输出结果 的章节清单包含 终端命令能力识别

步骤 4. 检查模板内容一致性

检查 skills/yy-create-agents/templates/agents-minimal-template.md 是否满足以下要求：

• 包含 路径格式规范 章节
• 包含 终端命令能力识别 章节
• 两个章节的正文与 AGENTS.md 中对应章节保持一致
• 两个章节位于 需要遵守的规则 章节之前

步骤 5. 检查示例输出一致性

检查 skills/yy-create-agents/examples/output.md 是否满足以下要求：

• 包含 路径格式规范 章节
• 包含 终端命令能力识别 章节
• 两个章节的正文与 AGENTS.md 中对应章节保持一致
• 两个章节位于 需要遵守的规则 章节之前

步骤 6. 修复不一致问题

决策分支：

• yy-create-agents 章节清单缺失：更新 skills/yy-create-agents/SKILL.md 中的必须包含章节和输出章节清单
• 模板章节缺失或内容不一致：用 AGENTS.md 中的权威章节更新 skills/yy-create-agents/templates/agents-minimal-template.md
• 示例章节缺失或内容不一致：用 AGENTS.md 中的权威章节更新 skills/yy-create-agents/examples/output.md
• 章节顺序不一致：调整为 路径格式规范、终端命令能力识别、需要遵守的规则 的顺序
• 无不一致问题：不修改文件

步骤 7. 输出结果

输出以下内容：

## 检查结果

### 章节清单

- 状态: 通过 / 已修复 / 未通过
- 详情: [具体说明]

### 模板内容

- 状态: 通过 / 已修复 / 未通过
- 详情: [具体说明]

### 示例输出

- 状态: 通过 / 已修复 / 未通过
- 详情: [具体说明]

### 修改文件

- [文件路径和行号]

注意事项

• 不修改 .claude-plugin/marketplace.json
• 不检查 README.md 中的技能列表一致性
• 只同步 AGENTS.md 中指定通用章节到 skills/yy-create-agents