PI 智行合一引擎
为编程及相关工作流提供可切换认知策略、分级推理与验证交付规范。
- Star 数
- ★ 108
- 最近更新
- 4 个月前
- License
- Apache-2.0
- 主语言
- HTML
- FA 评分
- 34/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要让 Claude Code 按明确步骤实现并验证代码的开发者，可使用编程道场及其验证标准。
- 不适合
- 只使用未列出平台、且不愿适配配置的团队
- 不能在本地运行决策可视化依赖的 Git 和 Node.js/npm 的用户
这个 Agent 能做什么，适合哪些场景？
PI 是一套面向 AI 编程助手及相关任务的技能与配置，提供六种认知原型、九类工作场景和轻量、标准、深度三档模式。它包含编程、测试、产品和运营四大道场，以及场景路由、任务拆解、验证矩阵和交付质量门等工作规范。Claude Code 可通过插件安装；Codex CLI、Gemini CLI、Copilot CLI、Qwen Code 等平台可按 README 所列方式安装技能文件，Cursor 和 Kiro 使用各自的规则或 steering 文件。可选的本地可视化器用 TypeScript、React 和 Vite 将 ~/.pi/decisions 中的决策历史呈现为交互式页面。它不提供独立托管推理服务；实际运行依赖所安装的宿主平台，README 未说明其模型费用。
安装后，PI 的 SKILL.md 或平台对应配置为宿主 AI 提供认知模式、场景路由和任务执行规范：根据任务选择场景与难度，按要求拆解问题、验证改动，并按编程、测试、产品或运营道场的质量标准检查交付。对多 Agent 任务，README 描述 Leader、Teammate 和 Coach 角色，并提供 agents/pi-teammate.md、agents/pi-coach.md 模板。安装器 install.sh 可交互检测平台并选择语言；可视化启动器 ~/.pi/visualize.sh 可将 ~/.pi/decisions 中的脱敏决策历史展示为可交互决策树，支持时间线回放、存档导入导出和 WebSocket 实时预览。
- 需要让 Claude Code 按明确步骤实现并验证代码的开发者，可使用编程道场及其验证标准。
- 负责质量保障的工程师，可用测试场景组织边界覆盖、执行和失败定位。
- 产品经理可通过产品决策场景拆解用户痛点、比较方案并明确可度量指标。
- 小组使用多个 AI Agent 处理跨文件任务时，可采用 Leader、Teammate 和 Coach 的协作角色及模板。
- 希望回看 AI 决策过程的开发者，可启动本地可视化器查看决策树与时间线。
如何安装或部署这个 Agent？
推荐使用仓库提供的一键安装器；该命令需要网络和 shell，并会交互选择平台与语言：
curl -fsSL https://raw.githubusercontent.com/share-skills/pi/main/install.sh | bash也可按宿主平台手动安装。例如 Codex CLI：
mkdir -p ~/.codex/skills/pi && cp skills/pi/SKILL.md ~/.codex/skills/pi/SKILL.mdClaude Code 可用 Marketplace 命令安装：
claude install-plugin https://github.com/share-skills/piREADME 未列出模型密钥要求或费用；需使用相应宿主平台。若运行可视化器，首次启动需要 Git 和 Node.js/npm。
如何使用这个 Agent？
完成安装后，在对应宿主中使用其 AI 助手执行任务，PI 的技能或平台配置会提供场景、难度和交付规范。README 没有给出一条跨平台通用的首次提示语。要查看本地决策记录，可运行：
~/.pi/visualize.sh首次启动可视化器时会按需引导安装运行时，要求 Git 和 Node.js/npm。若宿主接入了仓库所述的 commands/ 路由，也可使用：
/pi visualize这个 Agent 有哪些优点和局限？
- 提供轻量、标准、深度三档模式，并将场景与认知策略组合，便于按任务调整流程。
- 编程道场明确列出调试六步、审码五维和编译及测试等交付检查项。
- README 给出 Claude Code、Codex CLI、Cursor、Kiro 等平台的具体安装路径，并提供中文和英文版本。
- 可选可视化器支持决策树、时间线、脱敏存档导入导出及 WebSocket 实时预览。
- PI 通过宿主平台的技能、插件或规则生效，实际行为和可用能力取决于宿主。
- 平台安装方式并不统一；渐进式 references 仅明确支持 Claude Code、Copilot CLI 和 OpenClaw，Cursor/Kiro 需使用完整单文件版。
- 可视化器首次运行需要 Git 和 Node.js/npm；其部署和运行细节多于单独安装技能文件。
- README 未说明模型费用、所需凭证或各宿主平台的具体模型能力。
这个 Agent 与同类方案有什么区别？
README 将 PI 与固定人格、单一激励、失败即停等传统提示方式作了对比，并说明其采用动态认知原型、六阶战势和验证交付流程；没有提供与其他具名产品的对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PI 智行合一引擎 当前 | 34 · 缺口较多 | Agent 插件 / 技能 | ★ 108 | 4 个月前 | HTML | Codex · Claude Code |
| Agentic Plugin Marketplace | 66 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 42k | 3 天前 | Python | Codex · Claude Code |
| EOC — Everything OpenAI Codex 工作流操作系统 | 75 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 80 | 5 个月前 | JavaScript | Codex |
| Spec Kit 多运行时技能集 | 51 · 缺口较多 | Agent 插件 / 技能 | ★ 170 | 2 天前 | Shell | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 推荐 curl | bash 一键安装，并会写入 ~/.pi/visualize.sh 且首次运行按需拉取运行时（git/node/npm），属于外部副作用且缺少回滚/卸载说明，故 rollback 记 0；least_privilege、user_confirmation、data_flow_transparency、sensitive_data_handling 仅见零散描述（如可视化器声称对决策档案做隐私清洗），无具体机制或确认流程，均记 1；依赖安全无锁定或审计证据，记 1；source_attribution 仅引用经典文献，未标注代码/素材来源，记 1。
README 内部存在不一致：标题称 v23.2.0，而描述与徽章体系庞杂，部分表格（如“十条戒律”只列五条）自相矛盾，self_consistency 记 1；依赖可用性仅提及 git/node/npm 需求，无版本约束，记 1；失败信息与错误处理在可见文件中无体现，记 1。
面向多平台（Claude Code、Codex、Cursor 等）与多场景（编程/测试/产品/运营）覆盖较广，audience_and_scenarios 与 environment_fit 记 2；但能力边界多为营销式断言，缺少明确“不做什么”的界定，capability_boundaries 记 1；触发精度依赖关键词路由表，无具体匹配规则证据，记 1。
信息架构清晰（分层目录、渐进披露、多语言），install_notes 提供多平台安装步骤，license 为完整 Apache-2.0 文本，均记 2；命名稳定性因版本号与目录命名（pi/pi-en）存在漂移风险记 1；示例以截图为主、缺少 FAQ，记 1；无已知限制章节记 0；版本化仅有徽章与 release 工作流，无 changelog 记 1；维护责任因发布者未验证且无维护者说明记 1。
输出可用性依赖大量截图与表格，缺少可复现的输入输出样例，记 1；边际价值相对通用提示词工程的增量难以从静态文件证实，记 1；成本收益方面声称节省约 43% token 但无基准数据支撑，记 1。
README 大量断言（如“工具验证交付”“节省 43% token”）无可追溯来源，claim_traceability 记 0；benchmark 目录下的测试文件与 PI 产品本身无对应关系，无法交叉印证，cross_source_corroboration 记 0；事实与推断混杂（如“真实截图”无法核实），fact_inference_separation 记 0。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 一键安装使用 curl | bash 并会写入用户目录、按需拉取运行时，建议先审阅 install.sh 与 setup-standalone-visualize.sh 再执行，并确认卸载/回滚方式。
- README 存在自相矛盾与夸大式断言（如“十条戒律”仅列五条、token 节省比例无基准），不应据此推断实际效果。
- 发布者身份未经验证，维护责任与更新路径不明确，采用前应确认维护状态。
- benchmark 目录中的测试文件与 PI 产品无对应关系，不能作为其质量证据。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Full Changelog: https://github.com/share-skills/pi/compare/1.1.7...1.1.8 Full Changelog: https://github.com/share-skills/pi/compare/1.1.7...1.1.8在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/share-skills/pi/compare/1.1.6...1.1.7 Full Changelog: https://github.com/share-skills/pi/compare/1.1.6...1.1.7在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/share-skills/pi/compare/1.1.5...1.1.6 Full Changelog: https://github.com/share-skills/pi/compare/1.1.5...1.1.6在 GitHub 查看 ↗
常见问题
PI 本身是否包含模型或托管推理服务？
哪些平台有明确安装步骤？
可视化器会展示什么？
~/.pi/decisions 中的脱敏决策历史呈现为交互式决策树，并支持时间线、存档导入导出和实时预览。