pace-workflow

A workflow guide for PACEflow, a process for planning, approving, implementing, verifying, and closing tracked code changes or hotfixes.

In plain words
What is it for?
Use it before editing files in a PACEflow-managed project, and when creating, approving, resuming, verifying, closing, or archiving a change.
Why use it?
It keeps coding work documented and controlled when the project has PACEflow enabled, including the required task records and review steps.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/paceaitian/paceflow/pace-workflow
Any agent
npx skills add paceaitian/paceflow --skill pace-workflow
Clone the repo
git clone --depth 1 https://github.com/paceaitian/paceflow

Made for: Claude Code, Codex.

Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,465 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00035 $0.07465
Opus 5 $0.00017 $0.03733
Sonnet 5 $0.00007 $0.01493
Haiku 4.5 $0.00003 $0.00747

Measured 2d ago against content hash 8bb85ec578c1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

pace-workflow scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugin/skills/pace-workflow/SKILL.md · 279 lines

How it starts

The opening of the file, as written. The whole thing — 279 lines — stays where its author put it; the contents beside it link to each section on GitHub.

PACE 协议工作流程

artifact 由 artifact-writer agent 创建和维护。主 session 负责分析、执行代码、验证和向用户确认;artifact 写入动作统一派 agent。

本 skill 的定位:PACEflow 已启用后的流程引导(P-A-C-E-V-R)。要不要启用 PACE 不由本 skill 判断,而是 hook 在 SessionStart 确定性处理:强信号(有 changes/ artifact / .pace-enabled / artifact-root 配置)→ 自动门控;软信号(detectSoftSignal:3+ 代码文件 / manifest 文件 / dated-plan)→ 注入指示让 AI 在响应用户前用 AskUserQuestion 问用户是否启用。本 skill 被加载时,PACE 通常已启用或正在启用流程中——下面直接讲流程,不再判断「要不要用」。


适用范围

启用后遵循 P-A-C-E-V-R。artifact 写入统一派 artifact-writer agent,主 session 通过 agent 完成创建/更新。

在已触发 PACEflow 信号的项目中,代码修改任务即使只涉及 1-2 个文件,也先按本 skill 判断流程;收到代码任务立即按流程判断,在第一次 Edit 前进入 PACE。一旦启用,写代码文件由写码门强制走 CHG,无豁免(详见下方「disable 是用户退出权」)。

Artifact 根目录以 hook 注入或 PreToolUse 提示为准。artifact_dir 仅用于 PaceFlow artifacts:spec.md / task.md / walkthrough.md / findings.md / corrections.md / changes/**

Project Root 是 PACEflow 管理边界;local artifact root 表示 Project Root 本地目录,不是当前子目录。Current CWD 位于父级 Project Root 内时,沿用父项目 artifact、owner、Stop 和 .pace 运行态。若当前子目录确实是独立项目,先运行 hook 提示的 set-project-root helper(--mode independent),再选择 artifact root。

继续、恢复或收口已有 CHG 前,先 Read 对应 changes/<id>.md,确认 ## 任务清单、实施详情和 ## 工作记录;SessionStart 摘要只用于定位,不替代 CHG 详情。

spec.md 是 artifact root 内的项目事实文件,用于记录技术栈、依赖、配置、目录结构和编码约定等长期事实。它由主 session 按需要直接 Edit 维护,不派 artifact-writer,也不参与 CHG/HOTFIX 的批准、验证或归档流程。

若用户已经明确选择 Obsidian vault、本地项目目录或自定义 artifact 目录,但 artifact-root 配置尚未写入,正确做法是先运行 hook 提示的 set-artifact-root helper(--choice vault--choice local,或 --choice <绝对路径或相对 Project Root 路径>),再从目标项目 cwd 运行 reserve helper。helper 会写入权威 runtime 配置位置。.pace/artifact-root 只由 set-artifact-root helper 写入;git worktree 与继承父 Project Root 的子目录走宿主项目共享位置。helper 接受自身文档列出的参数;reserve 命令默认带 --cwd <项目 cwd> 锚定——Claude 主 session 的 Bash cwd 会在命令间漂移,不带 --cwd 时 reservation 可能写错 runtime(后续 artifact-writer 误报「无效或已过期」);其余 artifact/root/project 路径由 helper 自行解析。

Helper 命令来源按以下顺序执行:

  1. 如果 SessionStart / PreToolUse 已给出完整 node ".../hooks/*.js" 命令,直接复制那条命令。
  2. 如果当前项目还没有 PACEflow 信号,但本 skill 已加载,使用 Claude Code 加载本 skill 时提供的 skill 根目录(本 SKILL.md 所在目录)作为 <skill-root>。按当前动作选择下面一条模板运行;这不是顺序执行清单:

Read the full file on GitHub · 279 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 279 lines · 35 tokens per session scan A 8bb85ec578c1

Subscribe to this mod's changes

pace-workflow is a skill published in the GitHub repository paceaitian/paceflow (38 stars, last pushed 15d ago), licensed MIT. It adds 35 tokens to every session and 7,465 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

concord-relay

Keep this Grok session reachable by other Concord agents while idle.

Get-Concord-AI/concord-mcp · 18 tokens

elasticsearch-esql

Generate and execute ES|QL (Elasticsearch Query Language) queries from natural language and visualize results with Vega-Lite charts. Translates user intent into valid ES|QL queries, executes them against Elasticsearch, and can render professional data visualizations (bar, line, scatter, heatmaps, small multiples…

walterra/eddoapp · 98 tokens

eddo-todo

Todo and task management via Eddo MCP server. Use for tracking work items, remembering tasks, managing project todos and time tracking. Supports GTD workflow with contexts and actionability tags (next actions, projects, waiting, someday). Use this skill whenever you need to remember something, track progress, or…

walterra/eddoapp · 72 tokens

eddo-work

Structured work mode for implementing complex tasks with phases. Use when user says "what next?" followed by "let's work on this" or "start working". Provides REFINE, IMPLEMENT, REVIEW, COMPLETE, and GITHUBPR phases with gates and reflection checklists. Works with eddo-todo for task tracking.

walterra/eddoapp · 68 tokens

searxng-search

Web search and content extraction via SearXNG. No API keys, no rate limits. Available in containerized agents via the eddo-chat Docker network.

walterra/eddoapp · 38 tokens

bcc-plan-spar

BCC align+lock+review PLAN.md for one slice (no product code). Slash: /bcc-plan-spar · chat: bcc:plan-spar · "lock PLAN" · spar the plan. Args: rounds=N (auto-review cap), review=self|subagent|cli|auto|off. Grill until clear enough (no default Q&A quota). Hand off to bcc-clean-cut after human APPROVE.

bo-cao/breaking-coding-chaos · 91 tokens