Pi — Minimal Terminal Coding Harness You Own

简介

Pi 是一个极简的终端编码 harness：通过扩展、skills 与 prompt 模板自定义成你的个人/团队 agent 外壳，并用上下文文件固化规则，避免被某个固定 UX 绑死与被动迁移。

• 适合谁： 想把 agent 工作流脚本化、并能跨项目复用扩展（skills/prompt/UI）的开发者
• 可搭配： Node.js + npm；支持交互模式与一次性 -p；支持 AGENTS.md 等上下文文件
• 准备时间： 15–30 分钟

实战建议

• 在每个仓库用 AGENTS.md 写清规则（测试、迁移、输出格式等）。
• 先跑通一个核心工作流（lint/test/fix），再按需增加扩展。

为什么“harness”很重要

很多 coding agent 是固定产品形态；Pi 刻意保持核心很小，便于你：

• 用上下文文件固化团队规则，
• 把 skills/prompts 做成可复用积木，
• 跨仓库保持一致的交付标准。

团队推荐落地方式

1）写清项目规则

在仓库根目录加 AGENTS.md：

- 改代码后必须跑 `npm test`。
- 不要修改生产迁移脚本。
- PR 总结不超过 10 行。

2）把“完成标准”教给 Pi

让 Pi 按固定节奏做事： 1）找项目脚本（package.json/Makefile 等），
2）运行检查，
3）给出最小 diff，
4）再跑一次检查验证。

一次性模式用于自动化

Pi 也支持非交互 prompt：

pi -p "Summarize this repo and tell me how to run checks."

适合 CI 助手或定时的仓库 hygiene 任务。

FAQ

Pi 是模型吗？ 答：不是。它是一个连接多种 provider 的 harness，并暴露 tools/skills/自定义能力。

怎么跨仓库保持一致行为？ 答：复用共享 skills/prompts，并在每个仓库用 AGENTS.md 固化规则。

能非交互使用吗？ 答：可以。用 pi -p "..." 做一次性调用，适合脚本或 CI。