w01-requirement-discovery
需求发现规范
探索性发现流程,通过多角色视角分析项目,启发用户识别高ROI功能方向。
⚠️ 核心强制要求
自动触发条件
检测到以下信号时必须触发:
- 用户询问:"有哪些功能?"、"应该做什么?"、"优先级?"、"下一步?"
- 用户表达迷茫、不确定的语气
- 用户要求"梳理任务"、"分析需求"、"探索方向"
发现流程
- 项目分析:快速理解项目定位、当前状态、技术栈
- 角色扮演:从目标用户/开发者/维护者视角分析
- 需求生成:列出高ROI必须实现的功能
- ROI评估:按影响范围 × 实现成本排序
- 启发输出:对话式呈现,不生成文档
AI Agent 行为要求
触发时执行
- 快速分析项目:理解项目定位、核心价值、当前状态
- 推荐角色:根据项目类型推荐角色(用户/开发者/维护者)
- 角色扮演:假设自己是目标角色,列出"必须实现的高ROI功能"
- ROI评估:每个功能标注影响范围、实现成本、优先级
- 对话式输出:以启发式对话呈现,不生成文档
输出格式
💡 需求发现
从 [角色] 视角分析,当前项目最应该优先实现:
1. [功能名] - ROI: ⭐⭐⭐⭐⭐
- 影响范围:[用户价值/技术价值/维护价值]
- 实现成本:[低/中/高]
- 优先级:P0/P1/P2
2. [功能名] - ROI: ⭐⭐⭐⭐
...
建议:选择功能后执行 /w02-task-planning 进行详细规划
衔接 w02-task-planning
用户确认功能后,提示:
已确认功能:[功能名],是否执行 /w02-task-planning 进行详细规划?
与 W00 协同(自动 + 手动)
- 方向确认且预计跨会话执行时,由主流程阶段完成 issue 初始化/绑定,再调用
w00-workflow-checkpoint写首个 checkpoint。 - 用户手动调用
/w00-workflow-checkpoint时,聚焦存档/读档,不负责初始化。
参考资料
references/trigger-signals.md- 触发信号详细识别规则references/role-play-method.md- 角色扮演方法与实践references/roi-evaluation.md- ROI评估框架
More from qiao-925/qiao-skills
agent-skill-rules
Agent Skills 开放标准与治理规则。用于 skill 的创建、修改、重构、迁移、审计与维护,并在创建前判断需求应落到自动化、项目级规则、通用或项目私有 skill 还是单次 prompt,提供平台无关的结构标准、frontmatter 规范、渐进式披露与质量门禁。
35python-coding-standards
Python 实现基线能力单元,帮助 Agent 在 Python 代码实现、修改、补全、重构与审查场景中,先对齐项目既有约定,再落实类型边界、日志纪律、命名与结构可读性,避免把个人偏好或项目私货写成通用规范。关键词:Python、编码规范、类型提示、日志、命名、代码结构、项目对齐。
23critical-thinking-guidance
规范 Agent 在解答前进行智能判断与思考引导,避免不必要的替代思考并保留用户主导权。适用于用户提问、方案咨询、学习交流等需要平衡效率与思考深度的场景。关键词:引导提问、智能判断、轻量引导、强制思考
21single-responsibility
单一职责能力单元,帮助 Agent 在文件拆分、函数重构、模块设计、代码审查与边界澄清场景中,识别职责混杂、变化原因耦合与命名失真问题,让文件、函数、类与模块都能围绕一个稳定职责组织。关键词:单一职责、职责拆分、边界澄清、重构、文件拆分、函数重构、模块设计。
20architecture-governance
架构治理能力单元,帮助 Agent 在架构评审、重构、新模块设计、分层边界调整、接口契约设计与项目初始化分析场景中,检查分层与依赖方向、变更影响面、接口契约与可替换性,避免跨层耦合、反向依赖与破坏性演进。关键词:架构治理、分层、依赖方向、影响面分析、接口契约、依赖注入、可插拔、重构。
19core-first-simplicity
核心优先的复杂度控制能力单元,帮助 Agent 在项目取舍、架构设计、模块重构、实现裁剪与方案收敛场景中,先识别主亮点、控制复杂度预算、稳定主路径、延后非核心扩张,避免过度设计与大而全实现。关键词:核心优先、复杂度控制、KISS、方案收敛、过度设计、主路径。
19