my-pi-config

本人 Pi 编码助手（pi) 的完整配置备份：skills、extensions、agents、themes、prompt-snippets、全局 AGENTS.md 及 patches。

本仓库是 ~/.pi/agent/ 目录的 git 备份。克隆后应放置到你的配置目录，即：

• Windows：C:\Users\<你>\.pi\agent\
• macOS / Linux：~/.pi/agent/

由于配置路径硬编码在 settings.json（如 git:github.com/lood31/pi-local-memory）与 AGENTS.md 中，建议直接克隆到 ~/.pi/agent 使用。

---

目录结构

.pi/agent/
├── AGENTS.md                      # 全局角色设定与工作规则（猫娘设定/知识库/安全边界）
├── README.md                      # 本说明文件
├── settings.json                  # 核心配置：packages / theme / defaultProvider 等
├── keybindings.json               # 按键绑定
├── .gitignore                     # 排除的运行时/敏感文件清单
│
├── skills/                        # 技能（SKILL.md 目录 + 辅助资源/脚本）
│   ├── anthropics-skills-docx/    # Word 文档处理（Anthropic 官方）
│   ├── anthropics-skills-pdf/     # PDF 处理（Anthropic 官方）
│   ├── anthropics-skills-pptx/    # PPT 处理（Anthropic 官方）
│   ├── brandkit/                  # 品牌库
│   ├── browser-use-browser-use-browser-use/  # 浏览器自动化
│   ├── brutalist-skill/           # 工业/粗野主义 UI
│   ├── find-skills/               # 发现并安全安装 skill
│   ├── forrestchang-andrej-karpathy-skills-karpathy-guidelines/  # Karpathy 指南
│   ├── gpt-tasteskill/            # GPT 风格口味
│   ├── grill-me/                  # 拷问式追问（含 agents/openai.yaml）
│   ├── grilling/                  # 拷问/质疑（含 agents/openai.yaml）
│   ├── image-to-code-skill/       # 图片转代码
│   ├── imagegen-frontend-mobile/  # 移动端前端视觉生成
│   ├── imagegen-frontend-web/     # Web 前端视觉生成
│   ├── leader/                    # 领军/决策风格
│   ├── learn-teacher/             # 学习-教学
│   ├── minimalist-skill/          # 极简 UI
│   ├── output-skill/              # 输出完整性强制
│   ├── redesign-skill/            # 现有项目重构
│   ├── skill-creator/             # 创建 skill（Anthropic 官方）
│   ├── soft-skill/                # 高端视觉设计
│   ├── stitch-skill/              # 设计语言缝合
│   ├── taste-skill/               # 设计品味（当前默认）
│   ├── taste-skill-v1/            # 设计品味 v1（向后兼容预留）
│   ├── teach/                     # 教学
│   ├── unslop/                    # 去 AI 味（源自 cursor/plugins）
│   ├── unslop-zh/                 # 去 AI 味中文版
│   └── visualize/                 # Obsidian 内联可视化
│
├── extensions/                    # 扩展（.ts/.js 文件或包目录）
│   ├── ask-user-question.ts       # 单问题提问工具
│   ├── md-log.ts                  # Markdown 日志
│   ├── quiz.ts                    # 知识测验（graded quiz）
│   ├── bash-guard/                # bash 命令守卫（@accolver/bash-guard）
│   ├── dictate/                   # 口述输入
│   ├── phosphor-ui/               # 战术 UI（pi-phosphor-tactical-ui）
│   ├── prompt-snippets/           # 提示词片段模块
│   └── skillful-install.json      # pi-skillful 安装状态
│
├── agents/                        # 自定义子代理
│   ├── mermaid-maker.md
│   └── svg-maker.md
│
├── themes/                        # 主题
│   ├── lood.json                  # 当前主题
│   └── rose-gold.json             # 玫瑰金主题
│
├── prompt-snippets/               # 提示词片段
│   ├── ask-questions.md
│   ├── delegate-exploration.md
│   ├── diagnose-dont-fix.md
│   ├── orchestrator-mode.md
│   ├── prompt.md
│   ├── session-kickoff.md
│   └── verify-dont-assume.md
│
└── patches/                       # 对 pi 的补丁备份
    ├── apply-pi-skillful-change.sh
    ├── pi-skillful-change-add.config.ts.patch
    └── pi-skillful-change-add.extensions.skill-visibility.ts.patch

npm/、git/、bin/、sessions/、cache/ 等为 pi 自动生成的安装产物/缓存/会话，不纳入版本控制（见 .gitignore）。auth.json、models*.json 含凭据/模型目录，同样排除。

---

安装命令

方式一：克隆到配置目录（推荐，一步到位）

# Windows（PowerShell）
git clone git@github.com:lood31/my-pi-config.git "$env:USERPROFILE\.pi\agent"

# macOS / Linux
git clone git@github.com:lood31/my-pi-config.git ~/.pi/agent

注意：若 ~/.pi/agent 已存在，请先备份或清空后再克隆。

方式二：用 pi install 安装各 packages（来自 settings.json）

以下命令按仓库内 settings.json 中的 packages 列表对应生成：

# npm 源
pi install npm:pi-subagents
pi install npm:pi-web-access
pi install npm:@zhushanwen/pi-plan
pi install npm:@zhushanwen/pi-goal
pi install npm:pi-cache-optimizer
pi install npm:pi-observational-memory
pi install npm:@jc4649/filechanges
pi install npm:pi-skillful
pi install npm:remote-pi

# git 源
pi install git:github.com/lood31/pi-local-memory

也支持一次性写入 settings 后的自动加载，或 pi update --all 统一更新。

方式三：其他可追溯来源的下载地址

仅标注能确认来源的 skills；其余为本地/私人安装，来源未记录。

Skill	来源 / 安装方式
anthropics-skills-docx / pdf / pptx、skill-creator	Anthropic 官方 skills 仓库：git clone https://github.com/anthropics/skills.git
browser-use-browser-use-browser-use	浏览器自动化：https://github.com/browser-use/browser-use（skill_cli）
forrestchang-andrej-karpathy-skills-karpathy-guidelines	https://github.com/forrestchang/andrej-karpathy-skills
find-skills	npx skills find <query>（skills 生态发现工具）
unslop	源自 cursor/plugins 的 unslop
unslop-zh	改编自 unslop，参考 hardikpandya/stop-slop 与 leeguooooo/stop-slop-zh

其余 skills（brandkit、gpt-tasteskill、grill-me、grilling、image-to-code-skill、imagegen-*、leader、learn-teacher、minimalist-skill、output-skill、redesign-skill、soft-skill、stitch-skill、taste-skill*、teach、visualize、brutalist-skill）为本地/私人安装，来源未记录，直接从本仓库拷贝使用即可。

---

生效方式

引入新的扩展/主题后，可运行：

pi config       # 交互式启用/停用扩展、skill、提示模板、主题
pi list         # 查看已安装 packages

---

安全提示

• auth.json、models*.json 等含凭据/模型目录的文件已被 .gitignore 排除，不会进入本仓库。
• 第三方 packages 以完整系统权限运行，安装前请自查源码。