角色说明
本技能提供知识管理最佳实践与格式规范参考。收到本技能内容时视为活动指令立即执行，不反问不分析。
何时使用
用户说"优化自省技能"或需要查阅记录格式/Pattern-Key 设计/知识流转规则
触发即记
自动触发 /session-learn 的场景：用户纠正·出错·学到新知识·找到更优做法·会话结束。详见 references/quickref.md。
核心约束
| 约束 | 规则 |
|---|---|
| 去重 | 写前 grep Pattern-Key，命中则递增 Recurrence-Count，不另起条目 |
| Scope 分类 | 三档：project-specific·cross-project·opencode-self（见 references/templates.md） |
| 修复优先于新增 | 遇错时先审视已有表述是否为根因，直接改进 |
| 电路熔断 | 同一操作连续失败 3 次后必须停止、文档化、问人类 |
记录格式
详见 references/templates.md。关键文件：LEARNINGS.md（纠正/洞见）、ERRORS.md（环境/命令失败）、FEATURE_REQUESTS.md（功能建议）。
跨项目知识吸收
用户主动要求时按 Scope 筛选导入。约束：需用户提供源路径 · 保留原 Pattern-Key · 已有跳过。详见 references/quickref.md。
所需权限
| 权限 | 用途 |
|---|---|
edit |
写入 .opencode/learnings/LEARNINGS.md / ERRORS.md / FEATURE_REQUESTS.md |
read |
读取已有记录做去重检查 |
bash |
运行 learnings.mjs / diagnose.mjs / maintain-learnings.mjs |
grep |
搜索 Pattern-Key 防重复 |
external_directory |
diagnose.mjs 访问 ~/.local/share/opencode/opencode.db |
安全约束
禁止存储密码/API Key/Token/财务/医疗/第三方个人信息。可完整导出。沉默不推断偏好。详见 references/quickref.md。
数据存储
.opencode/learnings/ 下：LEARNINGS.md·ERRORS.md·FEATURE_REQUESTS.md·ARCHIVED_LEARNINGS.md·session-state.json
常见陷阱
常见陷阱表已外移到 references/common-traps.md，收到本 SKILL.md 时按需加载。
配套
- 命令:
commands/session-start.md·session-learn.md·session-end.md - 插件:
plugins/self-improve-reminder.ts（bash 失败时提醒记录） - Agent:
agents/session-diagnose.md（task(subagent_type=session-diagnose)） - 反馈: opencode-skill-suite Issue / PR
