关于 observe
observe 是一项用于检查 UI Agent 会话是否遵守页面编辑规则的技能,通过脚本读取 hooks 记录并报告结果。它评估规则执行情况,不评价设计质量;未完成的会话不计入正反结果。
主要功能
- 01读取 hooks 记录的会话
- 02汇总页面编辑规则检查结果
- 03定位违规会话及对应时间线
- 04按需生成 HTML 页面
适用场景
- 01检查近期 UI 编辑会话的规则遵循情况
- 02追踪特定会话中的违规记录
- 03为会话审查生成 HTML 页面
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ plugin87/ ux-ui-agent-skills --skill observe安装后在 Claude Code 中输入/observe确认已加载。
详细介绍
步骤 0 - 工具包在这里吗? 检查一次:
ls ${CLAUDE_SKILL_DIR}/../../../scripts/observe.mjs >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING仅当出现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>运行,并提供路径。
它衡量的内容及不衡量的内容:每个会话有三条计数规则——
每个经过编辑的页面都必须在结束前通过检查;快速检查发现的问题不能留在文件的最新版本中;并且 Agent 结束时,Stop 钩子不能仍有页面处于打开状态。它不评价设计质量,而标记为 unfinished 的会话既不计入正面结果,也不计入负面结果。
评论
支持 Markdown