保姆级实战：手把手写一个需求分析 Skill，复制即用，全平台稳定触发

关于作者10 年项目管理与全栈开发经验近半年专注 Agent Skills 实战落地帮助团队实现项目交付效率提升 40%。本文所有逻辑、案例与规则均基于 Trae / Cursor / OpenClaw / Hemers 全环境测试通过。系列专栏Agent Skills 开发实战・阶段 2 基础实操这是「Agent Skills 开发实战」系列的第 6 篇第 6 周定位落地实战、开箱即用、附完整可复制模板承接上一篇四层排错体系把理论直接落地成可用的业务技能。回顾系列前文第 1 篇建立认知搞懂 Agent Skills 本质第 2 篇快速上手写出 Hello World第 3 篇拆解底层吃透 [SKILL.md](SKILL.md) 标准结构第 4 篇澄清概念分清 Prompt、Rule、Skill 边界与优先级第 5 篇故障排查四层排查法解决 99% 技能失效问题。系列导航上一篇《为什么你的 Skill 总是不生效四层排查法从 完全没反应 到 稳定触发》一、学完排错直接落地今天做一个能干活的需求分析 Skill先看效果输入一句话AI直接输出规范PRD在对话中输入「帮我写一个AI智能体技能管理系统的需求分析PRD」Skill自动触发全程0人工干预最终输出一份包含项目概述、功能/非功能需求、技术规格、约束条件等6大模块的标准化需求文档见文末实战截图。这就是我们今天要手把手做的东西。上一篇我们讲透了四层排查体系但很多读者反馈道理都懂真要自己写一个业务Skill还是不知道从哪下手写出来要么触发率低要么输出乱要么一换平台就挂。新手最缺的不是理论而是一个完整、规范、可直接复制、全平台稳定运行的实战范本。本篇我们就从零开始手把手做一个「需求分析 Skill」—— 产品/研发/项目管理场景最高频复用的技能零基础也能跟着写完。全程边写边对应四层排错标准写完直接通过自检不会出现「文件放进去没反应」「AI 不主动调用」「输出格式乱飘」这些新手常见病。文末附完整资源下载复制到文件夹里就能用。二、动手前先避坑前置规范对齐四层排错写代码前先定规范这是避免后续反复排错的核心。我们直接用上一篇的四层标准做前置约束从根源上杜绝 80% 的故障。文件层规范新建独立文件夹命名requirements与内部 name 字段一致核心文件严格命名SKILL.md全大写区分大小写系统写错直接失效文件编码 UTF-8用纯文本编辑器编写禁用 Word/WPSYAML 头部顶格写前面不能有空行如图触发层规范description 开篇写触发场景不写空话套话预埋 3-5 个用户高频关键词PRD、需求文档、需求分析、需求评审明确适用边界不模糊、不越界优先级层规范Skill 内部明确输出格式与优先级声明「本技能格式优先于全局 Rule」核心流程不依赖临时 Prompt避免被用户一句话冲散环境层规范只用全平台通用字段不写平台专属语法纯文本 Skill 不依赖脚本零依赖、可跨平台迁移三、分步拆解从零搭建完整需求分析 Skill3.1 第一步写头部元数据技能身份证对应文件层元数据是 AI 识别技能的第一入口写错一个字符都可能导致技能列表不显示。✅ 标准正确写法yaml---name: requirementsversion: 1.0.0description: 当用户新建项目、变更需求、编写PRD、需求评审时使用引导完成标准化需求分析文档包含项目概述、功能/非功能需求、技术规格、约束条件完整流程。---❌ 新手常见错误name 用中文、用驼峰命名AI 识别不稳定description 只写功能不写触发场景AI 不知道什么时候调用---前面有空行YAML 解析失败整个技能加载不出来3.2 第二步定义触发条件对应触发层提升主动调用率很多人写的 Skill 只能手动 调用AI 从不主动用核心问题就是触发条件写得太笼统。触发条件要做到「场景 关键词」双覆盖。markdown## 触发条件当用户进行以下活动时应使用此技能- 开始新的项目开发需要编写需求分析文档- 现有项目需求变更需要更新需求分析文档- 进行项目规划需要明确功能和非功能需求- 与 stakeholders 沟通项目需求需要结构化的文档支持- 进行需求评审需要标准化的需求文档格式- 用户提到关键词写需求文档、起草需求分析、创建需求规格、PRD、功能规格触发层优化技巧把用户最常说的原话直接写进去而不是写你的专业概括。比如用户会说「帮我写个 PRD」不会说「进行需求规格说明书编制」前者才是有效的扳机词。3.3 第三步三段式核心工作流Skill 的灵魂对应优先级层这是 Skill 的主体部分。一个好的业务 Skill 不是把规则甩给 AI而是给它一套步骤明确、可执行、容错强的标准化流程。我们采用「上下文收集 → 优化结构化 → 读者测试」三段式工作流这也是专业产品经理做需求的标准 SOP。第一阶段上下文收集目标先搞懂项目再动笔写文档避免自嗨。markdown## 第一阶段上下文收集### 初始提问先确认 7 项基础元信息1. 项目名称是什么2. 项目的简要描述是什么3. 核心业务目标和价值是什么4. 主要受众和使用人群是谁5. 文档预期达到什么效果6. 是否有指定模板或格式要求7. 还有哪些约束条件工期、预算、技术栈### 信息倾倒引导用户全量输出相关信息项目背景、替代方案、团队情况、时间压力、技术架构、初步功能想法支持文字、链接、文档多种形式输入不用整理结构。### 澄清问题根据信息空白生成 5-10 个具体澄清问题用编号列出。用户可简答补充。### 过渡确认用户无更多信息补充后进入文档起草阶段。如图第二阶段优化与结构化目标逐章节打磨输出标准化 Markdown 文档。markdown## 第二阶段优化与结构化### 章节结构默认采用 6 大标准章节支持用户自定义调整项目概述、功能需求、非功能需求、技术规格、约束条件、输出规范### 执行规则1. 先创建 requirements.md 文件填充章节占位标题2. 从信息缺口最大的章节开始默认功能需求逐章节处理3. 每章节执行六步法澄清提问 → 头脑风暴 → 筛选内容 → 查漏补缺 → 起草内容 → 迭代优化4. 80% 章节完成后全局检查一致性、删除冗余、修正矛盾5. 全部章节完成后整体审阅询问是否进入读者测试如图第三阶段读者测试目标避免「自己写的自己看得懂别人看了一头雾水」。markdown## 第三阶段读者测试### 测试方法1. 预测读者可能提出的 5-10 个核心疑问2. 指导用户打开全新空白对话粘贴文档内容3. 向新对话提问验证答案是否准确、有无歧义、是否隐含前置知识、有无内部矛盾4. 根据测试结果返回对应章节修改优化5. 新对话能准确回答全部问题即为测试通过## 最终审阅提醒用户自行核对事实细节、技术参数、业务逻辑。确认无误后交付完整 Markdown 文档附带后续迭代维护建议。如图3.4 第四步内置标准化文档模板很多 Skill 输出忽长忽短、格式不一本质是没有内置固定模板。把文档规范写进 Skill优先级高于全局 Rule输出就会稳定可控。markdown## 需求分析文档规范### 项目概述- 项目名称XXX- 项目描述一句话说明项目用途- 项目目标明确核心业务目标与交付价值### 功能需求按模块拆分每个需求带唯一编号- **FR-001**功能描述 适用角色 操作流程- **触发条件**前置条件、触发场景、操作路径### 非功能需求按性能、安全、兼容性分类全部量化- **NFR-001**性能指标响应时间、并发量、吞吐量 测试标准- **NFR-002**安全要求加密、鉴权、权限控制 验证方式### 技术规格分别明确前后端、API 选型- 后端技术栈、框架、数据库- 前端技术栈、UI 组件库- API接口规范、认证方式### 约束条件列出工期、预算、合规、技术依赖等硬性限制说明例外处理机制。### 输出要求统一 Markdown 格式带目录、需求编号、术语附录支持导出 PDF。3.5 第五步引导技巧与异常处理真实使用中用户不会完全按你的流程走必须加容错处理。markdown## 有效引导技巧- 语气简洁直接必要时解释原因不啰嗦、不推销- 用户想跳过阶段、赶时间提供简化方案保留用户主动权- 遇到陌生术语、信息空白立刻追问不脑补、不瞎编- 质量优先于速度每次迭代要有实质改进不敷衍凑数四、完整技能资源CSDN 专属一键下载开箱即用两种获取方式按需选择方式一学习推荐直接复制上文各步骤中的代码块对照四层规范手动构建。适合想深入理解 Skill 底层结构的读者。方式二快捷部署为避免手动复制出现漏行、格式错乱、YAML报错等问题我已将完整合规的需求分析 Skill 全套文件整理打包上传至CSDN资源中心。下载后无需二次修改解压即用完美适配全平台规范。资源包包含内容完整可运行SKILL.md主文件对齐四层排错所有规范内置三段式专业工作流、容错机制、标准化 PRD 模板全平台适配配置兼容 Trae / Cursor / OpenClaw / Hemers极简部署 使用说明书小白零门槛上手✅ 部署使用方法下载资源包并解压获取完整requirements技能文件夹将文件夹放入对应平台的skills项目目录重启客户端、刷新技能列表自动加载生效直接输入自然语言指令即可自动触发技能、生成标准 PRD。资源获取文章最上面【资源下载】区一键获取全套源码文件五、写完必做四层排查法自检写完不要急着用用上一篇的四层排查法过一遍排除 99% 的隐性故障。文件层自检文件夹名requirements与 name 字段一致文件名SKILL.md大小写完全正确编码 UTF-8YAML 头顶格无空行字段无拼写错误触发层自检description 开头即触发场景预埋了 PRD、需求文档、需求分析等高频关键词手动调用能生效自然提问也能匹配优先级层自检内置了明确的文档格式规范不依赖全局 Rule核心流程完整不会被简短临时 Prompt 完全冲散边界清晰不会和其他 Skill 抢活环境层自检纯文本 Skill无脚本依赖只用通用字段无平台专属语法跨 Trae / Cursor / OpenClaw / Hemers 无需修改六、新手最容易踩的 5 个坑结合四层排错经验整理新手写需求分析 Skill 的高频翻车点只写流程不固定输出模板后果每次输出格式都不一样文档规范性差。解决把文档结构、编号规则、章节模板全部写死在 Skill 里。省略读者测试环节后果写出来的文档只有自己看得懂开发拿到全是歧义。解决把读者测试作为标准流程强制环节不能跳过。description 写得太笼统后果AI 从不主动调用只能手动 。解决开篇就写「当用户…… 时使用」直接埋关键词。YAML 头空行 / 文件名小写后果技能根本加载不出来属于第一层文件故障。解决严格按规范命名写完先去技能列表确认能看到。流程太刚性没有容错后果用户想跳过某步、想加快速度时AI 只会机械坚持流程体验很差。解决保留简化模式和跳过选项给用户主动权。七、怎么用一句话触发配置完成后直接在对话里说「帮我写一个在线教育平台的需求分析 PRD」「用需求分析 Skill 拆解一下这个电商后台项目」「帮我做一份项目需求文档要标准格式」AI 会自动匹配并激活这个 Skill按三段式流程引导你一步步输出完整、规范的需求分析文档。八、实战效果真实运行界面展示下图为需求分析 Skill 在 Trae SOLO Agent 模式下的实际运行效果完整对应前文所述的三段式工作流图注左侧对话区Skill 自动触发后进入「上下文收集」阶段按预设的 7 项基础问题引导用户补充项目信息全程无需手动引导右侧文档区用户输入信息后Skill 自动进入「优化与结构化」阶段生成标准化《AI 智能体技能管理系统SkillMaster需求分析文档》完整覆盖项目概述、功能需求等模块格式统一、编号规范可直接交付团队使用。从实际运行效果可以看到整个过程 AI 严格遵循预设流程无自由发挥输出结果稳定可控彻底解决了普通 Prompt 输出飘忽不定的问题。关于 Agent Skills 开发实战系列本文为「Agent Skills 开发实战・阶段 2 基础实操」系列第 6 篇承接上一篇四层排错体系将文件、触发、优先级、环境四层规范完整落地到真实业务场景产出可直接复制使用的需求分析 Skill 模板。系列往期文章1、《一文读懂 Agent Skills》AI 智能体技能核心认知解析2、《5 分钟上手写第一个 Hello World Skill》零基础快速建立开发信心3、《[Skill.md](Skill.md) 文件结构拆解》夯实 Agent 技能底层编写规范4、《Prompt、Rule、Skill 区别一篇讲透90% 的 Skill 不稳定都是因为分不清这三兄弟》5、《为什么你的 Skill 总是不生效四层排查法从 完全没反应 到 稳定触发》下期预告第 7 周《跨平台适配同一套 Skill 如何在 Trae 和 OpenClaw 中通用》详解这套需求分析 Skill 如何零修改兼容多平台拆解各平台目录规范、语法差异与兼容技巧真正实现一次编写、全平台复用。