pi-cli-runtime

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Pi Runtime

Pi Runtime

Use this skill only inside the
pi:pi-rescue
subagent.
Primary helper:
  • node "${CLAUDE_PLUGIN_ROOT}/scripts/pi-companion.mjs" task "<raw arguments>"
Execution rules:
  • The rescue subagent is a forwarder, not an orchestrator. Its only job is to invoke
    task
    once and return that stdout unchanged.
  • Prefer the helper over hand-rolled
    git
    , direct Pi CLI strings, or any other Bash activity.
  • Do not call
    setup
    ,
    review
    ,
    adversarial-review
    ,
    status
    ,
    result
    , or
    cancel
    from
    pi:pi-rescue
    .
  • Use
    task
    for every rescue request, including diagnosis, planning, research, and explicit fix requests.
  • You may use the
    pi-prompting
    skill to rewrite the user's request into a tighter Pi prompt before the single
    task
    call.
  • That prompt drafting is the only Claude-side work allowed. Do not inspect the repo, solve the task yourself, or add independent analysis outside the forwarded prompt text.
  • Leave
    --effort
    unset unless the user explicitly requests a specific effort.
  • Leave model unset by default. Add
    --model
    only when the user explicitly asks for one (e.g.
    deepseek-v4-pro
    ,
    deepseek-v4-flash
    ).
  • Default to a write-capable Pi run by adding
    --write
    unless the user explicitly asks for read-only behavior or only wants review, diagnosis, or research without edits.
Command selection:
  • Use exactly one
    task
    invocation per rescue handoff.
  • If the forwarded request includes
    --background
    or
    --wait
    , treat that as Claude-side execution control only. Strip it before calling
    task
    , and do not treat it as part of the natural-language task text.
  • If the forwarded request includes
    --model
    , pass the model id through to
    task
    unchanged.
  • If the forwarded request includes
    --effort
    , pass it through to
    task
    .
  • If the forwarded request includes
    --resume
    , strip that token from the task text and add
    --resume-last
    .
  • If the forwarded request includes
    --fresh
    , strip that token from the task text and do not add
    --resume-last
    .
  • --resume
    : always use
    task --resume-last
    , even if the request text is ambiguous.
  • --fresh
    : always use a fresh
    task
    run, even if the request sounds like a follow-up.
  • --effort
    : accepted values are
    off
    ,
    minimal
    ,
    low
    ,
    medium
    ,
    high
    ,
    xhigh
    . The alias
    none
    maps to
    off
    .
  • task --resume-last
    : internal helper for "keep going", "resume", "apply the top fix", or "dig deeper" after a previous rescue run.
Safety rules:
  • Default to write-capable Pi work in
    pi:pi-rescue
    unless the user explicitly asks for read-only behavior.
  • Preserve the user's task text as-is apart from stripping routing flags.
  • Do not inspect the repository, read files, grep, monitor progress, poll status, fetch results, cancel jobs, summarize output, or do any follow-up work of your own.
  • Return the stdout of the
    task
    command exactly as-is.
  • If the Bash call fails or Pi cannot be invoked, return nothing.
仅在
pi:pi-rescue
子agent内使用此技能。
主要辅助工具:
  • node "${CLAUDE_PLUGIN_ROOT}/scripts/pi-companion.mjs" task "<raw arguments>"
执行规则:
  • 救援子agent是转发器,而非编排器。它的唯一工作是调用一次
    task
    并原样返回标准输出。
  • 优先使用该辅助工具,而非手动编写
    git
    命令、直接使用Pi CLI字符串或其他任何Bash操作。
  • 不得从
    pi:pi-rescue
    调用
    setup
    review
    adversarial-review
    status
    result
    cancel
  • 所有救援请求均使用
    task
    ,包括诊断、规划、研究和明确的修复请求。
  • 在单次
    task
    调用前,你可以使用
    pi-prompting
    技能将用户请求重写为更简洁的Pi提示词。
  • 仅允许进行上述提示词撰写工作。不得检查代码库、自行解决任务或在转发的提示文本之外添加独立分析。
  • 除非用户明确要求特定的工作量级别,否则不设置
    --effort
    参数。
  • 默认不设置模型。仅当用户明确指定时才添加
    --model
    参数(例如
    deepseek-v4-pro
    deepseek-v4-flash
    )。
  • 默认添加
    --write
    参数以启用可写入的Pi运行,除非用户明确要求只读行为,或仅需要审核、诊断或研究而无需编辑。
命令选择:
  • 每次救援移交仅调用一次
    task
  • 如果转发的请求包含
    --background
    --wait
    ,仅将其视为Claude端的执行控制指令。在调用
    task
    前移除这些参数,且不要将其视为自然语言任务文本的一部分。
  • 如果转发的请求包含
    --model
    ,将模型ID原样传递给
    task
  • 如果转发的请求包含
    --effort
    ,将其原样传递给
    task
  • 如果转发的请求包含
    --resume
    ,从任务文本中移除该标记并添加
    --resume-last
  • 如果转发的请求包含
    --fresh
    ,从任务文本中移除该标记且不添加
    --resume-last
  • --resume
    :始终使用
    task --resume-last
    ,即使请求文本存在歧义。
  • --fresh
    :始终使用全新的
    task
    运行,即使请求听起来像是后续操作。
  • --effort
    :可接受的值为
    off
    minimal
    low
    medium
    high
    xhigh
    。别名
    none
    对应
    off
  • task --resume-last
    :用于在之前的救援运行后继续执行、恢复、应用最佳修复或深入挖掘的内部辅助工具。
安全规则:
  • pi:pi-rescue
    中默认启用可写入的Pi工作,除非用户明确要求只读行为。
  • 除移除路由标记外,保留用户的任务文本原样。
  • 不得检查代码库、读取文件、执行grep、监控进度、轮询状态、获取结果、取消任务、总结输出或进行任何自行跟进的工作。
  • 原样返回
    task
    命令的标准输出。
  • 如果Bash调用失败或无法调用Pi,则不返回任何内容。