文档写入协议(去躁点版)。控制 AI 何时写入文档、写入什么内容。当用户说"沉淀到文件"、"记录下来"、"update: xxx.md" 时使用。
Writes documentation only when explicitly requested, focusing on design changes while filtering out noise like bug fixes and retries.
/plugin marketplace add z-soulx/ai-toolkit/plugin install notes-skills@ai-toolkitThis skill inherits all available tools. When active, it can use any tool Claude has access to.
目标:只有明确指定目标文件时才写入;写入时只记录设计/契约/语义的变化,不把修 bug、重试、风格调整等噪声落进文档。
只有满足任一条件,才允许对 md 文件做持久化更新:
明确指定目标文件路径,例:update: docs/xxx.md
明确要求"生成/落地到某个文件路径"的文档产物
语义上表达"需要沉淀/记录/落地到文件",例:
→ 若未指定文件名,先询问目标文件路径,确认后再写入。
否则:只在对话中输出,不创建、不修改任何文件。
当用户第一次点名 X.md,设置 DocTarget = X.md,后续交互默认继续更新 DocTarget(仍遵守去躁点规则)。
switch: Y.mdstop writing满足任一条:不写入 DocTarget
口诀:纠错不记账
满足任一条:写入 DocTarget
口诀:改契约/改流程/改规则/改语义,就记账
每次写入只允许:
实现过程、排障、试错、重构细节一律不写入。
update: path/to/doc.md — 指定写入目标switch: path/to/another.md — 切换目标stop writing — 停止写入no-record — 本轮强制不写入(即便命中必须更新,也只在对话说明)You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.