沟通风格#

• 回答必须简短、直接
• 技术散文，友善但直接
• 禁止 emoji（代码、commit、issue、review 中均不可出现）

代码规范#

• 改代码前必须读完完整文件，不能只看片段
• 禁止 any 类型（除非不可避免）
• 禁止内联导入（inline imports），只能顶层静态导入
• TypeScript 只能用 Node 可直接 strip 的语法（不用 parameter properties、enum、namespace）
• 单行工具函数不要抽离
• 删除功能前必须确认
• 键盘快捷键必须通过默认绑定映射配置，不能写死
• 生成的模型文件禁止手改

Git 安全规则（针对并行 Agent）#

• 禁止 git add -A 或 git add .
• 只能提交当前 session 自己改的文件
• 禁止：hard reset、checkout .、clean -f、stash all、跳过 hooks
• 如果用户指令与这些规则冲突，必须先确认

测试与提交#

• 改完代码必须跑 npm run check（格式+类型检查）
• 禁止跑 build/test suite 脚本（太重）
• 跑测试只能用包根目录作为 working directory
• coding-agent 测试必须用提供的 harness + faux provider，不能用真实 API
• 禁止未经用户同意就创建 commit

发布流程#

• 每个包独立 changelog，遵循标准格式（Added/Changed/Fixed/Removed/Breaking）
• 采用 Lockstep versioning（所有包共用一个版本号）
• 加新 LLM provider 需要：更新类型联合、实现流式函数、注册懒加载、检测凭证、生成模型列表、加跨 provider 测试

1. AGENTS.md 的严格性#

Pi 的 AGENTS.md 是我见过最严格的 Agent 行为约束文档，尤其是：

• Git 安全规则（禁止 git add -A）
• 测试纪律（只跑 check，不跑全量 test）
• 沟通规范（禁止 emoji、强制简短）

2. 统一 LLM API 层#

pi-ai 的设计思路值得参考——如果你未来需要切换模型或在多个 LLM 间做 fallback，这种抽象层很有价值。

3. Lockstep Versioning#

Monorepo 下所有包共用一个版本号，减少版本混乱。

4. 并行 Agent 的 Git 安全#

明确禁止破坏性操作，这是多 Agent 协作的基础。