---------------------- Parafork SKILL.md开始符号 ----------------------

Parafork 执行协议卡片

• 当你看到此段文字，代表用户意图显式激活此 SKILL, 同意并接受本文件约束。
• 读取并使用本 skill，即默认接受本文件全部硬约束。本文件是必须遵守的任务协议，不是参考建议。任何修改都必须遵循本协议，不得绕开流程直接改仓库。

Hard Gates（硬门闩）

• 术语定义

  • SIDE-EFFECT（状态变更操作）：任何会改变工作区、git 状态、worktree 元数据或审计状态的操作
  • 例如 init --new/--reuse、do commit、merge、apply_patch、写 paradoc/Log.txt）。

• 1) 目录与写权限

  • base repo 默认只读；在 base repo 仅允许 help/init。
  • 任何状态变更操作前，必须先进入 parafork worktree 根目录。

• 2) 命令白名单

  • 仅允许：help/init/do/check/merge。
  • do 仅允许：exec|commit；check 仅允许：status|merge。
  • do exec 仅允许参数：--strict。

• 2.1) base 分支策略（init --new）

  • 默认：base.branch=autodetect，直接使用当前分支作为 BASE_BRANCH。
  • 若 base.branch 为显式值且与当前分支不同：交互模式询问是否改用当前分支；非交互模式默认改用当前分支。

• 3) 统一审批门闩（唯一规则）

  • 凡命令包含 --yes --i-am-maintainer，执行前必须先获得人类明确批准。
  • 未获批准时必须 FAIL，禁止自行补门闩继续执行。

• 4) 复用门闩（init --reuse）

  • 仅允许通过 init --reuse 复用，且仅允许在已有 parafork worktree 内执行。
  • 必须携带 CLI 门闩：--yes --i-am-maintainer。

• 5) 并发锁门闩

  • 若 WORKTREE_LOCK_OWNER 非当前 agent，必须拒绝。
  • 锁冲突时必须输出：LOCK_OWNER/AGENT_ID/SAFE_NEXT/TAKEOVER_NEXT。
  • 锁冲突时必须满足：NEXT=SAFE_NEXT，且 SAFE_NEXT=init --new。
  • TAKEOVER_NEXT 仅为高风险备选（获批后才可执行）。

• 6) 合并门闩（merge）

  • merge 禁止自动执行；仅 maintainer 显式批准后运行。
  • 必须携带 CLI 门闩，并通过 merge 前检查链。

• 7) 执行安全规则

  • 脚本优先：有脚本能力时禁止裸 git 替代。
  • 检测到 merge/rebase/cherry-pick 冲突态时，仅可诊断与建议；未经人类明确批准，禁止继续推进冲突相关 git 动作。

• 8) 数据与审计规则

  • .worktree-symbol 仅作 KEY=VALUE 数据文件（按首个 = 解析），禁止 source/eval/dot-source/Invoke-Expression。
  • .worktree-symbol 与 paradoc/ 默认不得进入 git history。
  • worktree 内执行输出应追加到 paradoc/Log.txt。

固定顺序（执行算法）

1. 判定请求类型：
   • READ-ONLY（解释/检索/审阅）
   • WRITE/SIDE-EFFECT（状态变更操作）
2. 若为状态变更操作：
   • 先写/更新 plan（优先遵守人类给定计划）
   • 再按平台只读取一个执行路由（Bash 或 PowerShell）
   • 若命令含 CLI 门闩，先发审批请求并等待明确同意
3. 审批请求必须复用以下固定模板：

审批请求：
- 目的：<为什么要执行>
- 命令：<完整可复制命令>
- 风险：<可能影响/失败后果>
- 回退：<失败后的回滚或退出路径>

失败分支（Failure Output）

• 目录不确定：先 help --debug；仍不确定则停止并请求人类确认目标 repo/worktree。
• 收到状态变更操作请求但不在 worktree：先 init --new，再 do exec，之后才可改动。
• 复用缺少 CLI 门闩或用户未明确复用：直接 FAIL，NEXT 指向补齐门闩后的完整命令。
• 需要 CLI 门闩但未获人类批准：直接 FAIL，输出审批模板，禁止继续执行。
• 锁冲突：直接 FAIL；输出 LOCK_OWNER/AGENT_ID/SAFE_NEXT/TAKEOVER_NEXT，且 NEXT=SAFE_NEXT。
• 旧命令请求：直接 FAIL（如 watch、do pull、check diff/log/review）。

路由入口（Route Entry）

• Bash：references/route-bash.md
• PowerShell：references/route-powershell.md

补充参考（非执行入口）：

• references/scripts.md
• references/wiki.md

---------------------- Parafork SKILL.md截止符号 ----------------------