# Yy Sync Instructions From Opencode

> 将 .opencode.json 中的非 OpenCode 专属规则同步到 AGENTS.md。当 .opencode.json 文件发生改动时触发， 确保通用规则不会仅存在于 .opencode.json 而缺失于 AGENTS.md。 不用于反向修改 .opencode.json、生成 AGENTS.md 主框架，也不用于检查 README 或规则列表一致性。

- Skill: `bulls-cows/yy-sync-instructions-from-opencode` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bulls-cows/yy-sync-instructions-from-opencode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bulls-cows/yy-sync-instructions-from-opencode/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bulls-cows (https://skillmd.com/u/bulls-cows)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bulls-cows/yy-sync-instructions-from-opencode

---


# yy-sync-instructions-from-opencode

## 描述

将 `.opencode.json` 中的通用规则同步到 `AGENTS.md`，确保两边规则一致。同步方向为单向：`.opencode.json` → `AGENTS.md`，尽量不修改 `.opencode.json`。

## 使用场景

- `.opencode.json` 文件发生改动后，需要检查是否有通用规则缺失于 AGENTS.md
- 主动检查 `.opencode.json` 与 AGENTS.md 的规则一致性

不应触发：

- 只是查看 `.opencode.json` 内容
- 修改与规则无关的配置项

## 指令

### 步骤 1. 读取两个文件

- 读取 `.opencode.json` 的 `instructions` 数组
- 读取 `AGENTS.md` 全文（而非仅"需要遵守的规则"章节），因为部分规则可能已在其他章节中体现

### 步骤 2. 逐条分类 instructions 中的规则

对 `instructions` 数组中的每一条，按以下规则分类：

- **文件路径引用**（以 `./` 开头或匹配已知文件名如 `AGENTS.md`）：跳过，AGENTS.md 已通过 `@` 语法引用
- **OpenCode 专属规则**：跳过，这类规则仅适用于 OpenCode 环境。判断标准：
  - 规则内容涉及 OpenCode 工具特有的功能或配置（如 OpenCode 的特定命令、快捷键、UI 行为）
  - 规则内容是对 OpenCode 工具本身的操作约束（而非通用的编码/协作规范）
  - 示例："本地测试后再提交，将技能复制到 OpenCode 并测试调用"——这条规则指定了使用 OpenCode 作为测试工具，属于 OpenCode 专属
- **通用规则**：AGENTS.md 中没有的、且不是 OpenCode 专属的规则，需要同步
  - 判断"AGENTS.md 中没有"时，需检查 AGENTS.md **全文**，而非仅"需要遵守的规则"章节
  - 如果规则内容已在 AGENTS.md 其他章节中体现（语义等价），视为"已有"，无需重复添加

### 步骤 3. 同步通用规则到 AGENTS.md

- 将步骤 2 识别出的通用规则，添加到 AGENTS.md 的 `## 需要遵守的规则` 章节末尾
- 保持 AGENTS.md 现有规则的格式和顺序

### 步骤 4. 验证一致性

- 确认所有通用规则在 AGENTS.md 中已存在
- 确认未修改 `.opencode.json`
- 确认未将 OpenCode 专属规则同步到 AGENTS.md

### 步骤 5. 输出结果

```markdown
## 同步结果

### 规则分类

- 文件路径引用: [数量] 条（已跳过）
- OpenCode 专属规则: [数量] 条（已跳过）
- 通用规则: [数量] 条

### 同步操作

- 新增到 AGENTS.md: [规则内容列表]
- 无需同步: [说明]

### 一致性验证

- 通用规则同步: ✅ 通过 / ❌ 未通过
- .opencode.json 未被修改: ✅ 通过 / ❌ 未通过
```