PAUL专项流程（SPECIAL-FLOWS）详解：如何声明并追踪自定义Skill的调用

PAUL 是一个面向 Claude Code 的结构化 AI 开发框架，通过 Plan-Apply-Unify 循环保证 AI 协作开发的质量。其中SPECIAL-FLOWS（专项流程）是它的进阶能力：让你把项目依赖的自定义 Skill（技能/命令）显式声明出来，并在开发循环中自动追踪这些 Skill 是否被真正调用过——解决"技能凭记忆随口调用、用完无法核查"的痛点。

为什么需要专项流程：技能"凭记忆调用"的四大隐患

很多用户会为自己积累一批专属技能，比如/revops-expert（营销文案专家）、/frontend-design（前端设计）。如果没有专项流程机制，会出现这些问题：

• ⚠️ 技能调用随机且不一致——这次用了，下次忘了
• ⚠️无法验证必需的技能是否真的被执行过
• ⚠️ 缺少差距分析，无法持续改进
• ⚠️ "哪类工作该用哪个技能"的知识只存在于人脑中

PAUL 的核心理念是：一个技能如果重要到需要被使用，就重要到值得被追踪。

四层联动机制：从声明到追踪的完整链路

SPECIAL-FLOWS 通过 PAUL 循环的四个环节层层强化，形成一条闭环链路：

SPECIAL-FLOWS.md → "本项目使用 X、Y、Z 技能" ↓ ROADMAP.md → "阶段 2 需要 X 技能" ↓ PLAN.md → "任务 2.1 调用 /frontend-design" ↓ UNIFY → "技能调用了吗？没调用就记录差距"

1. 声明：在SPECIAL-FLOWS.md中声明哪些技能适用于本项目
2. 阶段标注：在ROADMAP.md中为特定阶段标注必需技能
3. 任务调用：PLAN.md自动填入技能清单，执行前逐一确认
4. 验证：UNIFY阶段审计调用情况，记录差距

一键配置命令：/paul:flows 的四种用法

配置入口只有一个命令/paul:flows，支持三种子命令（详见 src/commands/flows.md）：

完整配置的引导流程（定义于 src/workflows/configure-special-flows.md）如下：

1. 检测现状——若已存在SPECIAL-FLOWS.md，提供"修改 / 重建 / 查看"三个选项
2. 发现可用技能——扫描~/.claude/commands/目录，列出环境中所有技能供你挑选
3. 建立映射——对每个选中的技能依次询问：什么工作类型触发它？是required还是optional？何时调用？
4. 阶段覆盖——询问某些阶段是否需要额外技能（如"阶段 3 需要特定框架技能"）
5. 模板与资产——登记 HTML 模板、外部文档等参考资源
6. 生成文件——写入.paul/SPECIAL-FLOWS.md，并在PROJECT.md中追加快速参考

💡 提示：即使环境中没有技能目录，也可以手动输入技能名称完成配置，流程不会中断。

SPECIAL-FLOWS.md 文件结构：五大区块详解

该文件由模板 src/templates/SPECIAL-FLOWS.md 生成，包含五个区块：

1. 项目级依赖（Project-Level Dependencies）

这是核心表格，声明全项目通用的技能映射：

两种优先级含义不同（详见 src/references/specialized-workflow-integration.md）：

• 📌required：UNIFY 阶段若未调用，会记录差距（Gap）
• 📎optional：仅供参考，不记录差距

2. 阶段覆盖（Phase Overrides）

为特定阶段追加技能，例如"阶段 3（定价页）需要/revops-expert:hormozi做价值堆叠"。

3. 模板与资产（Templates & Assets）

登记参考资源及其使用时机，如"Hero 模板 → templates/hero-section.html → 首页 Hero 区块"。

4. 验证清单（Verification Checklist）

UNIFY 阶段执行的三项确认：必需技能是否被调用、差距是否已写入STATE.md、有意偏离是否应更新为新的标准模式。

5. 修订历史（Amendment History）

记录每次修改的时间和原因，让技能配置本身也可追溯。

PLAN 与 APPLY 阶段：Skill 如何被强制加载

声明只是第一步，真正的"牙齿"在开发循环中：

📋 PLAN 阶段：运行/paul:plan时，框架会自动读取SPECIAL-FLOWS.md，把匹配当前工作类型的技能填入 PLAN.md 的<skills>区块（模板见 src/templates/PLAN.md 的 Skill Invocation Checklist），并弹出提醒："以下技能必须在 APPLY 前加载"。

🚦 APPLY 阶段：执行 src/workflows/apply-phase.md 时有一个阻断式检查——在任何任务执行前，逐一核对必需技能是否已在当前会话中调用：

• 全部加载 → 显示 "All required skills loaded"，继续执行
• 有缺失 → 直接阻断，列出缺失技能及运行命令，输入ready重新检查；如确需跳过，输入override，该操作会被记入STATE.md的决策记录

这样"忘记加载技能就开工"的情况从机制上被杜绝了。

UNIFY 阶段追踪：警告不阻断的差距审计

闭环的最后一环在 src/workflows/unify-phase.md 的 Skill 审计步骤中：

1. 读取SPECIAL-FLOWS.md中所有required技能
2. 回顾本阶段 APPLY 的会话记录，标记 ✓（已调用）或 ○（差距）
3. 发现差距时，写入STATE.md的 Deviations 区块，例如：

注意这里的设计取舍：差距只产生警告，不阻断 UNIFY。原因有二——钩子式自动追踪复杂且易漏报，人工审计更简单可靠；而且 PAUL 追求的是"持续改进"而非"刚性卡死"，你可以把有意偏离标注为 intentional deviation，甚至在未来将其升级为新的标准模式。

进阶：从差距数据中反哺流程

随着项目推进，SPECIAL-FLOWS 会自然沉淀出改进信号：哪些技能总被调用、哪些经常被跳过（也许该降级为optional）、哪些新技能该补充进来。当"有意偏离"成为常态时，按参考文档 src/references/specialized-workflow-integration.md 的建议更新配置并记录决策。

相关文件速查

常见问题

Q1：没有自定义技能也要配置 SPECIAL-FLOWS 吗？不需要。它是可选功能，文件不存在时 PLAN/UNIFY 会自动跳过相关步骤。

Q2：required 技能没加载会卡住整个循环吗？APPLY 会阻断等待你加载（或用override显式跳过）；但 UNIFY 阶段的差距审计只警告、不阻断。

Q3：如何审计某个阶段的技能要求？运行/paul:flows audit，它会读取SPECIAL-FLOWS.md与STATE.md的当前阶段，列出该阶段必需的项目级技能和阶段覆盖技能。

一句话总结：SPECIAL-FLOWS 让"哪个技能、何时必用"从个人记忆变成项目资产——声明在SPECIAL-FLOWS.md，执行前有阻断检查，收尾时有差距审计，全程可追溯。