Menú
在独立 git worktree 中隔离推进一个 change 的原子能力；当 dev workflow 需要为某个 change 建立隔离分支与 .worktree/ 工作树、审查整条 change 分支树的全部 commit、或在收尾时把分支合并回原分支并清理时使用。默认不启用，仅在用户显式请求隔离时由调用方读取。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Manage git submodules for the learning-open-code mono-repo. Use when the user wants to: (1) Add a new git submodule — auto-detect or specify the category (open-ai-skills/open-sdd/open-ai-agent/open-ai-desktop/open-knowledge/open-productivity/open-java/open-trading/open-data), record the tracking branch in .gitmodules, clone the repo, and update README.md index. (2) Sync all existing submodules to their configured branches (git fetch + checkout branch + pull). (3) Update the root README.md with an up-to-date index of all synced projects grouped by category. (4) Initialize submodules after git clone — when open-*/ directories are empty or git submodule status returns nothing, guide through the full SOP (git submodule update --init --recursive [--remote]). Trigger keywords: submodule, git submodule, 子模块, add submodule, sync submodule, update submodule, submodule branch, README index, 更新索引, clone, init, 初始化子模块, submodule init, 拉取子模块.
对开源项目进行穷尽式教学文档生成——从宏观架构到微观实现的五层分级讲解，使用 Goal Loop 算法自主驱动完整代码覆盖。所有具体教学内容生成必须激活 `.agents/skills/teach/SKILL.md`。触发条件：用户要求"完整学习某个项目"、"生成项目架构文档"、"从入口到落地讲清楚每个功能"、"代码考古"、"源码分析"、或指定一个项目目录/仓库要求全面教学。
使用并行子 agent 为模块生成多个截然不同的接口设计。当用户想要设计 API、探索接口选项、比较模块形态，或提到 "设计两次" 时使用。
交互式 QA 会话，用户以对话方式报告 bug 或问题，agent 将其录入 GitHub Issue。在后台探索代码库以获取上下文和领域语言。当用户想要报告 bug、做 QA、以对话方式录入 issue，或提及 "QA session" 时使用。
通过用户访谈创建包含微小提交的详细重构计划，并将其录入 GitHub Issue。当用户想要规划重构、创建重构 RFC，或将重构分解为安全的渐进步骤时使用。
从当前对话中提取 DDD 风格的通用语言词汇表，标记歧义并提出规范术语。保存到 UBIQUITOUS_LANGUAGE.md。当用户想要定义领域术语、构建词汇表、固化术语、创建通用语言，或提到 "领域模型" 或 "DDD" 时使用。
| id | worktree-isolation |
| type | skill |
| name | Worktree Isolation |
| description | 在独立 git worktree 中隔离推进一个 change 的原子能力；当 dev workflow 需要为某个 change 建立隔离分支与 .worktree/ 工作树、审查整条 change 分支树的全部 commit、或在收尾时把分支合并回原分支并清理时使用。默认不启用，仅在用户显式请求隔离时由调用方读取。 |
当 dev workflow 需要把一个 change 与原分支物理隔离地推进时使用。三个典型触发：
.worktree/<change>/ 工作树，代码与所有 Speculo 产物都落在 change 分支上，不污染原分支。默认不启用。 只有用户显式请求隔离（“用 worktree / 隔离这个 change”）时，调用方才读取并执行本 skill；未请求时调用方完全不加载本 skill，既有流程零行为变化。
YYYY-MM-DD-<kebab>）与其分类 <cat>（dev | doc | person | ops）.gitignore本 skill 自带全部隔离程序，不外读仓库 docs/。
git 状态变更：隔离分支、.worktree/<change>/ 工作树、合并与清理结果
供调用方持久化的状态字段集（本 skill 不自行选择持久化目录，由调用方 workflow 写入同一 change 的 .status.json）：
| 字段 | 类型 | 含义 |
|---|---|---|
worktree_enabled | bool | 是否启用隔离 |
base_branch | string | 原分支（启用隔离时的当前分支） |
change_branch | string | 隔离分支，固定 speculo/<cat>/<change> |
worktree_path | string | 工作树路径，固定 .worktree/<change> |
worktree_status | string | created | active | merged | removed |
可归档摘要：base / change 分支、worktree 路径、合并与清理结论、残留风险
speculo/.speculo/ 被 git 跟踪（产物需随分支合并）。任一不满足 → 不创建，向调用方报告原因并降级为非 worktree 模式。change_branch = speculo/<cat>/<change>；worktree_path = .worktree/<change>。references/create-worktree.md。完成后返回 base_branch / change_branch / worktree_path 与 worktree_status: active 供调用方写入。speculo/.speculo/<cat>/<change>/ 产物）都在 worktree_path 内、change_branch 上进行。references/audit-branch-tree.md，覆盖 base..change_branch 的每个 commit。references/merge-and-cleanup.md，合并回 base、删分支、删 worktree。破坏性步骤（合并、删分支、删 worktree）必须先列计划、经用户确认再执行；合并冲突即停、不强推。
references/create-worktree.md：建立隔离分支与 .worktree/ 工作树时读取（grill / change 创建）。references/audit-branch-tree.md：审查 change 分支树相对 base 的全部 commit 时读取（review）。references/merge-and-cleanup.md：把 change 分支合并回原分支并清理时读取（finalize）。