ProjectGovernor
Cybernetic PDCA workflow skill suite for Claude Code.
把项目从需求冻结 → 流程设计 → 实体状态设计 → UI 设计 → 实现计划 → 阶段门禁 → 复盘升级串成一个闭环治理系统。底层原则采用控制论/反馈控制 + PDCA。
安装
前置依赖
ProjectGovernor 是纯编排层，实际工作委托给已有插件：
| 插件 | 安装命令 | 必要性 |
|---|
| Superpowers | claude plugin install superpowers | 必装（所有项目） |
| Everything Claude Code | claude plugin install everything-claude-code | 必装（所有项目） |
| Frontend Design | claude plugin install frontend-design | 仅 B 型项目（带 UI） |
安装 ProjectGovernor
claude plugin marketplace add zmyfrank/project-governor
claude plugin install project-governor@project-governor
重启 Claude Code 后生效。
项目类型
| 类型 | 适用场景 | 阶段路径 |
|---|
| A 型 (CLI/Agent) | 命令行工具、自动化脚本、Agent | 跳过 UI Design |
| B 型 (UI Product) | Web 应用、桌面应用、移动端 | 包含完整 UI Design |
两种使用模式
手动模式（默认）
每个阶段独立调用，完成后停下来等用户手动调下一个。适合需要仔细审查每个阶段产物的场景。
/project-governor:project-init
/project-governor:requirements-freeze
/project-governor:flow-design
# ... 逐个调用
自动模式（governor-run）
一条命令跑完所有阶段。project-init 时选 auto: true，之后每个阶段通过门禁后自动链式调用下一个阶段。
/project-governor:governor-run
也可以在任意中间阶段开始自动运行 — 如果部分阶段已完成，governor-run 会从第一个未完成的阶段开始继续。
注意： 自动模式不会跳过交互。requirements-freeze、flow-design、state-design 委托给 brainstorming，仍然会向用户提问。自动模式只是省去了手动调用每个阶段这一步。
调用流程
Type A（CLI/Agent 项目）
1. /project-governor:project-init ← 初始化项目，选 A 型
2. /project-governor:requirements-freeze ← 冻结需求规格
3. /project-governor:flow-design ← 设计流程/数据/错误流
4. /project-governor:state-design ← 设计实体状态机
5. /project-governor:implementation-plan ← 生成实现计划
6. /project-governor:stage-gate ← 跨阶段一致性验证
7. /project-governor:retrospective ← 复盘，决定迭代或关闭
└→ 迭代: 回到步骤 2 重新开始新一轮 PDCA
└→ 关闭: 项目治理结束
Type B（UI 产品项目）
1. /project-governor:project-init ← 初始化项目，选 B 型
2. /project-governor:requirements-freeze ← 冻结需求规格
3. /project-governor:flow-design ← 设计流程/数据/错误流
4. /project-governor:state-design ← 设计实体状态机
5. /project-governor:ui-design ← 设计 UI 屏幕/组件/导航
6. /project-governor:implementation-plan ← 生成实现计划
7. /project-governor:stage-gate ← 跨阶段一致性验证
8. /project-governor:retrospective ← 复盘，决定迭代或关闭
└→ 迭代: 回到步骤 2 重新开始新一轮 PDCA
└→ 关闭: 项目治理结束
自动模式（任意类型）
/project-governor:governor-run ← 一条命令跑完全部阶段
等效于手动模式中从当前未完成阶段开始依次调用所有后续阶段。
Hook 行为
安装后有两个 hook 自动生效，无需配置：
| Hook | 触发时机 | 行为 |
|---|
| phase-guard (PreToolUse) | 调用任意 governor skill 时 | 拦截：前置阶段未完成则阻止执行，并提示应先完成哪个阶段 |
| retro-trigger (PostToolUse) | stage-gate 完成后 | 提示：建议用户启动 retrospective（不强制） |
phase-guard 在手动模式下尤其有用 — 如果你跳步（比如还没做 requirements-freeze 就直接调 flow-design），会被拦截并提示。
每个阶段的内部 PDCA
每个阶段本身就是一个 Plan → Do → Check → Act 循环：
Plan → 定义本阶段目标 + 验收标准
Do → 委托现有 skill 执行（brainstorming / writing-plans 等）
Check → gate-checker agent 对照门禁清单验证
Act → PASS → 下一阶段 / FAIL → 回退到 Do 重做
自动模式下，Act 在 PASS 后直接调用下一个阶段，不等待用户指令。
产出物
所有产出物存储在项目的 docs/governor/ 目录下：
docs/governor/
├── project.yaml ← 项目元数据 + 阶段状态 + auto 标记
├── specs/ ← 需求规格 (YYYY-MM-DD-*-requirements.md)
├── flows/ ← 流程设计 (YYYY-MM-DD-*-flows.md)
├── states/ ← 状态设计 (YYYY-MM-DD-*-states.md)
├── ui/ ← UI 设计，仅 B 型 (YYYY-MM-DD-*-ui.md)
├── plans/ ← 实现计划 (YYYY-MM-DD-*-plan.md)
├── gates/ ← 门禁记录 (gate-*-*.md)
└── retros/ ← 复盘报告 (YYYY-MM-DD-*-retro-cycle-N.md)
依赖关系
每个 skill 委托给哪些现有 skill：
| Governor Skill | 委托目标 |
|---|
| requirements-freeze | superpowers:brainstorming |
| flow-design | superpowers:brainstorming |
| state-design | superpowers:brainstorming |
| ui-design | frontend-design:frontend-design |
| implementation-plan | superpowers:writing-plans |
| stage-gate | superpowers:dispatching-parallel-agents + superpowers:verification-before-completion |
| retrospective | everything-claude-code:continuous-learning-v2 + everything-claude-code:architecture-decision-records |
| governor-run | 无委托（编排层，依次调用上述 skill） |
快速开始
手动模式
# 1. 安装插件
claude plugin marketplace add zmyfrank/project-governor
claude plugin install project-governor@project-governor
# 2. 重启 Claude Code，进入你的项目目录
cd /path/to/your/project
claude
# 3. 初始化治理系统（选 auto: false）
/project-governor:project-init
# 4. 按提示逐阶段推进
/project-governor:requirements-freeze
/project-governor:flow-design
# ... 依次类推
自动模式
# 1. 安装插件（同上）
# 2. 重启 Claude Code，进入你的项目目录
cd /path/to/your/project
claude
# 3. 一条命令启动（init 时选 auto: true）
/project-governor:governor-run
文件结构
wshobson
Ratler
Chachamaru127
affaan-m
xhyqaq
obra