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