Commit Graph
2 Commits
Author SHA1 Message Date
company-desktop 6337ee45bc docs: 增加 pi agent 使用说明
新增 pi-agent-setup.md,把这几轮摸出来的 pi 使用知识固定下来,供三台机器
共用:

- 仓库里放了什么:AGENTS.md、4 个 skill、3 个 prompt 模板,以及加载规则
  (AGENTS.md 作为 context file 不需要项目信任,.pi/ 下需要)。
  并说明 AGENTS.md 为何不复制 CODEBUDDY.md 正文。
- 常用命令:启动参数(-c/-r/--session/--fork/--tui-mode/-e/--offline)、
  会话命令(/new /resume /tree /fork /clone /compact)、资源命令。
- 重点澄清 /reload 不恢复会话:它只重载 skill/prompt/AGENTS.md/主题/扩展,
  历史靠 -c / -r / /resume;并给出 pull 之后的推荐顺序,以及"会话按工作
  目录关联"这个容易踩的点。
- Windows 终端底部状态栏上下跳动:定位到三条叠加原因(cmd 的默认宿主是
  conhost、terminal.clearOnShrink 默认 false、窗口不够宽导致 footer 折行),
  给出按性价比排序的处理办法和 PI_TUI_WRITE_LOG 排查手段,附当前本机配置
  与桌面快捷方式的实际参数。
- 三台机器的同步清单:哪些随仓库走、哪些必须各自准备、三个坑
  (.pi/settings.json 冲突、项目级与用户级 skill 目录、首次要授予项目信任)。
- 插件取舍:pi-lens 对本仓库为何不建议装(clangd 需要 compile_commands.json
  而本项目用 VS 生成器、编译检查不带 ARX/MFC 宏、无 .clang-format 且强制
  UTF-8 BOM),以及少数值得考虑的包和明确不需要的包。
- 其他已知坑:pi 不读 CODEBUDDY.md、内置工具只有 read/write/edit/bash、
  UTF-8 BOM 约定、类名与文件名不一致。

同时在 AGENTS.md 里加一行指向该文档。
2026-10-28 11:00:00 +08:00
company-desktop d29aa70957 docs: 增加 AGENTS.md 与 .pi 下的 skill / prompt 模板
pi agent 只认 AGENTS.md / CLAUDE.md,不认 CODEBUDDY.md,所以此前 pi 启动时
完全没有加载本仓库的项目说明。本次补上,并把手头反复要做的流程固化成
skill 与 prompt 模板,供团队三台机器共享。

新增内容:

- AGENTS.md —— pi 每次启动自动加载。只放 pi 环境差异(内置工具只有
  read/write/edit/bash,搜索用 rg;万行文件分段读;类名与文件名不一致)
  和硬性红线(UTF-8 BOM、禁止 vcxproj、不直推 main、中文 commit、
  匿名 namespace、#ifdef ZWCAD 判平台),其余指路 CODEBUDDY.md。
  不复制 CODEBUDDY.md 正文,避免两份 170 行文档各自漂移;CODEBUDDY.md
  这个名字还被 3 篇分析文档引用,保持原文件名不动。

- .pi/skills/build-arx —— preset(R180~R260 / Z2023~Z2026)与常用 target、
  加密双版本 target 后缀、目录名≠target 的例外、产物与部署路径、
  LNK4099 rxapi PDB 属已知噪音。

- .pi/skills/verify-utf8 —— UTF-8 BOM 自检命令与判读表、写坏后
  git checkout 还原重做的流程、批量自检脚本。

- .pi/skills/pr-flow —— 分支命名(<机器名>/<英文描述>)、代码与文档分开
  两个 commit、中文 message 结构、git push refs/for/main/<分支>、
  提交前检查清单、私钥不入库。

- .pi/skills/analyze-big-entity —— 万行实体类的定位套路(先 rg
  ACRX_DXF_DEFINE_MEMBERS 确认类名、必看的持久化/生命周期/绘制缓存/
  内存所有权四个面)、性能问题的量化口径、分析文档命名与结构。

- .pi/prompts/{build,pr,chk}.md —— /build、/pr、/chk 三个模板。

全部为 Markdown,不含可执行代码。.pi/ 为项目级资源,需 pi 授予项目信任
后加载;AGENTS.md 作为 context file 不受信任限制。
2026-10-28 10:36:55 +08:00