docs: 增加 AGENTS.md 与 .pi 下的 skill / prompt 模板 #90

Merged
gjm merged 1 commits from company-desktop/company-desktop-computer/doc-pi-agent-setup AGit into main 2026-10-28 10:37:35 +08:00
1 Commits
Author SHA1 Message Date
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