# pi-model-system-prompt
让不同大模型能够使用不同的系统提示词。
切换大模型时，按当前激活的 model id，把该模型专属的 system prompt 追加到上下文。

[English](README.md)

## 为什么需要这个插件
不同的大模型，除了能力不同，其实还需要不同的harness方式。

Harness的水平，极大程度的影响大模型的发挥，这已经是业界公认的事实。

表现在agent中, 如claude code, codex, pi agent，那就是启动时针对特定模型加载的系统提示词。

在我们使用Pi agent的过程中，可能使用多个不同来源的大模型进行混用，这种用法也是Pi Agent这种高自由度coding agent的魅力。

那么在Pi agent中切换不同模型时，最好能让不同模型能使用各自独立的系统提示词，可是pi agent本身并没有这种能力。

本插件提供此能力。

## 安装

```sh
pi install npm:pi-model-system-prompt
```

装完重启 Pi。

## 快速开始
安装完毕后自动生效。插件会选取 ~/.pi/agent/model-system-prompt/ 下**文件名是当前 model id 最长前缀**的那个 md 文件，把它的内容追加进 pi agent 的系统提示词。例如 model 为 glm-5.3-flash 时依次看 glm-5.3-flash.md、glm-5.3.md、glm.md，取存在且最长的那一个。不区分大小写；没有任何文件匹配的模型完全不受影响。

需要自己写特定模型的系统提示词时，只需要在 ~/.pi/agent/model-system-prompt/ 目录下添加与该 model 同名的 md 文件——或者用它所归属的同族名，此后以该名字开头的所有 model id 都会用它——并在文件中编写即可。打开 pi 时会自动加载。

插件提供优质的预置提示词。注意，由于开源模型存在不同精度和微调，所以预置提示词的调校均基于各自的官方模型，不对非官方模型效果做保证。鼓励用户根据自己使用的模型自己调控系统提示词。

预置系统提示词的模型列表
* MiniMax-M3
* MiniMax-M3.1-Flash-Preview
* claude-sonnet-5、claude-haiku-5（Claude Code 的完整版系统提示词）
* claude-opus-5、claude-fable-5（Claude Code 的较短版系统提示词）
* deepseek-flash
* glm-5.3-flash
* glm-5.3
* gpt-5.6（gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra——codex 给这三个档同一份提示词，因此一个族文件）
* gpt-6-luna、gpt-6-sol、gpt-6-astra、gpt-6.1-sol（codex 每一档各写一份，因此一档一个文件）
* kimi（kimi-k3 及同族其它 id）

## 匹配与覆盖规则
谁生效，由文件名决定

1. 最长前缀胜出**。多个文件都能匹配同一个 model id 时，名字最长的那一个生效。比如 id 是 `glm-5.3-flash`，而 `glm-5.3-flash.md`、`glm-5.3.md`、`glm.md` 都在，那只有 `glm-5.3-flash.md` 生效。
2. 与 id 完全同名的文件必定胜出。
3. 不区分大小写。
4. 没有通配符，只有字面前缀**。`glm.md` 也会命中 `glmish-2` 这种跟 glm 无关的 id。所以别起太短的名字：`g.md` 会吃掉所有以 g 开头的 id。前缀从 id 的开头算起，所以叫 `claude-opus-5.md` 的文件命中不了带 provider 前缀的 id，比如 `anthropic.claude-opus-5`。

### 让某个模型不生效
- 推荐：把生效的那个文件清空。文件在、内容为空 = 这个模型拿不到任何专属提示词，而且不会再回退去吃更短的同族文件。
- 删除文件不等于关闭。只有在没有更短的同名文件仍能匹配它时才算关掉：删掉 `glm-5.3.md`，`glm-5.3` 仍然会吃 `glm.md`。
- 想关掉一整个大类：清空大类文件只能关掉没有更具体文件的 id——清空 `glm.md` 后 `glm-4` 不再有提示词，但只要 `glm-5.3.md` 还在，`glm-5.3-flash` 照样走 `glm-5.3.md`。真要整类关掉，清空所有相关的 `glm*.md`。


## 预置提示词来源
均来自于各官方模型自己的专用coding agent工具

minimax来自于minimax code

glm来自于zcode

deepseek来自于deepseek harness

kimi来自于kimi code（整个模型族共用一份 harness，因此是一个族文件）

claude来自于claude code（2.1.285，stable 通道；它自带完整版与较短版两套系统提示词，按模型选用，两套都照搬，每族一个文件）

gpt来自于codex（`openai/codex`，tag `rust-v0.161.0`；某个 model id 用哪份文本，看 `codex-rs/models-manager/models.json` 里该 slug 的 `instructions_template` 字段，发布的 `@openai/codex@0.161.0` 二进制里是同一批字节。codex 给 gpt-5.6 全族一份提示词、给 gpt-6 每一档各写一份，所以 5.6 是单个族文件，gpt-6 各档各自一个文件；更晚的世代自带新文本，需要新文件）

欢迎提交新的模型预置提示词

为了核实通用性，但是必须标注清楚来源，必须是官模调校

## 首次运行会发生什么

| 你已经有… | 会发生什么 |
| --- | --- |
| 什么都没有 | 预置模型系统提示词被复制进 `~/.pi/agent/model-system-prompt/`。 |
| 自己写的 `~/.pi/agent/model-system-prompt/<modelId>.md` | 一律不动。 |

## ☕ 支持这个项目

如果你觉得这个项目有用，可以请作者喝杯咖啡

[![Support me on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/你的用户名)