首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >开发会话复盘怎么落地:先分清导航、检查与判断

开发会话复盘怎么落地:先分清导航、检查与判断

原创
作者头像
阿零的 AI 实验室
发布于 2026-11-19 09:38:57
发布于 2026-11-19 09:38:57
120
举报

一次开发会话结束后,怎样把复盘建议落到合适的位置?这里借助 retro 的三个切面,整理一份从证据到最小改进的写法。

开发任务结束后,复盘建议常见的交付形式是一串“下次注意”。要把它变成能复查的改进,可以先问:缺的是找到信息的入口、能自动判定的检查,还是需要结合上下文的审查判断?

本文根据 retro 技能及 WorkBuddy 适配说明整理,只讨论导航、自动检查和判断规则三个切面。后面的报告导出场景是新编假设示例,尚未执行;没有模型试用、WorkBuddy 运行、真人结果或效率测量。分类表与记录模板由实验室整理。

先给建议找一段原始依据

准备这次获准使用的会话片段、规格、文件变化,以及实际检查记录。把“发生了什么”和“可能为什么”分开:一段找文件的记录,可以支持“本次查找绕路”,不能直接证明“整个项目结构有问题”。读不到的日志就记缺失。

再读项目现有说明、检查脚本与 CI。已有检查没有接入,或者接入后一直失败,与“没有检查”是不同的问题。先保留准确现象和配置出处,再选择改什么。一次会话只能支持其中看得见的候选,不宜推断长期发生频率。

按问题选择改动的位置

问题与所需依据

优先考虑的改动

准备怎样验证

会话确实在寻找已有资料时绕路,资料本身仍准确

在合适的入口增加简短导航,写清触发条件与目标材料;优先复用已有文档

从触发任务出发,能按指引找到实际目标文件;链接、路径和内容对应

规范可以写成固定、可重复的判定条件

先核项目已有检查;修复或接入现有检查,缺少时再提最小自动检查

用应被拒绝的样例和应被接受的样例检查判定,并核实际接入路径与输出

要结合跨文件约定、调用者需要或设计取舍才能判断

为审查补一条范围明确的判断规则,附正反例与例外条件

对照真实差异说明采用或不采用的理由,保留仍需人决定的部分

这三类可以同时出现在一个任务里,但一条建议应先说明主要问题。分类也不代替严重程度排序:影响和优先级仍需回到实际证据。

导航要告诉读者“什么情况下去看哪里”,不必把目标文档全文再抄一份。机械问题若只写进说明,每次仍要靠人记住;可重复的判定优先交给项目已有的检查体系。需要判断的规则则要留下上下文,不强行变成看似精确的语法条件。

复制一张最小改进记录

下面是复盘建议记录,不是任务验收通过表。先填一项,确认采用后再实施。

代码语言:txt
复制
会话与授权材料:[本次范围、可读取的路径或片段]
观察到的问题:[原始证据位置;观察不到就写未知]
候选解释:[推断及尚缺的依据]
分类:[导航 / 自动检查 / 判断规则;理由]
已有机制:[文档、检查或审查约定的实际出处]
最小建议:[改哪里、解决什么;尚未实施]
采用状态:[待选择 / 已授权采用 / 暂缓及原因]
验证设计:[什么现象支持改善;哪些反例或边界需检查]
实际验证:[做了什么、实际输出和证据;没做写未执行]
结果与限制:[已观察的结果、未覆盖项、保留/撤回/继续核对]

如果验证要运行命令,命令应来自真实项目配置或经确认的说明;记录工作目录、命令、退出码及输出位置。还没取得项目或环境时,这些字段写“待确认,未执行”,不补一个常用命令充数。

未执行示例:报告导出项目的三个候选

假定有一个报告导出项目;下面的现象、文件和规则都只是条件假设,没有对应真实会话或实际项目,当前状态全部是“待选择、未执行”。它们也不是读者反馈。

导航候选。 如果会话记录显示反复找不到已有的导出格式说明,并且已核实那份文档仍适用,可以建议在项目入口补一句“调整导出列时,先读现有格式说明”。验证时应确认这句入口能指向真实资料,并能据此找到对应模块;目前没有链接、路径或查找结果,均待真实项目提供。

自动检查候选。 如果项目明确禁止某个旧导出 API,而这次变化恰好用了它,先查项目的检查配置和执行记录。已有规则却未在约定流程运行,建议应针对接入缺口;确实没有规则时,才提新增确定性检查。验证设计应至少包含一个应拒绝和一个应接受的样例,并检查规则是否实际运行。当前规则实现、接入配置、命令和输出都未取得。

判断规则候选。 如果不同调用入口对“没有可导出数据”的处理存在取舍,需要结合既有交互约定判断,可建议审查时核对调用者预期,并写明采用提示、空文件或其他行为的理由。项目尚未确认预期时先保留问题,不能替它选定答案。验证材料应包括已确认的约定、相关差异和审查理由;当前均待补。

三个候选不必一起采用。选择一个有实际依据、范围清楚且能验证的改进,通常比留下多条宽泛提醒更便于后续复查;这是一种整理方法,不是已经测出的改进效果。

从建议到修改,分别留下记录

retro 的主工作流是读取指定会话的原始材料、发现环境改进候选,再按严重程度呈现。得到一条建议,不表示对应文件、检查或配置已经修改。

采用后,再核对本次授权与实际工具能力,在明确范围内实施,并保存改动和验证证据。修改全局说明、接入 CI 或读取其他日志不因复盘自动获得授权。缺访问、写入或运行能力时,交付建议和缺口即可,实际状态保留未执行。

“检查通过”也要写清通过了什么:静态规则命中不等于整条开发任务完成;一次可定位的导航结果不证明所有任务都更快;一份审查意见不等于真人使用结果。记录能支持的范围,后续才知道保留、修改还是撤回这条建议。

技能入口与来源

适用技能为开发会话复盘 retro。以下是 2026 年 11 月 19 日观察到的公开入口与 1.0.3 版本,仅说明当日可见名称和版本;公开入口可访问不等于宿主运行能力或复盘效果已验证。

开发会话复盘 retro 1.0.3

原技能作者:Matt Pocock;Copyright (c) 2026 Matt Pocock;许可证:MIT。阿零的 AI 实验室负责 WorkBuddy 适配与本文整理,内容有 AI 协助。分类模板与假设示例是实验室的教学整理,不是原作者对任务效果的承诺。

固定上游提交:5beb35b040e3de97e54fa9e386d7e42d15c295c2。复制或再分发技能包时,应保留完整原许可证及版权声明。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 先给建议找一段原始依据
  • 按问题选择改动的位置
  • 复制一张最小改进记录
  • 未执行示例:报告导出项目的三个候选
  • 从建议到修改,分别留下记录
  • 技能入口与来源
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档