SuperAPI AI 工具集

implementation-workflow

编程与开发

查看项目

更新于 10-16 07:57

技能介绍

用途:用于仓库内所有编辑及其规划,包括代码、文档、配置和测试改动;也可在用户未指定任务时,帮助从任务跟踪器中选择下一个任务。需遵循本地项目说明与约定,可结合相关领域技能,也可在没有这些技能时单独使用。

模式:支持仅规划(只检查并提出方案,不改文件)、规划并实现、继续或恢复(重建当前状态后做最小安全改动)。用户要求实现时,应持续推进到验证和交付结果;仅因缺少必要答复、实际阻塞或用户要求暂停时才停顿。

任务选择:用户要求选择或规划下一个任务而未指定时,先查看仓库声明的主要工作跟踪器;若为 GitHub 仓库且无其他声明来源,则使用 GitHub Issues 及关联的 GitHub Project。按优先级、影响、就绪度、依赖和仓库现状排序,选出明确首选并继续规划;多个候选相近时列出前二或三个并询问用户。若首选是没有子任务的大型工作项,应停止选择并说明需要先规划拆解;无可访问跟踪器时查看本地路线图、TODO 或待办文档,再询问用户。

范围与规划:规划或编辑前读取本地说明、项目约定和相关领域技能,检查工作树、邻近模式、测试和证据,明确结果、约束、非目标、影响范围和验证需求。计划应覆盖结果、边界、顺序、受影响区域、验证和剩余风险;文件与模块名仅在澄清改动或避免错误时列出。已批准计划应与进度清单分开存储,可使用原生存储或系统临时目录下的 task-specific plan.md,首次编辑前及压缩后重新读取,任务完成或取消后删除。

实现:为已知任务创建分支时包含跟踪器 ID,遵循项目命名约定并保留大小写,例如 feat/gh-42-session-cache 或 fix/APP-123-token-refresh。按最小可用切片工作,复用本地模式,仅为确认的需求添加抽象。高风险边界(如 schema、共享工具、公共 API、有状态 UI、迁移、认证)之后进行验证。范围变化、风险解决或出现阻塞时通知用户。编辑重叠文件前检查当前 diff,可能覆盖用户工作时先展示冲突并询问。

并行:仅在独立工作可并发且收益超过协调成本时使用子代理,优先只读研究、风险分析、测试发现和架构比较;各子代理需有明确目标、证据、边界、编辑权限和输出要求,避免重叠编辑,由编排者整合决策并做最终验证。

验证与收尾:遵循仓库验证矩阵,否则按影响范围选择检查:文档改动进行相关 lint 或格式检查;类型或 UI 改动进行类型检查、lint、聚焦测试,流程变化时增加浏览器覆盖;共享工具、schema、数据模型、认证、持久化和公共契约需要更广泛测试;新浏览器流程先运行聚焦场景再跑全套。不要对微小改动反射性跑全套,也不要低估风险改动的验证。检查失败时判断是否由本次改动导致,修复相关失败;范围内检查失败时不得标记完成,无关或既有失败需提供证据报告。收尾前检查最终工作树和 diff,移除任务产生的调试或生成文件,保留原有改动,确认结果符合约定任务和最新澄清,并报告改动面、已运行验证、未运行检查和具体残余风险。