SuperAPI AI 工具集

plan-work

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:在动手编码前先完成规划,让计划建立在仓库真实情况之上,明确决策与风险,并在没有未知项后再给出实施步骤。

主要能力与流程:

  1. 调研现状:先阅读仓库指引(AGENTS.md、README.md、docs/),识别入口与负责人(后端/前端/基础设施),用 rg 查找符号、端点、配置键、错误字符串,必要时用 git log -p / git blame 了解历史与意图;若依赖外部行为,查阅官方文档、发布说明或 context7,并说明版本与假设。
  2. 分析:复述需求与假设,列出 1-3 个方案及取舍并选定其一,识别风险与边界情况以及覆盖它们的测试,收集待解决问题。
  3. 问答关卡:存在未决问题时先提问并停止,用户回答或明确接受假设前不提出实施步骤。首轮提 1-5 个能消除整块工作的问题,之后继续追问直至澄清。问题应编号、简短、尽量多选,给出默认/建议与快速回复方式(如回复 defaults),选项列表中不标注默认项,可提供“不确定”选项,区分“必须知道”与“最好知道”,支持紧凑回复(如 1b 2a 3c)并复述选择。
  4. 实施计划:仅在问答后给出,拆成有序小步骤,指明可能改动的文件/目录,列出要运行的测试(单元/集成/构建),跨模块时加入协调步骤(契约变更、客户端重新生成、版本管理)。

输入:若缺失需询问结果/验收标准、约束(时间、向后兼容、性能、安全、数据迁移)、目标环境(本地/预发/生产)及特性开关或发布要求、非目标。

限制:问答前不运行命令、不编辑文件、不产出依赖未知项的计划;只允许不承诺方向的低风险只读探索。交付物使用 references/plan-template.md 填写。