菜单
"AI 秘书的经验积累与自检机制。用户纠正处理结果（"不对"、"搞错了"、"应该是 X"）、要求记住偏好（"记住这个"、"下次别这样"、"以后都这么做"）、追问过去的教训（"你上次就搞错了"、"之前学到了什么"、"查一下之前的教训"、"回顾一下经验"）、或输入 /self-improvement 时触发。处理完素材后也应自动评估是否有值得记录的经验。不要在正常素材整理时触发（那是基础 journal 能力）、不要在 /lint 整理日志库时触发（lint 有自己的流程，但会读取学习记录）、不要在 /ideate 探索想法时触发。"
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
文档自动维护（Docs Maintenance）——git commit 前，凡本次改动对应的 story 已 verified 且其 design.md 影响面涉及架构 / 设计 / 约定变更，必须使用本技能。文档已覆盖变更则跳过——本技能的产出是文档与代码一致，不是每次都改文档。
Use when dispatching independent subagents via opencode CLI in the Journal repository, especially for verification-gate, requirements-gate, or docs-maintenance tasks where context isolation and standardized report output are required.
需求门禁（Requirements Gate）——只要用户提出开发需求或变更请求（实现 / 新增 / 开发 / 加一个 / 修改 / 重构 / 优化 / 接入 / 修复 / add / implement / build / feature / fix），哪怕措辞很随意，且该任务还没有 status: approved 的 story.md，就必须在写任何代码之前使用本技能。不要因为需求看起来很简单而跳过。
验收门禁（Verification Gate）——与 requirements-gate 成对的下游环节：需求门禁确保做对的东西，验收门禁确保做的东西是对的。开发完成、准备 git commit、或想宣称'做完了'之前，凡存在与本次改动相关、status: approved 但尚未 verified 的 story.md，必须使用本技能。注意：测试全部通过不等于验收通过——技术正确性归 verification-before-completion，需求符合度归本技能。
文档自动维护（Docs Maintenance）——git commit 前，凡本次改动对应的 spec 已 verified 且影响面涉及架构 / 设计 / 约定变更，必须使用本技能判断并同步更新 AGENTS.md / ARCH.md / DESIGN.md，并按需维护 README、llms.txt、用户使用说明与技术开发说明文档。当 PreToolUse hook 注入「文档维护」提醒时必须使用。文档已覆盖变更则跳过——本技能的产出是文档与代码一致，不是每次都改文档。
"灵感探讨的思维搭档。用户抛出模糊设计想法（"帮我想想 X 怎么做"、"纠结 A 和 B 方案"、"你觉得这样做怎么样"、"帮我过一遍思路"）、要对比方案、或需要把碎片需求拆成清晰设计决策时触发。过程工具，边聊边在浏览器里画探索画板（黑白点阵风格），不是产出最终文档。如果用户已有成型日志要转可视化长页，改用 visual-design-book；写代码前所有"还没想清楚怎么做"的环节都应先走 ideate。"
| name | self-improvement |
| description | "AI 秘书的经验积累与自检机制。用户纠正处理结果（"不对"、"搞错了"、"应该是 X"）、要求记住偏好（"记住这个"、"下次别这样"、"以后都这么做"）、追问过去的教训（"你上次就搞错了"、"之前学到了什么"、"查一下之前的教训"、"回顾一下经验"）、或输入 /self-improvement 时触发。处理完素材后也应自动评估是否有值得记录的经验。不要在正常素材整理时触发（那是基础 journal 能力）、不要在 /lint 整理日志库时触发（lint 有自己的流程，但会读取学习记录）、不要在 /ideate 探索想法时触发。" |
AI 秘书的持续改进机制。把处理素材中犯的错、用户的纠正、发现的规律记录下来，下次遇到类似情况时主动应用，避免重复犯错。
| 维度 | 声明 |
|---|---|
| reads | .claude/learnings/LEARNINGS.md、yyMM/*.md（自检时读最近条目） |
| writes | .claude/learnings/LEARNINGS.md、workspace CLAUDE.md（晋升规则时） |
| depends | 无 |
| 场景 | 动作 |
|---|---|
| 用户纠正处理结果 | 记录学习条目（category: correction） |
| 用户表达偏好 | 记录学习条目（category: preference） |
| 处理素材失败或质量差 | 记录学习条目（category: error） |
| 发现可复用的规律 | 记录学习条目（category: pattern） |
| 用户说"查一下之前的教训" | 读取并展示相关学习记录 |
| 处理完素材后 | 运行自检协议（见 references/self-check-protocol.md） |
/lint 运行时 | lint 自行读取 LEARNINGS.md，本 skill 不介入 |
用户纠正或自检发现问题时，追加条目到 .claude/learnings/LEARNINGS.md。
条目格式详见 references/entry-format.md。四种 category：
correction — 用户明确纠正（"不对"、"应该是 X"、"搞错了"）preference — 用户表达偏好（"以后都这么做"、"我喜欢这样"、"别用那种格式"）pattern — 从多次处理中归纳出的规律（如"这类会议总是需要先理清参会人关系"）error — 处理失败或质量明显不达标捕获原则：
处理新素材前，读 .claude/learnings/LEARNINGS.md 中 status: active 的条目，优先关注：
回顾不需要向用户展示，默默应用即可。只在用户主动询问时展示学习记录。
同类学习出现 3 次（同一 Area 下相似的 correction 或 pattern）→ 提炼为一条简洁规则，写入 workspace CLAUDE.md 的对应段落。
晋升流程：
CLAUDE.md（追加到 ## 行为准则 段落末尾）status: promoted，元数据追加 晋升位置: CLAUDE.md晋升标准：
处理完素材后运行 5 项快速检查。详见 references/self-check-protocol.md。
自检不需要向用户展示过程。只在发现问题时：