@0xkobold/pi-persona

PI智能体的人格与身份管理扩展

开发流程 管理多个AI编码代理配置切换多项目配置管理AI身份 通用 ★ 8 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@0xkobold/pi-persona。
它的用途是:PI智能体的人格与身份管理扩展
完整的 Skill 内容见:https://321skill.com/skills/0xkobold-pi-persona/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'persona({ action: "update", file: "SOUL.md", content: "# 我是一个严谨的代码审查助手\n## 价值观\n- 优先保证代码安全\n- 遵循团队编码规范", scope: "global" })',它会更新全局人格文件。之后在项目目录下运行 '/persona-init-project' 即可创建项目级 persona 文件,实现上下文隔离。

介绍

这个 Skill 解决了 AI 智能体在不同项目间频繁切换身份、记忆混乱的问题。在使用 pi 框架开发时,全局人格与项目上下文往往需要区分,手动管理多个配置文件容易出错。

使用方式很简单:安装后,在用户目录 ~/.0xkobold/ 下创建 SOUL.mdIDENTITY.mdUSER.md 等文件定义核心人格,在项目目录 .0xkobold/ 下创建同名文件即可覆盖。通过 /persona-reload 命令刷新,/persona-init 初始化全局默认文件,/persona-init-project 生成项目级文件。内置的 persona 工具支持读取、更新、初始化等操作。

它非常适合需要管理多个 AI 编码代理的团队或个人。尤其是那些频繁切换项目上下文、希望每个项目保持独立人格和规则的开发者。项目经理可以统一团队 AI 助手的能力,智能体开发人员可以快速切换配置。

建议在团队内部统一使用此工具,先定义全局核心人格,再针对每个项目细化覆盖。注意项目级文件需放置于 .0xkobold/ 目录下,并确保 scope: project 标签正确。该扩展仅兼容 pi 框架,需要 Node.js 环境。

常见问题

如何安装 pi-persona?

推荐使用 `pi install npm:@0xkobold/pi-kobold` 捆绑安装,也可单独运行 `pi install npm:@0xkobold/pi-persona`。

项目级 persona 文件放在哪里?

放在项目根目录的 `.0xkobold/` 文件夹下,文件名与全局一致(如 SOUL.md),并添加 `---\nscope: project\n---` 前置元数据。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/0xkobold-pi-persona/raw/index.md 读取 @0xkobold/pi-persona 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。