用途:observe 用于回答“最近的会话里,智能体有没有按 kit 的规则做事”,属于合规观察而非设计评审。它强调报告的是 hook 记录下来的事实,而不是凭记忆重建的内容。
主要能力:
- 环境检测:先检查 kit 脚本是否存在(ls ${CLAUDE_SKILL_DIR}/../../../scripts/observe.mjs)。若 KIT_MISSING,说明只安装了技能文件夹,应提示用户走插件安装或 npx ux-ui-agent-skills init,然后停止。
- 会话摘要:运行 node ${CLAUDE_SKILL_DIR}/../../../scripts/observe.mjs --project "$CLAUDE_PROJECT_DIR";用户询问全部项目时可省略 --project,用户给出时间窗口时加 --days N。引用其打印的摘要行;若显示没有会话编辑过 UI,则说明并停止,因为没有可判断的内容。
- 违规定位:对每个标记为 BROKE A RULE 的会话,用 --session <id> 再次运行,指出失败的规则以及体现该问题的时间线行。
- 页面输出:用户需要页面时,用 --html <path> 运行并给出路径。
衡量的三条可计数规则(每个会话):
- 每个被编辑的页面在结束前都通过了一次 gate;
- 没有 fast-gate 发现项遗留在文件的最新版本上;
- 智能体从未在 Stop hook 仍有页面未关闭时结束。
适用场景:在完成一轮 UI 相关智能体会话后做合规核对,或按项目、按天回顾历史会话的执行情况。
限制:它不评价设计质量;未完成的会话不计入对或错的统计。所有结论以本地 hook 事件为准,不可用于推断记录之外的行为。