omp packages

pi-agents-workflow0.1.1

Register .agents/workflows/*.md as native-style pi slash commands: each markdown file becomes a /command that expands with native prompt-template argument semantics.

GitHub Actions Published 1 month ago MIT ~312 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

pi-agents-workflow

把 .agents/workflows/*.md 注册成 pi 斜杠命令，行为与 pi 原生 prompt template 完全一致。

每个 markdown 文件变成一个 / 命令：/名称 参数 用 pi 原生的参数替换语义展开文件正文，并作为用户消息发送到当前会话——不派 subagent、不切上下文。适合放进 .agents/ 的流程手册（PM 编排规则、验证清单、发布流程）。

.agents/
├── skills/          ← pi 原生就读这里
└── workflows/       ← 装上本包后 pi 也会读这里
    ├── deploy.md
    └── dev-agent-cycle.md

安装

pi install npm:pi-agents-workflow

不想安装可以先试用：

pi -e npm:pi-agents-workflow

用法

假设 .agents/workflows/deploy.md：

---
description: 把服务部署到指定环境
argument-hint: "<env>"
---
Deploy to ${1:-prod} with these extras: ${@:-none}.

在 pi 里输入 /deploy staging --fast，实际发送：

Deploy to staging with these extras: staging --fast.

（$@ 是全部参数拼接——与原生模板一致。）

  • /deploy — 展开并发送该 workflow（自动补全显示 description + 参数提示）
  • /agents-workflows — 列出已发现的 workflow、扫描目录和问题

作用域

作用域 目录 说明
项目 <项目>/.agents/workflows/*.md 同名时项目级优先
用户 ~/.agents/workflows/*.md 跨项目共享

发现逻辑为非递归，与原生 prompts/ 一致。会话中途新增的文件提交时依然可用（input 事件兜底）；自动补全里的出现要等 /reload 之后。

文件格式

与原生 prompt template 相同：

  • 文件名（去掉 .md）即命令名——用单 Token 名称（dev-agent-cycle.md，不要 my flow.md）
  • description — 自动补全文案；缺省用正文第一行非空行
  • argument-hint — 自动补全里渲染为 <提示> — 描述
  • 正文 — 模板内容，支持完整的原生参数替换：
    • $1、$2、… 位置参数
    • $@ / $ARGUMENTS — 全部参数拼接
    • ${1:-default}、${@:-default} — 缺省值
    • ${@:N}、${@:N:L} — 参数切片

其余 frontmatter 键忽略（向前兼容）。

注意

  • 扩展命令优先于 .pi/prompts/ 里的同名原生模板——两边都用的话请避免重名。
  • 展开只发生一次；以 / 开头的正文不会链式触发另一个命令。
  • 本包不派 subagent。想让 workflow 作为 subagent 任务执行，请配 pi-subagents 用它自己的 prompts 目录。

开发

npm install
npm test             # node:test 测试
npm run typecheck    # tsc --noEmit
pi -e .              # 交互式试用

MIT License。