WezTerm 是外层终端，负责窗口、字体、配色，以及把键盘和图形能力传给里面的程序。
Herdr 在 WezTerm 里做工作区、标签和窗格，并汇集 agent 的状态。关掉窗口或分离之后，里面的进程还在跑，之后可以再接回去。
Pi 在窗格里处理读文件、改代码和执行命令，并用插件和 Skills 补上网页访问、界面打磨等能力。本机的 Pi 设置主要参考 Kun Chen 的 dotfiles 和 Kun’s Pi Agent Config。
日常 workflow
打开 WezTerm，在里面启动 Herdr，再在某个窗格里运行 Pi。需要离开时分离即可，进程会继续留在 Herdr 的 session 里。回到同一台机器时，重新打开 WezTerm 并接入原来的 session，就能接着上次的工作。
Herdr 用工作区、标签和窗格把不同任务分开，并在侧栏里显示 Pi 是在工作、等待还是空闲。Pi 负责具体的编码和命令，需要上网或按某种流程做事时，再调用下面这些插件和 Skills。
Pi 插件
这些是本机 Pi 里用到的插件，主要用来补能力或调整使用体验。
| 插件 | 功能 |
|---|---|
| pi-web-access | 搜索网页、抓取页面内容，也能克隆 GitHub 仓库、提取 PDF，以及理解视频内容 |
| codex-fast-mode | 在使用 Codex 时切换更快、更简短的模式 |
| Calm | 只改变对话的展示方式，让思考块和工具输出更安静，不改变实际执行 |
| terminal-status-title | 在终端标题里显示 Pi 是否正在工作，结束后给出完成标记 |
| herdr-agent-state | 由 Herdr 提供，把 Pi 的工作、等待和空闲状态汇报给 Herdr 侧栏 |
Calm 和 terminal-status-title 来自上面提到的 Kun Chen 配置。herdr-agent-state 则是 Herdr 自己安装和管理的。
Pi Skills
这些是本机 Pi 里会用到的 Skills，用来按特定流程做事。同一来源的技能会归在一起，并链到对应仓库。
界面与设计
| Skill | 功能 |
|---|---|
| impeccable | 设计、改版、评审和打磨界面，覆盖网站、控制台、产品 UI，以及 iOS / Android 界面 |
| frontend-design | 为新界面或改版给出明确的视觉方向，避免千篇一律的默认风格 |
阅读
| Skill | 功能 |
|---|---|
| weread-skills | 微信读书：搜索书籍、查看书架、导出笔记划线、阅读统计、书评和推荐 |
发现技能
| Skill | 功能 |
|---|---|
| find-skills | 按需求搜索并安装新的 Agent Skills |
工程与写作流程
下面这组来自 mattpocock/skills，覆盖从提问、规格、实现到复盘的日常工程流程，以及一部分写作和教学技能。
| Skill | 功能 |
|---|---|
| ask-matt | 根据当前情况，建议该用哪一个技能或流程 |
| setup-matt-pocock-skills | 为这组工程技能初始化仓库里的跟踪方式和文档布局 |
| to-spec | 把当前讨论收成一份规格 |
| to-tickets | 把计划或规格拆成可执行的工单 |
| to-questionnaire | 把讨论收成一份问卷 |
| implement | 按规格或工单落地代码 |
| implement-spec | 在一条集成分支上实现整份规格 |
| tdd | 测试先行 |
| diagnosing-bugs | 排查难复现的缺陷或性能回退 |
| code-review | 按仓库标准和原始规格复查改动 |
| codebase-design | 做模块和系统设计 |
| improve-codebase-architecture | 寻找并推进可以加深的架构改进 |
| domain-modeling | 梳理领域模型和术语 |
| research | 按一级来源做调研并写成仓库里的笔记 |
| prototype | 用一次性原型回答设计问题 |
| pr | 撰写 PR 说明 |
| retro | 复盘这次工作，改进 agent 的工作环境 |
| triage | 给议题分诊并推进状态 |
| wayfinder | 把一大块工作拆成可以逐步做完的决策图 |
| grilling | 用追问压实计划或设计 |
| grill-me | 针对当前方案做一轮追问 |
| grill-with-docs | 在追问的同时更新项目里的领域文档 |
| handoff | 把当前对话交接给下一个 agent |
| claude-handoff | 面向 Claude 的交接写法 |
| loop-me | 用循环追问把方案推到足够清楚 |
| writing-beats | 安排一篇文章的写作节奏 |
| writing-fragments | 整理写作素材和片段 |
| writing-shape | 把素材收成完整成稿 |
| writing-for-agents | 写给 agent 阅读和执行的文档 |
| teach | 把一个概念讲清楚 |
| wizard | 生成交互式向导 |
| wait-what | 在没听清时重新表述问题 |
| setup-pre-commit | 为仓库配置 pre-commit |
| setup-ts-deep-modules | 配置 TypeScript 的深层模块结构 |
| migrate-to-shoehorn | 把测试迁移到 Shoehorn |
| git-guardrails-claude-code | 为仓库加上 Git 防护规则 |
| scaffold-exercises | 搭练习用的脚手架 |