何时使用
- 创建模式：用户想要创建新技能或 agent 时
- 审查模式（被动）：用户要求审查、改进现有技能/agent 的设计质量时
- 审查模式（主动）：修改技能/agent 的结构、核心逻辑或权限配置后，主动询问用户是否需要审查
加载协议
收到本技能时，按以下顺序加载：
- 输出声明行确认本次请求的模式和范围（例：
📌 审查模式 — 目标: <技能名>，深度: 标准审查） - 读
core/mode.md判断当前请求属于创建还是审查模式 - 根据模式读
core/create.md或core/review.md - 仅在执行对应步骤时按需读
references/中的参考文件
审查模式的强制规则
审查分析必须委托给 skill-review agent（task(subagent_type=skill-review)），AI 只负责触发、输出格式修正和修复执行。禁止自审——不使用 skill-review agent 的审查视为无效。红队安全测试（references/red-team-testing.md）是审查的必选步骤，不可跳过。
数据存储
需项目追踪时在 .opencode/ 下创建文件夹（如 .opencode/notepads/）。创建文件前先问用户。临时文件一律使用 .opencode/.tmp/。
快速参考
| 主题 | 文件 |
|---|---|
| 使用引导 | setup.md |
| 技能模式与描述示例 | references/patterns.md |
| 质量与安全检查清单 | references/checklists.md |
| Agent 格式与权限配置 | references/agent-format.md |
| 常见陷阱 | references/common-traps.md |
| 红队测试 | references/red-team-testing.md |
| 跨技能边界 | references/cross-skill-boundary.md |
| Bug 修复流程 | references/bug-fix-flow.md |
| 技能自动化校验 | scripts/validate-skill.mjs <skillDir> |
相关技能
opencode-command-manager— 创建和审查 OpenCode 命令文件skill-tester— 对已安装的 skill/agent 执行功能测试opencode-skill-packager— 打包技能为 zipopencode-skill-installer— 安装/查询/卸载技能
常见陷阱
| 陷阱 | 原因 | 解决 |
|---|---|---|
| 创建模式写审查内容 | 模式混用导致指令矛盾 | 规则 1：模式分离 |
| 核心规则写太多 | 超过 7 条则代理记不住 | 限制 3-7 条 |
| 规则藏在描述后 | 模型优先执行用户请求而非 prompt 体中的规则 | 编号强制规则放 prompt 顶部 |
| description 不含关键约束 | available_agents 仅可见此描述，子代理凭此决定行为 | 描述末尾加入关键行为约束 |
| 改 agent 后不重启即测试 | agent .md 不热重载 |
改 agent 后须重启 session 才能生效 |
| 审查时越界做功能测试 | 本技能只做设计审查 | 涉及运行时行为 → 交给 skill-tester |
| 审查 agent 忘记红队测试 | 权限配置漏洞在静态检查中不易发现 | 红队测试是审查必选步骤，不可跳过。审查时必须加载 references/red-team-testing.md |
| 不委托 skill-review 直接自审 | AI 认为自审更快，跳过 subagent 委托，导致红队测试、版本建议等子步骤全部丢失 | 审查模式强制委托 skill-review agent，禁止自审。AI 只负责触发、格式修正和修复执行 |
| 审查前不输出声明行 | AI 直接开始审查，用户无法在开始时纠正方向或确认范围 | 加载协议第一步强制输出声明行（模式+目标+深度），用户确认后再继续 |
| 把"何时使用"当注释 | ## 何时使用 是 AI 的路由触发条件 |
与核心规则一同放在 prompt 前部 |
| CMD-002 正则过宽抓假阳性 | 正则匹配了 URL、路径和 markdown 格式 | 限定为反引号/引号内模式 + 读 _meta.json aliases |
| 审查漏检敏感信息 | 示例暴露真实用户名/路径/API key | 审查时 grep 确认无敏感信息残留 |
| 测试输出用系统临时目录 | $env:TEMP / /tmp 触发 external_directory 弹窗且不易清理 |
所有测试/临时文件写入 .opencode/.tmp/ |
反馈
在 opencode-skill-suite 提交 Issue 或 PR。
