@xulthekl/team-flow 0.58.0 → 0.60.0

package/.claude/always/phase-guard.md

@@ -1,3 +1,3 @@
-# team-flow v0.58.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.60.0 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback + business-analysis. 27 skills + 17 agents, one install.",
+  "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + workflow-orchestrator + workflow-bootstrap + e2e + session-handoff + workflow-feedback + business-analysis. 28 skills + 17 agents, one install.",
   "owner": {
     "name": "LT",
     "url": "https://github.com/LT"
@@ -8,8 +8,8 @@
   "plugins": [
     {
       "name": "team-flow",
-      "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback + independent business analysis. 27 skills + 17 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
-      "version": "0.58.0",
+      "description": "8-state spec workflow + compound global compounding + architecture-design (4A/DDD) + local HTML prototype + product-level orchestration + bootstrap + e2e + session handoff + workflow feedback + independent business analysis. 28 skills + 17 agents with embedded TDD, SDD, code review, debugging, delta spec sync, and design-system-driven prototyping.",
+      "version": "0.60.0",
       "source": "./",
       "author": {
         "name": "LT",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.58.0",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + design-system (design tokens + component contract + AI primer + showcase) + test-strategy (test strategy design) + project-initialize (new service onboarding). 27 skills + 17 agents, one install.",
+  "version": "0.60.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + design-system (design tokens + component contract + AI primer + showcase) + test-strategy (test strategy design) + project-initialize (new service onboarding) + jarvis (team-flow decision agent, opt-in). 28 skills + 17 agents, one install.",
   "source": "./",
   "author": {
     "name": "LT",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "version": "0.58.0",
+  "version": "0.60.0",
   "description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
   "author": {
     "name": "MageByte",
@@ -26,7 +26,7 @@
   "interface": {
     "displayName": "team-flow",
     "shortDescription": "Spec-first workflow with guarded execution.",
-    "longDescription": "A self-contained Codex workflow plugin with 27 skills for intent exploration, planning artifacts, execution contracts, TDD execution, review gates, systematic debugging, closure, delta spec sync, and independent business analysis.",
+    "longDescription": "A self-contained Codex workflow plugin with 28 skills for intent exploration, planning artifacts, execution contracts, TDD execution, review gates, systematic debugging, closure, delta spec sync, and independent business analysis.",
     "developerName": "MageByte",
     "category": "Developer Tools",
     "composerIcon": "./assets/icon.svg",

package/.cursor-plugin/marketplace.json

@@ -5,13 +5,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugin marketplace for Cursor (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.58.0"
+    "version": "0.60.0"
   },
   "plugins": [
     {
       "name": "team-flow",
       "source": ".",
-      "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + business-analysis. 27 skills + 17 agents."
+      "description": "Unified workflow plugin: team-flow + compound-engineering core subset + architecture-design + prototype + business-analysis. 28 skills + 17 agents."
     }
   ]
 }

package/.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "team-flow",
   "displayName": "team-flow",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact). 27 skills + 17 agents, one install.",
-  "version": "0.58.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + jarvis (team-flow decision agent, opt-in). 28 skills + 17 agents, one install.",
+  "version": "0.60.0",
   "author": {
     "name": "LT",
     "url": "https://github.com/LT"

package/.github/plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Unified workflow plugins and skills for AI coding agents (team-flow: team-flow + compound + architecture-design + prototype).",
-    "version": "0.58.0"
+    "version": "0.60.0"
   },
   "plugins": [
     {
       "name": "team-flow",
       "description": "Unified workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, delta spec sync, architecture-design, independent business analysis, and local HTML prototyping.",
-      "version": "0.58.0",
+      "version": "0.60.0",
       "source": ".",
       "author": {
         "name": "LT",

package/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md · team-flow
 
-> team-flow 统一插件 = **team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 Playwright E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，十二套能力协同（27 skills + 17 agents），支持 9 安装面（Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, Trae, ima-copilot）。
+> team-flow 统一插件 = **team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 Playwright E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，十三套能力协同（28 skills + 17 agents），支持 9 安装面（Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, Trae, ima-copilot）。
 
 ## What This Is
 
@@ -12,7 +12,7 @@
 
 ### 身份与依赖关系
 
-- **team-flow**（本插件）：Claude Code / Cursor 等宿主的插件实体（`plugin.json` name = `team-flow`），包含 27 个 skills + 17 个 agents + hooks + templates
+- **team-flow**（本插件）：Claude Code / Cursor 等宿主的插件实体（`plugin.json` name = `team-flow`），包含 28 个 skills + 17 个 agents + hooks + templates
 - **@xulthekl/team-flow**（npm 底座包）：team-flow 的 CLI 工具层（`package.json` name = `@xulthekl/team-flow`，bin = `tf` / `team-flow`），提供状态机、校验、复利 CLI 等运行时能力
 - 关系：team-flow 插件 **包含** @xulthekl/team-flow npm 包作为底座（同一仓库、同一版本）。skills 中的 `tf ...` 调用的是已全局安装的 @xulthekl/team-flow CLI，版本由 session-start hook 自动同步
 - 历史身份（已废弃）：`spec-superflow`（npm 包名，0.11.0 后停止发布）/ `ssf`（CLI 前缀）/ `.spec-superflow.yaml`（状态文件）—— 详见设计增强方案 v0.9 §27
@@ -33,7 +33,7 @@ node --test tests/e2e.test.mjs --test-name-pattern="parseDeltaSpec"
 npm run validate
 ```
 
-## 能力概览（十二套合一，27 skills）
+## 能力概览（十三套合一，28 skills）
 
 ### 1. team-flow（底座，11 skills）
 spec 驱动开发过程。8 态变更机：`exploring → specifying → bridging → approved-for-build → executing → closing`（另有 `debugging` 侧路径 + `abandoned` 终态）。
@@ -100,6 +100,11 @@ spec 驱动开发过程。8 态变更机：`exploring → specifying → bridgin
 - glaf4 体系走 glaf4-dev 的 PROJECT_INITIALIZE 模式；非 glaf4 走内置引导（B1.5 骨架生成）
 - 由 ARCH 后 Pre-check 服务初始化检测触发（缺失时引导接入）
 
+### 13. jarvis（1 skill，team-flow 决策代理，v0.59.0 新增 / v0.60.0 改名，**可选启用**）
+- 在授权范围内代做 team-flow 决策点裁决：布置任务并逐点预授权 → 经 Orca 派 worker 跑工作流 → 裁决可代答的点、其余 HOLD 等用户 → 交付决策过程汇总。**核心场景是夜间/离席值守，但不再限于此**——在场时亦可分流决策点，减少打断
+- 依赖**个人资产**：`~/.claude/lt-preferences/` 决策偏好库 + Jarvis home（各成员自建）
+- **不进任何默认流程**，需要的成员独立启用；设计文档见工作区 `docs/plan/jarvis-design.md`
+
 ## 全局产物结构（Discoverability —— 设计/开发前先检索）
 
 ```
@@ -184,7 +189,7 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
   全局作为下一 change / 下一 PRD 版本的 grounding → 闭环
 ```
 
-## Skills 索引（27 个）
+## Skills 索引（28 个）
 
 | Skill | 归属 | 用途 |
 |---|---|---|
@@ -215,6 +220,7 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
 | workflow-feedback | 工作流反馈 | 工作流问题结构化记录（v0.16.0） |
 | business-analysis | 独立业务分析 | 将任意输入整理为 requirement/vN/business-analysis.md（独立外挂，v0.44.0） |
 | project-initialize | 项目初始化引导 | 工作空间代码服务为空时：架构选择（glaf4/前端分离/单体微服务/拆分）→ 服务命名确认 → 创建服务子目录 → 委托初始化（glaf4 走 glaf4-dev，非 glaf4 走内置引导）（v0.45.0） |
+| jarvis | team-flow 决策代理（**可选启用**） | 在授权范围内代做 team-flow 决策点裁决（**夜间/离席值守**为核心场景，在场时亦可分流、只把 HOLD 项交回）；经 Orca 派 worker，依赖个人偏好库与 Jarvis home（v0.59.0 新增 / v0.60.0 改名） |
 
 ### 触发域分层（v0.12.0 新增）
 
@@ -225,7 +231,7 @@ STRATEGY.md CONCEPTS.md 产品策略(BA) / 领域词汇
 | 接入层 | workflow-bootstrap | "初始化/接入/分析代码库" | 一次性，触发词独特，无冲突 |
 | 产品级（唯一入口） | **workflow-orchestrator** | 新的产品级需求（"新需求/从头开始/我有个想法/做一个XX"） | 拥有所有"产品级新需求"触发词，内部路由到 ce-brainstorm/ce-plan |
 | 变更级（唯一入口） | workflow-start | change 上下文内的操作（.team-flow.yaml） | 有强上下文约束，与产品级天然隔离 |
-| 步骤级 - 独立工具 | ce-ideate, ce-strategy, ce-compound, ce-proof, architecture-design, prototype, e2e, session-handoff, workflow-feedback, **business-analysis** | 各自独特触发词 | 无冲突，可独立触发；business-analysis 不进入核心工作流 |
+| 步骤级 - 独立工具 | ce-ideate, ce-strategy, ce-compound, ce-proof, architecture-design, prototype, e2e, session-handoff, workflow-feedback, **business-analysis**, **jarvis** | 各自独特触发词 | 无冲突，可独立触发；business-analysis 不进入核心工作流；**jarvis 为可选启用**（个人决策代理，不进任何默认流程） |
 | 步骤级 - 受限独立 | ce-brainstorm, ce-plan | 可独立触发，但产品级新需求应走 orchestrator | description 中标注路由指导 |
 | 步骤级 - 仅路由 | need-explorer, spec-writer, contract-builder, build-executor, code-reviewer, spec-merger, release-archivist, bug-investigator | 仅由 workflow-start 路由 | 不独立触发 |
 | 内部方法论（预加载）| test-strategy, clean-code | 无触发词——仅经 agent `skills:` 字段预加载，或由派发模板内联 | 不独立触发；判据真相源，执行处为派发模板（`user-invocable: false`）|

package/CHANGELOG.md

@@ -4,6 +4,99 @@ All notable changes to `team-flow` will be documented in this file.
 
 The format loosely follows Keep a Changelog.
 
+## [0.60.0] - 2026-09-12
+
+### Changed（`decision-surrogate` → `jarvis`：更名 + 重定位 + 首次通道实测修订）
+
+**更名**：第 28 个 skill `decision-surrogate` → **`jarvis`**（目录 / frontmatter `name` / 全部文档引用同步；设计文档更名为 `docs/plan/jarvis-design.md`）。
+
+**重定位**：从「夜间决策替身」扩为 **「team-flow 专用决策代理」**——夜间/离席值守仍为核心场景，但**不再限时段**（在场时亦可分流决策点、只把 HOLD 项交回）；通用跨项目的「大副」角色由 firstmate 承担，两者不重叠。
+
+### Added（首次通道实测：六条通路，详见设计文档附录 E）
+
+| 通路 | 结果 | 关键证据 |
+|------|------|---------|
+| `ask` → `reply`（worker 问、代理答） | ✅ 可用 | 14 秒闭环；worker 写回文件与代答原文**逐字一致** |
+| `send --to dispatch` 唤醒 settled worker | ❌ **不可用** | 消息 `read=0` 永久滞留邮箱 |
+| 重新派发（退化路径） | ✅ 可用 | 新 task 完成原 worker 目标 |
+| Claude Code `SendMessage` 唤醒 idle 会话 | ✅ **可用** | 唤起 idle worker 并完成写入 |
+| Orca 派发 + SendMessage 对话 | ✅ 可用 | worker 主动联系代理会话成功 |
+| 多轮持续对话 | ✅ 可用 | 3 轮问答全部无超时 |
+
+### Changed（方案 v4.1 → v4.2）
+
+1. **§7.1 双通道互补** —— `orca ask/reply`（worker 发起、**阻塞语义**）+ Claude Code `SendMessage`（代理发起、**异步唤醒**），含**反向寻址**机制（worker 会话名随机 → 由 worker 启动后主动联系代理，代理凭消息头 `from=` 回复）
+2. **§7.2 晨间恢复改 SendMessage** —— 原 `send --to dispatch` 路径**已证伪**
+3. **§7.5 ⑧ 结案**（不可用）+ 新增 ⑩–⑬ 四项待验
+4. **新增 §7.6 环境前置检查**（shell 启动期提示 / 目录信任 / 不休眠 / runtime / orchestration）
+5. **§11 补三行异常**
+
+**`agent_prompt_stalled` 真因修正（重要）**：实测证明主因是 **shell 启动期的交互提示**——oh-my-zsh 更新提示吃掉 Orca 注入的 `claude` 命令首字母（实际执行 `laude`），故障发生在 worker 启动**之前**，与 TUI 模态无关，且报错完全不指向真因。
+
+### Fixed（skill 侧 4 处缺陷，均由实测暴露）
+
+1. **`orca ask` 简写不存在** → 更正为 `orca orchestration ask`
+2. **ask 命令模板缺鉴权参数** → 补 `--from` / `--dispatch-capability`（裸命令返回 `dispatch_capability_invalid`）
+3. **HOLD 早上恢复路径已证伪** → 改 SendMessage
+4. **重试命令缺前置步骤** → 补 `orca orchestration task-update --status ready`（派发失败会连坐 task，否则报 `task_not_startable`）
+
+### Changed（环境前置，实测踩坑）
+
+- `~/.zshrc`：`DISABLE_UPDATE_PROMPT="true"` 取消注释——**消除 oh-my-zsh 更新提示对 worker 派发的干扰**（实测 5 次连续派发失败的根因）
+- 目标目录须预置 `~/.claude.json` 的 `hasTrustDialogAccepted: true`——新目录首次派发否则必失败
+
+### Changed（文档同步）
+
+`README.md` / `AGENTS.md` / 工作区 `CLAUDE.md`：skill 名、设计文档路径、定位描述全部同步。
+
+## [0.59.0] - 2026-09-12
+
+### Added（decision-surrogate 决策替身 —— 第 28 个 skill，可选启用）
+
+设计来源：`docs/plan/decision-surrogate-design.md` **v4.1**（P1.5 完整档三轮对抗验证，收官 0 Critical；P4 修订见其变更记录；附录 A 如实记账 18 真闭合 / 5 表面闭合 / 1 未采纳）。**不进任何默认流程**——需要的成员独立启用。
+
+**新增 `decision-surrogate` skill**（第 28 个）：用户离席期间扮演决策代理——睡前布置任务并逐点预授权，夜间经 Orca orchestration 派 worker 跑 team-flow 工作流，裁决**可代答**的决策点、其余一律 HOLD 等用户，早上交付决策过程汇总。
+
+**代答权限三分**（9 个 DP 门 + 5 个确认点）：无条件代答 1（DP-0）／条件代答 6（DP-1/2/3/4/G4/E2E）／挂起 7（DP-A 架构门禁、DP-5/6/7、G5、Code Landing、S3.5 publish）。DP-3 条件代答须**同时满足四条件**才批准。
+
+**夜间红线**（用户确认）：允许 worktree 内本地提交；禁止 push／发布／删除／改契约范围外接口／任何对外发送／自行发明任务方向／Code Landing。
+
+**关键设计决策**（均有实证依据）：
+
+- **HOLD 不写任何决策点字段**：`dp_N_result` 是门禁判据（`dp-gate-passed` 只校验非空），写入 HOLD 值会让 change 呈现"已批准"假象；而 `dp_{1,2,3,5,6,7}_decisions` / `_confirmed` 共 12 个字段 **不可落盘**（`dp_0_*` 除外）——它们在 `SETTABLE_FIELDS` 白名单内但 `writeState` 无序列化分支，`tf state set` **回显 ✅ 却零写入**（P4 亲测）。HOLD 的持久锚点 = escalation 消息 + 替身决策日志 + change 的 `state` 仍停在门禁前。
+- **禁止 AskUserQuestion 是硬要求**：P0 实证 `orca terminal send` 返回 `agent_prompt_stalled`——worker 一旦弹出 TUI 模态，**没有任何自动化手段能救它**（设计文档附录 D 通道实证）。
+- **不做「沉默即同意」**：`ask` 超时不产生默认裁决，保留 message_id 待恢复；HOLD 是主要形态，不得静默放行。
+- **`observation.agentWait` 是健康态**（worker 等待人工应答），非故障——避免误判失败而重启。
+- **未验证机制不写定论**：worker 遵循 task spec 是靠运行时约束的行为，每次任务须核对早报与**决策日志 + change 的 `state` 位置**是否一致（字段能否落盘须实测，勿据白名单推断）。
+
+**Phase 0 首次接入**：9 项环境探测矩阵（Orca CLI／runtime／orchestration 开关／协调者锚点／可用项目／项目空间判据／偏好库／替身 home／机器不休眠），缺项给**具体引导命令**而非笼统报错；偏好库初始化三档（交互式 5 分钟 8 题／从既有资产提炼／历史会话挖掘）。
+
+**三个 references**：`onboarding.md`（探测矩阵 + 偏好库与 home 初始化）／`decision-points.md`（代答权限 + 三档处置 + 红线）／`protocols.md`（授权书模板、worker task spec 模板、HOLD 六步协议、决策日志与早报格式）。
+
+### Fixed
+
+- **guard 安全档位倒置**（`scripts/guard/guard.mjs`）：full 工作流的 `bridging:approved-for-build` 原只挂 `dp-gate-passed`（仅要求 `dp_3_result` 非空），而**取值严格校验**的 `dp3-approved` 只挂在 hotfix → 更重要的 full 反而用弱校验。后果：任何能写 `dp_3_result` 的主体（如夜间替身按早期设计写入 HOLD 值）都能让 change 呈现"已批准"假象，在无真实批准的前提下跨过 DP-3 硬门。修复：full 该转换补挂 `dp3-approved`（取值须以 `approved` 开头）。
+- **`dp3-approved` 失败文案漂移**（`scripts/guard/checks/dp3-approved.mjs:10`）：滞留 "before hotfix build"，而该维度自本轮起同时守护 full → 改为 "before build"。
+- **12 个「白名单内但不可落盘」的字段已移除**（`scripts/lib/cmd-state.mjs`）：`dp_{1,2,3,5,6,7}_decisions` / `_confirmed` 在旧 `SETTABLE_FIELDS` 内，但 `writeState` 无序列化分支 → `tf state set` **回显成功却零写入**（静默假成功；全仓零消费者，实测确认）。移除后写入即报 `⛔ Field ... is not settable`。`dp_0_decisions` / `dp_0_confirmed` 保留（二者确有序列化分支）。
+- **`.zcode/` 残留目录删除 + `.gitignore` 加规则**：该目录是 2026-07-30（v0.27.0）在插件仓库根调试 `install-zcode` 时留下的产物，被 `git add -A` 一并提交；其 `hooks.json` 含**本机绝对路径**，且只有 1 个 skill，与「28 skills」口径冲突。
+
+### Fixed（横展：skills 计数漂移）
+
+- **`INSTALL.md` 7 处**（`:342` `:367` `:390` `:465` `:531` `:686` `:797`）全部写「9 个 skill」——`install-workbuddy --dry-run` 实证输出 `Skills: 28`；qoder/cline/pi 走共享 `scripts/lib/install.mjs` 的 `copySkillsWithRoot`（只过滤目录、无名字过滤），同样部署全部。**危害**：`:390` 等处是安装验证步骤，照 9 数会误判安装失败。
+- **`docs/platform-matrix.md:5`**「9 个 skill」→ 28。
+- **`docs/usage-guide.md:39`**「24 个 skills + 15 个 agents」→ 28/17（该文件 `:3` 上轮已改计数却漏了 `:39`，典型**修复未传播**）；`:3` 版本锚点 → v0.59.0（该文件不在 `check-version-consistency.mjs` 扫描面内，无门禁兜底）。
+- **`HANDOFF.md` 有意不改**（7 处过期计数）：该文件已在 v0.53.0 标注作废、保留供追溯，当轮 CHANGELOG 记录过决策——「只改几行会造成'已同步'假象」，故维持作废横幅、不同步数字。
+
+### Added（机械门禁）
+
+- **full 模式 DP-3 取值门测试**（`tests/lib/guard.test.mjs` 新增 3 个）：维度已挂载／HOLD 值被拒／approved 值放行。**反向验证**：临时移除该维度 → 正好 3 个测试变红、其余 34 个不受影响（门禁自证有效，而非"改了门禁测试仍全绿"）。
+- **`check-version-consistency` 扫描面扩展 + `--fix` 嵌套写回修复**（`scripts/check-version-consistency.mjs`）：计数检查由 4 个文件扩至 **9 条 JSON manifest + 7 条文档规则**（新纳 usage-guide / platform-matrix / release-checklist；INSTALL.md 用 3 条精确规则，**不得用全局替换**——那会误改 `:797` 的「其余 27 个」= count-1）。同时修复 `--fix` 的真实缺陷：原实现只写顶层键，遇到新增的嵌套路径（`plugins[0].description`、`interface.longDescription`）会把父级整体覆盖成字符串 → **毁文件**；改为按完整路径回溯写回，路径不可写时显式报错而非静默跳过。
+- **`tests/lib/check-version-consistency.test.mjs`（新增 5 个测试）**：覆盖面锁定 + **行为验证**（改错 → 必须检出 → `--fix` 修复 → 结构完好 → 还原）。**反向验证**：把 `--fix` 改回旧实现 → 恰好嵌套路径测试变红、其余 4 个不受影响。
+
+### Changed
+
+- **skills 计数 27 → 28 同步（子仓库 12 处 + 工作区 CLAUDE.md）**：宿主 manifest 6 处（`.claude-plugin/` ×2、`.cursor-plugin/` ×2、`.codex-plugin/plugin.json`、`gemini-extension.json`）、`plugin.json`、`package.json`、`README.md`（含「十二套」→「十三套」）、`AGENTS.md`（能力概览第 13 节 + Skills 索引 + 触发域分层）、`docs/usage-guide.md`、`docs/release-checklist.md`。
+
 ## [0.58.0] - 2026-09-12
 
 ### Added（clean-code 结构判据能力）

package/GEMINI.md

@@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r
 
 
 <!-- team-flow-phase-guard-start -->
-# team-flow v0.58.0 | 阶段: {{state}} | 工作流: {{workflow}}
+# team-flow v0.60.0 | 阶段: {{state}} | 工作流: {{workflow}}
 当前阶段允许的操作由 workflow-start 路由规则定义。
 禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
 <!-- team-flow-phase-guard-end -->

package/HANDOFF.md

@@ -3,8 +3,8 @@
 > ## ⚠️ 本文档已作废（2026-09-10 标注，v0.53.0）
 >
 > 最后更新停留在 **2026-07-28（v0.30.0 时代）**，此后未再维护。已知失准之处至少包括：
-> skill/agent 计数（此处 23+15，实际 **26+17**）、closing 回写链顺序
-> （此处 `arch-merge → prototype-sync`，实际 **`arch-merge → state transition closing → prototype-sync → test-merge`**，v0.53.0 §110 B' 时序前移）等。
+> **skill/agent 计数——已完全失准，本文中的任何数字只代表 v0.30.0 时点，请以 `AGENTS.md` / `plugin.json` 为准**；
+> closing 回写链顺序（此处 `arch-merge → prototype-sync`，实际 **`arch-merge → state transition closing → prototype-sync → test-merge`**，v0.53.0 §110 B' 时序前移）等。
 >
 > **权威来源**：`CLAUDE.md` / `AGENTS.md` / `README.md` / `../docs/architecture-api-db-design-enhancement-v0.25.md`。
 > 本文档**仅作历史追溯**，**不得**据其执行流程——照旧顺序执行会触发 `arch-merged` 门禁拒绝（因回写未发生在状态转换之前）。

package/INSTALL.md

@@ -7,7 +7,7 @@
 - [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎（Schema 验证、Delta Spec、工件解析）
 - [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律（TDD 铁律、SDD、系统化调试、代码审查）
 
-当前发布版本：**v0.58.0**。
+当前发布版本：**v0.60.0**。
 
 ---
 
@@ -43,7 +43,7 @@
 ### 安装（推荐：Marketplace）
 
 ```bash
-/plugin marketplace add http://team:glpat-qyqtVEKeE3eu6EfrohoAEm86MQp1OjEyOQk.01.0z1ft22h9@172.25.254.5:10080/d40050-gtmc-ai/team-flow.git
+/plugin marketplace add http://172.25.254.5:10080/d40050-gtmc-ai/team-flow.git
 /plugin install team-flow@team-flow
 ```
 
@@ -66,7 +66,7 @@
 ### 本地安装（开发 / 离线）
 
 ```bash
-git clone http://team:glpat-qyqtVEKeE3eu6EfrohoAEm86MQp1OjEyOQk.01.0z1ft22h9@172.25.254.5:10080/d40050-gtmc-ai/team-flow.git
+git clone http://172.25.254.5:10080/d40050-gtmc-ai/team-flow.git
 
 # 在 Claude Code 中执行：
 /plugin install file:/absolute/path/to/team-flow
@@ -339,7 +339,7 @@ rm -rf your-project/.agents/skills
 
 ## WorkBuddy
 
-WorkBuddy 把 Skill 作为 marketplace 插件管理。安装器把 team-flow 部署为单个插件，包含 9 个 skill、运行时依赖（scripts/docs/templates/dist/hooks）、phase-guard 规则和 `.codebuddy-plugin/plugin.json` 清单，写入 `~/.workbuddy/plugins/marketplaces/<marketplace>/plugins/team-flow/`。
+WorkBuddy 把 Skill 作为 marketplace 插件管理。安装器把 team-flow 部署为单个插件，包含 28 个 skill、运行时依赖（scripts/docs/templates/dist/hooks）、phase-guard 规则和 `.codebuddy-plugin/plugin.json` 清单，写入 `~/.workbuddy/plugins/marketplaces/<marketplace>/plugins/team-flow/`。
 
 ### 安装（推荐：一键脚本）
 
@@ -364,7 +364,7 @@ tf install-workbuddy --dry-run
 ```text
 ~/.workbuddy/plugins/marketplaces/cb_teams_marketplace/plugins/team-flow/
 ├── .codebuddy-plugin/plugin.json   ← 插件清单（name, version, skills[]）
-├── skills/                         ← 9 个 skill（${CLAUDE_PLUGIN_ROOT} 已重写）
+├── skills/                         ← 28 个 skill（${CLAUDE_PLUGIN_ROOT} 已重写）
 ├── rules/phase-guard.md            ← phase-guard 规则（WorkBuddy 自动加载）
 ├── scripts/  docs/  templates/     ← 运行时依赖
 ├── dist/  hooks/
@@ -387,7 +387,7 @@ rm -rf ~/.workbuddy/plugins/marketplaces/cb_teams_marketplace/plugins/team-flow
 ### 验证
 
 ```bash
-ls ~/.workbuddy/plugins/marketplaces/cb_teams_marketplace/plugins/team-flow/skills   # 应有 9 个 skill 目录
+ls ~/.workbuddy/plugins/marketplaces/cb_teams_marketplace/plugins/team-flow/skills   # 应有 28 个 skill 目录
 cat ~/.workbuddy/plugins/marketplaces/cb_teams_marketplace/plugins/team-flow/rules/phase-guard.md
 cat ~/.workbuddy/plugins/marketplaces/cb_teams_marketplace/plugins/team-flow/.codebuddy-plugin/plugin.json
 ```
@@ -462,7 +462,7 @@ rm -rf .qoder/skills .qoder/team-flow .qoder/rules/phase-guard.md
 ### 验证
 
 ```bash
-ls .qoder/skills          # 应有 9 个 skill 目录
+ls .qoder/skills          # 应有 28 个 skill 目录
 cat .qoder/rules/phase-guard.md
 ```
 
@@ -528,7 +528,7 @@ rm -rf .cline/skills .cline/team-flow .clinerules/phase-guard.md
 ### 验证
 
 ```bash
-ls .cline/skills          # 应有 9 个 skill 目录
+ls .cline/skills          # 应有 28 个 skill 目录
 cat .clinerules/phase-guard.md
 ```
 
@@ -683,7 +683,7 @@ npx team-flow@latest install-pi
 ```bash
 npx team-flow@latest install-pi
 rm -rf .pi/skills .pi/team-flow
-ls .pi/skills   # 应有 9 个 skill 目录
+ls .pi/skills   # 应有 28 个 skill 目录
 ```
 
 > Pi 无 phase-guard 规则自动注入，会话中请显式 `用 workflow-start 开始`。
@@ -794,7 +794,7 @@ Checkpoint 是任务级恢复上下文。`result-ready` handoff 在继续受影
 安装后验证：
 
 - `workflow-start` skill 已可用
-- 其余 8 个 skill 全部可见
+- 其余 27 个 skill 全部可见
 
 ## 故障排查
 

package/README.md

@@ -1,8 +1,8 @@
 # team-flow
 
-> 当前版本：`v0.58.0`
+> 当前版本：`v0.60.0`
 
-> 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，十二套能力协同（详见下文「十二套能力」）。
+> 统一插件：**team-flow**（spec 驱动开发）+ **compound-engineering 核心子集**（全局复利）+ **architecture-design**（4A+DDD 增量设计）+ **prototype**（本地 HTML 原型）+ **e2e**（AC 驱动 E2E）+ **workflow-orchestrator**（产品级编排）+ **workflow-bootstrap**（既有项目接入）。一次安装，十三套能力协同（详见下文「十三套能力」）。
 
 ## 30 秒上手
 
@@ -34,7 +34,7 @@
 git clone <your-repo> && <cli> plugin install ./team-flow
 ```
 
-> 不同宿主 CLI 的安装子命令略有差异（如 Claude Code 为 `/plugin add`，Cursor 为 `plugin install`）。以宿主文档为准；本插件提供单一 `plugin.json`，一次安装即加载全部 27 个 skills。
+> 不同宿主 CLI 的安装子命令略有差异（如 Claude Code 为 `/plugin add`，Cursor 为 `plugin install`）。以宿主文档为准；本插件提供单一 `plugin.json`，一次安装即加载全部 28 个 skills。
 
 ## 配置（插件层扩展字段）
 
@@ -70,7 +70,7 @@ specs/<cap>/        每变更规格：spec.md（learnings.md 归 change 根目
 STRATEGY.md CONCEPTS.md 策略 / 领域词汇
 ```
 
-## 十二套能力（27 skills）
+## 十三套能力（28 skills）
 
 - **team-flow**（11）：workflow-start / need-explorer / spec-writer / contract-builder / build-executor / code-reviewer / spec-merger / release-archivist / bug-investigator / test-strategy / clean-code
 - **compound 核心子集**（6）：ce-brainstorm / ce-plan / ce-compound / ce-strategy / ce-ideate / ce-proof
@@ -84,6 +84,7 @@ STRATEGY.md CONCEPTS.md 策略 / 领域词汇
 - **设计系统**（1）：design-system（独立创建/迭代项目级设计系统，用户主导交互，v0.19.0）
 - **业务分析**（1）：business-analysis（将任意输入整理为 requirement/vN/business-analysis.md，多轮单问澄清，独立外挂，v0.44.0）
 - **项目初始化**（1）：project-initialize（工作空间代码服务为空时的初始化引导：架构选择 → 服务命名 → 创建子目录 → 委托骨架，v0.45.0）
+- **Jarvis**（1）：jarvis（team-flow 专用决策代理：在授权范围内代做决策点裁决——**夜间/离席值守**为核心场景，在场时亦可分流、只把 HOLD 项交回；经 Orca 派 worker，依赖个人偏好库与 Jarvis home，**可选启用**，v0.59.0 新增 / v0.60.0 改名）
 
 ### 配套 agents（17 个，v0.47.0 增至 17）
 
@@ -97,7 +98,7 @@ Skills 命名保留其来源前缀，作为功能分组的自然标识：
 |------|------|------|--------|
 | `ce-` | compound-engineering | 产品级思维工具（头脑风暴、计划、策略、复利、创意、验证） | ce-brainstorm, ce-plan, ce-strategy, ce-compound, ce-ideate, ce-proof |
 | 无前缀 | team-flow | 变更级开发流程工具（状态机、规格、构建、审查、归档、内部方法论） | workflow-start, need-explorer, spec-writer, contract-builder, build-executor, code-reviewer, spec-merger, release-archivist, bug-investigator, test-strategy, clean-code |
-| 无前缀 | team-flow 新增 | 编排/接入/设计/原型/测试/交接/反馈/初始化 | workflow-orchestrator, workflow-bootstrap, architecture-design, prototype, e2e, session-handoff, workflow-feedback, design-system, project-initialize |
+| 无前缀 | team-flow 新增 | 编排/接入/设计/原型/测试/交接/反馈/初始化/分析/决策代理 | workflow-orchestrator, workflow-bootstrap, architecture-design, prototype, e2e, session-handoff, workflow-feedback, design-system, project-initialize, business-analysis, jarvis |
 
 > `ce-` 前缀来自 compound-engineering 项目，team-flow 整合时保留了这一命名以维持功能分组的可辨识性。这不是命名不一致，而是有意的来源标注。
 

package/docs/README_en.md

@@ -126,7 +126,7 @@ npm install -g team-flow
 
 ### Version
 
-- Current: `v0.58.0`
+- Current: `v0.60.0`
 - v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
 - Self-contained — no OpenSpec or Superpowers runtime required
 - Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)

package/docs/platform-matrix.md

@@ -2,7 +2,7 @@
 
 team-flow 共支持 **18 个** AI 编程平台。每个平台按三层接入：
 
-- **Skills** — 9 个 skill 部署到平台技能目录（`${CLAUDE_PLUGIN_ROOT}` 重写为绝对路径）。
+- **Skills** — 28 个 skill 部署到平台技能目录（`${CLAUDE_PLUGIN_ROOT}` 重写为绝对路径）。
 - **Rules** — phase-guard 规则文件部署到平台规则目录，被平台自动加载为常驻上下文（守卫机制）。
 - **Hooks** — SessionStart 上下文注入钩子（仅在该平台原生支持且已验证时接入）。
 

package/docs/release-checklist.md

@@ -46,7 +46,7 @@ For each example in `docs/examples/`:
 - `node scripts/team-flow.mjs version <version> --dry-run` — reports all files in sync
 - `node scripts/check-version-consistency.mjs` — exits 0
 - `node scripts/team-flow.mjs --help` — all subcommands listed
-- `node scripts/team-flow.mjs install-workbuddy --dry-run` — finds all 27 skills and target paths
+- `node scripts/team-flow.mjs install-workbuddy --dry-run` — finds all 28 skills and target paths
 - `npm run test:raw-mode` — packs the current source and runs a canonical runtime in an empty directory with no plugin-root variables or global `tf`.
 - Run a representative local-installer smoke test.
 - `team-flow.config.json` absence still works (backward compatible defaults)

package/docs/usage-guide.md

@@ -1,6 +1,6 @@
 # team-flow 使用说明（研发团队版）
 
-> 版本锚点：v0.58.0（27 skills + 17 agents）· 更新日期：2026-09-12
+> 版本锚点：v0.60.0（28 skills + 17 agents）· 更新日期：2026-09-12
 > 读者：使用 team-flow 做日常研发的工程师。不需要你懂插件内部实现，只需要照着路径走。
 > 配套文档：安装细节见 [INSTALL.md](../INSTALL.md)；状态机细节见 [state-machine.md](state-machine.md)；决策点细节见 [decision-points.md](decision-points.md)；平台差异见 [platform-matrix.md](platform-matrix.md)。
 
@@ -36,7 +36,7 @@
 | 大需求拆成一团乱麻，改 A 坏 B | 产品级编排拆分 change + 依赖 DAG + 跨 change 冲突检测 |
 | 会话中断后上下文全丢 | 状态持久化在 `.team-flow.yaml`，新会话可无损恢复 |
 
-**规模感知**：24 个 skills（工作流能力）+ 15 个 agents（子代理角色）+ 1 个 `tf` CLI（状态机与门禁运行时）。你日常真正需要记住的入口只有 **3 个**（见第 3 节）。
+**规模感知**：28 个 skills（工作流能力）+ 17 个 agents（子代理角色）+ 1 个 `tf` CLI（状态机与门禁运行时）。你日常真正需要记住的入口只有 **3 个**（见第 3 节）。
 
 ### 双层编排架构
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "team-flow",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML) + business-analysis (independent requirement/scenario artifact). 27 skills, one install.",
-  "version": "0.58.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev) + compound-engineering core subset + architecture-design (4A/DDD) + prototype (local HTML) + business-analysis (independent requirement/scenario artifact) + jarvis (team-flow decision agent, opt-in). 28 skills, one install.",
+  "version": "0.60.0",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# v0.58.0: auto-sync CLI version with plugin version
+# v0.60.0: auto-sync CLI version with plugin version
 set -e
 
 # ═══════════════════════════════════════════════════════════════
 # Plugin version (update this when releasing new versions)
 # ═══════════════════════════════════════════════════════════════
-PLUGIN_VERSION="0.58.0"
+PLUGIN_VERSION="0.60.0"
 
 # ═══════════════════════════════════════════════════════════════
 # Step 1: Auto-sync CLI version with plugin version

package/llms.txt

@@ -3,7 +3,7 @@
 ## Overview
 spec-superflow is a self-contained workflow integration plugin for Claude Code, Cursor, OpenAI Codex CLI/App, GitHub Copilot CLI, Gemini CLI, OpenCode, WorkBuddy, and Trae. It merges spec-driven planning artifacts (proposal, specs, design, tasks) with disciplined execution guardrails (TDD, review gates, controlled handoff) into one unified workflow.
 
-Current version: v0.58.0.
+Current version: v0.60.0.
 
 ## Key Documents
 - README.md: Chinese homepage with full usage guide and FAQ

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xulthekl/team-flow",
-  "version": "0.58.0",
-  "description": "Unified plugin (27 skills + 17 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
+  "version": "0.60.0",
+  "description": "Unified plugin (28 skills + 17 agents) integrating team-flow, compound-engineering, architecture-design, prototype, design-system, workflow-orchestrator, workflow-bootstrap, e2e, session-handoff, workflow-feedback, business-analysis for multi-agent coding tools.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "team-flow",
-  "version": "0.58.0",
-  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + design-system (design tokens + component contract + AI primer + showcase) + test-strategy (test strategy design) + project-initialize (new service onboarding). 27 skills + 17 agents, one install.",
+  "version": "0.60.0",
+  "description": "Unified workflow plugin: team-flow (spec-driven dev: TDD/SDD/code-review/debugging) + compound-engineering core subset (brainstorm/plan/compound/strategy/ideate/proof, global compounding) + architecture-design (4A+DDD incremental design & global compounding) + prototype (local HTML prototype, zero external deps) + e2e (Playwright E2E, AC-driven) + workflow-orchestrator (product-level workflow orchestration) + workflow-bootstrap (existing project onboarding) + session-handoff (context transfer) + workflow-feedback (issue tracking) + business-analysis (independent requirement/scenario artifact) + design-system (design tokens + component contract + AI primer + showcase) + test-strategy (test strategy design) + project-initialize (new service onboarding) + jarvis (team-flow decision agent, opt-in). 28 skills + 17 agents, one install.",
   "author": {
     "name": "LT"
   },