SuperAPI AI 工具集

swe-method

通用与其它

查看项目

更新于 10-15 17:19

技能介绍

SWE Method 是一套用于高效推进 Jira 故事的工程流程,目标是在动手实现前积累足够上下文与验证,避免基于猜测的编码。流程共六步。

第一步:定义上下文。把已知资源集中起来,包括规格说明、Jira 工单 ID、附加上下文索引、Slack 线程链接、AI 工具交互的会话 ID、会议记录、个人笔记,以及父任务、相关任务和子任务、已有分支与 PR。

第二步:把数据拉取到不可变层。将作为推理依据的原始材料单独保存,与后续解读分离,使后续步骤基于事实而非记忆。

第三步:探索代码库与系统。依据规格和附加上下文,检查工作所依赖的真实仓库、分支、PR、API、schema、CLI 及周边系统。

第四步:人机协同(HIL)细化规格。原则是任务越大越难在前期消除全部歧义,自主运行时间越长越容易偏离工程师本意。任务规模指引:极小且重复的任务常可跳过 HIL,将决策固化进 skill;小任务做轻量 HIL 规划后再自动实现;较大任务拆成更小子任务,逐个细化后再执行。借助 agent 的提问流一次提取一个决策,把澄清后的规格存入 spec 文件或 spec 文件夹。问题类型可包括依赖利益相关者或同事的需求,以及工程师可自行决定或上报的设计决策。

第五步:执行计划。规格说明“建什么”,执行计划说明“怎么建”而不臆造缺失事实。在棕地系统中,尤其涉及数据库、API、CLI 或 SDK 时,不要让 agent 假设 schema 或响应结构,应先验证。执行计划可包含让 agent 接触真实 API 响应、真实 DB schema、真实 CLI 或 SDK 行为的 HIL 步骤;只有假设被验证后,才应针对这些事实编写测试。示例执行计划:查询该类依赖的 API 或 DB,用观察到的结构定义测试用例,实现直到测试通过,再重构简化并更新文档。

第六步:实现。两种可行范式:其一,先实现一个切片,对真实系统端到端运行,排错直到行为正确,再加测试锁定;其二,先验证真实外部行为,再做基于真实响应而非想象响应的测试驱动开发(TDD)。实现与清理交替进行,使代码质量和约定持续应用,而非拖到最后。

限制方面:资料未提供该方法的费用、适用平台或具体安装命令。