SuperAPI AI 工具集

plan

编程与开发

查看项目

更新于 10-16 03:38

技能介绍

plan 是 han-core 提供的技术规划技能,入口命令为 /plan [arguments],用于为某个功能或任务制定战术层面的实施计划。它关注"如何构建功能 X",包含具体实施步骤、任务拆解和执行顺序;与之相对,架构设计技能关注"系统应如何组织"这类战略性结构决策。资料建议在实现具体功能、把工作拆解为任务、排列实施步骤、估算复杂度时使用本技能,而设计新系统、重大重构、技术选型和长期策略则使用架构设计。

规划流程:一是理解需求,明确要构建什么、解决什么问题、验收标准以及范围边界,并追问使用者、预期行为、边界情况、性能与安全要求;二是分析现状,了解已有代码、在用的模式、可复用与需改动的部分,可用 grep -r "similar_pattern" .、find . -name "related"、grep -r "test.*similar" test/ 等方式调研;三是拆解任务,任务应具体、可测试、规模适中(数小时到数天)、尽量独立并在有依赖时有序,任务模板包含 What、Why、Dependencies、Complexity(S/M/L)、Success criteria、Files affected、Testing approach;四是识别依赖,区分 Blocks、Blocked by、Related,并判断哪些可并行、哪些必须顺序执行;五是估算复杂度,用 S/M/L 相对规模而非时间,超过 L 应继续拆分;六是定义测试策略,涵盖单元、集成、E2E 和手动测试。

计划文档结构依次为:标题与估算复杂度、状态(Draft/Approved/In Progress/Complete)、目标、当前状态、拟采用方案(含技术决策与备选方案)、按阶段组织的任务、测试策略、风险与考虑事项表、明确的范围外内容、待解决问题、成功指标和参考资料。资料还给出按层次、按功能垂直切片、按优先级(P0/P1/P2)等拆解策略,以及规划原则和常见错误:过于笼统、过于琐碎、遗漏依赖、缺少成功标准。

资料指出计划是随实施演进的活文档,应在发现新需求、找到可复用代码、识别额外复杂度或改变方案时更新,并给出完成前的检查清单。本技能可与 simplicity-principles、architecture-design、test-driven-development 等技能配合,引用 solid-principles、structural-design-principles 作为实现指导。资料未提供该技能的收费、价格、平台支持等具体信息。