SuperAPI AI 工具集

technical-planning

编程与开发

查看项目

更新于 10-16 04:24

技能介绍

用途

Technical Planning 技能用于为功能或任务创建可执行的实施计划。其核心原则是:好的计划能把模糊目标转化为具体、可执行的步骤。

该技能明确区分技术规划与架构设计:

  • 技术规划(本技能):战术层面,回答“如何构建功能 X”,包含具体实施步骤,时间跨度为数天到数周,把工作拆解为任务,聚焦执行。
  • 架构设计(architecture-design 技能):战略层面,回答“系统应如何组织”,包含高层设计决策,影响周期为数周到数月,定义组件与模式,聚焦结构。

适合使用规划的场景:实现具体功能、把工作拆解为任务、排列实施步骤顺序、估算复杂度。适合使用架构的场景:设计新系统、重大重构、技术选型、长期策略。

主要能力

该技能提供一套完整的规划流程:

  1. 理解需求:明确要构建什么、解决什么问题、验收标准、范围边界,并追问使用者、预期行为、边界情况、性能与安全要求。
  2. 分析现状:了解已有代码、在用模式、可复用内容、需要变更的部分,并给出查找相似实现、相关文件、现有测试的示例命令。
  3. 拆解任务:好任务应具体、可测试、大小合适(数小时到数天)、尽可能独立、在存在依赖时有序。提供任务模板,包含 What、Why、Dependencies、Complexity、Success criteria、Files affected、Testing approach。
  4. 识别依赖:区分 Blocks、Blocked by、Related,并说明并行与串行的判断。
  5. 估算复杂度:使用相对规模 S(1-4 小时)、M(4-8 小时)、L(1-2 天),超过 L 需继续拆分,并列出复杂度影响因素与示例。
  6. 定义测试策略:包括单元测试、集成测试、E2E 测试、手动测试步骤。

此外还提供计划文档结构模板,包含 Goal、Current State、Proposed Approach、Tasks(按阶段组织)、Testing Strategy、Risks & Considerations、Out of Scope、Open Questions、Success Metrics、References。

使用方式

该技能以技能文档形式提供,用户可依据其中的流程、模板和检查清单来编写实施计划。文档给出任务拆解策略:按层(前端、后端、基础设施)、按功能切片(垂直切片)、按优先级(P0/P1/P2)。还给出规划最佳实践:从简开始、让任务可执行、记录决策、包含示例。

文档包含常见规划错误示例:过于模糊、过于细节、遗漏依赖、缺少成功标准。并说明与其他技能的集成:simplicity-principles、architecture-design、test-driven-development、solid-principles、structural-design-principles。

文档还介绍自适应规划:计划是活文档,应随学习更新,记录变更,并给出更新示例。最后提供规划检查清单,涵盖目标、现状、方法、任务、依赖、复杂度、成功标准、测试策略、风险、范围外事项、评审批准。

适用场景

适用于为具体功能或任务制定实施计划、把工作拆解为可执行任务、排列实施顺序、估算复杂度、定义测试策略。不适用于设计新系统、重大重构、技术选型、长期策略等架构层面工作。

限制

资料未提供该技能的安装命令、收费方式、支持平台或具体运行环境等信息,暂未提供。