生成明细级技术方案
将以下提示词粘贴到你的 AI 对话框中:
请访问官方安装指南地址 https://skillhub.cn/install/skillhub.md,按照指引安装规范名 @user_e939f472/generate-tech-plan 的技能到你的 AI 助手中。
技能介绍
要解决的问题
开发前的技术方案设计,常卡在“细节不够”和“覆盖不全”之间:要么是“实现用户登录”这种空泛描述,开发时还要反复补逻辑;要么漏了边界情况、兼容性要求,导致后期返工。尤其是在需求、现有代码现状、盲区都确认后,如何把零散结论串成能直接指导开发的方案,是很多人的痛点。
它能做什么
这个技能是标准开发流程的第4步,核心是在前置条件满足时,生成一份函数级设计的Markdown技术方案。
前置条件
- 第1步“
需求确认卡”已由用户确认 - 第2步“
代码现状摘要”已由用户确认 - 第3步“
盲区”已确认解决
方案结构与设计要求
方案覆盖8个核心部分:需求概述、现有代码现状、业务规则/关键约定、技术设计(含模块划分、接口设计、关键流程)、改动清单(新建/修改文件及作用)、边界与风险、验收标准、Task拆分雏形。每个部分都有明确来源:需求概述来自需求确认卡,代码现状来自代码摘要,技术设计要求细化到函数设计思路+伪代码/核心片段,甚至接近可复制的代码骨架。比如设计用户鉴权模块时,会明确AuthService类需要包含validate_token、refresh_session等方法,每个方法的参数、返回值和核心逻辑也会描述清楚,避免后续开发时“再想一遍”。
自我把关流程
输出方案后,技能会先内部review:检查是否覆盖所有需求要点、各部分逻辑是否自洽、边界情况和异常处理是否考虑——比如评判方案有没有考虑旧版本API的兼容性、多个用户同时请求时会不会有并发问题。确认无漏洞后,才会提交给用户审阅。
适用边界与注意点
- 前置依赖强:依赖前三个步骤的用户确认,若需求或代码现状未确认,生成的方案可能偏离实际。
- 代码需结合现有风格:方案里的代码骨架需要适配项目现有代码风格,不能凭空引入不存在的API,否则开发时需要额外调整。
- Task拆分非最终版:Task拆分雏形仅为第6步铺垫,后续会进一步细化确认。
简单说,它解决的是“技术方案不够细导致开发卡壳”的问题,帮开发者在写代码前把逻辑、结构、风险都理清楚。
使用场景
- 改完需求确认后,要把需求现况转换成详细技术方案和新建文件清单
- 做功能迭代时,需要补充接口设计关键流程和边界风险技术点
- 后续要拆开发Task前,先形成细到函数级的改动方案供评审确认
- 改老模块怕出问题时,整理一份接近代码骨架的技术文档给团队对照
适合人员
- 需要参与技术方案评审确保开发不偏离需求的工程师
- 负责将确认后的需求转为详细设计的开发负责人
- 在写代码前需用技术方案指导开发的系统开发者
- 需要规范团队开发流程的小型研发团队管理者