From paceflow
Enforces PACE (Plan-Artifact-Check-Execute-Verify) workflow for complex tasks with 3+ file changes, new dependencies, architecture design, large refactors, or hotfixes. Auto-activates on triggers and integrates superpowers skills.
npx claudepluginhub paceaitian/paceflow --plugin paceflowThis skill uses the workspace's default tool permissions.
当任务满足触发条件时,执行此工作流程。
Bridges Superpowers plans (docs/plans/ or docs/superpowers/plans/) and Claude Code plans (~/.claude/plans/) to PACEflow task.md and implementation_plan.md artifacts with CHG/T IDs and structured tasks.
Executes work from plans, task packs, or prompts: triages input complexity, scans repos for patterns and tests, builds task lists, implements features while following conventions and maintaining quality.
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
当任务满足触发条件时,执行此工作流程。
flowchart TD
A[收到任务] --> B{符合豁免条件?}
B -->|是| C[跳过 PACE]
B -->|否| D{Hook 自动检测}
D -->|artifact 已存在| E[启用 PACE]
D -->|superpowers| E
D -->|.pace-enabled| E
D -->|3+ 代码文件| E
D -->|无信号| F{AI 自行判断}
F -->|满足条件| E
F -->|不满足| C
豁免条件详见 User Rule G-8。Hook 强制行为:
isPaceProject()四信号优先级artifact>superpowers>manual>code-count。
默认使用 brainstorming skill 探索设计空间:
invoke superpowers:brainstorming — 探索上下文 → 澄清需求 → 提出方案 → 展示设计 → 写计划文件到 docs/plans/。
P 阶段完成标志:docs/plans/ 中有新的计划文件。
降级条件(回退 PACE 原生规划):HOTFIX / 用户已给完整需求 / 用户说"直接做" / Superpowers 插件未安装。 降级时直接分析代码、识别依赖和风险,进入 A 阶段手动创建 artifacts。
详细 brainstorming 流程和搜索资源优先级见 references/superpowers-integration.md。
Superpowers 流程(P 阶段使用了 brainstorming):
invoke paceflow:pace-bridge — 自动读取 docs/plans/ 最新计划 → 生成 CHG-ID + T-NNN → 写入 implementation_plan.md(简称 impl_plan)+ task.md + <!-- APPROVED -->(auto-APPROVED)。
A 阶段完成标志:task.md 有活跃任务 + <!-- APPROVED --> + impl_plan 有 [/] 条目。
降级流程(P 阶段未使用 brainstorming):
task.md(按 paceflow:artifact-management 变更管理快速开始)implementation_plan.md(变更索引 + 详情段落,必须包含 4 段结构:背景+范围+技术决策+任务分解,详见 artifact-management 内容深度要求)findings 反向关联:变更源自 findings.md 调研时,在 finding 条目补 [change:: CHG-ID] + 状态 [x]。
Artifact 格式规范、Write/Edit 规则、CHG-ID 生成详见
paceflow:artifact-management。
Superpowers 流程:pace-bridge 已在 A 阶段自动标记 <!-- APPROVED -->,C 阶段被吸收,直接进入 E。
降级流程:停止执行,询问用户是否批准。获批后:
<!-- APPROVED -->,首个任务标 [/][ ] → [/]严禁批准前修改代码。
Hook 强制:PreToolUse 检查
<!-- APPROVED -->+[/]/[!]任务 + impl_plan[/]索引。缺少则 deny。
选择执行方式(根据任务特征选择 Superpowers skill):
| 条件 | 执行 skill |
|---|---|
| 有依赖/高风险/核心模块 | superpowers:executing-plans |
| 独立 task + 不同 domain | superpowers:dispatching-parallel-agents |
| 独立 task + 同 domain(默认) | superpowers:subagent-driven-development |
| 降级(HOTFIX / 简单任务) | 直接执行 |
Worktree 隔离、TDD 开发、finishing-branch 等详细执行策略见 references/superpowers-integration.md。
执行中维护:
task.md 进度([/] → [x])walkthrough.mdspec.md[P] 标记任务可并行分配给 subagent执行中检查:每 5 个子任务重读 task.md;对话超 20 轮重读核心 Artifact。
执行中纠偏(方案根本性错误时):
[!],停止写代码<!-- APPROVED -->[!] → [/] 恢复执行小范围调整(修改单个任务实现方式)不走纠偏流程,直接调整。
invoke superpowers:verification-before-completion — IDENTIFY → RUN → READ → VERIFY → CLAIM。
测试要求:API/数据处理/安全必须测试;业务逻辑建议测试;UI/一次性脚本可选。 无测试框架可通过 Terminal/Browser 手动验证,结果记录到 walkthrough.md。
验证任务规则:
T-NNN 验证修复效果)验证通过后:task.md 添加 <!-- VERIFIED -->(放在 APPROVED 下方)。
Hook 强制:Stop hook 检查
[x]无<!-- VERIFIED -->时 block。
验证完成后:执行 User Rule G-9 完成检查清单。
| 使用 PACE | 跳过 PACE |
|---|---|
| 多步骤任务(3+ 步骤) | 简单问答 |
| 研究型任务 | 单文件小修改 |
| 构建/创建项目 | 快速查询 |
| 涉及多次工具调用 | 纯文档/注释 |
详见 User Rule G-8。