用途:为 pi 编程智能体编写自定义系统提示词补充内容。pi 自带包含身份、工具与准则的默认系统提示词,本技能说明应通过 SYSTEM.md(替换默认)或 APPEND_SYSTEM.md(扩展默认)添加什么内容。
主要能力:pi 动态构建系统提示词,顺序为身份→工具→准则→文档→追加→上下文→技能→元数据。SYSTEM.md 替换默认提示词,APPEND_SYSTEM.md 扩展默认提示词。位置包括 .pi/SYSTEM.md(项目)、~/.pi/agent/SYSTEM.md(全局)或 --system-prompt(CLI)。
可编写的内容分四部分,均为可选:核心原则(编码标准与架构偏好,如简洁性、代码质量、代码库健康、构建验证、安全);行为准则(调试、架构、测试、范围、错误处理、文档、用户指令);自定义工具使用准则(仅针对扩展带来的工具,内置工具自动记录);项目特定上下文(AGENTS.md/CLAUDE.md 未覆盖的约定)。
架构建议:优先用 APPEND_SYSTEM.md 扩展,非必要不替换 pi 默认提示词;仅在需根本改变行为时用 SYSTEM.md。用 XML 标签组织原则,规则应简洁、基于价值(如“范围神圣”),避免过程性细节、代码片段、变量名或分步场景。
校验清单:不重复 pi 默认内容(身份、日期、工具、技能);原则简洁且基于价值;用 XML 标签逻辑组织;原则中无代码片段或变量名;自定义工具准则仅限扩展工具;项目上下文仅限非显而易见的约定;文件放置正确;不包含政治、伦理或道德观点;聚焦智能体问责与事实性。
限制:资料未提供具体示例文件内容、安装命令或版本要求。