文档自动维护(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 日志。