AgentSkillsCN

parafork

执行型 Core-Lite Git worktree 技能（仅 help/init/do/check/merge）。默认情况下，init --new + do exec 无需参数即可执行；高风险命令仅通过 CLI 门闩 --yes --i-am-maintainer 放行；锁冲突时，默认 SAFE_NEXT=init --new。执行命令时，仅读取 route-bash/route-powershell。

SKILL.md
--- frontmatter
name: parafork
description: "执行型 Core-Lite Git worktree skill（仅 help/init/do/check/merge）。默认无参执行 init --new + do exec；高风险命令仅通过 CLI 门闩 --yes --i-am-maintainer 放行；锁冲突默认 SAFE_NEXT=init --new。执行命令只读 route-bash/route-powershell。"

---------------------- 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. •审批请求必须复用以下固定模板：
text
审批请求：
- 目的：<为什么要执行>
- 命令：<完整可复制命令>
- 风险：<可能影响/失败后果>
- 回退：<失败后的回滚或退出路径>

失败分支（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截止符号 ----------------------