@namewta/speculo 0.6.0 → 0.6.1

package/template/workflows/specdev/common/schemas/source.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:source:v1",
+  "title": "SpecDev Source Frontmatter",
+  "type": "object",
+  "required": ["schema_version", "artifact", "change", "source_type", "canonical_locator", "captured_at", "content_sha256", "remote_state", "close_capability"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "artifact": {"const": "source"},
+    "change": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"},
+    "source_type": {"enum": ["conversation", "pasted", "local-file", "url", "github-issue", "github-pr"]},
+    "canonical_locator": {"type": ["string", "null"]},
+    "captured_at": {"type": "string", "minLength": 1},
+    "content_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "remote_state": {"enum": ["open", "closed", "unknown", "not-applicable"]},
+    "close_capability": {"enum": ["supported", "unsupported", "not-applicable"]},
+    "supersedes_source": {"type": "string", "minLength": 1}
+  },
+  "additionalProperties": true
+}

package/template/workflows/specdev/common/schemas/status.schema.json

@@ -1,18 +1,17 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:speculo:specdev:status:v3",
+  "$id": "urn:speculo:specdev:status:v4",
   "title": "SpecDev Global Status",
   "type": "object",
   "required": [
     "schema_version",
     "workflow",
     "active",
-    "work_history",
-    "completed"
+    "archived"
   ],
   "properties": {
     "schema_version": {
-      "const": 3
+      "const": 4
     },
     "workflow": {
       "const": "specdev"
@@ -24,30 +23,27 @@
         "required": [
           "change",
           "current_work",
-          "works_run",
-          "result"
+          "works_run"
         ],
         "properties": {
           "change": {
-            "type": "string"
+            "type": "string",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
           },
           "current_work": {
             "type": [
               "string",
               "null"
-            ]
+            ],
+            "pattern": "^specdev/"
           },
           "works_run": {
             "type": "array",
             "items": {
-              "type": "string"
-            }
-          },
-          "result": {
-            "type": [
-              "string",
-              "null"
-            ]
+              "type": "string",
+              "pattern": "^specdev/"
+            },
+            "uniqueItems": true
           },
           "claimed_investigations": {
             "type": "array",
@@ -75,75 +71,21 @@
                   "type": "string"
                 }
               },
-              "additionalProperties": true
+              "additionalProperties": false
             }
           }
         },
-        "additionalProperties": true
+        "additionalProperties": false
       }
     },
-    "work_history": {
+    "archived": {
       "type": "array",
       "items": {
-        "type": "object",
-        "required": [
-          "change",
-          "work_id",
-          "started_at",
-          "completed_at",
-          "result"
-        ],
-        "properties": {
-          "change": {
-            "type": "string"
-          },
-          "work_id": {
-            "type": "string",
-            "pattern": "^specdev/"
-          },
-          "started_at": {
-            "type": "string"
-          },
-          "completed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "result": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "additionalProperties": true
-      }
-    },
-    "completed": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": [
-          "change",
-          "archived_at",
-          "archive_path"
-        ],
-        "properties": {
-          "change": {
-            "type": "string"
-          },
-          "archived_at": {
-            "type": "string"
-          },
-          "archive_path": {
-            "type": "string",
-            "pattern": "^<Path>\\{roots\\.state\\}/specdev/archive/[^<]+</Path>$"
-          }
-        },
-        "additionalProperties": true
-      }
+        "type": "string",
+        "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"
+      },
+      "uniqueItems": true
     }
   },
-  "additionalProperties": true
+  "additionalProperties": false
 }

package/template/workflows/specdev/common/schemas/triage.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:triage:v1",
+  "title": "SpecDev Triage Frontmatter",
+  "type": "object",
+  "required": ["schema_version", "artifact", "change", "mode", "source", "classification", "risk", "route", "ready_for_implementation", "external_action", "updated_at"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "artifact": {"const": "triage"},
+    "change": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"},
+    "mode": {"enum": ["intake", "reconcile"]},
+    "source": {"type": "string", "minLength": 1},
+    "classification": {"enum": ["bug", "feature", "refactor", "investigation", "operations", "documentation", "review", "mixed"]},
+    "risk": {"enum": ["low", "medium", "high", "critical"]},
+    "route": {"type": "string", "pattern": "^specdev/[a-z0-9]+(?:-[a-z0-9]+)*$"},
+    "ready_for_implementation": {"type": "boolean"},
+    "external_action": {"enum": ["not-applicable", "pending-close", "closed", "close-failed", "waived"]},
+    "updated_at": {"type": "string", "minLength": 1}
+  },
+  "additionalProperties": true
+}

package/template/workflows/specdev/common/skills/code-review/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: specdev-code-review
+description: 从不可变固定点对本地 diff 执行隔离的标准轴与规范轴审查，供独立 C Work 和 I Work 最终审查共同调用。
+---
+
+# SpecDev Code Review
+
+本 Skill 返回审查结果，不创建 runtime namespace。调用方分别负责 C review 工件或 I Evidence。
+
+## 输入
+
+- `fixed_point`：已解析的 commit SHA；
+- `head`：已解析的 HEAD/checkpoint SHA；
+- `diff_command`：固定为三点 diff；
+- `commit_log`：固定点之后的 commit 列表；
+- `spec_sources`：零个或多个本地权威来源；
+- `standards_sources`：仓库编码标准来源；
+- `review_context`：路径范围、调用 Work 和适用授权；
+- `parallel_reviewers`：平台支持时为 true，否则使用两个独立上下文包顺序执行。
+
+## 流程
+
+1. 重验 fixed point/head 可解析、三点 diff 非空，失败时不启动 reviewer。
+2. 加载 `<Path>{roots.workflows}/specdev/common/skills/code-review/references/source-discovery.md</Path>`，穷尽规范和标准来源。
+3. 加载 `<Path>{roots.workflows}/specdev/common/skills/code-review/references/fowler-smells.md</Path>` 作为标准轴最低启发式；仓库明确标准优先。
+4. 加载 `<Path>{roots.workflows}/specdev/common/skills/code-review/references/reviewer-contracts.md</Path>`，用互不共享发现的上下文分别运行两个轴。
+5. 原顺序返回 `standards` 和 `specification` 两份结果。规范来源不存在时只跳过规范轴并解释，标准轴继续。
+
+## 输出
+
+```text
+{
+  fixed_point, head, diff_command, commit_log,
+  standards: { result, findings, sources },
+  specification: { result, findings, sources },
+  skipped_axes,
+  summary_counts
+}
+```
+
+Finding 必须包含 severity、项目相对 Path/代码块、具体风险、依据和满足条件。两个轴不合并、不跨轴重排，也不选“赢家”。
+
+## 完成标准
+
+- fixed point、head、diff 和 commits 固定且可重复；
+- 仓库标准优先于 Fowler 启发式；
+- 两个 reviewer 上下文没有相互发现污染；
+- 每个发现可定位且说明行为风险；
+- 两轴按固定顺序返回，缺失规范没有掩盖标准审查。

package/template/workflows/specdev/common/skills/code-review/references/fowler-smells.md

@@ -0,0 +1,18 @@
+# Fowler Smell Baseline
+
+以下条目是标准轴最低启发式，不是硬性违规；仓库明确允许时抑制，工具链已覆盖时不重复报告：
+
+- **Mysterious Name**：名称不能揭示职责或数据含义；重命名，无法诚实命名时重新审视设计。
+- **Duplicated Code**：同一知识形态出现在多个代码块；提取单一权威实现。
+- **Feature Envy**：方法主要操作另一个对象的数据；把行为移动到数据 owner。
+- **Data Clumps**：一组字段/参数反复同行；形成有语义的类型。
+- **Primitive Obsession**：基本类型代替领域概念；引入小型领域类型。
+- **Repeated Switches**：同一分类判断重复出现；集中映射或使用多态。
+- **Shotgun Surgery**：一个逻辑变化迫使分散修改多个文件；汇聚共同变化知识。
+- **Divergent Change**：同一模块因多个无关理由变化；按职责拆分。
+- **Speculative Generality**：为规范未要求的未来需求增加抽象；删除并内联到真实需求出现。
+- **Message Chains**：调用者依赖长导航链；由第一个对象隐藏导航。
+- **Middle Man**：模块大部分只做转发；删除无价值中间层。
+- **Refused Bequest**：继承者拒绝大部分合同；使用组合或重建接口。
+
+每个命中写为“可能的 <Smell>”，引用代码块并解释为什么在当前 diff 中构成风险。

package/template/workflows/specdev/common/skills/code-review/references/reviewer-contracts.md

@@ -0,0 +1,13 @@
+# Isolated Reviewer Contracts
+
+## 标准轴
+
+输入仅包含固定 diff/log、标准来源和 Fowler baseline。报告仓库规则违规和判断性 smell，引用来源与代码块，区分 hard violation 与 heuristic，并跳过工具链已强制执行的纯格式项。
+
+## 规范轴
+
+输入仅包含固定 diff/log 与规范来源。报告缺失或不完整需求、超出范围行为和语义/失败/边界错误，并引用具体规范来源。
+
+## 隔离与结果
+
+平台支持独立 reviewer 时可并行；否则创建两个不共享发现的完整输入包并顺序执行。汇总者只整理格式，不删除、合并或跨轴重排 finding。每轴独立返回 `pass | request-changes | skipped`；一轴通过不抵消另一轴失败。

package/template/workflows/specdev/common/skills/code-review/references/source-discovery.md

@@ -0,0 +1,22 @@
+# Review Source Discovery
+
+## 规范来源
+
+按顺序查找并记录每一步结论：
+
+1. commit message 中的 Issue/PR 引用，对应本地 `<Path>{roots.state}/specdev/changes/{change}/source.md</Path>`；
+2. 调用方显式提供的 Spec、Ticket、ADR、Goal Plan 或其他路径；
+3. 与分支或功能匹配的仓库 `docs/`、`specs/` 或同类规范文件；
+4. 都不存在时询问规范是否确实不存在。确认不存在后规范轴标记 `skipped:no-spec`。
+
+远程 Issue/PR 必须先由 Triage 冻结，或解析为本地不可变 SHA；review 不把可变远程正文当作唯一权威。
+
+## 标准来源
+
+穷尽仓库中声明代码写法的文件：适用的 AGENTS/CLAUDE、CONTRIBUTING、编码标准、lint/type/test 配置和项目生成的 standards skill。记录适用范围；工具已经机械执行的格式项不重复生成人工噪声。
+
+## 完成标准
+
+- 每个候选来源有 found/not-found/not-applicable 结论；
+- 来源使用项目相对 Path 或 SpecDev 完整 Path；
+- 不存在的规范被明确确认，不由 reviewer 猜测。

package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md

@@ -1,28 +1,31 @@
 ---
 name: specdev-dev-worktree
-description: 为并行写代码的 Ready Ticket 建立隔离 worktree，并由 Lead 完成基线、集成验证和清理。Goal Plan Lead 在创建、恢复或收尾 Ticket worktree 时使用。
+description: 为需要隔离项目写入的 Ready Ticket 或一次性原型建立可恢复 worktree，并由调用方明确的 workspace owner 管理基线、集成或清理。
 ---
 
 # SpecDev Dev Worktree
 
 ## 适用范围
 
-- 仅用于并行写代码且路径所有权不冲突的 Ready Ticket。
+- 用于并行写代码且路径所有权不冲突的 Ready Ticket，或明确要求临时隔离的一次性原型。
 - 只读调查和顺序执行默认共用当前工作区。
-- Lead 管理创建、集成和清理；Worker 只实现、验证并返回 Evidence。
+- 调用方必须明确 workspace owner、implementation owner、固定基线、工作项 ID、持久化 owner 和允许的结束动作。
+- 普通执行不建立额外角色；委派 Goal Plan 才把 workspace owner/implementation owner 分别映射为 Lead/Worker。
 - 平台原生 worktree 优先；不可用时使用 Git worktree。
 
 ## 生命周期
 
 1. 创建或恢复时加载 `<Path>{roots.workflows}/specdev/common/skills/dev-worktree/references/create.md</Path>`。
-2. Worker 完成后将记录从 `active` 更新为 `review`，返回 Ticket 状态、Evidence 路径、`workspace_ref`、commit 或 PR 引用，以及条件性 Lead E2E。
-3. Lead 集成或清理时加载 `<Path>{roots.workflows}/specdev/common/skills/dev-worktree/references/finalize.md</Path>`。
+2. implementation owner 完成后返回工作项状态、Evidence/record 路径、`workspace_ref`、checkpoint、commit 或 PR 引用和未验证项；Ticket worktree 从 `active` 更新为 `review`。
+3. workspace owner 集成或清理时加载 `<Path>{roots.workflows}/specdev/common/skills/dev-worktree/references/finalize.md</Path>`；一次性原型只评估和清理，不合入生产分支。
 
-状态依次为 `planned → active → review → integrated → removed`；失败进入 `blocked`。记录写入 `<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 的 `worktrees`。
+Ticket worktree 状态依次为 `planned → active → review → integrated → removed`；失败进入 `blocked`，记录写入 `<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 的 `worktrees`。原型的 branch、`workspace_ref` 和清理结果只写入 `<Path>{roots.state}/specdev/changes/{change}/prototypes/{prototype-id}/record.md</Path>`，不伪造 Ticket worktree 记录。
 
 ## 边界
 
-- 每个并行 Ticket 使用独立 worktree、分支和相同 `base_sha`。
-- 持久状态只保存 `workspace_ref`，不保存机器绝对路径。
-- E2E 仅由 Lead 在集成阶段执行，且仅适用于用户界面交互受影响的变更。
+- 每个并行 Ticket 使用独立 worktree、分支和相同 `base_sha`；每个原型使用独立 worktree 和分支。
+- Git provider 固定使用 `<project-root>/specdev-worktree/<work-item-id>/`，持久化 `workspace_ref: specdev-worktree/<work-item-id>`；`<project-root>` 由 `workspace.json#path_base: project-root` 解析。
+- native/external provider 保留其可迁移 opaque locator；所有 provider 都不保存机器绝对路径、认证秘密或真实用户数据。
+- 项目根 `.gitignore` 的 `specdev-worktree/` 条目由 `speculo init` 单一维护；缺失时创建流程阻塞并提示重新运行 init。
+- E2E 仅适用于用户界面交互受影响的变更。普通执行由当前集成 owner 运行；委派执行由 Lead 在集成阶段运行。
 - 合并、推送、PR、删除分支或 worktree 仍需用户授权。

package/template/workflows/specdev/common/skills/dev-worktree/references/create.md

@@ -1,30 +1,35 @@
-# 创建或恢复 Ticket Worktree
+# 创建或恢复工作项 Worktree
 
 ## 前置
 
-- Ticket `ready: true`，依赖完成，写路径无冲突。
-- `<Path>{roots.state}/specdev/config.json</Path>` 中 `git.worktree_for_parallel: true`。
-- Lead 已固定所有并行 Ticket 共用的 `base_sha`。
+- Ticket `ready: true` 且依赖完成，或原型问题与临时写入范围已锁定；项目写路径无冲突。
+- 并行 Ticket 要求 `<Path>{roots.state}/specdev/config.json</Path>` 中 `git.worktree_for_parallel: true`；一次性原型要求 P-prototype 已取得本次临时 worktree 授权。
+- 调用方已指定 workspace owner、implementation owner、工作项 ID、持久化 owner，并固定 `base_sha`；并行 Ticket 共用同一基线。
 
 ## 创建
 
-1. 若 `<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 的 `worktrees` 已有该 Ticket 的 `active` 或 `review` 记录，解析 `workspace_ref` 并验证分支、`base_sha` 和工作区状态；一致则恢复。
-2. 否则优先调用平台原生 worktree 能力；不可用时从 `base_sha` 执行 `git worktree add -b <ticket-branch> <physical-path> <base-sha>`。物理路径必须位于主工作树之外。
-3. 分支使用 `speculo/<change>/<ticket-id>`；现有分支或目标路径未能匹配记录时停止。
-4. 安装项目所需依赖，运行最小基线检查。E2E 不属于 Worker 基线。
-5. 写入 `worktrees`：
+1. 从 Speculo 工作区声明的 `path_base: project-root` 解析 `<project-root>`。若记录的 provider 为 `git`，要求 `workspace_ref` 精确为 `specdev-worktree/<work-item-id>`，拼接后仍位于 project root，且 `specdev-worktree/` 不是逃逸到外部的符号链接。
+2. 读取调用方拥有的持久化记录：Ticket 使用 `<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 的 `worktrees`；原型使用 `<Path>{roots.state}/specdev/changes/{change}/prototypes/{prototype-id}/record.md</Path>`。若已有可恢复记录，Git provider 必须在 `git worktree list --porcelain` 中匹配固定路径、分支与 `base_sha`；native/external 由对应 provider 解析 opaque locator。一致则恢复，任一不一致停止。
+3. 否则优先调用平台原生 worktree 能力。使用 native/external 时保存 provider 返回的可迁移 locator；不可用时进入 Git fallback。
+4. Git fallback 前确认项目根 `.gitignore` 已包含 `specdev-worktree/` 或等价根模式。缺失时停止并提示重新运行当前版本 `speculo init`，不在本 Skill 内修改 `.gitignore`。
+5. Git fallback 固定 `physical_path = <project-root>/specdev-worktree/<work-item-id>`、`workspace_ref = specdev-worktree/<work-item-id>`，从 `base_sha` 执行 `git worktree add -b <work-item-branch> <physical-path> <base-sha>`。已存在但未与同一记录和 Git 注册匹配的目标路径一律阻塞。
+6. 分支使用 `speculo/<change>/<work-item-id>`；现有分支未能匹配记录时停止。
+7. 安装项目所需依赖，运行最小基线检查。E2E 不属于 implementation owner 的创建基线。
+8. Ticket 将记录写入 `worktrees`：
 
 ```json
 {
   "ticket_id": "T-01",
-  "owner": "<worker>",
-  "provider": "native",
+  "owner": "<implementation-owner>",
+  "provider": "git",
   "base_sha": "<sha>",
   "branch": "speculo/<change>/T-01",
-  "workspace_ref": "<provider-opaque-or-project-relative-ref>",
+  "workspace_ref": "specdev-worktree/T-01",
   "status": "active",
   "updated_at": "<ISO-8601>"
 }
 ```
 
-完成条件：工作区可定位、基线可用、状态记录与实际分支一致。失败时设为 `blocked` 并保留现场。
+native/external provider 将示例中的 provider 与 `workspace_ref` 换为对应可迁移 locator，不套用 Git 物理路径。原型不使用本 JSON 结构，只在 record 的 Run and Assets 中记录源码 branch/commit，并在 frontmatter 写入 `workspace_ref` 与清理状态。
+
+完成条件：工作区可定位、基线可用、调用方记录与实际 provider、分支和 checkpoint 一致；Git provider 的引用与工作项 ID 完全一致。失败时在调用方拥有的记录中设为 `blocked` 并保留现场。

package/template/workflows/specdev/common/skills/dev-worktree/references/finalize.md

@@ -1,16 +1,18 @@
-# 集成与清理 Ticket Worktree
+# 集成与清理工作项 Worktree
 
-## Lead 集成
+## 集成
 
-1. 确认记录为 `review`，读取 Worker Evidence，实际修改未越过路径契约。
+仅生产 Ticket 进入本段；一次性原型不得合入生产分支。
+
+1. workspace owner 确认记录为 `review`，读取 implementation owner 的 Evidence，实际修改未越过路径契约。
 2. 在目标集成基线上应用变更并运行受影响的定向与回归验证。
-3. 仅当变更影响用户界面交互时，由 Lead 运行验收所需的最小 E2E；Worker 只提供场景和预期结果。
+3. 仅当变更影响用户界面交互时，由当前集成 owner 运行验收所需的最小 E2E；委派执行中 implementation owner 只提供场景和预期结果，Lead 负责运行。
 4. 验证通过后将记录更新为 `integrated`；冲突或失败时设为 `blocked` 并保留 worktree。
 
 ## 清理
 
 1. 取得用户对删除 worktree 和分支的授权。
-2. 从主工作树或平台管理入口移除已集成 worktree。
-3. 确认 worktree 不再注册后删除对应分支，并将状态更新为 `removed`。
+2. Git provider 从 project root 解析 `specdev-worktree/<work-item-id>`，重验无路径逃逸且与 `git worktree list --porcelain` 的记录一致，再从主工作树移除；native/external 通过对应 provider 管理入口移除。
+3. 确认 worktree 不再注册且工作项目录不存在后删除对应分支。Ticket 将状态更新为 `removed`；原型把 `cleanup_status` 更新为 `clean`。保留项目根 `specdev-worktree/` 统一目录及 `.gitignore` 条目。
 
 PR 或暂缓集成时保留 worktree。清理失败时停止；仅在用户明确要求时使用强制删除。

package/template/workflows/specdev/common/skills/research/SKILL.md

@@ -1,43 +1,55 @@
 ---
 name: specdev-research
-description: 针对影响 SpecDev 决策的外部技术、依赖、标准或未知行为进行来源分级研究，并输出可追踪的结论与不确定性。
+description: 为调用 Work 的具体决定研究外部技术、依赖、标准或未知行为，逐声明返回一手来源、限制与不确定性，由调用方写入其拥有的工件。
 ---
 
 # SpecDev Research
 
-## 触发
+## 输入
 
-当外部 API、库版本、协议、法规、产品能力或最佳实践会改变设计/实现决策，且当前材料不足时使用。
+- `decision`：研究要支持的一个具体决定；
+- `questions`：需要回答的穷尽问题集；
+- `stop_condition`：何时证据已足够；
+- `caller`：D、G、S、W、R、T 或 I；
+- `target_artifact`：调用方拥有且将接收结果的完整 Path。
+
+缺少 owner 或 target 时返回阻塞，不创建 `{change}/research/` 等共享 namespace。
 
 ## 流程
 
-1. 写清楚要支持的具体决策和停止条件。
-2. 优先官方文档、规范、源代码、论文或维护者材料；技术问题优先一手来源。
-3. 核对版本、发布日期、适用环境和已知限制。
-4. 区分：来源明确事实、代码库事实、推断、建议。
-5. 对关键结论至少交叉验证；来源冲突时并列呈现，不强行调和。
-6. 记录摘要、证据、置信度、对 ADR/Spec/Ticket 的影响和仍未知项。
-7. 长期有效且经实现验证后才可由 Archive 提升到永久 research。
+1. 固定问题、版本、环境和停止条件。
+2. 优先官方文档、规范、源代码、论文或维护者材料；技术问题使用一手来源。
+3. 核对发布日期、版本、适用环境、限制和已知冲突。
+4. 对每个会改变决定的实质声明就近给出来源；关键结论交叉验证，来源冲突时并列呈现。
+5. 区分来源事实、代码库事实、推断、建议和未知项。
+6. 返回一个 Markdown block，由 caller 原子写入 `target_artifact`；本 Skill 不自行写 state。
 
-## 输出模板
+## 输出
 
 ```markdown
-# Research: <问题>
-- 决策用途：
-- 范围/版本：
-- 停止条件：
+## Research: <问题>
+- Decision / target:
+- Scope / version:
+- Stop condition:
 
-## Findings
 ### R-001
-- 结论：
-- 类型：官方事实 / 代码事实 / 推断 / 建议
-- 来源：
-- 置信度：high / medium / low
-- 适用限制：
-- 对工件影响：
-
-## Conflicts and Unknowns
-## Recommendation
+- Claim:
+- Type: official fact / code fact / inference / recommendation
+- Source:
+- Confidence:
+- Limits:
+- Artifact impact:
+
+### Conflicts and Unknowns
+### Recommendation
 ```
 
-不得长篇复制受版权保护的来源；使用短引文和自己的准确摘要。
+不得长篇复制受版权保护内容。长期有效且经实现验证的结论只能由 Archive 从调用方工件提升到永久 research。
+
+## 完成标准
+
+- 每个输入问题有答案或明确未知；
+- 每个实质声明就近引用一手来源；
+- 版本、限制、冲突和置信度已记录；
+- 结果有唯一 owning artifact；
+- 本 Skill 没有创建自己的 state 路径。

package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: subagent-delivery
-description: 交付合同：为 Goal Plan 生成可恢复的 direct、原生或外部网页 Agent 派单，并在 Implement 阶段核对基线、候选交付、修正和 Lead 验收。
+description: 交付合同：只为用户已选择委派的 Goal Plan 生成可恢复的原生或外部网页 Agent 派单，并在 Implement 阶段核对基线、候选交付、修正和 Lead 验收。
 ---
 
 # SpecDev Subagent Delivery
@@ -10,12 +10,12 @@ description: 交付合同：为 Goal Plan 生成可恢复的 direct、原生或
 ## 输入
 
 - `operation`：`plan` 或 `execute`；
-- `execution_model`：`direct`、`native-subagent` 或 `external-web-subagent`；
+- `execution_model`：`native-subagent` 或 `external-web-subagent`；
 - Lead、Ticket、Goal Plan、Spec、适用 ADR/CONTEXT、Wave/Gate 和依赖 Evidence；
 - 项目写、只读和 shared 路径，验证矩阵与当前源码基线；
 - provider、会话或 workspace locator、源码交付方式，以及用户当前明确授权。
 
-缺失 Goal Plan 的 `direct` Ticket 可以由 `<Path>{roots.workflows}/specdev/I-implement/I-implement.md</Path>` 按 Ticket 契约执行；其他输入缺失时返回调用方补齐，不猜测 checkpoint、权限或验收结果。
+普通 Goal Plan 和缺失 Goal Plan 的 Ticket 直接由 `<Path>{roots.workflows}/specdev/I-implement/I-implement.md</Path>` 执行，不调用本 Skill。委派输入缺失时返回调用方补齐，不猜测 checkpoint、权限或验收结果。
 
 ## 流程
 
@@ -37,7 +37,6 @@ description: 交付合同：为 Goal Plan 生成可恢复的 direct、原生或
 
 ### 3. 加载执行分支
 
-- `direct`：直接使用 Ticket、Goal Plan、`<Path>{roots.workflows}/specdev/I-implement/I-implement.md</Path>` 和 Evidence 合同，不加载 provider 规则；
 - `native-subagent`：加载 `<Path>{roots.workflows}/specdev/common/skills/subagent-delivery/references/native-subagent.md</Path>`，完成隔离派单、恢复和返回；
 - `external-web-subagent`：加载 `<Path>{roots.workflows}/specdev/common/skills/subagent-delivery/references/external-web-subagent.md</Path>`，完成能力探测、会话恢复、候选交付与修正。
 
@@ -58,4 +57,3 @@ description: 交付合同：为 Goal Plan 生成可恢复的 direct、原生或
 恢复时读取 Goal Plan 的派单块、Ticket、最新 Evidence 和 change/worktree 状态，从最后已验证 checkpoint 继续，不重新决定已锁定事项。完成或阻塞后向调用方返回 Ticket 状态、Evidence 完整路径、workspace/session locator、checkpoint、commit/PR 引用、未验证项和待 Lead E2E。
 
 **完成标准**：交付结束于 `review`、`done`、`blocked` 或 `deviated`；状态、Evidence、源码引用和恢复信息一致。
-

package/template/workflows/specdev/common/tools/README.md

@@ -4,9 +4,12 @@
 
 ```bash
 node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
+  --stage <triage|diagnosis|grill|spec|tickets|goal-plan|implement|review|prototype|wayfinder|complete> \
   <Path>{roots.state}/specdev/changes/{change}</Path>
 ```
 
+`--stage` 只要求该阶段已经拥有的工件；所有已经存在的工件仍会验证。省略 stage 时验证当前存在的工件，不会因未来 Work 尚未运行而报错。
+
 ## 校验 SpecDev 工作流包
 
 ```bash