Files

T

johnQ 237631147a chore(skill): 清理全部 23 条历史校验警告

- 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

2026-10-31 22:21:07 +08:00

5.1 KiB

Raw Blame History

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 影响产出物。

禁止行为

不得根据 memory 中的偏好跳过或合并 PRD 模板章节
不得用 memory 里的历史需求/项目内容填充当前 PRD
不得根据 memory 反馈调整 PRD 章节顺序、表格列数、标题层级
不得读取 ~/.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 同名规则。

5.1 KiB Raw Blame History Unescape Escape