用户说"创建/写"→ 创建模式。用户说"审查/改进/检查"→ 审查模式。两种模式不混合。
opencode.json 设为 "allow"；为外部构建的技能（浏览器自动化、第三方集成）→ 不注册，避免污染主环境本技能只做人工判断型审查（设计合理性、安全评估、结构直觉）。
审查开始前先展示确认行，明确审查范围和深度，让用户在看结果前就能纠正理解偏差：
📌 确认审查范围：
- 目标：[技能名/agent名]
- 审查类型：[设计审查 / 安全检查 / 完整评估]
- 深度：[快速扫描 / 标准审查 / 深度审计]
如需调整请告诉我 ↓
审查开始前先确认审查深度，不同深度覆盖范围不同：
| 深度 | 覆盖范围 | 适用场景 |
|---|---|---|
| ------ | --------- | --------- |
| 快速扫描 | 结构完整性 + 权限配置 + 常见陷阱 | 用户自检，快速确认无明显问题 |
| 标准审查 | 快速扫描 + 设计合理性 + 安全评估 | 默认，常规审查 |
| 深度审计 | 标准审查 + 红队测试 + 跨技能影响分析 | 发布前 final check |
审查过程中区分两类问题，处理方式不同：
格式、排版、拼写、元数据字段缺失、命名风格不一致等不影响功能逻辑的问题，直接修改，无需用户确认。
涉及结构设计、流程逻辑、权限配置、安全策略等影响功能行为的问题：
references/checklists.md 和 references/common-traps.md，输出问题列表（标注严重程度和优化方案）_meta.json + SKILL.md frontmatter），patch/minor/major 按改动范围定仅深度审计模式下自动执行；标准和快速模式下根据用户判断决定。
如果审查 agent，参照 references/red-team-testing.md 发送 3-5 个越权请求验证安全约束是否生效，报告测试结果。
用户对审查结果不满意时，按以下分级路径处理：
| 轮次 | 行为 |
|---|---|
| ------ | ------ |
| 第1轮 | 直接根据用户反馈修订评估，标注"改了什么"（格式：✏️ 已调整[XXX]） |
| 第2轮 | 先复述确认用户预期："我理解你想重点优化 [X] 方向，对吗？"重新出一版评估 |
| 第3轮 | 请求用户提供参考标准："你能发一个你认为是'好设计'的例子吗？我按那个标准重评" |
| 事项 | 应交给 |
|---|---|
| ------ | -------- |
| 功能测试（运行时测试用例） | skill-tester |
| 自定义命令的创建和审查 | opencode-command-manager |
| 打包发布 | opencode-skill-packager |
| 安装到运行时 | opencode-skill-installer |
需项目追踪时在主目录下创建文件夹。创建文件前先问用户。
| 主题 | 文件 |
|---|---|
| ------ | ------ |
| 使用引导 | setup.md |
| 技能模式与描述示例 | references/patterns.md |
| 质量与安全检查清单 | references/checklists.md |
| Agent 格式与权限配置 | references/agent-format.md |
| 常见陷阱 | references/common-traps.md |
| 红队测试 | references/red-team-testing.md |
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 忘记红队测试 | 权限配置漏洞（bash 绕过、task 委托）在静态检查中不易发现 | 审查 agent 时必须执行红队测试（red-team-testing.md） |
| 把"何时使用"当注释 | ## 何时使用 是 AI 的路由触发条件，不是人类文档 | 与核心规则一同放在 prompt 前部，不可单独后移 |
在 opencode-skill-suite 提交 Issue 或 PR。
共 2 个版本