# skill-creator-design

Adopt this skill: https://proskills.md/skills/other/balancegsr-skill-creators-design

Page: https://proskills.md/skills/other/balancegsr-skill-creators-design
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: design/SKILL.md
size: 14245
sha: 0e985b28a784302ff36016e3f1a21fa98c4ac741
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/SKILL.md

````text
---
name: skill-creator-design
description: >
  生成定制化的设计项目 Skill（含 SKILL.md + references/），为用户的设计过程提供从需求定义到
  交付的持续引导。触发场景：用户表达想做设计相关工作（"我想设计 X""做个 X 的方案"
  "帮我设计一个 X""出个设计""改版 X""重新做一下 X""想想 X 怎么做""design X"
  "redesign X"），或要求生成设计规划、设计 skill（"创建设计项目""generate a design skill"
  "帮我规划一下这个设计"）。涵盖产品设计、交互设计、体验设计、信息架构、视觉方案等。
  安装本 skill 即表明用户倾向于系统化设计管理——遇到设计意图时优先触发，而非直接进入
  即时头脑风暴。
tools: [write, bash]
---

# Skill Creator: Design

根据用户的设计需求，生成一个定制化的设计项目 Skill。生成物是一个独立的 SKILL.md（+ references/），
安装后能在用户的设计项目中持续引导从需求定义到交付的全过程。

本 Creator 执行一次性的信息收集→生成→交付流程，不是一个持续运行的助手。

---

## Phase 1: 信息收集（Intake）

目标：用 2-3 轮自然对话收集生成所需的关键信息。像一个有经验的设计顾问在了解需求，不像在填表。

### 第一轮：主题 + 目标

被触发后，先用一句话说明自己做什么，然后问最核心的两个变量：

> "我可以帮你生成一个设计项目 skill——它会在你的设计过程中引导需求定义、调研、方案设计、评审和交付。
> 先告诉我：你想设计什么？最终希望达到什么效果？"

这两个信息通常是用户触发 Creator 时脑子里最清晰的，开口门槛最低。

### 第二轮：范围/背景 + 约束条件 + 条件追问

先对用户第一轮回答做简短回应（表示理解，让对话有来有回），然后补收：

> "[对用户设计目标的简短回应]。再告诉我两件事：这个设计的范围是什么——是从零做一个新产品，还是在现有产品上做功能迭代？有什么约束条件需要提前考虑的——比如技术限制、预算、时间、特定平台等？"

条件追问（仅在信息不充分时触发）：

| 情况 | 追问方式 |
|---|---|
| 目标不可衡量（如"做一个好的设计"） | "设计完成后，怎么判断它是成功的？有没有具体的指标或标准？" |
| 范围不清（不知道是新产品还是功能级） | "这是一个全新的产品，还是已有产品的功能/迭代？" |
| 约束条件完全空白 | "有什么限制需要提前考虑的吗？比如技术、预算、时间？没有的话我先假设没有硬性约束。" |
| 第一轮已自发带出了范围或约束 | 只补缺失的，不重复问 |
| 所有必答信息已充分 | 直接进入汇总确认 |

**可选变量**——不主动问，从对话中捕获：
- 目标受众/用户画像（如用户说"这个主要是给运营团队用的"）→ 覆盖默认的从主题推断
- 交付物偏好（如用户说"最后我需要一份 PRD"）→ 覆盖默认的领域推荐
- 如用户未提及，使用默认值即可

### 第三轮：汇总确认

结构化展示收集到的信息 + 模式推荐：

```
我理解到的信息：
- 设计主题：[主题]
- 设计目标：[目标，确保是可衡量表述]
- 设计范围：[0→1 新产品 / 功能级 / 迭代级]
- 约束条件：[约束描述，或"暂无硬性约束"]
- 推荐模式：[轻量/完整]
  └ 轻量模式默认快速推进，遇到高影响决策自动加深；完整模式默认深入系统，明确简单的环节自动精简。

有需要修正的吗？确认后我开始生成 skill 预览。
```

模式推荐规则：
- 单功能设计 / 小型迭代 → 推荐轻量模式（范围小，深度调研和系统评审的 ROI 低）
- 新产品 0→1 / 大型功能 → 推荐完整模式（范围大，需要充分的调研、系统评审和完整决策记录）
- 不确定 → 推荐完整模式（宁多勿少，用户可以跳步）
- 用户可覆盖推荐，尊重选择

**信息充分性门槛**——进入汇总确认前检查：
- ✅ 主题明确（能用来做文件命名和领域判断）
- ✅ 目标有方向（能回答"设计完成后想达到什么效果"）
- ✅ 范围有定位（新产品 / 功能 / 迭代，量级层面）
- ✅ 约束已知或确认无约束

不满足时的兜底：用合理假设填充，在汇总中**显式标注**哪些是假设让用户确认。例如：
> "你没提到约束条件，我先假设没有硬性的技术或预算限制。如果有，告诉我我会调整设计引导的侧重。"

---

## Phase 2: 生成与预览（Generate & Preview）

用户确认汇总后，进入生成流程。

### 变量准备

从收集到的信息中提取生成所需的变量：

| 变量 | 来源 | 处理方式 |
|---|---|---|
| `topic` | 用户提供的设计主题 | 直接使用 |
| `topic_slug` | 从 topic 派生 | 转为适合文件命名和 name 字段的格式（小写、下划线、无空格，如 "user_onboarding"） |
| `goal` | 用户提供的设计目标 | 确保是可衡量表述 |
| `scope` | 用户提供的设计范围/背景 | 直接使用 |
| `constraints` | 用户提供的约束条件 | 直接使用，或"暂无硬性约束" |
| `mode` | 用户确认的模式 | "轻量" 或 "完整" |
| `target_audience_override` | 可选，用户提到的目标受众 | 如未提供，留空（清除占位符） |
| `deliverable_override` | 可选，用户提到的交付物偏好 | 如未提供，留空（清除占位符） |
| `lang` | 用户对话使用的语言 | 生成物使用相同语言 |
| `project_dir` | 从 topic_slug 派生 | `design_` + topic_slug + `/`（如 `design_user_onboarding/`），项目文件的存放目录 |
| `generated_by` | Creator 版本标识 | 固定值 `skill_creator_design v1.2.0` |

### 生成逻辑

1. 根据 `mode` 选择对应的骨架模板：
   - 轻量模式 → 读取 `references/templates/skill/lite.md`
   - 完整模式 → 读取 `references/templates/skill/full.md`

2. 用收集到的变量替换模板中的占位符（`{{topic}}`、`{{goal}}` 等）

3. 处理可选变量的条件注入：
   - `target_audience_override`：如用户提供了受众信息，在模板的 `{{target_audience_override}}` 位置插入一行，如 `- 目标受众：运营团队（非技术背景）`
   - `deliverable_override`：如用户提供了交付物偏好，在模板的 `{{deliverable_override}}` 位置插入说明，如"\n- 注意：本项目用户指定交付物为技术方案文档，输出格式以此为准"
   - 如未提供，清除占位符（不留空行）

4. 准备 references/ 文件：
   - 两种模式都需要：读取 `references/templates/guides/review_checklist.md` → 生成 `review_checklist.md`
   - 两种模式都需要：根据模式选择对应的总结指南模板
     - 轻量模式 → 读取 `references/templates/guides/summary_guide_lite.md` → 生成 `summary_guide.md`
     - 完整模式 → 读取 `references/templates/guides/summary_guide_full.md` → 生成 `summary_guide.md`

5. 如果对话语言不是中文，将生成物全文翻译为用户使用的语言，保持结构和格式不变

### 预览展示

将生成的 SKILL.md 完整内容展示给用户，然后列出 references/ 文件清单：

> "此外还会生成以下配套文件：
> - references/review_checklist.md — 评审执行清单（三视角 + 质疑角度）
> - references/summary_guide.md — 设计总结生成指南（[轻量版/完整版]）
>
> 你可以提出修改意见，或者确认后我直接生成。"

### 修改处理

| 修改类型 | 判断标准 | 处理方式 |
|---|---|---|
| 结构性修改 | 影响流程结构或文件管理逻辑（如"不需要调研步骤""加个用户测试环节"） | 调整骨架，重新生成受影响部分，再次完整展示 |
| 内容微调 | 不影响结构（如"目标描述改一下""加一条约束"） | 定点修改，展示差异点（"已更新 XX，其他不变。确认？"） |

迭代引导：
- 首次："你可以提出修改意见，或者确认后我直接生成。"
- 后续："已调整。还有需要改的吗？没有的话我开始生成。"
- 不设轮数上限，用户想改就改

### 占位符对照表

生成时逐项检查，确保每个占位符都已处理：

| 占位符 | 来源 | 处理方式 |
|---|---|---|
| `{{topic}}` | 用户输入的设计主题 | 直接替换 |
| `{{topic_slug}}` | 从 topic 派生（小写、下划线、无空格） | 直接替换 |
| `{{goal}}` | 用户输入的设计目标（可衡量表述） | 直接替换 |
| `{{scope}}` | 用户输入的设计范围/背景 | 直接替换 |
| `{{constraints}}` | 用户输入的约束条件 | 直接替换 |
| `{{target_audience_override}}` | 可选，用户提到的目标受众 | 有值→插入说明文本；无值→清除占位符（不留空行） |
| `{{deliverable_override}}` | 可选，用户提到的交付物偏好 | 有值→插入说明文本；无值→清除占位符（不留空行） |
| `{{project_dir}}` | 从 topic_slug 派生 | `design_` + topic_slug + `/`（如 `design_saas_dashboard/`），直接替换 |
| `{{generated_by}}` | Creator 版本标识 | 固定值 `skill_creator_design v1.2.0`，直接替换 |

> **⚠️ 用户确认生成后，必须进入 Phase 3 执行交付流程。不要直接写文件——Phase 3 包含安装路径探测、交付方式询问等必要步骤。**

---

## Phase 3: 交付（Deliver）

用户确认预览后，询问交付方式：

> "你希望我怎么交付？
> 1. **直接安装到当前工作空间** — skill 和项目文件夹都创建在当前工作空间内，立即可用
> 2. **打包为 ZIP** — 生成 zip 文件，你可以自行解压到任意位置或分享给别人"

### 安装路径探测

无论哪种交付方式，都需要先确定 skill 的安装目录前缀。按以下优先级探测：

1. **检查当前 workspace 下的已有 skill 路径**：扫描项目根目录中是否存在 `.claude/skills/`、`.agents/skills/`、`.agent/skills/`、`_agents/skills/`、`_agent/skills/`、`.workbuddy/skills/`、`skills/` 等目录。找到任意一个则沿用该前缀
2. **检查用户根目录（`~/`）下的全局 skill 路径**：扫描是否存在 `~/.claude/skills/`、`~/.openclaw/skills/`、`~/.agents/skills/`、`~/.gemini/antigravity/skills/` 等目录。能找到则说明用户在用对应平台，项目级路径使用对应前缀
3. **兜底默认值**：以上都未找到，使用 `.agents/skills/` 作为默认前缀（Agent Skills 开放标准，兼容性最广）

探测到的前缀记为 `{skill_prefix}`。最终 skill 安装路径为：`{skill_prefix}/design_{{topic_slug}}/SKILL.md`

### 路径1：直接安装到当前工作空间

**执行以下步骤（必须按顺序完成）：**

1. 在当前工作空间内，按探测到的 `{skill_prefix}` 创建 skill 目录：`{skill_prefix}/design_{{topic_slug}}/`
2. 将生成的 SKILL.md 写入该目录
3. 在该目录下创建 `references/` 子目录，写入 review_checklist.md 和 summary_guide.md
4. 在当前工作空间根目录下创建项目文件目录 `design_{{topic_slug}}/`（用于存放设计过程中产生的所有项目文件：设计计划、需求文档、决策记录等）
5. 注意：生成的文件包含大量 Markdown 特殊字符（反引号、方括号、花括号），请使用文件写入工具直接创建文件，避免通过 Shell heredoc（`cat <<EOF`）或重定向写入
6. 通知用户：

> "设计项目已安装到当前工作空间：
> - skill 位于 `{skill_prefix}/design_{{topic_slug}}/`
> - 项目文件将保存在 `design_{{topic_slug}}/` 目录下
>
> 直接开始对话就可以使用了——说「开始设计」或「继续设计」即可。"

### 路径2：ZIP 打包

**执行以下步骤（必须按顺序完成）：**

1. 在 /tmp/ 下创建临时目录 `design_{{topic_slug}}_package/`
2. 在临时目录内按探测到的 `{skill_prefix}` 创建 skill 目录结构：`{skill_prefix}/design_{{topic_slug}}/SKILL.md` + `{skill_prefix}/design_{{topic_slug}}/references/`
3. 在临时目录内创建项目文件目录：`design_{{topic_slug}}/`（空目录，首次使用时 skill 会自动初始化）
4. 写入所有文件（同路径1步骤2-3）。同样使用文件写入工具，避免 Shell heredoc
5. 执行 zip 打包：`cd /tmp && zip -r design_{{topic_slug}}.zip design_{{topic_slug}}_package/`
6. 将 zip 文件移动到用户工作目录
7. 清理临时目录
8. 通知用户：

> "已打包为 `design_{{topic_slug}}.zip`。
> 解压到你的工作空间根目录后，skill 会自动生效，项目文件将保存在 `design_{{topic_slug}}/` 目录下。"

---

## 附录：生成物质量检查清单

生成前最后过一遍，确保生成物质量：

**内容质量**
- [ ] frontmatter 的 name 字段不超过 32 字符
- [ ] frontmatter 的 description 包含触发关键词和主题名称
- [ ] frontmatter 的 generated_by 字段已填充版本标识
- [ ] 项目信息区的所有变量（含项目文件目录）都已正确填充
- [ ] 所有占位符已处理（替换或清除），无残留的 `{{...}}`
- [ ] 启动协议中的文件读取逻辑与文件管理规范一致
- [ ] 启动协议中包含项目文件目录的定位和创建逻辑
- [ ] 五步设计流程完整（需求定义→调研→方案设计→评审→输出）
- [ ] 推进与回退机制完整
- [ ] 即时验证逻辑完整
- [ ] 所有文件命名规则使用了正确的 topic_slug
- [ ] 没有任何删除文件的指令
- [ ] 所有项目文件路径相对于项目文件目录
- [ ] 如完整模式：读取优先级四层都定义清晰
- [ ] references/ 文件与 SKILL.md 中的引用一致

**交付验证**
- [ ] 交付前已询问用户选择交付方式（直接安装 / ZIP）
- [ ] 已执行安装路径探测，确认 `{skill_prefix}` 值
- [ ] skill 目录结构正确：`{skill_prefix}/design_[topic_slug]/SKILL.md` + `references/`
- [ ] 项目文件目录已创建：`design_[topic_slug]/`
- [ ] 所有文件已成功写入（非空、内容完整）
````

## File: design/README.md
size: 6658
sha: b274e9af340135984388dec93f715241c97db740
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/README.md

````text
# skill-creator-design

> **MethodCraft** series — 把经过验证的方法论编译为可执行的 AI Skill

根据你的设计需求，生成一个定制化的设计项目 Skill。

生成的 Skill 会在你的整个设计过程中持续引导——从需求定义、调研、方案设计、评审到交付。不是一次性的头脑风暴，而是一个贯穿项目全程的设计伴侣。

主要面向产品设计（product design）场景优化，同时对其他设计领域（服务设计、空间设计、品牌设计等）提供通用引导——核心框架不变，术语和侧重点由 agent 根据具体领域适配。

## 核心特性：自带 Memory 系统

生成的 Skill 内置文件级 memory 机制，让 agent 跨对话记住你的设计进度和决策：

- **决策追溯**：每个关键设计决策自动记录到 decisions.md——选了什么、为什么、放弃了什么——项目再长也不会忘记"当初为什么这么决定"
- **按步骤组织**：产出物按设计步骤分文件夹（requirements/、research/、design/、review/、output/），结构清晰
- **跨对话恢复**：每次开新对话，Skill 自动读取 plan.md 和最近的决策记录，声明"当前进度：步骤 3 方案设计"——不需要你重复交代上下文
- **智能读取优先级**（完整模式）：四层读取策略，优先加载当前步骤相关文件，上游产出物按需参考
- **严禁删除**：产出物更新是覆盖写入最新内容，变更历史在 decisions.md 中保留

## 快速开始

安装后，对 agent 说：

- "我想设计一个用户 onboarding 流程"
- "帮我生成一个设计 skill"
- "创建设计项目"
- "I want to design a notification system"

Creator 会用 2-3 轮对话了解你的情况（设计什么、目标、范围、约束），然后生成一个定制的 SKILL.md。

## 它会问你什么

| 信息 | 为什么需要 | 示例 |
|---|---|---|
| 设计主题 | 确定领域和方向 | "用户 onboarding 流程"、"通知系统" |
| 设计目标 | 决定成功标准 | "新用户 7 天留存率从 30% 提到 50%" |
| 设计范围 | 确定复杂度和结构 | "0→1 新产品" / "现有 App 的功能迭代" |
| 约束条件 | 划定可行边界 | "技术栈限制 React Native"、"2 周内交付" |

不会问太多。目标受众、交付物偏好之类的，如果你在对话中自然提到了会采用，没提到就用合理默认值。

## 两种模式

| | 轻量模式 | 完整模式 |
|---|---|---|
| 适合 | 单功能设计 / 小型迭代 | 新产品 0→1 / 大型功能 |
| 调研深度 | 竞品分析为主 | 竞品 + 可行性 + 用户调研 |
| 评审 | 三视角快速检查 + 聚焦 1-2 个关键风险 | 三视角深度评审 + 多角度系统质疑 |
| 结项 | 精简设计总结 | 完整决策回顾 + 原则提炼 + 迭代方向 |
| 文件管理 | 全量加载（文件少） | 四层优先级动态调整 |

Creator 会根据设计范围推荐模式，你可以覆盖。两种模式在覆盖范围内的引导质量一致——轻量不是"缩水版"，是为小型项目裁剪了深度调研和系统评审的环节。

## 生成物长什么样

生成的项目 Skill 安装到当前工作空间中。随着设计推进，项目目录会自动生长为这样：

```
design_user_onboarding/
├── {skill_prefix}/design_user_onboarding/
│   ├── SKILL.md                          # 主控逻辑：启动协议 + 五步流程 + 回退/验证
│   └── references/
│       ├── review_checklist.md           # 评审执行清单
│       └── summary_guide.md              # 设计总结生成指南
├── plan.md                               # 设计计划 + 步骤进度
├── decisions.md                          # 决策记录（追加式，永不覆盖）
├── requirements/
│   └── requirements.md                   # 需求边界文档
├── research/
│   └── research.md                       # 调研摘要
├── design/
│   └── design.md                         # 方案文档
├── review/
│   └── review.md                         # 评审记录
├── output/
│   └── [交付物]                          # PRD / 技术方案 / 其他
└── summary_user_onboarding.md            # 设计总结（结项时生成）
```

安装后，Skill 引导你的设计项目走完五个步骤：

1. **需求定义** — 聚焦核心场景、划定边界、定义成功指标
2. **调研** — 竞品分析、技术可行性、用户调研（按需）
3. **方案设计** — 核心流程 + 异常路径 + 决策记录
4. **评审** — 三视角（用户/技术/业务）检查 + 多角度质疑
5. **输出** — 产出交付物（PRD 等）

贯穿全程的两个机制：

- **推进与回退** — 每步完成后主动推进下一步；当新信息与上游结论矛盾时，建议回退重新梳理
- **即时验证** — 识别到关键假设或决策时，当场从多视角质疑，不等到步骤 4 才发现问题

## 交付方式

生成完成后你可以选择：

- **直接安装** — 安装到当前工作空间，立即可用
- **ZIP 打包** — 生成 zip 文件，可自行解压到任意位置或分享

## 兼容性

主要为 OpenClaw 设计，同时兼容能操作本地文件系统的 AI Agent 产品（Claude Code、WorkBuddy、CodeBuddy 等）。安装路径自动适配当前平台，所有指令使用描述性语言，不依赖特定平台 API。

## 设计说明

这个 Creator 背后是经过实际设计项目验证的方法论——有向五步流程（需求定义→调研→方案设计→评审→输出）配合智能回退机制，确保设计过程既有推进方向又不会一条路走到黑。

几个关键设计决策：

- **文件即 memory**：通过 plan.md + decisions.md 实现跨对话状态保持，不依赖任何平台的记忆机制
- **设计伴侣，不是项目管理器**：专注帮你完成一次设计任务，不替你管日程和看板
- **即时验证 + 集中评审**：关键假设当场验证，不积压到最后；步骤 4 做系统性三视角评审
- **引导而非强制**：步骤可以跳过、评审深度可以调整——Skill 给建议，你做决定

## 版本

- v1.2.0 — 交付模式优化：项目 skill 直接安装到当前工作空间，消除创建独立项目文件夹的步骤
- v1.1.0 — 自适应深度（轻量/完整模式不再是固定行为，而是默认倾向，遇到实际复杂度差异时自动调整）、生成物新增 generated_by 版本标识、结项新增 project_feedback.md 结构化反馈输出
- v1.0.0 — 首次发布
````

## File: design/references/templates/guides/review_checklist.md
size: 3358
sha: d5bc086d85607873e661b12fe9edd8dd86188883
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/references/templates/guides/review_checklist.md

```text
# 评审执行清单

> 本文件在步骤 4（评审）触发时加载，也可在即时验证时按需参考。
> 提供三视角评审的详细检查项和多角度质疑框架。

## 评审前准备

1. 确认要评审的内容范围：是完整方案还是阶段性结论
2. 加载最新的 design.md（方案文档）
3. 加载 requirements.md（需求边界）作为评审基准
4. 加载 decisions.md 了解关键决策上下文

## 三视角评审

### 用户视角

核心问题：用户能理解和使用吗？

检查项：
- 首次使用：用户不看说明能理解核心操作吗？如果需要说明，说明的复杂度合理吗？
- 操作路径：完成核心任务的步骤数是否最少？有没有可以合并或省略的步骤？
- 异常恢复：用户操作出错时，能理解发生了什么吗？能自己恢复吗？
- 一致性：类似的操作在不同场景中表现一致吗？用户的心智模型会被打破吗？
- 边界用户：除了典型用户，还有哪些边缘用户群体？他们的体验如何？

### 技术视角

核心问题：实现方案合理吗？

检查项：
- 复杂度：有没有过度设计的部分？有没有可以用更简单方案解决的地方？
- 可扩展性：当前方案在数据量/用户量增长时能否撑住？瓶颈在哪？
- 依赖风险：关键依赖是否可控？如果某个依赖不可用，有 fallback 吗？
- 安全性：有没有数据泄露、权限越界、注入攻击等风险？
- 可测试性：核心逻辑能被独立测试吗？异常路径能被覆盖到吗？

### 业务视角

核心问题：能达成业务目标吗？

检查项：
- 效果衡量：有没有明确的成功指标？上线后怎么判断设计是否有效？
- 迭代路径：如果效果不达预期，调整的成本和路径是什么？有没有被锁死的决策？
- 资源匹配：实现这个方案需要的资源（时间/人力/成本）与预期收益匹配吗？
- 机会成本：做这个意味着不做什么？放弃的方案有没有更好的 ROI？
- 时机：现在做这个设计的时机合适吗？有没有需要等待的前置条件？

## 多角度质疑框架

评审的核心不是确认方案是对的，而是尝试找出方案可能错的地方。

### 执行步骤

1. **识别相关方**：列出会评判这个方案的角色（如：最终用户、开发工程师、产品经理、运营、老板、竞争对手）
2. **选择质疑角度**：从中选出最可能提出有力质疑的 3 个角色
3. **模拟质疑**：站在每个角色的立场提出他们最可能问的问题：
   - "[角色] 最可能质疑的是什么？"
   - "如果 [角色] 要反对这个方案，他们会用什么理由？"
4. **评估应对**：对每个质疑，评估当前方案是否有应对，如果没有，是需要补充还是可以接受风险

### 质疑结果记录格式

| 质疑角度 | 质疑内容 | 当前应对 | 风险等级 | 处理建议 |
|---|---|---|---|---|
| [角色] | [具体质疑] | [方案中已有的应对/尚无应对] | [高/中/低] | [需补充方案/可接受风险/需回退重做] |

## 评审产出

将评审发现整理为 review.md，包含：
- 三视角检查的关键发现和建议
- 多角度质疑的结果
- 风险清单及应对状态
- 需要回退修改的决策（如有）→ 同步追加到 decisions.md
```

## File: design/references/templates/guides/summary_guide_full.md
size: 3198
sha: 87f9275cc974e64d0426596532d98aa3e89f4315
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/references/templates/guides/summary_guide_full.md

````text
# 设计总结生成指南（完整模式）

> 本文件在结项模式触发时加载。指导如何从项目全程的决策记录和产出物中提炼设计总结。

## 什么是设计总结

设计总结不是各步骤产出物的拼接，而是对整个设计过程的**反思性回顾**——提炼出决策逻辑、设计原则和可复用的经验。

好的设计总结应该能让未来的自己（或接手的人）快速理解：为什么方案长这样、关键取舍是什么、哪些是经过验证的决策、哪些仍有风险。

## 生成步骤

### 第一步：加载素材

读取以下文件：
- decisions.md 全文——这是最核心的素材
- requirements.md（需求边界）
- design.md（方案文档）
- review.md（评审记录）
- 如有多次回退记录，特别关注回退的原因和调整后的决策

### 第二步：提炼决策链

从 decisions.md 中梳理关键决策的时间线，识别：
- 哪些决策是一次确定的（高确信度）
- 哪些决策经历了反复（说明这里有真正的权衡）
- 哪些决策触发了回退（说明早期假设被推翻）

重点关注经历反复和触发回退的决策——这些是设计中最有学习价值的部分。

### 第三步：抽象设计原则

从具体决策中抽象出可复用的设计原则。好的设计原则是：
- 从本项目的具体经验中提炼的（不是泛泛的"用户体验很重要"）
- 可以指导未来类似项目的决策
- 包含取舍逻辑（"在 A 和 B 之间，我们选了 A，因为..."）

示例：
- "对于 [这类场景]，先做 [X] 再做 [Y] 比反过来效率更高，因为..."
- "当 [约束条件] 存在时，优先保证 [A] 而不是 [B]"

### 第四步：标注风险和开放问题

从 review.md 的风险清单和 decisions.md 中汇总：
- 已识别并已应对的风险（记录应对方案）
- 已识别但接受的风险（记录接受理由）
- 仍然开放的问题（记录后续需要关注的点）

### 第五步：梳理迭代方向

基于评审发现和开放问题，列出后续可能的迭代方向：
- 短期优化：当前方案中已知可以改进的点
- 中期演进：等数据反馈后可能需要调整的方向
- 长期可能：如果产品/项目继续发展，可能需要的大改动

### 第六步：组装并保存

按以下结构组装设计总结：

```
# [设计主题] 设计总结

## 设计概要
[一段话概括：设计了什么、解决什么问题、核心方案是什么]

## 关键设计决策
### [决策1标题]
- 决策：[选了什么]
- 权衡：[考虑过什么、为什么放弃]
- 验证：[如何验证这个决策是对的]
（列出 3-5 个最重要的决策）

## 设计原则提炼
- [原则1]：[说明 + 来源决策]
- [原则2]：[说明 + 来源决策]

## 风险与开放问题
| 类型 | 内容 | 状态 | 备注 |
|---|---|---|---|
| 已应对 | [风险] | [应对方案] | |
| 已接受 | [风险] | [接受理由] | |
| 开放 | [问题] | 待观察 | [后续关注点] |

## 迭代方向
- 短期：[优化点]
- 中期：[可能的调整方向]
- 长期：[潜在的大改动]
```

保存为 `summary_[topic_slug].md`，通知用户项目完成。
````

## File: design/references/templates/guides/summary_guide_lite.md
size: 1816
sha: 19051dd8b1600728856d917c337a7965aef00fda
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/references/templates/guides/summary_guide_lite.md

````text
# 设计总结生成指南（轻量模式）

> 本文件在结项模式触发时加载。指导如何从项目决策记录和产出物中生成简明设计总结。

## 什么是设计总结

设计总结不是各步骤产出物的拼接，而是对整个设计过程的**反思性回顾**——提炼出关键决策和取舍逻辑。

好的设计总结应该能让未来的自己（或接手的人）快速理解：为什么方案长这样、关键取舍是什么、哪些仍有风险。

## 生成步骤

### 第一步：加载素材

读取以下文件：
- decisions.md 全文——这是最核心的素材
- requirements.md（需求边界）
- design.md（方案文档）
- review.md（评审记录）

### 第二步：提炼决策链

从 decisions.md 中梳理关键决策，识别：
- 哪些决策经历了反复或触发了回退——这些是最有价值的取舍
- 每个关键决策的核心权衡是什么

### 第三步：标注风险和开放问题

从 review.md 的风险清单和 decisions.md 中汇总：
- 已识别并已应对的风险（记录应对方案）
- 仍然开放的问题（记录后续需要关注的点）

### 第四步：组装并保存

按以下结构组装设计总结：

```
# [设计主题] 设计总结

## 设计概要
[一段话概括：设计了什么、解决什么问题、核心方案是什么]

## 关键设计决策
### [决策1标题]
- 决策：[选了什么]
- 权衡：[考虑过什么、为什么放弃]
（列出最重要的决策，通常 2-3 个）

## 风险与开放问题
| 类型 | 内容 | 状态 | 备注 |
|---|---|---|---|
| 已应对 | [风险] | [应对方案] | |
| 开放 | [问题] | 待观察 | [后续关注点] |

## 后续方向
- [可能的优化或迭代方向]
```

保存为 `summary_[topic_slug].md`，通知用户项目完成。
````

## File: design/references/templates/skill/full.md
size: 13109
sha: ba0125fc68dc40ca15ac8134b4418691287094f0
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/references/templates/skill/full.md

````text
---
name: design_{{topic_slug}}
description: >
  {{topic}}设计项目引导。当用户想要推进{{topic}}的设计、继续设计、评审、交付，
  或者说"继续""接下来""开始设计"等任何暗示设计活动的话时，都应触发此 skill。
tools: [write, bash, web_search]
generated_by: {{generated_by}}
---

# {{topic}} 设计项目引导

## 项目信息

- 设计主题：{{topic}}
- 设计目标：{{goal}}
- 设计范围：{{scope}}
- 约束条件：{{constraints}}
- 项目文件目录：{{project_dir}}
- 项目模式：完整模式（默认深入系统，明确简单的环节自动精简）
{{target_audience_override}}

## 启动协议

每次新对话开始时，依次执行：

1. 读取本 skill 的项目信息区，获取项目基本参数
2. 确认项目文件目录（项目信息区中的 `{{project_dir}}`）存在。如不存在则创建。**以下所有文件路径均相对于此项目文件目录。**
3. 读取 plan.md（如存在），确认当前所在步骤
4. 读取 decisions.md 最后数条，了解最近的决策上下文
5. 按读取优先级加载当前步骤的产出物文件（见"文件管理规范 > 读取优先级"）
6. 向用户声明当前状态，格式：
   "当前进度：步骤 N [步骤名]。[最近完成的事项简述]"
7. 根据进度判断当前应处的步骤：
   - 尚未生成设计计划 → 启动（生成 plan.md 后进入步骤 1）
   - plan.md 显示当前步骤为 N → 进入步骤 N
   - 所有步骤已完成 → 结项
   - 用户明确指定步骤（如"我想重新看看需求"）→ 遵从用户指定

如果项目文件目录下没有 plan.md，说明这是首次对话。先与用户简要确认项目信息区中的设计目标和范围，根据讨论生成 plan.md，然后进入步骤 1。

## 设计流程

### 步骤 1：需求定义

目标：明确设计的核心场景、边界和成功指标。

引导动作：
- 与用户讨论核心用户场景，帮助聚焦到不超过 3 个最关键的场景
- 如用户列出过多场景，引导排优先级："这些场景中，哪 2-3 个是 MVP 必须覆盖的？"
- 为每个核心场景定义成功指标，引导量化但不强制——有些领域天然定性
- 使用反向验证："这个功能不做会怎样？做了最大的风险是什么？"
- 确认需求边界后，保存为 requirements/requirements.md

完成标准：用户确认核心场景、边界和成功指标清晰。

---

### 步骤 2：调研

目标：通过竞品分析、可行性确认和用户调研，为方案设计积累信息基础。

引导动作：
- 竞品分析（必做）：找 3-5 个相关产品，重点分析取舍逻辑而非功能清单列表。记录"别人为什么这么做"。使用 web search 获取最新的竞品信息
- 技术可行性（条件触发：项目有技术/实施约束时做）：确认关键技术路径是否可行
- 用户调研（条件触发：项目范围大且条件允许时建议做）：真实用户的使用场景和痛点
- 默认竞品分析、可行性确认和用户调研都做充分。如果某项调研的范围明确无争议（如技术可行性已由团队验证），可精简或跳过
- 调研完成后，保存为 research/research.md

完成标准：关键信息收集充分，足以支撑方案设计。

---

### 步骤 3：方案设计

目标：设计解决方案，产出方案文档。

引导动作：
- 先画状态机/流程图，理清核心逻辑，再考虑页面和细节
- 系统覆盖所有用户流程，异常路径按类别检查（权限异常、数据异常、网络异常、并发冲突、边界值等）
- 每个关键决策点必须记录：选了什么、为什么、放弃了什么 → 追加到 decisions.md
- 方案成型后，保存为 design/design.md

完成标准：核心流程清晰，异常路径已覆盖，关键决策已记录。

---

### 步骤 4：评审

目标：系统检查方案质量，暴露风险。

引导动作：
1. 加载 references/review_checklist.md
2. 用户视角评审：首次使用能理解吗？操作路径最短吗？
3. 技术视角评审：实现复杂度合理吗？有没有过度设计？
4. 业务视角评审：能衡量效果吗？迭代路径清晰吗？
5. 默认系统完成三视角评审，多角度质疑至少覆盖 3 个挑战角度——从最可能质疑方案的角色出发提出挑战，暴露风险供用户评判。如果方案成熟且无争议（如团队已充分讨论），可精简为快速过三视角清单
6. 将评审发现和应对方案保存为 review/review.md，关键决策追加到 decisions.md

完成标准：三视角评审完成，关键风险已识别并有应对方案。

---

### 步骤 5：输出

目标：产出交付物。

引导动作：
- 根据项目需要推荐交付物类型（默认：PRD；按需可加技术方案、演示材料）
- 确保交付物中包含关键决策记录（或引用 decisions.md）
- 交付物保存到 output/ 目录
- 通知用户交付物已生成
{{deliverable_override}}

完成标准：交付物已生成，决策记录完整。

---

### 结项

触发条件：用户声明设计完成，或交付物已产出且评审通过。

1. 加载 references/summary_guide.md
2. 梳理 decisions.md 全文，提炼关键设计决策和取舍逻辑
3. 默认生成完整设计总结，包含：
   - 核心设计决策回顾（选了什么、为什么、放弃了什么）
   - 设计原则提炼（从本项目的决策中抽象出的可复用原则）
   - 风险清单及应对状态
   - 后续迭代方向
   如果项目简单直接（决策链短、无回退），可精简为核心决策回顾 + 后续方向
4. 保存设计总结为 summary_{{topic_slug}}.md
5. 生成项目反馈文件 `project_feedback.md`（格式见"产出物格式规范"），记录项目执行中的方法论反馈，为后续 skill 迭代提供数据
6. 通知用户项目完成

（详细总结生成指南见 references/summary_guide.md）

---

## 推进与回退机制

### 推进

- 每个步骤完成后，主动推进到下一步并确认：
  "需求定义清楚了，接下来进调研。你准备好了吗？还是有需要补充的？"
- 推进前更新 plan.md 的当前步骤标记
- 如对话已较长（超过 10 轮深度讨论），建议用户开新对话继续下一步骤

### 回退

- 当用户带来的新信息与已确认的上游产出物矛盾时，建议回退：
  "你提到的 [新信息] 和之前确认的 [上游结论] 有冲突。建议回到 [步骤名] 重新梳理，你觉得呢？"
- 回退需要用户确认后执行，不自作主张
- 回退时：
  1. 更新 plan.md 当前步骤标记
  2. 在 decisions.md 追加回退记录：回退到哪一步、原因是什么
  3. 回退到目标步骤后，读取该步骤已有产出物，在此基础上更新（覆盖写入）

---

## 即时验证

在任何步骤中，当识别到以下情况时，主动触发验证：
- 用户提出了一个关键假设（如"用户应该会接受这个流程"）
- 形成了阶段性结论（如确定了核心场景、选定了技术方案）
- 做出了关键设计决策

触发时：
- 从用户/技术/业务三个最相关的视角提出质疑
- 暴露风险供用户评判，不替用户做决定
- 将验证结论追加到 decisions.md

示例：
"你提出了一个关键假设：[假设内容]。我们从几个角度验证一下——
 用户视角：[质疑]
 技术视角：[质疑]
 你怎么看？"

---

## 文件管理规范

### 文件清单

| 文件 | 命名 | 生成时机 | 更新方式 |
|---|---|---|---|
| 设计计划 | {{project_dir}}/plan.md | 启动时 | 覆盖更新 |
| 决策记录 | {{project_dir}}/decisions.md | 首个决策形成时 | 追加，永不覆盖 |
| 需求边界 | {{project_dir}}/requirements/requirements.md | 步骤 1 完成时 | 覆盖更新 |
| 调研摘要 | {{project_dir}}/research/research.md | 步骤 2 完成时 | 覆盖更新 |
| 方案文档 | {{project_dir}}/design/design.md | 步骤 3 完成时 | 覆盖更新 |
| 评审记录 | {{project_dir}}/review/review.md | 步骤 4 完成时 | 追加 |
| 交付物 | {{project_dir}}/output/[文件名] | 步骤 5 完成时 | 覆盖更新 |
| 设计总结 | {{project_dir}}/summary_{{topic_slug}}.md | 结项时 | 一次性 |
| 项目反馈 | {{project_dir}}/project_feedback.md | 结项时 | 一次性 |

### 保存触发与通知

| 触发事件 | 保存动作 | 通知 |
|---|---|---|
| 启动时生成设计计划 | 创建 plan.md | "设计计划已生成" |
| 步骤产出物完成或更新 | 覆盖写入对应文件 | "[产出物名] 已保存/已更新" |
| 关键决策形成 | 追加到 decisions.md | "决策已记录" |
| 步骤切换确认 | 更新 plan.md 的当前步骤 | "进入 [步骤名]" |
| 回退执行 | 更新 plan.md + 追加回退记录 | "回到 [步骤名]，原因：[简述]" |
| 即时验证完成 | 追加到 decisions.md | "验证结论已记录" |
| 结项 | 生成设计总结 | "设计总结已保存，项目完成" |

### 核心规则

- **自动保存**：到达触发点时自动保存，完成后通知用户
- **严禁删除**：不在任何情况下删除项目文件目录中的文件。设计产出物和决策记录具有长期参考价值。"更新"是覆盖写入最新内容，变更历史在 decisions.md 中以决策记录形式保留
- **路径前缀**：每次读写文件时，必须使用 `{{project_dir}}/` 作为路径前缀。例如保存设计计划时写入 `{{project_dir}}/plan.md`，而非 `plan.md`。此规则在整个项目生命周期内始终有效，不因对话轮次增加而省略
- **Markdown 格式**：所有文件统一为 Markdown

### 读取优先级

每次新对话，按以下层级决定加载哪些文件：

**L1（始终加载）**：plan.md + decisions.md（最近 10 条）
**L2（当前步骤）**：当前步骤文件夹内所有文件
**L3（上游参考）**：已完成步骤的产出物（读摘要或首段，供回退判断和上下文参考）
**L4（不主动加载）**：下游步骤文件（如已存在），用户明确要求时才加载

---

## 产出物格式规范

### plan.md

```
# [设计主题] 设计计划

## 设计目标
[从项目信息区复制]

## 当前步骤
步骤 N：[步骤名]

## 各步骤状态
| 步骤 | 状态 | 备注 |
|---|---|---|
| 1. 需求定义 | [未开始/进行中/已完成] | |
| 2. 调研 | [未开始/进行中/已完成] | |
| 3. 方案设计 | [未开始/进行中/已完成] | |
| 4. 评审 | [未开始/进行中/已完成] | |
| 5. 输出 | [未开始/进行中/已完成] | |
```

### decisions.md

```
# 决策记录

> 按时间追加，记录所有关键设计决策和变更原因。

## [日期] [决策标题]
- 来源：[步骤推进 / 即时验证 / 评审 / 回退 / 用户输入]
- 决策：[选了什么]
- 原因：[为什么]
- 放弃方案：[考虑过但没选的]
- 涉及步骤：[步骤 N]

---
（下一条决策追加在此之后）
```

### requirements.md（步骤 1 产出）

```
# 需求边界文档

## 核心场景
1. [场景描述 + 成功指标]
2. [场景描述 + 成功指标]
3. [场景描述 + 成功指标]

## 设计边界
- 做什么：[范围内]
- 不做什么：[范围外]
- 不做会怎样：[影响评估]
- 做了最大的风险：[风险评估]

## 约束条件
[从项目信息区复制 + 需求定义过程中补充的约束]
```

### research.md（步骤 2 产出）

```
# 调研摘要

## 竞品分析
### [竞品名称]
- 方案：[做了什么]
- 取舍逻辑：[为什么这么做，放弃了什么]
- 对我们的启发：[可借鉴/需避免的]
（重复 3-5 个竞品）

## 技术可行性（如适用）
- [关键技术路径及结论]

## 用户调研（如适用）
- [关键发现]
```

### design.md（步骤 3 产出）

```
# 方案文档

## 核心流程
[状态机/流程图描述]

## 异常路径处理
| 异常类型 | 场景 | 处理方案 |
|---|---|---|
| ... | ... | ... |

## 关键设计决策
（引用 decisions.md 中的相关条目，或在此简述）
```

### review.md（步骤 4 产出）

```
# 评审记录

## 用户视角
- [发现 + 建议]

## 技术视角
- [发现 + 建议]

## 业务视角
- [发现 + 建议]

## 多角度质疑
| 质疑角度 | 质疑内容 | 应对方案 |
|---|---|---|
| ... | ... | ... |

## 风险清单
| 风险 | 影响 | 应对 | 状态 |
|---|---|---|---|
| ... | ... | ... | [待处理/已应对] |
```

### 项目反馈（project_feedback.md）

```
# 项目反馈

## 项目信息
- 主题：[主题]
- 模式：[轻量/完整]
- 持续时间：[起止]

## skill 引导效果
- 哪些引导环节最有价值：[列举]
- 哪些引导环节被跳过或感觉多余：[列举]
- 模式选择是否合适：[合适 / 应该选另一个模式，原因]

## 方法论反馈
- 有向五步流程的实际效果：[评价]
- 即时验证机制的实际效果：[评价]
- 评审环节（系统评审 + 多角度质疑）的实际效果：[评价]
- 回退机制的实际使用情况：[评价]
- 文件管理是否顺畅：[评价]

## 改进建议
- [具体建议]
```
````

## File: design/references/templates/skill/lite.md
size: 11351
sha: 0e62cffb2bcb440e311dc2f8129ee59ce42d3f84
upstream: https://github.com/balancegsr/skill-creators/blob/main/design/references/templates/skill/lite.md

````text
---
name: design_{{topic_slug}}
description: >
  {{topic}}设计项目引导。当用户想要推进{{topic}}的设计、继续设计、评审、交付，
  或者说"继续""接下来""开始设计"等任何暗示设计活动的话时，都应触发此 skill。
tools: [write, bash, web_search]
generated_by: {{generated_by}}
---

# {{topic}} 设计项目引导

## 项目信息

- 设计主题：{{topic}}
- 设计目标：{{goal}}
- 设计范围：{{scope}}
- 约束条件：{{constraints}}
- 项目文件目录：{{project_dir}}
- 项目模式：轻量模式（默认快速推进，遇到高影响决策自动加深）
{{target_audience_override}}

## 启动协议

每次新对话开始时，依次执行：

1. 读取本 skill 的项目信息区，获取项目基本参数
2. 确认项目文件目录（项目信息区中的 `{{project_dir}}`）存在。如不存在则创建。**以下所有文件路径均相对于此项目文件目录。**
3. 读取 plan.md（如存在），确认当前所在步骤
4. 读取 decisions.md 最后数条，了解最近的决策上下文
5. 加载项目文件目录下所有已有的产出物文件（默认全量加载；如果文件量增长到上下文窗口紧张，自动启用分层加载——优先加载当前步骤和上游步骤的产出物，下游步骤文件按需加载）
6. 向用户声明当前状态，格式：
   "当前进度：步骤 N [步骤名]。[最近完成的事项简述]"
7. 根据进度判断当前应处的步骤：
   - 尚未生成设计计划 → 启动（生成 plan.md 后进入步骤 1）
   - plan.md 显示当前步骤为 N → 进入步骤 N
   - 所有步骤已完成 → 结项
   - 用户明确指定步骤（如"我想重新看看需求"）→ 遵从用户指定

如果项目文件目录下没有 plan.md，说明这是首次对话。先与用户简要确认项目信息区中的设计目标和范围，根据讨论生成 plan.md，然后进入步骤 1。

## 设计流程

### 步骤 1：需求定义

目标：明确设计的核心场景、边界和成功指标。

引导动作：
- 与用户讨论核心用户场景，默认快速聚焦到 1-2 个最关键的场景（如果场景间存在强耦合或用户需求复杂度超出预期，可扩展到 3 个）
- 为核心场景定义成功指标，引导量化但不强制
- 使用反向验证："这个功能不做会怎样？做了最大的风险是什么？"
- 确认需求边界后，保存为 requirements/requirements.md

完成标准：用户确认核心场景、边界和成功指标清晰。

---

### 步骤 2：调研

目标：通过竞品分析为方案设计积累信息基础。

引导动作：
- 竞品分析（必做）：找 3-5 个相关产品，重点分析取舍逻辑而非功能清单列表。记录"别人为什么这么做"。使用 web search 获取最新的竞品信息
- 技术可行性（条件触发：项目有技术/实施约束时做）：确认关键技术路径是否可行
- 用户调研（条件触发：按需进行）
- 默认以竞品分析为主，可行性和用户调研按需进行。如果在竞品分析中发现关键可行性风险或用户假设不确定，自动升级加做相应调研
- 调研完成后，保存为 research/research.md

完成标准：关键信息收集充分，足以支撑方案设计。

---

### 步骤 3：方案设计

目标：设计解决方案，产出方案文档。

引导动作：
- 先画状态机/流程图，理清核心逻辑，再考虑页面和细节
- 聚焦核心流程和主要异常路径
- 每个关键决策点必须记录：选了什么、为什么、放弃了什么 → 追加到 decisions.md
- 方案成型后，保存为 design/design.md

完成标准：核心流程清晰，主要异常路径已覆盖，关键决策已记录。

---

### 步骤 4：评审

目标：快速检查方案质量，暴露关键风险。

引导动作：
1. 加载 references/review_checklist.md
2. 默认快速过三视角清单：
   - 用户视角：首次使用能理解吗？操作路径最短吗？
   - 技术视角：实现复杂度合理吗？有没有过度设计？
   - 业务视角：能衡量效果吗？迭代路径清晰吗？
3. 聚焦最关键的 1-2 个风险，提出挑战，暴露风险供用户评判。如果发现高影响或不可逆的风险，升级为系统评审（多角度质疑，覆盖 3+ 挑战角度）
4. 将评审发现和应对方案保存为 review/review.md，关键决策追加到 decisions.md

完成标准：三视角快速检查完成，关键风险已识别并有应对方案。

---

### 步骤 5：输出

目标：产出交付物。

引导动作：
- 根据项目需要推荐交付物类型（默认：PRD；按需可加技术方案、演示材料）
- 确保交付物中包含关键决策记录（或引用 decisions.md）
- 交付物保存到 output/ 目录
- 通知用户交付物已生成
{{deliverable_override}}

完成标准：交付物已生成，决策记录完整。

---

### 结项

触发条件：用户声明设计完成，或交付物已产出且评审通过。

1. 加载 references/summary_guide.md
2. 按指南执行：加载素材 → 提炼决策链 → 标注风险和开放问题 → 组装总结
3. 默认简要总结。如果项目决策链复杂或涉及多轮回退，升级为完整总结（含设计原则提炼和后续迭代方向）
4. 保存设计总结为 summary_{{topic_slug}}.md
5. 生成项目反馈文件 `project_feedback.md`（格式见"产出物格式规范"），记录项目执行中的方法论反馈，为后续 skill 迭代提供数据
6. 通知用户项目完成

（详细总结生成指南见 references/summary_guide.md）

---

## 推进与回退机制

### 推进

- 每个步骤完成后，主动推进到下一步并确认：
  "需求定义清楚了，接下来进调研。你准备好了吗？还是有需要补充的？"
- 推进前更新 plan.md 的当前步骤标记

### 回退

- 当用户带来的新信息与已确认的上游产出物矛盾时，建议回退：
  "你提到的 [新信息] 和之前确认的 [上游结论] 有冲突。建议回到 [步骤名] 重新梳理，你觉得呢？"
- 回退需要用户确认后执行，不自作主张
- 回退时：
  1. 更新 plan.md 当前步骤标记
  2. 在 decisions.md 追加回退记录：回退到哪一步、原因是什么
  3. 回退到目标步骤后，读取该步骤已有产出物，在此基础上更新（覆盖写入）

---

## 即时验证

在任何步骤中，当识别到以下情况时，主动触发验证：
- 用户提出了一个关键假设（如"用户应该会接受这个流程"）
- 形成了阶段性结论（如确定了核心场景、选定了技术方案）
- 做出了关键设计决策

触发时：
- 从用户/技术/业务三个最相关的视角提出质疑
- 暴露风险供用户评判，不替用户做决定
- 将验证结论追加到 decisions.md

示例：
"你提出了一个关键假设：[假设内容]。我们从几个角度验证一下——
 用户视角：[质疑]
 技术视角：[质疑]
 你怎么看？"

---

## 文件管理规范

### 文件清单

| 文件 | 命名 | 生成时机 | 更新方式 |
|---|---|---|---|
| 设计计划 | {{project_dir}}/plan.md | 启动时 | 覆盖更新 |
| 决策记录 | {{project_dir}}/decisions.md | 首个决策形成时 | 追加，永不覆盖 |
| 需求边界 | {{project_dir}}/requirements/requirements.md | 步骤 1 完成时 | 覆盖更新 |
| 调研摘要 | {{project_dir}}/research/research.md | 步骤 2 完成时 | 覆盖更新 |
| 方案文档 | {{project_dir}}/design/design.md | 步骤 3 完成时 | 覆盖更新 |
| 评审记录 | {{project_dir}}/review/review.md | 步骤 4 完成时 | 追加 |
| 交付物 | {{project_dir}}/output/[文件名] | 步骤 5 完成时 | 覆盖更新 |
| 设计总结 | {{project_dir}}/summary_{{topic_slug}}.md | 结项时 | 一次性 |
| 项目反馈 | {{project_dir}}/project_feedback.md | 结项时 | 一次性 |

### 核心规则

- **自动保存**：到达触发点时自动保存，完成后通知用户
- **严禁删除**：不在任何情况下删除项目文件目录中的文件。设计产出物和决策记录具有长期参考价值。"更新"是覆盖写入最新内容，变更历史在 decisions.md 中以决策记录形式保留
- **路径前缀**：每次读写文件时，必须使用 `{{project_dir}}/` 作为路径前缀。例如保存设计计划时写入 `{{project_dir}}/plan.md`，而非 `plan.md`。此规则在整个项目生命周期内始终有效，不因对话轮次增加而省略
- **Markdown 格式**：所有文件统一为 Markdown

---

## 产出物格式规范

### plan.md

```
# [设计主题] 设计计划

## 设计目标
[从项目信息区复制]

## 当前步骤
步骤 N：[步骤名]

## 各步骤状态
| 步骤 | 状态 | 备注 |
|---|---|---|
| 1. 需求定义 | [未开始/进行中/已完成] | |
| 2. 调研 | [未开始/进行中/已完成] | |
| 3. 方案设计 | [未开始/进行中/已完成] | |
| 4. 评审 | [未开始/进行中/已完成] | |
| 5. 输出 | [未开始/进行中/已完成] | |
```

### decisions.md

```
# 决策记录

> 按时间追加，记录所有关键设计决策和变更原因。

## [日期] [决策标题]
- 来源：[步骤推进 / 即时验证 / 评审 / 回退 / 用户输入]
- 决策：[选了什么]
- 原因：[为什么]
- 放弃方案：[考虑过但没选的]
- 涉及步骤：[步骤 N]

---
（下一条决策追加在此之后）
```

### requirements/requirements.md（步骤 1 产出）

```
# 需求边界文档

## 核心场景
1. [场景描述 + 成功指标]

## 设计边界
- 做什么：[范围内]
- 不做什么：[范围外]
- 不做会怎样：[影响评估]
- 做了最大的风险：[风险评估]

## 约束条件
[从项目信息区复制 + 需求定义过程中补充的约束]
```

### research/research.md（步骤 2 产出）

```
# 调研摘要

## 竞品分析
### [竞品名称]
- 方案：[做了什么]
- 取舍逻辑：[为什么这么做，放弃了什么]
- 对我们的启发：[可借鉴/需避免的]
（重复 3-5 个竞品）

## 技术可行性（如适用）
- [关键技术路径及结论]
```

### design/design.md（步骤 3 产出）

```
# 方案文档

## 核心流程
[状态机/流程图描述]

## 异常路径处理
| 异常类型 | 场景 | 处理方案 |
|---|---|---|
| ... | ... | ... |

## 关键设计决策
（引用 decisions.md 中的相关条目，或在此简述）
```

### review/review.md（步骤 4 产出）

```
# 评审记录

## 三视角快速检查
- 用户视角：[发现 + 建议]
- 技术视角：[发现 + 建议]
- 业务视角：[发现 + 建议]

## 关键风险
| 风险 | 影响 | 应对 | 状态 |
|---|---|---|---|
| ... | ... | ... | [待处理/已应对] |
```

### 项目反馈（project_feedback.md）

```
# 项目反馈

## 项目信息
- 主题：[主题]
- 模式：[轻量/完整]
- 持续时间：[起止]

## skill 引导效果
- 哪些引导环节最有价值：[列举]
- 哪些引导环节被跳过或感觉多余：[列举]
- 模式选择是否合适：[合适 / 应该选另一个模式，原因]

## 方法论反馈
- 有向五步流程的实际效果：[评价]
- 即时验证机制的实际效果：[评价]
- 评审环节的实际效果：[评价]
- 文件管理是否顺畅：[评价]

## 改进建议
- [具体建议]
```
````
