{
  "markdown": "# PM Solution Design Skills\n\n> 把模糊需求推进成可评审、可执行的 PRD / 方案 Brief。\n\n[![version](https://img.shields.io/badge/version-2.0.1-2f6feb)](./CHANGELOG.md)\n[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)\n[![platforms](https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Codex%20%7C%20Cursor%20%7C%20Gemini%20CLI-6f42c1)](#支持平台)\n\n`pm-solution-design` 是面向产品方案和 PRD 写作的 Skill。它不是一个“模板填空器”，而是一套带流程、门禁和输出契约的方案设计工作流：先把问题讲清楚，再让方案站得住，最后交付能被评审和继续推进的文档。\n\n它不抢工程师的活：接口、数据模型、伪代码、具体人天和纯代码实现不在输出范围内。\n\n## 能力地图\n\n| 能力 | 它解决什么 |\n|---|---|\n| Flow Engine | 用 S0-S8 状态机推进需求澄清、方案生成和质量复核。 |\n| G1-G4 Gates | 守住问题定义、方案成立、执行契约和评审就绪四条质量线。 |\n| Output Contracts | 区分完整 PRD、方案 Brief 和快速草稿，避免输出形态混乱。 |\n| PM Practices | 覆盖取舍、灵感碰撞、场景泛化、业务规则设计、五态覆盖和执行基线。 |\n\n## 适用场景\n\n- 写 PRD、需求文档、产品方案。\n- 澄清一句话需求、老板想法或还没成形的功能点。\n- 规划新功能，并明确边界、状态、异常和验收标准。\n- 做方案取舍，让 trade-off 可以解释、可以复盘。\n- 梳理复杂规则，例如权限、边界品类、异步等待态、不可逆操作和错误下一步。\n\n## 工作流一览\n\n```text\n需求输入\n→ S0 Intake\n→ S1 Complexity Check\n→ S2 Mode Selection\n→ G1 Problem Definition\n→ S3 Output Scope Selection\n→ S4 Ideation\n→ S5 Refinement\n→ G2 Solution Validity\n→ G3 Execution Contract\n→ G4 Review Readiness\n→ S6 Output Assembly\n→ S7 Quality Review\n→ S8 Final Report\n```\n\n四个门禁会决定文档能不能继续向后推进：\n\n- G1 问题定义：为什么做，边界是什么，成功如何判断。\n- G2 方案成立：核心流程、状态、五态覆盖、边界品类、业务规则设计、异常、权限、场景泛化是否成立。\n- G3 执行契约：用户故事、界面交互、异步等待态、不可逆确认机制、错误下一步、验收标准、测试场景是否可执行。\n- G4 交付可评审：输出是否能被评审、交接、继续推进。\n\n## 项目结构\n\n```text\nskills/pm-solution-design/\n  SKILL.md\n  prd-template.md\n  example-prd.md\n  references/\n    flow.md\n    loading.md\n    gates.md\n    output-scope.md\n    prd-contract.md\n    brief-contract.md\n    quality-review.md\n    practices/\n      ideation.md\n      refinement.md\n      trade-offs.md\n      scenario-generalization.md\n      business-rule-design.md\n      state-coverage.md\n      execution-baseline.md\n```\n\n核心文件分工：\n\n- `SKILL.md`：启动器和守门员。\n- `flow.md`：流程引擎和状态机。\n- `gates.md`：G1-G4 的准入、准出和失败处理。\n- `output-scope.md`：询问用户 PRD 包含或不包含哪些内容。\n- `prd-contract.md` / `brief-contract.md`：输出内容契约。\n- `practices/*`：灵感、精致打磨、取舍、场景泛化、业务规则设计、五态覆盖、执行基线。\n\n## 支持平台\n\n| 平台 | 配置文件 | 上下文入口 |\n|---|---|---|\n| Claude Code | `.claude-plugin/plugin.json` | `CLAUDE.md` |\n| Codex | `.codex-plugin/plugin.json` | `AGENTS.md` |\n| Cursor | `.cursor-plugin/plugin.json` | `.cursorrules` |\n| Gemini CLI | `gemini-extension.json` | `GEMINI.md` |\n\n## 安装方式\n\nClaude Code 推荐通过 Stayer Marketplace 安装；其他平台使用常规 `git clone` 获取仓库后，从本地路径安装或复制入口文件。\n\n### Claude Code\n\n通过 Stayer Marketplace 安装：\n\n```text\n/plugin marketplace add StayerYao/marketplace\n/plugin install pm-solution-design@stayer-marketplace\n```\n\n安装后使用 `/pm-solution-design:pm-solution-design`，或输入 PRD、需求文档、产品方案、功能规划等关键词触发。\n\n本地验证或临时使用时，也可以直接通过 `--plugin-dir` 加载当前仓库：\n\n```bash\nclaude --plugin-dir \"$PWD\"\n```\n\n通过 `--plugin-dir` 加载后，进入 Claude Code 运行 `/reload-plugins` 让插件生效。\n\n### Codex\n\n获取仓库代码：\n\n```bash\ngit clone https://github.com/StayerYao/PM-Solution-Design-Skills.git\ncd PM-Solution-Design-Skills\n```\n\n安装 skill 到本机 Codex skills 目录：\n\n```bash\nmkdir -p ~/.codex/skills\ncp -R skills/pm-solution-design ~/.codex/skills/\n```\n\n如果希望在某个项目中显式启用，把 `AGENTS.md` 复制到目标项目根目录，或将其中的 `pm-solution-design` 触发规则合并进目标项目已有的 `AGENTS.md`。Codex 会根据 `AGENTS.md` 和已安装的 skill，在相关需求场景下加载 `pm-solution-design`。\n\n### Cursor\n\nCursor 项目级使用时，先获取仓库代码，再将以下内容复制到目标项目根目录：\n\n```bash\ngit clone https://github.com/StayerYao/PM-Solution-Design-Skills.git\ncd PM-Solution-Design-Skills\n```\n\n```bash\ncp .cursorrules /path/to/your-project/.cursorrules\nmkdir -p /path/to/your-project/skills\ncp -R skills/pm-solution-design /path/to/your-project/skills/\n```\n\n如果你的 Cursor 版本支持插件目录，也可以保留仓库根目录结构，通过 `.cursor-plugin/plugin.json`、`.cursorrules` 和 `skills/` 作为插件入口。\n\n### Gemini CLI\n\n获取仓库代码：\n\n```bash\ngit clone https://github.com/StayerYao/PM-Solution-Design-Skills.git\ncd PM-Solution-Design-Skills\n```\n\n从本地路径安装到 Gemini CLI：\n\n```bash\ngemini extensions install \"$PWD\"\n```\n\n本地开发时可以改用链接方式，修改后无需反复安装：\n\n```bash\ngemini extensions link \"$PWD\"\n```\n\nGemini CLI 会读取 `gemini-extension.json` 中的 `contextFileName`，并加载 `GEMINI.md` 作为上下文入口。安装或更新扩展后，重启 Gemini CLI 会话让变更生效。\n\n### 手动复制\n\n如果你的客户端不支持插件目录，先获取仓库代码，再把以下文件复制到目标项目根目录：\n\n```bash\ngit clone https://github.com/StayerYao/PM-Solution-Design-Skills.git\ncd PM-Solution-Design-Skills\n```\n\n- `skills/pm-solution-design/`\n- 对应平台的上下文入口：`CLAUDE.md`、`AGENTS.md`、`.cursorrules` 或 `GEMINI.md`\n- 对应平台的配置文件：`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`.cursor-plugin/plugin.json` 或 `gemini-extension.json`\n\n## 升级方式\n\n### Claude Code\n\n```text\n/plugin marketplace update stayer-marketplace\n/plugin update pm-solution-design@stayer-marketplace\n```\n\n更新后重启 Claude Code，或重新进入会话让新版插件生效。\n\n### Codex\n\n```bash\ncd PM-Solution-Design-Skills\ngit pull\ncp -R skills/pm-solution-design ~/.codex/skills/\n```\n\n如果目标项目使用了本仓库的 `AGENTS.md`，同步复制或手动合并新版 `AGENTS.md`。\n\n### Cursor\n\n如果使用项目级复制安装，重新获取仓库最新代码后覆盖目标项目中的同名文件：\n\n```bash\ncp .cursorrules /path/to/your-project/.cursorrules\ncp -R skills/pm-solution-design /path/to/your-project/skills/\n```\n\n### Gemini CLI\n\n```bash\ncd PM-Solution-Design-Skills\ngit pull\ngemini extensions install \"$PWD\"\n```\n\n如果是通过 `gemini extensions link \"$PWD\"` 链接的本地开发目录，更新本仓库代码后重启 Gemini CLI 会话即可。\n\n## 本地评估\n\n```bash\nnpm test\n```\n\n或直接运行：\n\n```bash\n./evals/test-eval-suite.sh\n```\n\n真实模型评估：\n\n```bash\n./evals/run-eval.sh\n./evals/run-eval.sh complex-rules\n```\n\n## License\n\nMIT\n",
  "bytes": 5248,
  "sha": "6a034555f8c3189e3361f0e25ae3a0ca6c60672919983a804692bed79a3961f9",
  "repo_slug": "stayeryao/pm-solution-design-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_stayeryao_pm_solution_design_skills_45f4cc8d/readme"
}