journal-claw

文档自动维护（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。"

维护 identity/ 下任何档案前必须加载。定义人物五维度画像、

统一笔记整理 skill。用户提交录音、粘贴文本、文件、网页素材、会议纪要、读书笔记、研究材料、工作汇报、技术记录、个人复盘，或说写日志/整理成日志/帮我记一下/记录一下时触发。先识别笔记家族和子类型，再按需加载 references 中的模板与组件规则，生成高质量 .mdx 日志。

谨迹日志库的自动整理 Agent。用户输入 /lint、说整理一下日志库、最近日志有点乱、帮我理一下档案、日志库维护、跑一次 lint时触发。执行四阶段整合流程修复「记忆腐烂」：标注决策演进、修复 Identity 档案矛盾、补充交叉引用、修复元数据、检测事实矛盾。只动日志「关联记录」区和 Identity 档案，绝不改日志正文、绝不改 raw/。不要在仅看单个条目或处理会议素材时触发 — 本 skill 面向「整个日志库」的周期性维护。

需求门禁（Requirements Gate）——在写任何代码之前，把模糊的开发需求变成一份无歧义、可验证的 spec.md。只要用户提出新的开发需求或变更请求（实现 / 新增 / 开发 / 加一个 / 修改 / 重构 / 优化 / 接入 / 修复 / add / implement / build / feature / fix），哪怕措辞很随意，且该任务还没有 status: approved 的 spec.md，就必须使用本技能。当 UserPromptSubmit hook 注入「需求门禁」提醒时也必须使用。不要因为需求看起来很简单而跳过——简单需求走 L1 轻量路径，同样留档。

"AI 秘书的经验积累与自检机制。用户纠正处理结果（"不对"、"搞错了"、"应该是 X"）、要求记住偏好（"记住这个"、"下次别这样"、"以后都这么做"）、追问过去的教训（"你上次就搞错了"、"之前学到了什么"、"查一下之前的教训"、"回顾一下经验"）、或输入 /self-improvement 时触发。处理完素材后也应自动评估是否有值得记录的经验。不要在正常素材整理时触发（那是基础 journal 能力）、不要在 /lint 整理日志库时触发（lint 有自己的流程，但会读取学习记录）、不要在 /ideate 探索想法时触发。"

验收门禁（Verification Gate）——与 requirements-gate 成对的下游环节：需求门禁确保做对的东西，验收门禁确保做的是对的东西。开发完成、准备 git commit、或想宣称'做完了'之前，凡存在与本次改动相关、status: approved 但尚未 verified 的 spec.md，必须使用本技能 spawn 独立 subAgent，按不漏不重不偏不倚不多不少六字标准核对实现与 spec 的符合度，产出 verify-report.md。当 PreToolUse hook 注入「验收门禁」提醒时必须使用。注意：测试全部通过不等于验收通过——技术正确性归 verification-before-completion，需求符合度归本技能。

"把日志条目转化为可视化网页设计说明书（金橙暖色叙事长页）。用户在日志详情右键"转化为可视化设计"、dock 栏输入 /visual-design-book @日志路径、或说"这篇日志做成可视化"、"帮我做个 design book"、"生成设计说明书"、"变成可视化长图"、"可视化呈现这份日志"、"这个分享/讲座/课程做成可视化"时触发。读取已完成的日志 HTML，自动识别内容类型(产品设计 / 会议纪要 / 通用知识 / 授课分享)，按五层叙事结构生成自包含 HTML 并关联回 sources。四种类型共用同一套金橙视觉系统，仅思维结构与排版有别。不要在想法探索阶段使用 — 那是 ideate 的职责。"

Browser automation CLI for AI agents. Use when the user needs to inspect, test, or automate browser behavior: navigating pages, filling forms, clicking buttons, taking screenshots, extracting page data, reading selected Open Design browser-tab context, testing web apps, dogfooding Open Design previews, QA, bug hunts, or reviewing app quality. Prefer local Open Design preview URLs unless the user explicitly asks for external browsing.

General-purpose desktop web prototype. Single self-contained HTML file built by copying the seed `assets/template.html` and pasting section layouts from `references/layouts.md`. Default for any landing / marketing / docs / SaaS page when no more specific skill matches.