mcpField
P
pipeline-reflection-ux

pipeline-reflection-ux

github.com/oimiragieoAgent 工作流4442 次安装17 周前更新
代码仓库

关于 pipeline-reflection-ux

用于精简并明确 pipeline 与 reflection 输出的 Skill，规定叙述顺序、完成报告和通知合并方式，并要求检查护栏行为不变。

主要功能

  1. 01明确展示 Step 0 叙述
  2. 02报告 reflection 完成及结果
  3. 03合并延迟 Agent 通知
  4. 04保留护栏语义
  5. 05检查测试与调试日志数量

适用场景

  1. 01在路由中展示 reflection 启动情况
  2. 02附路径报告 reflection 结果
  3. 03减少后台 Agent 延迟通知噪声
  4. 04验证 pipeline 改动不影响护栏

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/oimiragieo/agent-studio --skill pipeline-reflection-ux

安装后在 Claude Code 中输入/pipeline-reflection-ux确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

commands/
pipeline-reflection-ux.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
rules/
pipeline-reflection-ux.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

详细介绍

流水线反思 UX

使用此技能，让流水线/反思输出简洁、明确且少噪声。

工作流

  1. 在路由器叙述中展示 Step 0。
  2. 在调用 TaskList() 前输出 Step 0 完成信息。
  3. 输出一行反思结果，并附上报告路径。
  4. 将流水线后期的通知合并为一条摘要。
  5. 保持防护栏语义不变（block 仍为 block）。

必要检查

  • 在行为变更前添加/调整测试。
  • 确认路由、taskupdate 和读取安全性测试没有回归。
  • 验证重复违规/噪声的调试日志数量有所改善。

铁律

  1. 始终在调用任何 TaskList() 前输出 Step 0 叙述（待处理反思数量也计入）——省略叙述会让用户看不到反思 Agent 的启动过程，并破坏流水线审计跟踪。
  2. 绝不将反思 Agent 的启动与依赖其结果的工具调用合并——反思 Agent 必须先完成，路由器才能继续路由；混合执行会造成竞态条件。
  3. 始终在反思 Agent 完成后输出一行反思结果（报告路径 + 摘要）——否则用户无法区分反思已完成还是被跳过。
  4. 绝不为每个后期完成的后台 Agent 单独输出状态消息——逐个通知会造成噪声风暴；通过排空门后，将所有后期完成的任务合并为一条摘要。
  5. 修改流水线叙述时，始终保留现有的 block 语义——修复 UX 文案时同时更改防护栏模式，会混淆两个关注点，并掩盖任一变更的行为影响。

反模式

反模式失败原因正确做法
省略 Step 0 叙述用户看不到反思 Agent 的启动过程；流水线审计跟踪遭到破坏启动反思 Agent 前，始终输出“Step 0：N 个待处理反思……”
缺少一行反思结果用户无法区分反思已完成还是被跳过每个反思 Agent 完成后，输出报告路径 + 一行摘要
为每个后期完成的 Agent 单独输出状态消息造成噪声风暴；使流水线输出杂乱通过排空门后，将所有后期完成的任务合并为一条摘要消息
修复 UX 文案时更改防护栏模式混淆两项变更；评审时无法看清各自的行为影响在不同提交中分别进行 UX 文案变更和防护栏模式变更
在 TaskList() 后输出 Step 0 完成信息违反路由器输出约定；叙述顺序错乱调用 TaskList() 前输出“Step 0 complete.”，而不是之后

记忆协议（强制）

开始前： 阅读 .claude/context/memory/learnings.md

完成后：

  • 新模式 → .claude/context/memory/learnings.md
  • 发现问题 → .claude/context/memory/issues.md
  • 做出决策 → .claude/context/memory/decisions.md

假设工作会中断：如果没有记录在记忆中，就等于没有发生。

参考资料

  • 详细 UX 评审：references/ui-reflection-review.md
  • 故障排查手册：.claude/docs/TROUBLESHOOTING.md
  • 任务跟踪协议：.claude/docs/@TASK_TRACKING_GUIDE.md

评论

支持 Markdown