Agent Skills
返回列表
生成明细级技术方案

生成明细级技术方案

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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前,先形成细到函数级的改动方案供评审确认
  • 改老模块怕出问题时,整理一份接近代码骨架的技术文档给团队对照

适合人员

  • 需要参与技术方案评审确保开发不偏离需求的工程师
  • 负责将确认后的需求转为详细设计的开发负责人
  • 在写代码前需用技术方案指导开发的系统开发者
  • 需要规范团队开发流程的小型研发团队管理者