⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
skill-creator-design
>
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
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 引导你的设计项目走完五个步骤:
- 需求定义 — 聚焦核心场景、划定边界、定义成功指标
- 调研 — 竞品分析、技术可行性、用户调研(按需)
- 方案设计 — 核心流程 + 异常路径 + 决策记录
- 评审 — 三视角(用户/技术/业务)检查 + 多角度质疑
- 输出 — 产出交付物(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 — 首次发布
// HOW IT'S BUILT
// FILES
7 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
design/SKILL.md14 KB0e985b28a784upstream ↗
--- 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]/` - [ ] 所有文件已成功写入(非空、内容完整)design/README.md6.5 KBb274e9af3401upstream ↗
# 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 — 首次发布design/references/templates/guides/review_checklist.md3.3 KBd5bc086d8560upstream ↗
# 评审执行清单 > 本文件在步骤 4(评审)触发时加载,也可在即时验证时按需参考。 > 提供三视角评审的详细检查项和多角度质疑框架。 ## 评审前准备 1. 确认要评审的内容范围:是完整方案还是阶段性结论 2. 加载最新的 design.md(方案文档) 3. 加载 requirements.md(需求边界)作为评审基准 4. 加载 decisions.md 了解关键决策上下文 ## 三视角评审 ### 用户视角 核心问题:用户能理解和使用吗? 检查项: - 首次使用:用户不看说明能理解核心操作吗?如果需要说明,说明的复杂度合理吗? - 操作路径:完成核心任务的步骤数是否最少?有没有可以合并或省略的步骤? - 异常恢复:用户操作出错时,能理解发生了什么吗?能自己恢复吗? - 一致性:类似的操作在不同场景中表现一致吗?用户的心智模型会被打破吗? - 边界用户:除了典型用户,还有哪些边缘用户群体?他们的体验如何? ### 技术视角 核心问题:实现方案合理吗? 检查项: - 复杂度:有没有过度设计的部分?有没有可以用更简单方案解决的地方? - 可扩展性:当前方案在数据量/用户量增长时能否撑住?瓶颈在哪? - 依赖风险:关键依赖是否可控?如果某个依赖不可用,有 fallback 吗? - 安全性:有没有数据泄露、权限越界、注入攻击等风险? - 可测试性:核心逻辑能被独立测试吗?异常路径能被覆盖到吗? ### 业务视角 核心问题:能达成业务目标吗? 检查项: - 效果衡量:有没有明确的成功指标?上线后怎么判断设计是否有效? - 迭代路径:如果效果不达预期,调整的成本和路径是什么?有没有被锁死的决策? - 资源匹配:实现这个方案需要的资源(时间/人力/成本)与预期收益匹配吗? - 机会成本:做这个意味着不做什么?放弃的方案有没有更好的 ROI? - 时机:现在做这个设计的时机合适吗?有没有需要等待的前置条件? ## 多角度质疑框架 评审的核心不是确认方案是对的,而是尝试找出方案可能错的地方。 ### 执行步骤 1. **识别相关方**:列出会评判这个方案的角色(如:最终用户、开发工程师、产品经理、运营、老板、竞争对手) 2. **选择质疑角度**:从中选出最可能提出有力质疑的 3 个角色 3. **模拟质疑**:站在每个角色的立场提出他们最可能问的问题: - "[角色] 最可能质疑的是什么?" - "如果 [角色] 要反对这个方案,他们会用什么理由?" 4. **评估应对**:对每个质疑,评估当前方案是否有应对,如果没有,是需要补充还是可以接受风险 ### 质疑结果记录格式 | 质疑角度 | 质疑内容 | 当前应对 | 风险等级 | 处理建议 | |---|---|---|---|---| | [角色] | [具体质疑] | [方案中已有的应对/尚无应对] | [高/中/低] | [需补充方案/可接受风险/需回退重做] | ## 评审产出 将评审发现整理为 review.md,包含: - 三视角检查的关键发现和建议 - 多角度质疑的结果 - 风险清单及应对状态 - 需要回退修改的决策(如有)→ 同步追加到 decisions.mddesign/references/templates/guides/summary_guide_full.md3.1 KB87f9275cc974upstream ↗
# 设计总结生成指南(完整模式) > 本文件在结项模式触发时加载。指导如何从项目全程的决策记录和产出物中提炼设计总结。 ## 什么是设计总结 设计总结不是各步骤产出物的拼接,而是对整个设计过程的**反思性回顾**——提炼出决策逻辑、设计原则和可复用的经验。 好的设计总结应该能让未来的自己(或接手的人)快速理解:为什么方案长这样、关键取舍是什么、哪些是经过验证的决策、哪些仍有风险。 ## 生成步骤 ### 第一步:加载素材 读取以下文件: - 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`,通知用户项目完成。design/references/templates/guides/summary_guide_lite.md1.8 KB19051dd8b160upstream ↗
# 设计总结生成指南(轻量模式) > 本文件在结项模式触发时加载。指导如何从项目决策记录和产出物中生成简明设计总结。 ## 什么是设计总结 设计总结不是各步骤产出物的拼接,而是对整个设计过程的**反思性回顾**——提炼出关键决策和取舍逻辑。 好的设计总结应该能让未来的自己(或接手的人)快速理解:为什么方案长这样、关键取舍是什么、哪些仍有风险。 ## 生成步骤 ### 第一步:加载素材 读取以下文件: - decisions.md 全文——这是最核心的素材 - requirements.md(需求边界) - design.md(方案文档) - review.md(评审记录) ### 第二步:提炼决策链 从 decisions.md 中梳理关键决策,识别: - 哪些决策经历了反复或触发了回退——这些是最有价值的取舍 - 每个关键决策的核心权衡是什么 ### 第三步:标注风险和开放问题 从 review.md 的风险清单和 decisions.md 中汇总: - 已识别并已应对的风险(记录应对方案) - 仍然开放的问题(记录后续需要关注的点) ### 第四步:组装并保存 按以下结构组装设计总结: ``` # [设计主题] 设计总结 ## 设计概要 [一段话概括:设计了什么、解决什么问题、核心方案是什么] ## 关键设计决策 ### [决策1标题] - 决策:[选了什么] - 权衡:[考虑过什么、为什么放弃] (列出最重要的决策,通常 2-3 个) ## 风险与开放问题 | 类型 | 内容 | 状态 | 备注 | |---|---|---|---| | 已应对 | [风险] | [应对方案] | | | 开放 | [问题] | 待观察 | [后续关注点] | ## 后续方向 - [可能的优化或迭代方向] ``` 保存为 `summary_[topic_slug].md`,通知用户项目完成。design/references/templates/skill/full.md13 KBba0125fc68dcupstream ↗
--- 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 引导效果 - 哪些引导环节最有价值:[列举] - 哪些引导环节被跳过或感觉多余:[列举] - 模式选择是否合适:[合适 / 应该选另一个模式,原因] ## 方法论反馈 - 有向五步流程的实际效果:[评价] - 即时验证机制的实际效果:[评价] - 评审环节(系统评审 + 多角度质疑)的实际效果:[评价] - 回退机制的实际使用情况:[评价] - 文件管理是否顺畅:[评价] ## 改进建议 - [具体建议] ```design/references/templates/skill/lite.md11 KB0e62cffb2bcbupstream ↗
--- 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 引导效果 - 哪些引导环节最有价值:[列举] - 哪些引导环节被跳过或感觉多余:[列举] - 模式选择是否合适:[合适 / 应该选另一个模式,原因] ## 方法论反馈 - 有向五步流程的实际效果:[评价] - 即时验证机制的实际效果:[评价] - 评审环节的实际效果:[评价] - 文件管理是否顺畅:[评价] ## 改进建议 - [具体建议] ```
Plain-text copy, no login: /skill-bundles/balancegsr-skill-creators-design.md