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