johnQ
237631147a
- 11 个超 20KB 的 SKILL.md 拆分，大章节移入 references/details.md - 7 处非标准字段（arguments/user_invocable）移入 metadata - 修 req-dev 4 条相对链接；validate 跳过行内代码避免  误报 - validate-skills.py: 23 warns -> 0 warns，0 errors
174 lines
5.1 KiB
Markdown
174 lines
5.1 KiB
Markdown
# skills 详细内容
|
||
|
||
## 功能设计流程
|
||
|
||
### 1. 需求收集
|
||
|
||
```
|
||
输入：
|
||
- 用户反馈
|
||
- 业务需求
|
||
- 数据分析
|
||
- 竞品分析
|
||
|
||
输出：
|
||
- 需求池（ai-proj 需求列表）
|
||
```
|
||
|
||
若命中“模块设计访谈模式”，本阶段改为执行访谈协议并持续写入 ai-proj 讨论文档；访谈未确认前不进入 PRD 定稿。
|
||
|
||
### 2. 需求分析
|
||
|
||
```
|
||
方法：
|
||
- 5W1H 分析法
|
||
- 用户访谈
|
||
- 数据验证
|
||
|
||
输出：
|
||
- 需求文档
|
||
- 优先级排序
|
||
```
|
||
|
||
### 3. 方案设计
|
||
|
||
```
|
||
内容：
|
||
- 功能架构
|
||
- 交互流程
|
||
- 界面原型
|
||
- 技术方案
|
||
|
||
输出：
|
||
- PRD 文档
|
||
- 可生成原型的界面状态与交互规格
|
||
```
|
||
|
||
### 4. 缺陷收敛
|
||
|
||
```
|
||
输入：
|
||
- 已确认讨论结论
|
||
- 最新版完整 PRD
|
||
|
||
执行：
|
||
- defect-analysis 全维度审计
|
||
- 接受项修订 PRD
|
||
- 对修订后的完整 PRD 重新审计，直至一轮 0 个新缺陷
|
||
|
||
输出：
|
||
- 已收敛 PRD
|
||
- 缺陷处置记录
|
||
```
|
||
|
||
### 5. HTML 原型与反馈闭环
|
||
|
||
```
|
||
适用：
|
||
- 所有包含界面、用户操作或可视状态的模块
|
||
|
||
执行：
|
||
- 调用 req-prototype 的 upload 模式生成独立 HTML
|
||
- 上传并关联 Requirement
|
||
- iframe 回填 PRD，验证访问和关键交互
|
||
- 请用户评审；行为性反馈回到问答 → PRD → defect-analysis → 新原型版本
|
||
|
||
输出：
|
||
- 已验证、已关联的 HTML 原型
|
||
- PRD 与讨论文档中的版本/反馈/确认记录
|
||
```
|
||
|
||
### 6. 评审验证
|
||
|
||
```
|
||
评审维度：
|
||
- 业务价值
|
||
- 技术可行性
|
||
- 资源评估
|
||
- 风险评估
|
||
|
||
输出：
|
||
- 评审结论
|
||
- 修改意见
|
||
```
|
||
|
||
模块设计访谈模式下，本阶段必须调用 `defect-analysis`，并按访谈协议将每轮发现、处置、PRD 修订和收敛结论回写到同一讨论文档。
|
||
|
||
UI 模块还必须核对最终 HTML 原型与最新版 PRD 一致，并取得用户对二者的联合确认；无 UI 模块则核对已记录的不适用理由和用户确认。
|
||
|
||
---
|
||
|
||
## 设计检查清单
|
||
|
||
### PRD 完整性检查
|
||
|
||
- [ ] 模块/系统设计已完成单轮单问访谈，且全过程已写入 ai-proj 讨论文档
|
||
- [ ] 讨论记录与 PRD 均已保存到仓库本地 Markdown 和对应 ai-proj Task Document
|
||
- [ ] 两端复读正文一致，交付说明包含本地路径、task/document 标识和远程版本
|
||
- [ ] 讨论结论已由用户明确确认
|
||
- [ ] `defect-analysis` 已基于最新版 PRD 收敛到一轮 0 个新缺陷
|
||
- [ ] 无未处置的致命/高严重度缺陷
|
||
- [ ] UI 模块 HTML 原型已生成、上传并关联 Requirement；无 UI 模块已记录不适用理由和用户确认
|
||
- [ ] 原型基线指向最新版 PRD，PRD `4.2` 已回填 iframe、版本说明和验证结果
|
||
- [ ] 原型反馈导致的行为变更已回到问答、PRD 和 defect 全量重审，并生成新原型版本
|
||
- [ ] 用户已联合确认最终 PRD 与 HTML 原型
|
||
- [ ] 背景与目标明确
|
||
- [ ] 用户群体定义清晰
|
||
- [ ] 功能需求完整
|
||
- [ ] 验收标准可测试（每条 AC 附带 VP-Data / VP-Steps / VP-Pass）
|
||
- [ ] 异常情况已考虑
|
||
- [ ] 性能要求已定义
|
||
- [ ] 上线计划合理
|
||
- [ ] 风险已评估
|
||
|
||
### 交互设计检查
|
||
|
||
- [ ] 用户流程完整
|
||
- [ ] HTML 原型覆盖核心入口、主流程及 PRD 指定的关键状态
|
||
- [ ] 原型 URL 可访问，Requirement 关联可读取，iframe 可展示，核心交互可操作
|
||
- [ ] 边界情况处理
|
||
- [ ] 错误提示友好
|
||
- [ ] 反馈及时
|
||
- [ ] 操作可撤销
|
||
- [ ] 符合用户习惯
|
||
|
||
### 非功能需求检查
|
||
|
||
- [ ] 性能要求已量化（响应时间、并发量）
|
||
- [ ] 安全需求已明确（权限、数据保护）
|
||
- [ ] 兼容性要求已定义（浏览器、设备）
|
||
- [ ] 可用性目标已设定
|
||
|
||
> **技术方案可行性检查**在 design 阶段由 `req-design` 技能完成。
|
||
|
||
---
|
||
|
||
## Memory 隔离规则（强制，源自 devflow-claude 借鉴）
|
||
|
||
**规则：本 skill 涉及模板/文档产出的命令禁止受 auto-memory 影响产出物。**
|
||
|
||
### 禁止行为
|
||
1. 不得根据 memory 中的偏好跳过或合并 PRD 模板章节
|
||
2. 不得用 memory 里的历史需求/项目内容填充当前 PRD
|
||
3. 不得根据 memory 反馈调整 PRD 章节顺序、表格列数、标题层级
|
||
4. 不得读取 `~/.claude/projects/*/memory/` 辅助生成 PRD 正文
|
||
|
||
### 允许行为
|
||
- memory 可影响**交互风格**（提问详略、确认节奏、语气）
|
||
- memory 可指导**命令选择**（如根据用户习惯推荐先走 req-compare 还是 req-prd）
|
||
- memory 可影响**非产出文本**（如对话中的说明）
|
||
|
||
### Why
|
||
auto-memory 设计用于跨会话建立用户画像。但 PRD/需求文档是正式产出物，必须由**模板结构 + 当前输入**决定，不能因 memory 中的偏好自作主张调整结构，否则会导致：
|
||
- 模板章节漂移（用户不知道为什么这次少了一章）
|
||
- 历史项目内容污染（张冠李戴）
|
||
- 产出不可复现
|
||
|
||
### How to apply
|
||
执行 `/req prd` / PRD 编写 / 需求描述生成等命令时：
|
||
- 仅读取：模板文件、用户当前输入、引用的已有需求文档
|
||
- 不读取：memory 目录下的任何文件
|
||
- 产出前自检：章节数量和顺序与模板完全一致
|
||
|
||
**参考**：devflow-claude 的 `plugins/req/commands/_common.md` 同名规则。
|