spec-worktree

内部 helper：为需要隔离 git worktree 的公开 workflow（spec-work、spec-code-review 等）提供并行 feature work 或 PR review 支持，仅在被委派时使用。

ASCII 链路图

Public workflow / maintainer task
  |
  v
+-- spec-worktree
    type: internal-only
    entry: internal_only
    output: focused support result returned to the caller

基本信息

字段	内容
Skill	spec-worktree
类型	internal-only
研发链路位置	Internal
当前入口	internal_only
兼容别名	不适用
Source	skills/spec-worktree/SKILL.md
Governance	src/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述

Internal helper for caller-owned git worktree isolation. Governed callers are spec-dogfood and spec-work; every caller must provide the forward invocation and intake contract.

Source 契约摘要

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用

• 被 spec-work、spec-code-review 或其他公开 workflow 委派需要隔离 worktree。
• 当前 checkout 不应被打扰。
• 需要并行处理多个分支或 review。

工作步骤

• 由上层 workflow、维护任务或专项场景触发。
• 读取当前任务的局部上下文和相关 source/runtime 文件。
• 完成单一内部能力，不把自身暴露成公开 spec-first 入口。
• 把结果返回给调用它的 workflow 或维护者。

输出

• 局部维护结果、辅助产物、验证证据或给上层 workflow 的结构化摘要。
• 是否写文件取决于调用场景和项目治理规则。

Agent 调度

• internal skill 通常不是 persona dispatch 容器。
• 如果它本身涉及审查、研究或浏览器验证，才按技能说明使用对应工具或 agent 能力。

本 skill 当前没有 skill-local references/agents 或 references/personas 文件；默认由 orchestrator 直接完成，或按阶段需要临时调用其他 skill 的专家。

边界

• 仅作为公开 workflow 的内部 helper，不作为独立用户入口。
• worktree 合并和清理仍需由调用方管理。

源码校准

• 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
• 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
• 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。