PI
CODE

Technical Narrative · Team Talk

Pi Code：把 Coding Agent 变成你的工作台

Pi 不是又一个封闭 IDE，也不是一个固定工作流。它是一个极简终端 coding harness：核心保持小，把能力交给工具、技能、扩展和你自己的团队规则。

Core thesis

Pi 的核心价值不是替你写几行代码，而是让 AI 协作进入 文件、命令、会话和团队流程。

Definition

Pi 是一个 minimal terminal coding harness。

默认给模型四个基本工具：读文件、写文件、精确编辑、执行命令。然后让你用 Skills、Extensions、Prompt Templates、Themes 和 Packages 按自己的流程扩展。

toolsread / edit / bash

contextrules / project state

skillson-demand workflows

extensionsruntime hooks

modesterminal / RPC / SDK

Codex-generated visual, used as an abstract harness map without readable labels.

Design choice

Pi 故意不把所有功能做进核心。

没有内置 plan mode、sub-agents、permission popups、MCP-first 等大而全设定。它的答案是：核心小，扩展点强。

小核心

更少默认假设。

强扩展

把 workflow 做成技能和扩展。

可组合

不同团队装不同包。

可审计

能力边界写在文件里。

Four modes

同一个 agent，可以出现在四种场景。

01

Interactive

终端里的日常协作界面。

02

Print / JSON

脚本化、一次性任务、CI 输出。

03

RPC

作为子进程接入其他系统。

04

SDK

嵌入自己的应用或工作流。

Daily loop

日常使用像是在终端里和一个能动手的同事协作。

你给目标，它读项目、跑命令、改文件、解释取舍；会话保存成树，可以继续、分叉、压缩、导出。

ask把目标和约束交给 agent，而不是只问一段答案。

inspect读文件、查项目规则、确认真实环境。

act执行命令、精确编辑、生成或修改产物。

verify跑检查、总结取舍，再继续或分叉。

Context system

Pi 用文件承载团队上下文。

AGENTS.md

项目规则、命令约定、安全边界、沟通风格。

Skills

按任务触发的专门工作流，避免把所有说明塞进常驻上下文。

Prompts

可复用的命令式提示模板，适合 review、release、复盘等高频动作。

Skills

Skill 是把经验变成可复用能力的最小单位。

一个目录、一个 SKILL.md，再加脚本、参考文档和资产。触发描述负责路由，正文负责执行。

my-skill/
├─ SKILL.md
├─ scripts/
├─ references/
└─ assets/

Extensions

Extension 是改造 Pi 行为的 TypeScript 插件层。

注册工具给模型新增可调用能力，例如部署、搜索、内部系统查询。

拦截事件在 tool_call、session、context、model events 上加治理逻辑。

定制 UI增加命令、确认框、状态栏、面板，甚至替换编辑器体验。

Packages

Pi Package 让团队能力可以分发。

一个 package 可以包含 extensions、skills、prompts、themes。可以来自 npm、git、URL 或本地路径，并支持项目级安装。

package.json pi: { extensions, skills, prompts, themes } install → config → reload → use

Codex-generated visual, used as an abstract package and extension ecosystem.

Integration surface

从个人终端到系统集成，有一条连续路径。

个人使用

交互式 Pi，处理代码和文档。

团队规则

AGENTS.md、skills、prompts。

运行时治理

extensions 拦截和增强。

产品集成

RPC / SDK 嵌入业务系统。

Takeaway

Pi Code 的宣讲重点，不是“AI 会写代码”。

重点是：我们可以把 AI 协作变成一套可沉淀、可审计、可扩展的工程工作台。

Start small

01从一个项目规则文件开始。

02把一个重复流程做成 skill。

03再把需要治理的地方做成 extension。