用途:在任意多步骤任务、智能体工作流或工作会话中,持续监测可改进技能的机会,把真实工作中发现的摩擦形式化记录为“观察”,供后续审查与沉淀,避免经验在会话之间丢失。它不是面向「专门去改进技能」的独立流程,而是伴随实际任务运行。
主要能力:以每次观察一个 Markdown 文件(带 YAML frontmatter)的方式写入观察日志目录,便于并发创建与低成本扫描;提供会话启动扫描脚本与每周审查流程,用于汇总、批准并交付更新后的技能。观察类型包括:发现新技能、改进已有技能、简化技能。
使用方式:需要一个稳定的持久工作区绝对路径(如用户级 ~/.claude/skill-observations/ 或等效路径),观察日志位于该路径下的 skill-observations/observation-log/,已解决条目归档到 observation-log/archive/。会话启动时运行扫描脚本(bash "<skill directory>/scripts/session-start-scan.sh" "[ABSOLUTE PATH]"),并加载所需参考文件(如 references/weekly-review.md、references/signals.md 等),参考文件按触发条件按需加载。每会话执行一次激活检查,建议在 CLAUDE.md 或等效配置中加入激活说明。
限制:技能正常运行时不需要网络,也不会打开文件中的 URL;仅两个由用户主动发起的例外涉及外部检查。工作区必须锚定在稳定绝对路径,不能放在 .claude/worktrees/ 等临时检出或技能发现目录中,否则观察会在清理时丢失;无文件系统的环境使用交接文档模式。日志为空、目标技能无法解析、暂存更新等情形都有特定处理规则。具体安装命令、许可与归属等细节本资料未提供。