# pi-mainflow

Matt Pocock 主流程编排器（pi 扩展）。把 **setup → grill-with-docs → to-spec → to-tickets → implement → code-review** 六阶段主流程做成状态机，每阶段自动加载对应 pi 技能。

**一键安装 = 扩展 + 10 个适配技能全部就位（含 Clean Architecture 词汇层 architecture-standards）**（技能已随包分发，无需单独安装）。

## 安装

```bash
# 方式一：本地路径（开发/试用）
pi install ./pi-mainflow

# 方式二：npm（发布后）
pi install npm:pi-mainflow

# 方式三：git（仓库发布后）
pi install git:github.com/YOUR_USERNAME/pi-mainflow

# 临时试用（不写入设置）
pi -e ./pi-mainflow
```

安装后 `pi list` 应能看到 `pi-mainflow`，**新会话或 `/reload`** 生效。

## 使用

```
/flow begin        # 开始主流程 → 进入 setup 阶段（自动触发 agent 回合）
/flow advance      # 完成当前阶段，进入下一阶段
/flow goto <stage> # 跳转到指定阶段（setup|grill|spec|tickets|implement|review|done）
/flow reset        # 重置流程
/flow              # 查看状态（TUI 里可弹选择器跳转）
```

agent 每回合自动注入 `[MAIN FLOW ACTIVE]`（当前阶段 + 技能文件路径 + 推进方式），完成后调 `flow` 工具 `advance`。

## 阶段映射

| 阶段 | 技能 | 产出 |
|---|---|---|
| setup | setup-matt-pocock-skills | docs/agents/issue-tracker.md（每个仓库一次） |
| grill | grill-with-docs（自动带 domain-modeling） | CONTEXT.md + ADRs |
| spec | to-spec | spec 文件（默认本地 .scratch/specs/） |
| tickets | to-tickets | .scratch/<feature>/issues/ 票文件（默认本地） |
| implement | implement（自动带 tdd） | 代码 + 测试 |
| review | code-review | 双轴并行 subagent 审查（Standards + Spec） |

## 随包技能（10 个）

`grilling` / `domain-modeling` / `grill-with-docs` / `architecture-standards` / `to-spec` / `to-tickets` / `implement` / `code-review` / `tdd` / `setup-matt-pocock-skills` —— 全部已适配 pi（斜杠命令引用改为按技能名、GitHub tracker 发布改为本地文件模式默认、code-review 子代理改为 pi 的 `subagent` 工具）。

## 说明

- 源码与适配细节：`docs/pi-extension-dev.md`、`docs/pi-skill-adaptation.md`
- 原版技能来自 [mattpocock/skills](https://github.com/mattpocock/skills)（MIT）
- `pi-mainflow` 本体 MIT