mcpField
R
run-retro

run-retro

github.com/frostneyAgent 工作流062 次安装4 天前更新
代码仓库

关于 run-retro

run-retro 是用于复盘已完成工作流的 Agent 技能,从交付速度、流程和代码库健康度评估工作。它基于证据提出改进选项,决策及获准的变更交由 grilling 技能和相应工作流处理。

主要功能

  1. 01评估交付、流程与代码健康度
  2. 02依据现有证据划定工作范围
  3. 03追溯决策、实现与文档
  4. 04分析耗时和关键路径贡献
  5. 05将发现归类为编辑、工单或报告

适用场景

  1. 01复盘已完成的项目工作流
  2. 02找出有证据支持的流程改进
  3. 03区分文档偏差与实现偏差

安装

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

$npx skills add https://github.com/frostney/known-good-route --skill run-retro

安装后在 Claude Code 中输入/run-retro确认已加载。

附带文件references/timing-analysis.md

详细介绍

运行回顾

从交付速度、流程和代码库健康度三个角度评估已完成的工作流,并与用户商定有证据支持的改进措施。 实际的 grilling 技能负责决策流程。请在对话中呈现回顾。

授权

运行回顾的请求仅授权分析。文件编辑和其他变更必须经过用户通过 grilling 作出的最终选择;该选择仅授权所选的文档编辑、通过 create-issue 执行所选的工单操作,以及通过其常规 /deliver 工作流调用任何明确选中的即时实施,绝不授权此技能直接实施。该请求不授权无关的提交、推送、PR、工单或文件编辑。最初的运行回顾请求不等同于最终选择。

关卡

  • 根据当前对话、交接记录、差异、提交、工单、PR、评审、检查、结果和返工,界定工作流范围。记录无法获取的证据并降低置信度;不要编造叙述,也不要扩大范围进行仓库审计。
  • 在提出流程或设计修正之前,追溯其起源决策、当前实现或可执行配置,以及当前文档。区分设计缺失、实现偏离和文档偏离。除非当前证据相互矛盾并要求重新决策,否则应保留已确定的选择;不要仅仅因为实现或文字描述出现偏离就再次审议。
  • 检查完整的协调者和子 Agent 记录,包括流程事件和交接。找出重复推理、重建或丢弃的证据、已加载但未使用或被绕过的技能、手动恢复、能力路由错误,以及其他无价值的上下文消耗。将这些无价值上下文单独报告,并指出有哪些对话或流程证据无法获取。
  • 构建时间记录前,请阅读 references/timing-analysis.md。对于已完成的 Milestone Rush,还要根据该参考文档读取被忽略的 .agent/milestone-rush-events.jsonl。将遥测数据与当前仓库、工单、拉取请求和 CI 证据进行核对;遥测不完整或缺失会限制置信度,不能据此推断数值。
  • 使用证据和候选项调用 grilling。不要用临时提问模仿它;如果无法使用,就停止。让它每次只提出一个决策问题并给出建议。只有在达成共识并确认确切的操作范围后,才能采取行动。
  • 即使某个角度没有可长期记录的发现,也要评估以下三个角度:
    • **交付速度:**减少等待、返工、交接摩擦、不必要的范围或认知负担,同时不降低质量。
    • **流程:**规划、决策、交接、关卡、工具和协作。
    • **代码库:**架构、可维护性、测试、开发者体验、可靠性和累积摩擦。
  • 仅提炼有证据支持、适用于项目层面的经验。排除时间线、一次性失误、个人偏好、重复内容、现有规则和推测。
  • 对工作流进行去重:复用先前的调查和决策,合并多个证据系统记录的同一事件,并合并原因和行动相同的候选经验,同时保留其出处。报告导致工作流摩擦的重复实现或可发现性证据,但不要把回顾变成仓库范围的重复或可发现性审计;这属于 codebase-audit 的职责。

为每条经验选择处理路径

  • **修改文档:**在现有契约、README、docs/、ADR、AGENTS、技能、模板、政策或贡献者指南中添加持久有效的指导。优先完善或与现有文本结合。直接修改仅限文档。
  • **后续工单:**需要修改源代码、可执行配置或其他实现。可提供更多细节、进一步追问、使用 create-issue(如果用户想先看草稿,则先提供草稿),或跳过;委派工作流保留各自的关卡。
  • **下一个周期前实施:**如果选定的改进应在下一个周期开始前交付,建议选择此路径。仅提出建议不代表获得授权。用户明确选择后,通过 create-issue 复用或创建用于跟踪的工单,进入常规 /deliver 工作流,并在行动交付或确实受阻之前保持此次复盘处于进行状态。委派工作流保留所有关卡。
  • **仅报告:**有用的证据既不值得修改,也不需要创建工单。

仅当指导内容与其实现分别不可或缺时,才同时修改文档和创建工单。只有在用户选定其确切拟定内容后,才能新建缺失的文档。

工作流

  1. 确定工作流边界,并阅读相关项目文档。
  2. 在上述门槛下追溯来源以及协调者/子 Agent 记录。 然后建立证据清单,记录结果、阻碍、返工、意外情况、有效或遗漏的门槛、成功实践,以及在全部三个视角下单独归类的无价值上下文。根据时间参考选择一个或多个计时配置,并映射高层生命周期阶段和可用的底层操作。
  3. 重建各项工作的独占关键路径贡献、重叠或被掩盖的工作,以及不重复计算的资源消耗。按独占墙钟时间影响对瓶颈排序;报告置信度和缺失的归因信息。
  4. 移除缺乏依据、仅适用于当前会话、重复以及已有覆盖的候选项;使用上述路径对其余候选项分类。
  5. 在对话中总结关键交付变更和重要结果,以有证据支持的变更前后状态、不确定性和来源链接为依据。若图示或对比表有助于说明机制或决策,则使用图示或对比表。
  6. 使用边界、证据、当前文档、缺失信息和候选项,通过 grilling 一次讨论一个决策。选择行动前,先询问用户是否希望深入探讨任何发现;将新证据纳入比较。
  7. 提供详细总结:
    • 每个视角下的发现,包括无发现的结果;
    • 生命周期和选定的表层配置、独占关键路径排序、被掩盖或重叠的工作、底层构建/测试/工具计时、资源总量、证据来源及置信度缺口;
    • 关键结果、变更前后状态,以及可供深入探讨的内容;
    • 按文件列出的精确文档新增、替换或移除内容;
    • 简明的工单摘要及所有可用的处理路径;
    • 仅供报告的观察、支持证据、置信度及缺口。
  8. 通过 grilling 获取用户的明确选择。需要更多细节或进一步讨论时,返回该循环并重新生成总结。
  9. 仅执行上述授权范围内用户选定的行动,保留文档结构并避免重复。对于每项选定的“下一周期前实施”行动,复用或创建可见性 issue,调用常规 /deliver,并在回顾流程中持续跟进,直到行动交付或确实受阻。
  10. 将结果与已确认的行动集进行比较,并运行已声明的文档检查。
  11. 报告已更改的文档、创建的 issue 链接、即时行动的交付或受阻证据、仅供报告的发现、置信度限制及观察到的验证结果。在聊天中保留工作流历史,并提醒用户可以要求深入探讨任何发现。

评论

支持 Markdown