[Casper-Mars]

Fixes #336

Summary

git-worktree 的 SKILL 把目标写成相对路径 .worktrees/<branch-name>，既没要求先确认在仓库根，也没用 git rev-parse --show-toplevel 构造路径。在 monorepo 子目录（如 packages/app）调用会建到 <subdir>/.worktrees/：根目录的 ignore 规则覆盖不到，形成未跟踪的嵌套 worktree，且报告里的 cd .worktrees/<branch-name> 指引失效。

• 新增 ## Repository root 段：先 repo_root=$(git rev-parse --show-toplevel)，失败时明确报错并非零退出，不回落到相对路径；
• Naming / Create 的目标改为绝对路径 "$repo_root/.worktrees/<branch-name>"，mkdir -p "$(dirname "$target")"；
• 边界：目标已存在 → 不覆盖、非零退出；git check-ignore -q "$target" 未命中时只提示用户在根 .gitignore 补 .worktrees/，本 skill 不自行改 .gitignore；
• Report 段 cd 指引改为 cd "$repo_root/.worktrees/<branch-name>"，并注明「可在仓库内任意子目录调用」；
• base 段未动（属 bug: git-worktree 在默认分支不是 main 的目标仓库中会选错或选不到 base #335 的改动区间），本 PR 与 docs(skills): 统一 git-branch / git-worktree 的 base 解析 (#335) #340 的改动区间分离。

Testing

fixture B：monorepo（main + 远端 origin/main + 根 .gitignore 含 .worktrees/），在 packages/app 子目录里执行；测试片段全部从 SKILL.md 现场抽取后顺序执行（占位符 <branch-name> 替换为 feat/demo-336）。

########## fixture B：在 packages/app 子目录执行
pwd = /tmp/…/mono/packages/app
从 SKILL.md 抽取的片段行数：48
repo_root   = /tmp/…/mono
target      = /tmp/…/mono/.worktrees/feat/demo-336
PASS: repo_root 是仓库根而不是子目录
PASS: 根目录 .worktrees/feat/demo-336 已创建
PASS: packages/app/.worktrees 不存在
PASS: git status --porcelain 无新增未跟踪条目
PASS: worktree HEAD == origin/main
PASS: cd 指引可用（worktree 自身即 toplevel）

########## 边界 1：目标已存在 → 不覆盖、非零退出
Worktree target already exists: /tmp/…/mono/.worktrees/feat/demo-336
Pick another branch name, or remove the existing worktree yourself; this skill never overwrites.
PASS: 重复创建非零退出
PASS: 明确报错拒绝覆盖
PASS: 已存在的 worktree 未被改动

########## 边界 2：不在 git 仓库内 → 明确报错、非零退出
fatal: not a git repository (or any parent up to mount point /)
Not inside a Git repository; run this from a repository checkout.
PASS: 非仓库内非零退出
PASS: 报错文案明确

########## 边界 3：.worktrees/ 未被忽略 → 只提示，不改 .gitignore
warning: /tmp/…/mono2/.worktrees/feat/demo-336 is not covered by .gitignore
Add '.worktrees/' to the repository root .gitignore before creating the worktree.
PASS: 未忽略时仍可创建（只警告）
PASS: 未自行修改 .gitignore

结果：ALL FIXTURES PASS（脚本 exit 0）

仓库回归（python:3.12-slim + git，Python 3.12.16，与 CI 同版本）：

$ python3 -m unittest discover -s .github/aicodingflow-tests   → exit 0，Ran 526 tests … OK
$ python3 -m unittest discover -s .github/tests                → exit 0，Ran 14 tests … OK (skipped=12)
$ python3 -m py_compile .github/scripts/*.py                   → exit 0

Risk

• 只改 skill 文档，不改脚本 / workflow / install.sh；但 .agents/skills 会被 install.sh 整目录同步到目标仓库，措辞即安装指引；
• 合并顺序：本 PR 基于 feature/AICF-1（已含 bug: git-worktree 在默认分支不是 main 的目标仓库中会选错或选不到 base #335 的 7a909ca），在 docs(skills): 统一 git-branch / git-worktree 的 base 解析 (#335) #340 合并前，本 PR 的 diff 会同时显示 bug: git-worktree 在默认分支不是 main 的目标仓库中会选错或选不到 base #335 的提交；建议先合 docs(skills): 统一 git-branch / git-worktree 的 base 解析 (#335) #340 再合本 PR，届时 diff 自动收缩为仅 bug: 从仓库子目录调用 git-worktree 会把 worktree 创建到错误目录 #336 的改动，不会产生同文件冲突；
• 目标已存在时直接失败（不自动清理）属于刻意的安全取舍。

How to revert

Revert 本 PR 的 merge commit；无数据、配置或安装脚本迁移。