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
Collaborator

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(R180R260 / Z2023Z2026)与常用 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 不受信任限制。

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 不受信任限制。
company-desktop added 1 commit 2026-10-28 10:37:01 +08:00
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 不受信任限制。
gjm merged commit fb82e5abd0 into main 2026-10-28 10:37:35 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: gjm/envi-code#90