用途:在项目进行到中途需要试功能或跑技术验证(spike)时,把实验改动隔离到沙箱中,避免污染主工作树;写一份小型实验文档交接给下一个 agent 或会话;实验有结论后按结论合并回主项目或丢弃,并清理沙箱。本技能只负责单个实验的隔离与回收,自足,不依赖其它技能的脚本或文件。
主要能力:自动探测版本控制状态并选择隔离策略——git 仓库且主树干净时默认用 git worktree(兄弟目录 ../<proj>-exp-<slug> 加分支 exp/<slug>);主树有未提交改动时先 commit/stash 再建 worktree;小改动可就地切分支(--mode branch);无 git 或 unborn HEAD 时复制项目副本(排除 node_modules/dist/.venv/target/.next/.git 并记快照 hash)。生成 .experiments/<slug>.md 文档(含状态、Goal、Method、隔离方式、基线、Run、结论、Next Steps、合并计划、合并结果、清理,Evidence 追加式)与索引 .experiments/EXPERIMENTS.md。合并前记基线作为回滚锚点,合并后跑验证,不通过即回滚。收束时清理沙箱与临时分支,文档迁入 archive/。
使用方式:仅用户显式调用 /experiment-handoff 时执行,agent 不得自主触发。三段手动:用户调用技能、用户手动把会话交给另一个 agent、用户手动宣告实验结束;其余步骤自动。附带脚本 scripts/experiment.sh(Linux/macOS/WSL/Git Bash)与 scripts/experiment.ps1(Windows PowerShell 5.1+),零 python/node 依赖。命令:scripts/experiment.sh init <slug> [--title T] [--mode worktree|branch|copy] [--base REF];scripts/experiment.sh close <slug> --keep|--discard [--paths p1,p2];scripts/experiment.sh list。PowerShell 为位置式参数:experiment.ps1 init <slug> [title] [mode] [base];experiment.ps1 close <slug> keep|discard [paths];experiment.ps1 list [write]。
适用场景:项目中途的功能试验、技术验证、spike;需要把实验交接给下一个 agent 或会话;需要按结论选择性合并或丢弃实验改动。
限制:仅手动触发;实验文档需保持小(约 600 tokens 以内),活跃实验不超过 10 条;文档不得含 API Key、密码或 PII;worktree 各自独立依赖,建后需 install;沙箱在外置盘时需 git worktree lock 防误 prune。方法论来源为 Technical Spike 模板、Git worktree 最佳实践与 agent handoff 模式。