SuperAPI AI 工具集

planning

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:在开始新的编码任务时,用 Planning 技能制定完整的实施计划,帮助明确目标、定位改动范围并提前识别风险。

主要能力与流程:

  1. 理解任务:完整阅读 issue 或任务描述,确认预期结果与验收标准,记录提到的约束或要求。
  2. 探索代码库:找到仓库根目录并阅读项目结构,识别技术栈(语言、框架、测试运行器),阅读 README、CONTRIBUTING 等文档,查找现有测试以了解测试模式。
  3. 识别相关文件:用 grep 查找与任务相关的代码,阅读最相关的文件(入口点、相关模块),区分需要修改与需要新建的文件,并检查应遵循的既有模式。
  4. 编写计划:使用 write_todos 创建结构化计划,例如: write_todos([ "1. <specific change in specific file>", "2. <next specific change>", "3. Write tests for <feature>", "4. Run test suite and fix failures", "5. Review all changes" ])
  5. 评估风险:判断是否存在破坏性变更、需要处理的边界情况、是否影响代码库其他部分,并对不确定项标记待审查。

使用准则:计划应包含 3 至 10 个具体步骤;每步应具体到无需再次规划即可执行;必须把编写测试与运行测试列为显式步骤;最后以审查或验证步骤收尾。

适用场景:适用于新编码任务启动阶段,尤其是需要先摸清代码库、明确改动文件与测试策略时。

限制:资料未提供该技能的具体安装方式、依赖环境、收费信息或平台支持范围,这些内容暂未提供。