SuperAPI AI 工具集

synthesis-code-planning

编程与开发

查看项目

更新于 10-22 18:15

技能介绍

Code Planning 是一套用于选择并实现代码方案的结构化方法论,围绕用户目标与约束条件展开。

用途

在动手写代码之前,帮助明确真实目标、识别现有代码带来的约束,并在存在真实选择时比较可行方案,最终以证据支撑的实现方式完成任务。适用于需要规划实现路径、修复缺陷诊断或做技术取舍的编码场景。

主要能力

  • 输入收集:要求先获取任务描述、现有代码(如有)、上下文文档(API 文档、框架指南、编码规范、架构决策)。
  • 四步流程:分析(真实目标、约束、性能/可维护性/正确性要求、最佳实践、哪些目标与非目标排除了方案、何种证据能改变选择);生成方案(仅对真实存在的选择列出优劣,不为凑数量制造第二方案);评估选择(说明理由、指出放弃替代方案所牺牲的内容,接近的权衡需明确说明);实现(清晰标记对现有代码的修改、遵循代码库既有约定、处理错误与边界情况)。
  • 缺陷诊断:编辑代码前记录假设、可证伪预测和会改变方案的观察;保留被证伪的预测,仅重开受影响的验收闭环;检查实际消费程序而非仅看结果,防止打印固定答案的测试通过。
  • 决策归属:遵守共享决策所有权契约,尊重显式监督检查点;委托范围内自主决定技术选择并继续,接近的技术权衡不构成新的审批门槛,仅在实质性结果歧义或确未满足的门槛处澄清。
  • 验证义务:委托改变审批节奏而非验证义务,需运行消费方检查与必要审计,变更后使受影响的证据失效。
  • 实现原则:框架优先(用内建特性而非自造方案)、约定优于配置、根因优于症状、更少代码更好。

使用方式

按 Step 1 分析、Step 2 生成方案、Step 3 评估选择、Step 4 实现推进;对于琐碎变更或已被约束确定的选项,跳过方案比较直接实现,并记录该决定性选择及其来源。文档结构引用了 references/coverage-map.md 说明文本各部分位置。

适用场景

需要规划代码实现路径、在多个技术方案间取舍、诊断并修复缺陷、以及在委托工作范围内自主推进编码任务的场景。

限制

该方法论未提供具体语言或框架的实现代码;技能、偏好或凭据不能创建新权限;未提供收费、平台支持范围等商业信息。