# 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` 同名规则。