用途:在多步任务、智能体工作流或实质性工作会话中持续发现技能改进机会,将执行过程中的摩擦与洞察记录为观察日志,避免经验在会话之间丢失。
主要能力:识别可新建技能的信号(可复用多步流程、重复任务类型、用户阐述的方法论);识别改进既有技能的信号(违反既有规则、用户纠正暴露缺失规则、出现更优流程、可推广的技巧、未文档化用例);识别简化技能的信号(长期无关章节、未验证的规则、用户总走的捷径、矛盾规则、从未触发的冗余复杂度)。
使用方式:观察日志位于工作区 skill-observations/log.md,需锚定到跨会话的稳定路径;会话开始时创建缺失的 log.md、cross-cutting-principles.md 与 last-review-date.txt(初始值为 never),扫描 OPEN 观察与生效原则。记录采用固定格式 ### Observation NNN:,首个字段必须为 Status: OPEN,追加到日志末尾,不插到文件中段。每完成约第 3 个 TodoWrite 条目或产出主要交付物(present_files、渲染文档、交付技能文件)时必须写入日志,或写入明确的无观察确认标记;要求实际写入而非仅提醒。写入前需读取日志获取最大编号并断言不冲突,写入后需核验编号唯一且条目仍存在。对共享日志的改动必须逐条有界进行,禁止使用 DOTALL 或贪婪模式跨条目匹配;全文件重写前必须重新读取并合并并发写入;改动前备份,改动后校验 ### Observation 头数量符合预期。
适用场景:任务执行、任务后反馈与评审讨论、关于技能或方法论的元讨论、反思与策略对话。仅休闲聊天和无工具、无交付物的快速事实问答不适用。
限制:资料未提供具体费用、价格、平台支持范围与效果数据;执行本技能不需要抓取外部 URL;评审流程、技能撰写规范与环境配置需分别按需加载 references/weekly-review.md、references/skill-authoring.md、references/environments.md,不得自行即兴处理;若引用的参考文件缺失,视为安装不完整,需告知用户缺失文件并指向规范来源;在无文件系统的环境中采用交接文档模式;工作区若位于临时检出路径(如 .claude/worktrees/ 或临时克隆)需先警告并重新锚定到稳定项目路径。