🌐 中文 | English
给 Claude Code 项目一个稳定的研发节奏——需求在变，节奏不乱。
Claude Code 的研发节奏 harness——用规则、Schema、门禁和反馈循环，让 AI 辅助开发可追溯、可度量。
使用 Claude Code 做产品开发时：
| 问题 | 没有 devpace | 有 devpace |
|---|---|---|
| 需求一变就乱 | "加个功能"导致连锁混乱，没人知道影响范围 | 影响分析 + 有序调整，Claude 不会自作主张改计划 |
| 质量时好时坏 | Claude 有时跳过测试、忘了检查 | 自动检查 + 人类审批，质量关卡不可跳过 |
| 做着做着偏离目标 | 技术工作和业务目标脱节，做了很多但价值不清 | 从业务目标到代码变更，始终可追溯 |
| 每次开会话都要重新解释 | 手动方案需 8 次用户纠正（3 次中断实测） | 自动恢复上下文，0 次纠正 |
/pace-init ← 初始化（只需一次）
"帮我实现用户认证" ← Claude 自动跟踪任务、写代码、跑测试、检查质量
"审批" 或 "打回" ← 你决定是否合并
"加一个导出功能" ← Claude 分析影响、调整计划、等你确认
"认证先不做了" ← 影响分析 → 暂停（保留工作）→ 调整计划
下次开会话，Claude 自动报告："上次停在认证模块，继续？"——零手动解释。
机会 ──→ 专题 ──→ 需求 ──→ 功能 ──→ 代码变更 ──→ 质量 ──→ 发布
│ │ │ │ │ │ │
pace-biz pace-biz pace-biz pace-plan pace-dev pace-review pace-release
pace-change pace-feedback
需求随时可变——/pace-change 自动分析影响、调整计划、等你确认。
每轮结束后，/pace-retro 展示质量指标和改进趋势。
devpace 在你的项目中构建一条从目标到代码的追溯链：
- 目标对齐 —— 每个代码变更都关联到业务目标。没有目的的工作不会发生。
- 自动质量门禁 —— Claude 自动检查代码质量和需求一致性，失败自动修复。人类审批不可跳过。
- 变更是常态 —— 需求变了？自动影响分析，有序调整，已有工作保留。
- 中断无忧 —— 会话断了？下次自动恢复。所有状态在
.devpace/中，纯 Markdown。
底层机制：一个 Claude Code Plugin，通过 Rules（行为准则）+ Skills（/pace-* 命令）+ Hooks（关键时刻自动触发）实现。
前置条件：需先安装 Claude Code CLI。
# 第一步：注册 marketplace（仅需一次）
/plugin marketplace add arch-team/devpace-marketplace
# 第二步：安装
/plugin install devpace@devpacegit clone https://github.com/arch-team/devpace.git
claude --plugin-dir /path/to/devpace安装后在 Claude Code 中输入 /pace-，如果 devpace 加载成功，会看到 /pace-init、/pace-dev、/pace-status 等自动补全建议。
大多数时候不需要敲命令——说"帮我实现 X"等于 /pace-dev，说"做到哪了"等于 /pace-status。
| 命令 | 作用 |
|---|---|
/pace-init |
首次初始化（只需一次） |
/pace-dev |
开始写代码——或者直接说"帮我实现 X" |
/pace-status |
看进度——或者说"做到哪了" |
/pace-review |
审批变更 |
/pace-next |
不确定做什么时，看 AI 推荐的下一步 |
随着项目发展，devpace 提供变更管理、迭代规划、业务对齐、发布编排等更多能力。查看用户指南了解全部 19 个命令。
常用：/pace-change（需求变了）· /pace-plan（规划迭代）· /pace-retro（复盘度量）· /pace-biz（业务规划）· /pace-release（发布）
| 能力 | 说明 |
|---|---|
| 需求变更 | 加功能、暂停、改范围——自动分析影响，有序调整，Claude 不擅自改计划 |
| 复杂度感知 | 自动评估任务复杂度，小变更快速通过、大变更完整流程，复杂度漂移自动检测 |
| 技术债务管理 | tech-debt CR 类型 + 迭代容量预留 + 趋势追踪 |
| 架构决策记录 | /pace-trace arch 管理跨 CR 的 ADR（Architecture Decision Record） |
| 能力 | 说明 |
|---|---|
| 质量门禁 | 代码质量 + 需求一致性自动检查 + 对抗审查，人类审批不可跳过 |
| 目标追溯 | 从业务目标到代码变更，始终可追溯 |
| 测试验证 | 需求追溯驱动——策略生成、覆盖率分析、AI 验收验证、变更影响回归 |
| 语义漂移检测 | 开发过程中持续监控代码与需求的对齐度，Review 包含语义一致性评分 |
| 能力 | 说明 |
|---|---|
| 跨会话恢复 | 会话断了自动续上，零手动解释，经验跨会话持久化 |
| 迭代管理 | 规划 → 执行 → 回顾完整循环，自动推荐下一步 |
| 渐进自主性 | 辅助/标准/自主三级——新用户多引导，熟练用户少干预 |
| DORA 代理度量 | 部署频率/前置时间/失败率/MTTR 代理值，Elite~Low 基准分级 + 趋势对比 |
| CI/CD 感知 | 自动检测 CI 工具类型，Gate 4 自动查询 CI 状态，零配置即用 |
| 风险织网 | OWASP 安全扫描 + Pre-flight 5 维风险扫描 + Runtime 实时监控 + 分级自主响应（High 必须人类确认） |
| 交付预测 | AI 预测迭代交付概率、识别瓶颈、发出风险预警 |
| 跨项目经验 | 高置信度经验可导出/导入到其他项目，减少重复学习 |
- 探索模式（默认）：自由读代码、分析问题、讨论方案。不触发任何流程。
- 推进模式（改代码时）：自动创建任务，跟踪进度，检查质量。小变更快速通过、大变更完整流程。
不确定时 Claude 会问："要开始改代码，还是先看看？"
常规流程：
开始做 ──→ 在做 ──→ 待审批 ──→ 完成
│ │
质量自动检查 你来审批 自动合并 + 状态更新
（Claude 处理）（你决定）
随时：
需求变了 ──→ 影响分析 ──→ 调整计划 ──→ 继续
会话中断 ──→ 下次自动从断点恢复
完整循环（可选）：
规划 (pace-plan) → 开发 (pace-dev) → 回顾 (pace-retro) → 下一轮
| 原则 | 含义 |
|---|---|
| 零摩擦 | 说自然语言就能工作，不需要学术语 |
| 渐进暴露 | 默认输出 1 行，详情按需展开 |
| 副产物非前置 | 结构化数据是工作的自动产出，不是前置要求 |
| 中断容错 | 任意时刻中断，下次无缝恢复 |
| 维度 | GitHub Issues / 手动管理 | devpace |
|---|---|---|
| 核心模型 | 任务列表 | 目标 → 功能 → 代码变更追溯链 |
| 需求变更 | 人工评估影响 | 自动影响分析 + 有序调整 |
| Claude 的角色 | 执行者（你指挥每一步） | 自主协作者（自动推进、自检、等你决策） |
| 追溯性 | 任务 → 代码 | 业务目标 → 功能 → 变更 → 代码 |
| 度量 | 完成数量 | 质量通过率 + 价值对齐 + DORA 代理值 |
- 不是 CI/CD 流水线 —— 它与你现有的工具（GitHub Actions、Jenkins 等）并行工作
- 不是项目管理平台 —— 没有 Web 界面、没有团队功能，纯 CLI
- 不是 git 的替代品 —— 它在
.devpace/中创建 Markdown 状态文件，你的代码仍在 git 中管理
用过 devpace？告诉我们你的感受 —— 一个词或一份完整报告，都对我们有帮助。
- 用户指南 — 完整命令参考、工作模式、状态机细节（English）
- 端到端演示 — 从初始化到完成的完整示例（English）
- 贡献指南 — 开发环境、测试、PR 规范
- 更新日志 — 版本历史（英文摘要见 GitHub Releases）
- 问题排查 — 搜索已知问题或提交新 Issue
MIT