pi-mainflow

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

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

安装

# 方式一：本地路径（开发/试用）
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//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（MIT）
• pi-mainflow 本体 MIT