用途:在完成代码改动后,更新代码库中的 Noridocs。Noridocs 是散布于代码库中的 docs.md 文件,用于记录每个文件夹的用途、架构与实现。核心原则为:提供上下文 → 派发子代理 → 验证更新。开始时需声明正在使用该技能。
主要能力与流程:第一步收集上下文,明确改了什么、为何改、修改了哪些文件夹或文件、是否有架构变化或新模式。第二步使用 Task 工具派发 nori-change-documenter 子代理,在提示中提供变更描述、修改的文件路径、来自 PR 或提交的相关上下文、架构影响,以及注意到的与本次改动无直接关系的过时文档。第三步验证更新,运行 git status 查看哪些 docs.md 发生变化,审查 diff 确认准确,并确保更新聚焦系统架构而非细枝末节。
Noridocs 格式:每个 docs.md 包含标题 Noridoc: [文件夹名]、以 @ 开头的仓库根路径、Overview、How it fits into the larger codebase、Core Implementation、Things to Know 等小节。文档不应列出文件、维护计数或跟踪行号。
常见错误:上下文含糊、跳过验证、记录琐碎改动。红线:绝不跳过提供上下文、绝不未验证就假定文档已更新、绝不手动更新文档而不使用子代理;始终提供详细上下文、验证子代理更新了合适的 docs.md、聚焦架构与系统级变化。