القائمة
Use for PACEflow-managed coding work: create, approve, resume, verify, close, or archive CHG/HOTFIX before project file edits.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use for PACEflow artifact fields and formats: task indexes, CHG/HOTFIX lifecycle operations, artifact-writer prompts, approvals, verification, and archive.
Use for PACEflow internal full audit: run five independent review agents, verify evidence from code/tests/logs, de-duplicate findings, and produce a severity-ranked report for release gates or comprehensive code review.
Use for PACEflow knowledge/thoughts notes, finding-to-knowledge extraction, correction knowledge links, and Obsidian frontmatter/L0-L2 note structure.
Use to bridge a confirmed Superpowers/native plan into PACEflow CHG/HOTFIX artifacts, create artifact-writer prompts, and mark the specific plan as synced.
| name | pace-workflow |
| effort | high |
| description | Use for PACEflow-managed coding work: create, approve, resume, verify, close, or archive CHG/HOTFIX before project file edits. |
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 命令来源按以下顺序执行：
node ".../hooks/*.js" 命令，直接复制那条命令。SKILL.md 所在目录）作为 <skill-root>。按当前动作选择下面一条模板运行；这不是顺序执行清单：node "<skill-root>/../../hooks/set-project-root.js" --mode independent
node "<skill-root>/../../hooks/set-artifact-root.js" --choice local
node "<skill-root>/../../hooks/set-artifact-root.js" --choice vault
node "<skill-root>/../../hooks/reserve-artifact-id.js" --operation create-chg --cwd <项目 cwd>
~/.claude/plugins/cache 猜版本。PACEflow 一旦启用（hook 检测到信号 / 有 artifact），写代码文件就由写码门强制走 CHG，没有豁免——唯一合法的停用是下面两个用户命令，不是 AI 绕过单次 deny。
被 PACE deny 拦住时，正确做法是走 PACE 流程（建 CHG / approve-and-start），不是 disable 绕过。/paceflow:disable（即 set-activation --disable）停用整个项目的 PACEflow，只在用户**明确表达「不想用 PACE 管理本项目」**时执行；AI 不得为绕过单次 deny 自主 disable。若判断用户可能想停用但用户未明说，先用 AskUserQuestion 确认，不自作主张。用户主动运行 /paceflow:disable 时直接执行，不再额外确认。
/paceflow:pause（即 set-activation --pause）是 session 级对应物：仅本 session 暂停流程门、artifact 完整性门保留、session 结束自动失效。防滥用约束同上且更严——AI 不得为绕过单次 deny 自行 pause，仅用户明确表达「本 session 不想要 PACEflow 约束」时执行；恢复用 /paceflow:resume。
参考：Superpowers/native plan 桥接细节见 references/superpowers-integration.md。
默认先用 Superpowers / native plan 完成方案探索；无可用规划工具时，主 session 自行完成需求拆解、风险识别和执行方案。
P 阶段产物：
pace-bridge 转成 CHG。CHG 不是大计划容器，而是连续执行、可独立验证、可独立回滚、可关闭的最小闭环单元——单个 CHG 自身就是一个能独立验证和回滚的完整变更，也能独立交给一个 worktree/session 执行。
close-chg 收尾。T-NNN，但这些任务必须服务于同一个闭环，限定在单个独立功能/模块内。调用 paceflow:pace-bridge。bridge 的职责是读取 plan，按上方 CHG 粒度原则拆成 N 个可闭环 CHG。拆出多个时优先一次性批量落地：reserve --operation create-chg --cwd <项目 cwd> --count N 取 N 个连号，再用一次 batch create（共享 change-set / change-set-total 头部 + N 个 --- CHG i/N --- 块）派 artifact-writer（详见 pace-bridge skill「批量创建」），避免「执行完一个才建下一个」把后续阶段规划只留在 session 上下文。生成：
changes/chg-yyyymmdd-nn.mdtask.md wikilink 索引（唯一 CHG 索引）Superpowers/native plan 中用户已参与设计且确认开始时，bridge 只对当前准备连续执行的 CHG继续派 update-chg action=approve-and-start，并带 approval-confirmed/source/evidence/task-id，形成 auto-APPROVED + 首个任务开始。后续 CHG 保持 planned，等真正开始时再批准/开始。
主 session 先预留编号，再组织字段派 artifact writer。优先使用 SessionStart / PreToolUse 提示中的 reserve helper 完整命令；如果上下文没有完整命令，按上方 helper 命令来源从当前 skill 根目录拼出同版本绝对路径。
node "<SessionStart/PreToolUse 输出的 reserve-artifact-id.js 绝对路径>" --operation create-chg --cwd <项目 cwd>
# 若没有 hook 输出但本 skill 已加载：
node "<skill-root>/../../hooks/reserve-artifact-id.js" --operation create-chg --cwd <项目 cwd>
HOTFIX 必须在预留时声明类型：
node "<SessionStart/PreToolUse 输出的 reserve-artifact-id.js 绝对路径>" --operation create-chg --cwd <项目 cwd> --type hotfix
# 若没有 hook 输出但本 skill 已加载：
node "<skill-root>/../../hooks/reserve-artifact-id.js" --operation create-chg --cwd <项目 cwd> --type hotfix
同一 session 默认复用尚未消费的 create-chg reservation。若已经预留过普通 CHG，现在要创建 HOTFIX，或确实需要第二个新编号，重新运行 helper 时加 --new：
node "<SessionStart/PreToolUse 输出的 reserve-artifact-id.js 绝对路径>" --operation create-chg --cwd <项目 cwd> --type hotfix --new
# 若没有 hook 输出但本 skill 已加载：
node "<skill-root>/../../hooks/reserve-artifact-id.js" --operation create-chg --cwd <项目 cwd> --type hotfix --new
将 helper 输出的 artifact_dir / operation / execution-context / reserved-id / reserved-file-prefix 原样放在 Agent prompt 顶部，再追加：
title: <变更标题>
tasks:
- T-001: <任务标题与验收>
- T-002: <任务标题与验收>
background: <Why>
scope: <What>
technical-decision: <How>
A 阶段完成标志：task.md 有活跃 [[chg-*]] / [[hotfix-*]] 索引，且 changes/<id>.md 存在。
若没有先运行 helper，create-chg 首次派遣会被 hook 阻止并返回 reserved-id / reserved-file-prefix；把这些字段原样加入 Agent prompt 后重派，编号一律来自 helper 预留。
检测到 v5 时代 artifact 布局（task.md 含活跃详情、无 changes/）时只会收到一句布局提示：新变更直接按当前合同走 create-chg（首次创建即建出 changes/），v5 存量内容保持原样、不迁移；如需保留历史，可建议用户手动归档到 <!-- ARCHIVE --> 下方。
Git worktree 中的 artifact root 与运行态 .pace/ 归一到宿主项目。普通子目录默认继承最近父级 Project Root。主 session 修改普通项目文件仍以当前 cwd/worktree 为准；只有 PaceFlow artifacts 与 .pace 运行态走 Project Root 共享位置。.pace/artifact-root 只由 set-artifact-root helper 写入；git worktree 与继承父 Project Root 的子目录走宿主项目共享位置。独立子项目先用 set-project-root --mode independent 声明边界。
改代码前先获批准：<!-- APPROVED --> 已写入 changes/<id>.md 且对应任务为 [/]。
需要用户确认时，先停止执行并询问是否批准当前 CHG。用户批准且准备开始时派 update-chg action=approve-and-start，必带 task-id、approval-confirmed: true、approval-source（user-directive | ask-user-question | accepted-plan | prior-approved-plan）、approval-evidence（用户原话或已确认方案摘要）；完整字段模板见 Skill(paceflow:artifact-management)「最小字段模板」。
若只是先批准、暂不执行，则派 update-chg action=approve，同样必须带 approval-confirmed: true、approval-source、approval-evidence。C 阶段批准标记只写入 changes/<id>.md；task.md 只保留索引，不承载批准标记。
如果用户已经直接要求“开始做/按方案执行/继续实现”，或已通过 plan/AskUserQuestion 明确批准，可以把这句话或确认摘要作为 approval-evidence；仍先派 approve-and-start 再写代码，让 C 阶段先行完成。
需要 AskUserQuestion 确认批准时，提供 2-3 个互斥选项，例如“批准并开始”与“暂不执行”。
PreToolUse 放行条件：活跃 CHG 在 task.md 存在，详情文件存在，已 APPROVED，且状态/checkbox 已进入可执行状态。APPROVED 标志 C 阶段完成；[ ] planned + APPROVED 属 ready/deferred，写项目文件前先 approve-and-start 或恢复为 [/] 进入 in-progress。
[!] 是 blocked/deferred：
按 CHG 的 ## 任务清单 连续执行代码修改。默认路径是：批准并开始 → 写代码/测试 → 运行并读取验证 → close-chg complete-open-tasks:true 一次收口。同一个连续 CHG 的多个 T-NNN 由这一次 close-chg 统一收口；update-status 仅在暂停/阻塞/跳过/跨 session 时单独调用。
| 场景 | agent 操作 |
|---|---|
| 批准并开始当前 CHG | update-chg target=CHG-... action=approve-and-start ... task-id=T-NNN |
| 连续执行完成且验证已通过 | close-chg target=CHG-... verification-confirmed=true complete-open-tasks=true implementation-notes=<per-task 实施说明> |
| 用户要求暂停/先停/等待外部信息 | update-chg target=CHG-... section=tasks action=update-status task-id=T-NNN new-status=[!] status-reason=<原因> |
| 跨 session 前记录已完成任务 | update-chg target=CHG-... section=tasks action=update-status task-id=T-NNN new-status=[x] |
| 已批准但暂不开始，后来单独开始某任务 | update-chg target=CHG-... section=tasks action=update-status task-id=T-NNN new-status=[/] |
| 任务跳过 | update-chg target=CHG-... section=tasks action=update-status task-id=T-NNN new-status=[-] |
| 任务阻塞 | update-chg target=CHG-... section=tasks action=update-status task-id=T-NNN new-status=[!] status-reason=<原因> |
| 补充实施说明 | update-chg target=CHG-... section=implementation action=append |
| 记录执行过程 | update-chg target=CHG-... section=work-record action=append |
update-status [!] 仅表示暂停/阻塞，保持任务待恢复，其他 worktree 仍需显式接手。恢复前先确认用户意图，再把任务重新标为 [/] 继续，或按用户决策标 [-] / 取消。
update-status [x] 是跨 session/非连续任务记录的例外路径；连续执行的默认路径是 close-chg。最后一个任务代码写完后，先运行验证并读取结果，验证通过后用 close-chg complete-open-tasks=true 一次收口（由它收尾最后任务，无需先派 update-status）。若暂时不准备验证或必须把进度留给后续 session，才用 update-status [x] 把进度停在 completed 待验证状态。
方案根本性错误时：将当前任务标 [!]，停止写代码，重新说明偏差并回到 A/C；更新方案和重新批准也必须通过 artifact writer。
连续执行同一个 CHG 时，复用同一个 artifact-writer 省掉每次 fresh spawn 的规范重载：
Agent spawn，捕获返回的 agentId。SendMessage(to: <agentId>) resume 同一 agent，不重新 spawn。可选优化，不软化任何门：agentId 不可用（新 session / compact / agent 退出）或 SendMessage 失败 → 回退 fresh spawn；resume 时仍须带齐该 op 全部必填字段（agent 第三层仍校验）。create-chg 不走 resume（须 fresh spawn 过 reservation + 字段门取编号）。
先运行验证、读取结果，再声称完成。验证遵循 superpowers:verification-before-completion 的 IDENTIFY → RUN → READ → VERIFY → CLAIM；无测试框架时用可复现的手动命令或浏览器验证。验证失败必须修复后重新验证，不跳过。
验证通过不直接收口——先完成下面的 R（审计） 步骤，再派 close-chg 一并写 VERIFIED + REVIEWED + 归档。R 跑完后的收尾合并操作是派 close-chg，必带 verification-confirmed: true、complete-open-tasks: true、review-confirmed: true、review-source、review-findings（P0/P1/P2/P3 计数 + 各自处置 wikilink）、verify-summary、implementation-notes（per-task 实施说明）、walkthrough-summary；完整字段模板见 Skill(paceflow:artifact-management)「最小字段模板」。
implementation-notes 必填（与 verify-summary 同款内容字段，hook 缺失即拒绝）：close 前主 session 按任务整理实际改动说明，agent 据此写入 ## 实施详情 段 ### T-NNN 标题下——缺失则详情文件只剩创建时的规划态信息（Why/What/How），执行情况无从审计。update-chg action=verify（只记录验证暂不归档）不要求此字段。
artifact writer 会同时写：
[ ] / [/] 任务收口为 [x]，先推 frontmatter status: completed，最终归档为 status: archived## 实施详情 段各任务 ### T-NNN 执行态记录（来自 implementation-notes）verified-date: YYYY-MM-DDTHH:mm:ss+08:00changes/<id>.md 中紧邻 <!-- APPROVED --> 下一行的 <!-- VERIFIED -->reviewed-date 与紧邻 <!-- VERIFIED --> 下一行的 <!-- REVIEWED -->（R 阶段标记，详见下方 R 小节与 Skill(paceflow:artifact-management)）## 工作记录 验证摘要、## 审查记录 findings 处置task.md 归档索引与 walkthrough.md 完成索引若只记录验证、暂不归档，才派 update-chg action=verify。Stop hook 会在 AI 主动停止时阻止 completed 但未 verified 的 CHG 结束会话；已 verified 但未 reviewed 时同样拦截，要求先跑 R 审计（见下）。
R 是与 V 同构的一等流程步骤：CHG 收口前，主 session 对本 CHG diff 做一次对抗审计，把"审计这步跑过了"连同验证、归档一起记录。只强制审计步骤发生 + 记录，从不裁决代码质量。 审计挖出的 findings 走既有 HOTFIX / record-finding 处置，不卡 close（阻断-on-步骤，不阻断-on-结论）。
职责分层：R 是主 session 的编排活（派 review subagent、读报告、判断 findings 处置），不是 artifact-writer 的动作——artifact-writer 只在收尾时落 reviewed-date + <!-- REVIEWED --> + ## 审查记录 三项证据。完整通用方法论见 references/review-methodology.md。
验证通过后、派 close-chg 之前，按以下五步编排 R：
review-source: manual），不固化一套标准 agent。用 references/review-methodology.md 的七条内核 direct 所派 subagent，要求其输出 P0-P3 分级报告。
执行约束（硬性）：审计 subagent 必须 inline / foreground 派发（Task / Agent 工具同步等待），不可作为 background / detached 任务。inline 时主 session 阻塞在 tool call 上（mid-turn），审计必然在本轮收尾前返回；若错误派成 background，主 session 可能在审计在途时就 end-turn，撞上 Stop 的"未审计"拦截。
record-finding / won't-fix）。subagent 的 Phase 2 不替代这一步。细节见 references/review-methodology.md step 4。create-chg --type hotfix）修，或判定不修则记 won't-fix finding（record-finding 带 status: rejected + rejection-reason，落 [-]，不注入 SessionStart）；record-finding 进 backlog：actionable 待修留 [ ]（默认），已决定不修标 [-]（won't-fix，同样 status: rejected + rejection-reason）；record-finding 后评估该 finding 结论是否跨项目通用；通用则派 Skill(paceflow:pace-knowledge) 按「Findings → Knowledge 提取 SOP」沉淀到 knowledge/。主 session 给通用性初判 + 沉淀裁决，artifact-writer 只产出评估信号、不自主沉淀。close-chg（含 review-confirmed: true / review-source / review-findings）一把梭折叠 VERIFIED + REVIEWED + 归档；只想记录审计暂不归档时，才派 update-chg action=review。阻断语义：close 前必须"审计这步跑过并记录 findings 处置"（阻断-on-步骤），但绝不要求"P0/P1 修完"才放行 close（不阻断-on-结论）。审计挖出 5 个 P0 全部路由成 won't-fix，照样满足 REVIEWED。
被用户纠正（"不对" / "别这样" / "错了" / "我说的是" 等）时，与 PACE 阶段正交、随时触发：先判断该纠正是跨项目通用经验还是仅限当前项目，再派 artifact-writer record-correction 写入 changes/corrections/<id>.md 与 corrections.md 索引。必填 trigger-quote / wrong-behavior / correct-behavior / trigger-scenario / root-cause，并二选一提供 knowledge-link: [[note]]（通用：先在 knowledge/ 选定或新建笔记拿 wikilink）或 project-scope: project-only（仅本项目）。禁止仅口头承认而不持久化。双写 SOP 与通用性评估详见 Skill(paceflow:pace-knowledge)「Corrections 双写流程」。
已 verified 且只需单独归档时派 archive-chg，必带 target + walkthrough-summary（完整字段模板见 Skill(paceflow:artifact-management)「最小字段模板」）。
归档不是移动详情内容，也不是主 session 上移 <!-- ARCHIVE -->。归档由 artifact writer 完成：
status: archived + archived-datetask.md 索引行移动到 ARCHIVE 下方