@fitchmultz/pi-workflows

中文文档
0.2.10发布于 2026/11/03MITES Module零依赖构建来源已验证近 30 天下载 1960

Pi-native recipe workflows and scripted agent()/pipeline() runtime

此软件包已被标记为弃用

No longer maintained. The repository is archived.

原始使用文档
文档目录7 节
  1. Install and start
  2. Optional recipe integrations
  3. Choose a recipe
  4. Run a scripted workflow
  5. Control a run
  6. More detail
  7. License

pi-workflows

pi-workflows adds development recipes and scripted workflows to Pi. Recipes use specialist agents; scripted workflows coordinate parallel workers.

A request in Pi branches into recipes with specialist review gates and product deliverables, or an approved script with parallel workers and collected results.

Install and start

pi-workflows requires Pi; see the compatibility requirements. The scripted workflow / agent() / pipeline() runtime works independently, without other extensions.

Run these commands from your project directory:

pi install npm:@fitchmultz/pi-workflows
pi

Then run this command in Pi:

/workflows

/workflows lists 17 recipes, 31 skills and 25 agents. It reports unavailable recipe integrations without disabling scripted workflows.

Optional recipe integrations

Recipes inherently use isolated specialists, parallel reviews, progress tools and explicit approval gates. They require a supported Pi Subagents version (or a compatible subagent executor with agent/task/label/tasks), todo_list, ask_question, and agent_browser_web_search. All four are hard runtime prerequisites for every recipe, even recipes without external research. These are extension integrations, not native Pi tools.

pi install npm:@fitchmultz/pi-subagents
pi install git:github.com/fitchmultz/pi-todo-list
pi install npm:@fitchmultz/pi-ask-question
pi install npm:pi-agent-browser-native

Configure EXA_API_KEY for Exa or BRAVE_API_KEY for Brave when using recipe research. Provider charges apply.

Owned /recipe-* and /skill:recipe-* invocations stop before model work when required tools are missing, disabled or incompatible. Cold Subagents is supported through its advertised load_subagent loader; native discovery can restore selected, instruction-group-deferred tools. A denied recipe reports the exact tools and does not steer an unrelated running turn. Text/JSON print mode also writes the diagnostic to stderr and exits nonzero.

Recipe instructions then verify specialist profiles and provider/dialog readiness before use; a missing capability is reported, not replaced with inline specialists, serialized reviews or assumed approval. The same instructions apply when a model reads a recipe skill directly. That model-read path is guidance, not a deterministic runtime guard.

Choose a recipe

Recipes use named agents and include approval points. Type /recipe to see recipe commands.

TaskCommand
Plan a feature/recipe-design Add account recovery
Build a backend or general change/recipe-implement Add rate limiting to the public API
Investigate a bug/recipe-diagnose Login returns 500 after deploy
Design frontend screens/recipe-front-design Add account recovery screens
Build a full-stack feature/recipe-fullstack-implement Add account recovery
Review a design/recipe-review docs/design/rate-limit.md

For frontend work, run /recipe-front-design. Next, run /recipe-front-plan. Then run /recipe-front-build.

Run a scripted workflow

Use a scripted workflow for repeated tasks across many files. Ask Pi to write one:

use a workflow to audit every route handler under src/routes/ for missing auth

The editor highlights the trigger phrase. Press Alt+W / Option+W to dismiss the highlight.

The terminal UI shows these choices before the script runs:

ChoiceAction
OnceRun the script once.
AlwaysSkip future approval for this workflow name in this project.
ViewRead or edit the script. Then return to the approval card.
DenyCancel the script before it runs.

Run /deep-research <question> to use the bundled research script.

Scripted workers use native file and shell tools. They do not inherit recipe agents or browser tools.

Workers can change files and run shell commands. Approve only scripts you trust. The runtime has no security sandbox or CPU deadline.

RPC requests confirmation for names without Always approval. Non-UI mode runs scripts without confirmation.

Each worker makes model calls. Large runs use more of your model allowance.

Control a run

Use /workflows to view, pause, resume, stop or save a run. Runs and the resume cache last for the current extension session.

Save writes the script to .pi/workflows/<name>.js. Pi adds the /<name> command in the next session.

/workflow-size shows the agent-count guideline. Set it with /workflow-size small, medium, large or unrestricted. The default is medium: fewer than 15 agents.

The runtime permits at most 16 workers at once and 1,000 calls per run. Size guidelines do not change these limits.

More detail

Read Scripted workflows for script examples, worker results and resume behavior.

Read Development for compatibility requirements, Git installs, the repository layout, build commands and host qualification.

Read the changelog for changes. Report problems or suggestions in issues.

License

MIT.

版本与发布记录

@fitchmultz/pi-workflows 共发布 11 个版本,首次发布于 2026/10/06;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.10latest2026/11/0312 天前
0.2.92026/11/0313 天前
0.2.82026/11/0313 天前
0.2.72026/11/0213 天前
0.2.62026/11/0213 天前
0.2.52026/11/0213 天前

关于 @fitchmultz/pi-workflows 的常见问题

@fitchmultz/pi-workflows 是什么?

Pi-native recipe workflows and scripted agent()/pipeline() runtime注意:该包已被作者标记为弃用——No longer maintained. The repository is archived.

如何安装 @fitchmultz/pi-workflows?

在项目目录运行 npm install @fitchmultz/pi-workflows,或使用 pnpm add / yarn add / bun add。

@fitchmultz/pi-workflows 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fitchmultz__pi-workflows 是否存在。

@fitchmultz/pi-workflows 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fitchmultz/pi-workflows 可以商用吗?

@fitchmultz/pi-workflows 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fitchmultz/pi-workflows 的下载量有多少?

根据 npm 官方下载统计,@fitchmultz/pi-workflows 在 2026/10/15 – 2026/11/13 这 30 天内被下载 1,960 次,日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fitchmultz/pi-workflows 还在维护吗?

最新版本 0.2.10 发布于 2026/11/03(12 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/06。作者已将其标记为弃用,新项目建议寻找替代方案。