本文介绍 PhSpec 的常见工作流模式及各命令的使用时机。基础配置见 入门，命令详情见 命令。
传统工作流把人锁在「先规划、再实现、然后结束」的阶段里，真实工作往往不是这样。
OPSX 的做法是：
传统（阶段锁定）：
规划 ────────► 实现 ────────► 完成
│ │
│ 「不能回头」 │
└──────────────┘
OPSX（灵活动作）：
提案 ──► 规范 ──► 设计 ──► 任务 ──► 实施
要点：
- 动作而非阶段 — 命令是可执行的动作，不是被锁死的阶段
- 依赖是「可做」 — 表示可以创建什么，而不是必须下一步做什么
自定义： OPSX 工作流由定义制品顺序的模式驱动。创建自定义模式见 自定义。
目标清晰、只需执行时：
/phsx:new ──► /phsx:ff ──► /phsx:apply ──► /phsx:verify ──► /phsx:archive
适合： 中小功能、修 bug、简单变更。
需求不清或需要先调研时：
/phsx:explore ──► /phsx:new ──► /phsx:continue ──► ... ──► /phsx:apply
适合： 性能优化、排查问题、架构决策、需求不明确。
同时推进多个变更：
变更 A: /phsx:new ──► /phsx:ff ──► /phsx:apply（进行中）
│
切换上下文
│
变更 B: /phsx:new ──► /phsx:ff ──────► /phsx:apply
多个变更都完成后，可用 /phsx:bulk-archive 一次性归档。批量归档会检测多个变更是否改同一规范，并通过检查实际实现来化解冲突。
适合： 并行多条线、紧急插入、团队协作。
推荐收尾流程：
/phsx:apply ──► /phsx:verify ──► /phsx:archive
│ │
校验实现 需要时提示同步
/phsx:verify 从三个维度校验实现与制品是否一致：完整性（任务与需求是否都落地）、正确性（实现是否符合规范意图）、一致性（设计是否体现在代码中）。校验不会阻止归档，但会暴露建议先处理的问题。
/phsx:archive 完成变更并移入归档。若增量规范尚未同步到主规范，会提示是否同步。任务未完成时仍可归档，但会给出警告。
审查命令用于在实施过程中进行质量检查，帮助发现问题并改进制品质量。
检查规格的完整性、清晰度、可实施性和可测试性。
使用时机：
- 完成规范后、实施前
- 发现实施困难，需要回溯规格质量
- 归档前进行最终质量检查
检查维度：
- 完整性：是否包含所有必需章节
- 清晰度：语言是否明确无歧义
- 可实施性：技术方案是否可行
- 可测试性：是否可验证和测试
验证代码实现与规格的一致性，检查功能正确性、错误处理等。
使用时机：
- 实施过程中检查代码质量
- 发现 bug 时分析原因
- 归档前确认代码符合规范
检查维度：
- 功能正确性：是否满足规范要求
- 错误处理：是否正确处理异常情况
- 边界条件：是否处理边界和边缘情况
- 非功能需求：性能、安全性、可维护性
- 规范漂移：代码是否与规范保持一致
检查设计方案与规格的关联性，评估设计质量。
使用时机：
- 完成设计后、实施前
- 实施中发现设计问题
- 归档前确认设计符合规范
检查维度：
- 设计遵循度：实现是否遵循设计决策
- 设计连贯性：设计决策是否内部一致
- 架构对齐：设计是否与系统架构对齐
- 可追溯性：设计是否能追溯到规格需求
- 设计完整性：设计是否覆盖所有规格需求
/phsx:new ──► /phsx:ff ──► /phsx:review-spec ──► /phsx:review-design
│ │
▼ ▼
调整规格 调整设计
│ │
└────────┬───────────┘
▼
/phsx:apply ──► /phsx:review-code
│
▼
/phsx:verify ──► /phsx:archive
| 情况 | 使用 |
|---|---|
| 需求清晰、准备开干 | /phsx:ff |
| 在探索、希望每步都审阅 | /phsx:continue |
| 想先打磨提案再写规范 | /phsx:continue |
| 时间紧、要快速推进 | /phsx:ff |
| 变更复杂、希望更多控制 | /phsx:continue |
经验法则： 能 upfront 说清范围就用 /phsx:ff；边做边摸清就用 /phsx:continue。
在既有变更上更新当： 意图相同、执行更精炼；范围收窄（先 MVP）；因对代码库的新认识做修正；根据实现发现微调设计。
新建变更当： 意图根本改变；范围扩大到完全不同的工作；原变更可独立「完成」；在原有上打补丁反而更乱。
phspec list 是否好用取决于变更名。推荐：add-dark-mode、fix-login-redirect；避免：feature-1、update、changes、wip。
完整说明与选项见 命令。
| 命令 | 用途 | 使用时机 |
|---|---|---|
/phsx:explore |
梳理想法 | 需求不清、需要调研 |
/phsx:new |
启动变更 | 任何新工作的开始 |
/phsx:continue |
创建下一制品 | 逐步创建制品 |
/phsx:ff |
创建全部规划制品 | 范围清晰、准备实施 |
/phsx:apply |
实施任务 | 准备写代码 |
/phsx:review-spec |
审查规格 | 规范完成后、实施前 |
/phsx:review-code |
审查代码 | 实施中、归档前 |
/phsx:review-design |
审查设计 | 设计完成后、实施前 |
/phsx:verify |
校验实现 | 归档前、发现偏差 |
/phsx:sync |
合并增量规范 | 可选—需要时归档会提示 |
/phsx:archive |
完成变更 | 工作全部完成 |
/phsx:bulk-archive |
归档多个变更 | 并行工作、批量收尾 |