mcpField
S
subtask4llm-pi

subtask4llm-pi

github.com/evgenyigumnov其他619 次安装1 天前更新
代码仓库

关于 subtask4llm-pi

Subtask4LLM for Pi 使用当前 Pi 会话规划并审查多步骤仓库任务，再由独立运行器依序启动 Pi worker。它适用于需要按顺序交接、且分离工作上下文有帮助的任务。

主要功能

  1. 01规划 1–10 个有序步骤
  2. 02试运行验证计划
  3. 03依序运行 Pi worker
  4. 04工作流统一实时日志
  5. 05审查最终报告和工作区差异

适用场景

  1. 01按步骤实现跨任务功能
  2. 02将有限范围的仓库改动交给 worker
  3. 03通过统一实时日志跟踪进度

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/evgenyigumnov/subtask4llm --skill subtask4llm-pi

安装后在 Claude Code 中输入/subtask4llm-pi确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
plan-format.md
scripts/
run_workflow.py
tests/
test_run_workflow.py

详细介绍

Pi 的 Subtask4LLM

将当前 Pi 会话用作规划器和审查者。scripts/run_workflow.py 中的独立运行器会在目标工作区中依次启动 Pi worker。

工作流

  1. 当请求的实现包含多个明确步骤，且按顺序交接有助于使用独立的工作者上下文时，选择此工作流。不要仅为使用运行器而拆分小改动。

  2. 检查代码库，并准备一份完整的第 1 版 JSON 计划，包含 1–10 个有序步骤。为每个步骤指定唯一 ID、范围明确的任务、非空验收标准，以及仅依赖更早步骤的依赖项。在计划中纳入共享的代码库发现、用户要求、约束、相关路径、设计决策和边缘情况，让工作者无需了解规划者的对话内容。

  3. 阅读 references/plan-format.md，将计划写入临时 JSON 文件，并在执行前使用 --dry-run 验证。

  4. 启动工作者前，向用户展示目标和有序的步骤标题，并为每个步骤简要说明其内容及依赖项。除非用户要求先审查或修改计划，否则随后启动工作流。

  5. 在目标代码库中运行运行器。

    在 macOS 或 Linux 上：

    python3 <skill-path>/scripts/run_workflow.py <plan.json> --workspace <repository>

    在 Windows PowerShell 上：

    py -3 <skill-path>\scripts\run_workflow.py <plan.json> --workspace <repository>

    仅当已知模型 ID 且需要覆盖已配置的模型时，才添加 --model <model-id>。否则，运行器会在设置了 PI_WORKFLOW_MODEL 时使用该变量，否则使用 Pi 配置的默认模型。只有任务需要这些控制选项时，才使用 --timeout-seconds、--timeout-checkpoint-seconds、--retries 0|1、--max-summary-chars、--pi-bin 或 --artifacts-dir。仅当用户希望前序步骤失败后仍运行后续步骤时，才添加 --continue-on-error；如果有任一步骤失败，最终工作流状态仍会报告失败。工件为可选项，且运行器拒绝覆盖现有的工件目标路径。

  6. 工作者以一次性 JSON 事件 Pi 进程运行，并使用 --mode json --no-session --no-skills。提示词通过标准输入发送，运行器会提取最终助手文本，该文本必须是符合文档结果架构的原始 JSON。运行器会将所有子任务和编排器的易读摘要流式写入一份工作流级实时日志；它不会为每次尝试创建单独的进度日志文件。运行开始时，运行器会打印日志路径和可直接复制的 tail -f 命令；使用 --live-log <path> 可指定其他路径。默认实时日志存储在系统临时目录中的工作区之外。日志包含工具命令及简短的输出或助手响应摘要，因此应将其视为可能包含敏感信息。运行器每 10 分钟检查一次进度；若某个 shell 命令 10 分钟未产生更新，则会停止该命令，否则运行器会继续运行，直至达到 30 分钟的硬性时限。超时诊断会包含近期活动，且不会重试。工作者仍会正常发现 AGENTS.md 上下文；运行器不会禁用上下文文件。每位工作者都会获得共享上下文、完整工作流图、分配给它的任务及验收标准，以及仅针对其声明依赖项的详细结果。 实时日志供用户跟进。运行器启动后，向用户提供日志路径和 tail -f 命令，然后等待运行器进程结束。不要反复轮询进程、单独运行 sleep 或 tail 检查、重新读取实时日志，也不要定时发送进度更新。只有用户提出要求或排障需要时，才再次检查进度。等待期间，运行器自身的进程监管和日志写入会继续进行。

  7. 非超时故障最多可按配置重试一次。超时和检测到的命令停滞不会重试。默认情况下，步骤持续未成功时，运行器会停止；添加 --continue-on-error 后，运行器会自行执行计划中的剩余步骤。运行器退出后，不要临时安排额外的工作者运行。

  8. 审查运行器的最终报告和实际工作区差异。按比例验证所请求的更改，然后报告变更文件、检查结果和未解决的风险。

前置条件和权限

运行此工作流前，必须已安装 Pi CLI 和为 Pi 配置的提供方，并且二者均可正常使用。此技能不会自动安装 Pi、提供方或其他工具。

Pi 工作进程命令可以使用当前用户的权限修改文件。Pi CLI 并非沙盒。仅在这些权限适用于所请求的仓库操作时使用运行器，保留无关更改，并且不要授权工作进程执行无关的外部操作。

参考资料

评论

支持 Markdown