用途:improve 是一个结构化改进审查技能,用于任务完成后、声称完成前、生成交接前,或用户询问“基于现在所知,有哪些改进”时。它基于本次会话实际观察到的情况提出具体建议,而非泛泛而谈。
主要能力:按正确性、简洁性、安全、测试覆盖、性能、开发者体验等维度分析,跳过没有具体观察可说的维度。每条建议需引用具体观察(文件:行、错误信息、测试缺口等),并区分有据建议与推测建议,推测项需明确标注。建议按对用户的影响排序,而非按描述难易。涉及公共 API 契约、认证边界或数据模式的改动须标记为高风险。
使用方式:先回顾本次会话发生了什么(改动文件、运行命令、遇到的错误、写的测试、建立的模式),再逐维度检查是否有具体发现。建议格式为 [IMP-N] 工作量/关卡: 摘要,附观察、建议、是否有据。工作量分 trivial(<5 分钟)、small(<30 分钟)、medium(数小时);关卡分 TDD、DEV、E2E、REVIEW、CI。在 ralph loop 中,应在 .rl/rl done 前运行,trivial 项直接修复,small 项若在当前里程碑范围内则处理,medium 项用 .rl/rl log decision 记录延后。生成交接时,未处理的改进放入 next_steps,沿用 [IMP-N] 格式。
适用场景:用户询问改进点、ralph loop 自检、生成交接前、完成大块工作后、审查刚写或刚改的代码。
限制:会话开始且尚无实质工作时、用户明确要求跳过审查直接发布时、架构重设计时不应使用(后者应走 spec/plan 流程)。建议不应超过 10 条,应聚焦影响最大的 5-7 条;不应超出当前工作的影响范围;不应提出无观察支撑的建议;不应为增加复杂度而增加复杂度。
分类:该技能用于代码改进审查,属于编程与开发范畴。