$ cat ~/map/pi-config.md

pi-config

可直接克隆的 Pi 全局配置，包含 agents、技能与提示词模板。

templates✓ 10月16日

mkdir -p ~/.pi && git clone git@github.com:HazAT/pi-config ~/.pi/agent && cd ~/.pi/agent && ./setup.sh

## 速览

HazAT 的个人 pi 全局配置仓库——克隆到 ~/.pi/agent/ 并运行 setup.sh，即可获得 /plan、/todos、/execute、/review 四步会话文件工作流，连同技能、提示词模板与扩展。

## 要点

• $安装：把仓库克隆到 ~/.pi/agent/ 后运行 ./setup.sh——它要求就在这个位置，会保留已有的 settings.json、安装配置中的 Git 包，并在 macOS 上用 uv 装好 macOS Harness 运行时。provider 凭据写入 ~/.pi/agent/auth.json 后重启 pi。
• $会话文件工作流由四个显式提示命令组成：/plan 加载规划技能并记录选定的方案；/todos 把计划拆成可直接执行的 todo；/execute 用 Superconductor 编排顺序执行的写码 worker，每人一次聚焦且经验证的提交；/review 跑独立的本地评审团队并修复阻断性问题，修复轮数上限两轮。
• $交接状态是当前会话旁边的纯 Markdown——${PI_SESSION_FILE%.jsonl}.plan.md、.todos.md 与 .review.md。没有侧车目录、仓库级运行存储或自定义 JSONL 状态；写入权归当前协调者，/review 只需要会话 JSONL。
• $编排直接使用 sc CLI；启动 agent 或团队前先读 skills/superconductor/SKILL.md 并运行 sc instructions orchestration——实时说明优先于记忆中的语法。worker 共享检出目录、顺序执行、从不推送；评审团队成员独立且只读。
• $仓库结构：prompts/*.md（plan、todos、execute、review、superconductor-setup）、skills/ 目录（plan、write-todos、worker、review、scout、superconductor、setup-superconductor-project、pi-extension-development、commit）、extensions/execute-command（用于自调用斜杠命令的 execute_command 工具），以及 settings.json、models.json、mcp.json。
• $更新方式：cd ~/.pi/agent、git pull，再跑一次 ./setup.sh。

## 常见问题

## 参考链接

• README（安装、工作流、目录结构） ↗

最后更新: 2026年8月31日