merge: feature/vision-obj-entity-upgrade → main

Vision/OBJ 元模型升级 + 技术增强 + OpenHands 借鉴 4 项增强

Author: arch-team

.claude/CLAUDE.md

@@ -90,6 +90,7 @@ devpace 分为两个独立层次，**产品层不得依赖开发层**：
   - 推荐使用流程：`SKILL.md`（权威）→ `user-guide.md`（文档派生）
   - 特性文档同步：各 `SKILL.md`（权威）→ `docs/features/<skill-name>.md`（文档派生）→ `docs/features/<skill-name>_zh.md`（翻译派生）
   - pace-next 信号摘要：`knowledge/signal-priority.md` + `knowledge/signal-collection.md`（权威）→ `skills/pace-next/SKILL.md` Step 2/3（内联摘要派生）→ `skills/pace-next/next-procedures-output-default.md`（命令引导派生）→ `docs/features/pace-next.md` + `pace-next_zh.md`（信号概览和示例派生）
+  - Schema→脚本规则同步：`knowledge/_schema/*.md`（权威）→ `scripts/validate-schema.mjs` RULES 注册表（派生）→ `scripts/collect-signals.mjs` 信号条件（派生）→ `scripts/compute-metrics.mjs` 指标公式（派生）
 - **pace-role 角色扩展清单**：新增角色时须同步以下文件（按顺序）：
   1. `skills/pace-role/role-procedures-dimensions.md`：角色定义表
   2. `skills/pace-role/role-procedures-switch.md`：别名映射

.gitignore

@@ -30,6 +30,9 @@ skills/*-workspace/
 # Playwright MCP
 .playwright-mcp/
 
+# devpace 运行时产物（不入库）
+.devpace/.pulse-cr-writes
+
 # 操作系统
 .DS_Store
 Thumbs.db

agents/pace-analyst.md

@@ -33,6 +33,16 @@ memory: project
 3. **趋势对比**：有历史数据时必须展示趋势变化（↑ ↓ →）
 4. **建设性建议**：问题分析后必须附带改进建议
 
+## 记忆积累
+
+每次执行结束前，检查是否发现了值得记录的项目特定模式：
+
+- **度量基线**：各指标的历史均值和正常波动范围，用于趋势对比
+- **分析模式**：有效的数据切面组合、常用的对比维度
+- **经验规律**：已验证的因果关系（如"CR 粒度 > N 行时通过率显著下降"）
+
+记录原则：只记**数据支撑**的规律，不记单次观测。格式：一行一条，`[类别] 描述`。
+
 ## 决策边界
 
 | 决策类型 | 行为 |

agents/pace-engineer.md

@@ -33,6 +33,16 @@ memory: project
 3. **检查点纪律**：每个原子步骤后 git commit + 更新 CR + 更新 state.md
 4. **范围意识**：执行意图漂移检测，范围外文件占比 > 30% 时提醒
 
+## 记忆积累
+
+每次执行结束前，检查是否发现了值得记录的项目特定模式：
+
+- **编码模式**：测试框架选择、API 风格约定、错误处理惯例、依赖版本要求
+- **质量门经验**：Gate 失败的常见原因及修复方式
+- **陷阱记录**：实现中踩过的坑（环境差异、隐式依赖、边界条件）
+
+记录原则：只记**反复出现**或**代价较高**的模式，不记一次性细节。格式：一行一条，`[类别] 描述`。
+
 ## 决策边界
 
 | 决策类型 | 行为 |

agents/pace-pm.md

@@ -33,6 +33,16 @@ memory: project
 3. **数据驱动**：基于 project.md、iterations/current.md、dashboard.md 数据做判断
 4. **变更敏感**：识别需求变更信号，主动引导走变更管理流程
 
+## 记忆积累
+
+每次执行结束前，检查是否发现了值得记录的项目特定模式：
+
+- **规划模式**：迭代容量经验值、PF 拆分粒度偏好、排期估算偏差规律
+- **变更经验**：常见变更触发场景、影响评估中容易遗漏的维度
+- **决策惯例**：用户的优先级偏好、风险容忍度、沟通节奏
+
+记录原则：只记**跨迭代复现**的规律，不记单次决策细节。格式：一行一条，`[类别] 描述`。
+
 ## 决策边界
 
 | 决策类型 | 行为 |

docs/design/design.md

@@ -34,7 +34,7 @@ Phase 0 ─────→ Phase 1 ─────→ Phase 2A/2B ────
 
 横切：/pace-role（视角切换）· /pace-theory（理论参考）· /pace-status（任意阶段查询）· /pace-trace（决策轨迹）· /pace-guard（风险管理）· /pace-next（全局导航）
 
-价值交付链路：Opportunity → Epic → BR → PF → CR → merged（→ released，可选）（OBJ 关联 Epic）
+价值交付链路：Vision(北极星) → OBJ(北极星贡献, 双维度MoS) → Opportunity → Epic(主/副OBJ, 双维度MoS) → BR(双维度MoS) → PF → CR → merged（→ released，可选）
 溯源标记：<!-- source: user --> / <!-- source: claude, [原因] --> — 区分用户输入与 Claude 推断（HTML 注释，日常不可见）
 四个闭环：业务闭环(人类主导) → 产品闭环(人机协作) → 技术闭环(Claude 自治) → 运维闭环(人机协作，可选)
 状态机：created → developing → verifying → in_review → approved → merged → released（可选）（任意⇄paused）
@@ -142,18 +142,21 @@ vision.md 定义了三层护城河，设计优先级据此排列：
 devpace 使用五类作业对象构成价值交付链路：
 
 ```
-Opportunity (业务机会)  →评估→  Epic (专题)  →1:N→  BR (业务需求)  →1:N→  PF (产品功能)  →1:N→  CR (变更请求)
-  Claude 捕获              人机协作         人机协作              人机协作              Claude 创建
-                              ↑
-                         OBJ (业务目标)
-                          人类定义
+Vision (产品愿景)  →分解→  OBJ (业务目标)  →1:N(主)+副→  Epic (专题)  →1:N→  BR (业务需求)  →1:N→  PF (产品功能)  →1:N→  CR (变更请求)
+  人类定义                  人类定义                       人机协作         人机协作              人机协作              Claude 创建
+  北极星指标                北极星贡献                     双维度MoS        双维度MoS
+                           双维度MoS(客户/企业)
+                                                             ↑
+                                                   Opportunity (业务机会)
+                                                        Claude 捕获
 ```
 
-**双向追溯**：正向确保技术工作锚定业务价值，反向确保技术工作可追溯到业务目的。**溯源标记**增加第三维度——区分用户输入与 Claude 推断的内容，支持跨会话信任和纠正检测。**Epic 层增加了业务规划域的可追溯性——从 CR 可以追溯到 Epic 和 Opportunity，验证每一行代码都有业务来源。**
+**双向追溯**：正向确保技术工作锚定业务价值（Vision→OBJ→Epic→BR→PF→CR），反向确保技术工作可追溯到业务目的。**溯源标记**增加第三维度——区分用户输入与 Claude 推断的内容，支持跨会话信任和纠正检测。**Vision→OBJ→Epic 链路实现从代码到战略愿景的完整追溯**，验证每一行代码都有业务来源。**MoS 双维度**（客户价值 + 企业价值）渗透到 OBJ/Epic/BR 三层，确保价值链每一层都关注"对谁有价值"。
 
 | 实体 | 存储位置 | 创建者 | 状态管理 |
 |------|---------|--------|---------|
-| OBJ | project.md 业务目标 section | 人类 | MoS checkbox |
+| Vision | vision.md（始终独立） | 人类 | 核心愿景 + 北极星指标 + 战略上下文 |
+| OBJ | objectives/OBJ-xxx.md（始终独立） | 人类 | 6 类类型 + 双维度 MoS + 3 态（活跃/已达成/已废弃） |
 | Opportunity | opportunities.md | Claude 捕获/人类 | 评估中→已采纳/已搁置/已拒绝 |
 | Epic | epics/EPIC-xxx.md（始终独立） | 人机协作 | 规划中→进行中→已完成→已搁置 |
 | BR | project.md 树视图（溢出后 requirements/BR-xxx.md） | 人机协作 | 基于 PF 完成度自动计算 |
@@ -200,8 +203,10 @@ Opportunity (业务机会)  →评估→  Epic (专题)  →1:N→  BR (业务
 
 | 概念 | 初始形态（轻量） | 丰富后形态 | 存储位置演变 |
 |------|-----------------|-----------|------------|
+| Vision（产品愿景） | 桩文件（占位文字） | 核心四要素 + 北极星指标 + 战略上下文 | 始终在 vision.md |
+| OBJ（业务目标） | 标题 + 类型 + 基本 MoS | 完整双维度 MoS + 北极星贡献 + 关联专题表 | 始终在 objectives/OBJ-xxx.md |
 | Opportunity（业务机会） | 一句话描述 + 来源 | 评估结论 + 去向（Epic） + 详细来源 | 始终在 opportunities.md |
-| Epic（专题） | 标题 + OBJ 关联 + 背景 | 完整 MoS + BR 列表 + 完成度 + 时间框架 | 始终在 epics/EPIC-xxx.md |
+| Epic（专题） | 标题 + 主/副 OBJ 关联 + 背景 | 完整双维度 MoS + BR 列表 + 完成度 + 时间框架 | 始终在 epics/EPIC-xxx.md |
 | BR（业务需求） | project.md 一行（标题 + 标签） | 带业务上下文、成功标准、PF 列表 | project.md 内联 → **requirements/BR-xxx.md**（溢出） |
 | PF（产品功能） | CR 文件的 `功能:` 字段 + state.md 功能概览行 | 功能分组视图 + 用户故事 + 验收标准 + 边界定义、依赖关系、完成进度 | CR + state.md → project.md 功能视图 + 功能规格 → **features/PF-xxx.md**（溢出） |
 | CR（变更请求） | backlog/CR-*.md 基础信息 + 意图（用户原话） | 意图完整填充、质量检查记录、review 历史、关联信息 | 始终在 backlog/CR-*.md |
@@ -211,13 +216,13 @@ Opportunity (业务机会)  →评估→  Epic (专题)  →1:N→  BR (业务
 **追溯链从第一天就完整**，只是每层初期较轻量：
 
 ```
-目标（state.md 一行）→ 功能（CR 的功能:字段）→ CR → 代码（Git 分支）
+愿景（vision.md 桩）→ 目标（objectives/ 基本 MoS）→ 功能（CR 的功能:字段）→ CR → 代码（Git 分支）
 ```
 
 随迭代丰富为：
 
 ```
-业务机会（opportunities.md）→ 专题 + MoS（epics/）→ 业务目标 + MoS（project.md）→ 功能树（project.md）→ PF 详情（features/ 溢出后）→ BR 详情（requirements/ 溢出后）→ CR（backlog/）→ 代码（Git）
+产品愿景 + 北极星（vision.md）→ 业务目标 + 双维度 MoS + 北极星贡献（objectives/）→ 业务机会（opportunities.md）→ 专题 + 双维度 MoS（epics/）→ 功能树（project.md）→ BR 详情 + 双维度 MoS（requirements/ 溢出后）→ PF 详情（features/ 溢出后）→ CR（backlog/）→ 代码（Git）
 ```
 
 **文件结构：/pace-init 创建完整目录，内容从最小开始**：
@@ -226,7 +231,9 @@ Opportunity (业务机会)  →评估→  Epic (专题)  →1:N→  BR (业务
 /pace-init 生成完整目录结构（解决 C1：产出物与渐进丰富的一致性）：
 .devpace/
 ├── state.md          # 含业务目标行 + 功能概览（5-8 行）
-├── project.md        # 初始仅含基础业务目标和功能列表
+├── project.md        # 初始含愿景链接 + OBJ 索引表 + 功能列表
+├── vision.md         # 产品愿景（核心四要素 + 北极星 + 战略上下文）
+├── objectives/       # OBJ 独立文件（OBJ-xxx.md，6 类类型 + 双维度 MoS）
 ├── opportunities.md  # 业务机会看板（/pace-biz 时填充，可选）
 ├── epics/            # Epic 专题文件（/pace-biz 时填充，可选）
 ├── requirements/     # BR 溢出文件（信息量增长后自动溢出，可选）
@@ -238,8 +245,10 @@ Opportunity (业务机会)  →评估→  Epic (专题)  →1:N→  BR (业务
 └── integrations/     # 目录预创建，配置外部工具集成时填充（可选）
 
 内容渐进丰富（结构不变，内容增长）：
+vision.md   : 桩 → 核心四要素 → + 北极星指标 → + 战略上下文
+objectives/ : 基本 MoS → 完整双维度 MoS + 北极星贡献 + 关联专题
 state.md    : 5-8 行 → 超出 ~10 行时精简为摘要，引用 project.md
-project.md  : 基础列表 → 完整功能树 + MoS + 范围 + 原则 + 功能规格
+project.md  : 愿景链接 + OBJ 索引表 + 基础列表 → 完整功能树 + 范围 + 原则 + 功能规格
 backlog/    : 基础 CR → 完整意图 + 质量检查记录 + review 历史
 iterations/ : 空 → current.md（迭代进度）
 rules/      : 空 → checks.md（项目特有质量规则）
@@ -248,6 +257,29 @@ releases/   : 空 → REL-xxx.md（启用发布流程后填充，可选）
 integrations/: 空 → config.md（配置外部工具集成，可选）
 ```
 
+### MoS 双维度格式
+
+成效指标（MoS）在 OBJ、Epic、BR 三层统一使用双维度格式，区分"对谁有价值"：
+
+```markdown
+## 成效指标（MoS）
+
+**客户价值**：
+- [ ] [指标]（目标：[值]，当前：[值] → 进度 [N]%）
+
+**企业价值**：
+- [ ] [指标]（目标：[值]，当前：[值] → 进度 [N]%）
+```
+
+| 维度 | 关注点 | 典型指标 | 主要出现在 |
+|------|--------|---------|----------|
+| 客户价值 | 对用户/客户有价值的成果 | NPS、完成率、满意度、响应时间 | product/growth 类型 OBJ |
+| 企业价值 | 对企业/团队有价值的成果 | 收入、利润率、交付频率、合规率 | business/tech/efficiency 类型 OBJ |
+
+**向后兼容**：无维度标签的简单 checkbox 列表仍合法——Claude 遇到旧格式时按未分类处理，不强制升级。
+
+**度量链**：MoS 沿价值树向上聚合（BR MoS → Epic MoS → OBJ MoS → 北极星指标）。日常操作中度量链隐式存在（通过树结构推断），/pace-retro 时 Claude 自动生成贡献分析。
+
 **质量检查分级**：
 - **基础**（始终有）：编译通过 + 测试通过 + 项目 lint 规则
 - **完整**（有项目 `rules/` 时）：基础 + 项目特有质量规则
@@ -827,12 +859,19 @@ devpace/                           # Plugin 本体（可分发）
 target-project/.devpace/
 ├── state.md                   #   /pace-init 生成（始终存在）
 ├── project.md                 #   /pace-init 生成（初始基础，渐进丰富）
+├── vision.md                  #   /pace-init 生成桩（始终独立文件）
+├── objectives/OBJ-*.md        #   /pace-init 推断或 /pace-biz 创建
+├── opportunities.md           #   业务机会看板（/pace-biz 时填充）
+├── epics/EPIC-*.md            #   /pace-biz epic 创建（始终独立文件）
 ├── backlog/CR-*.md            #   推进模式中创建（type: feature/defect/hotfix）
+├── requirements/BR-*.md       #   BR 溢出后自动创建
+├── features/PF-*.md           #   PF 溢出后自动创建
 ├── iterations/current.md      #   有迭代节奏需求时填充
 ├── rules/                     #   需要项目特有质量规则时填充
 ├── metrics/                   #   需要度量报告时填充
 │   ├── dashboard.md           #     度量仪表盘（/pace-retro 更新）
 │   └── insights.md            #     经验积累（pace-learn 自动追加）
+├── risks/                     #   /pace-guard 风险管理时填充（可选）
 ├── releases/REL-*.md          #   启用发布流程后填充（可选）
 └── integrations/config.md     #   配置外部工具集成（可选）
 ```