跳转至

AGENTS.md — 给 AI 的工作约定

你正在阿韦家的企业知识库里工作。这个库同时服务人和 AI,遵守以下约定。

先读什么

  1. index.md(总索引,按角色/域导航)
  2. 目标域的 00_索引.md
  3. 涉及对外口径时,必须读 11_待确认/口径冲突清单.md
  4. 要改结构或写新页面时,读 00_元/知识库宪法.md 与 00_元/页面模板.md

不要一上来 grep 全库。先用索引定位,再读 1—3 个相关页面。

硬规则

  1. 不编造事实。没有来源的数字写「未知」或标 待确认,不要用行业常识补。
  2. 尊重状态。status: 待确认 的内容不能作为结论输出;已废止 的内容只能用于解释历史。
  3. 原文在 10_原始素材/,那是由 99_工具/ingest.py 生成的只读层。不要手改里面的文件;要改就改原件再重跑脚本。
  4. 一页一主题。新知识优先补进已有页面,确需新页时放对应域,并在该域 00_索引.md 加一行。
  5. 链接用相对路径 Markdown,不用 [[wikilink]]。
  6. 改生效页面要留痕:更新 updated、页尾变更记录、11_待确认/变更日志.md 加一行。
  7. 不要动 ~/Desktop/Asset Management/、~/Documents/Awj/ 里的原件(除非用户明确要求);本库只读它们。
  8. 合同、财务、身份信息未脱敏:不要把本库内容发到外部渠道。

常见任务怎么做

任务 做法
回答「加盟费多少」 读 04_加盟/加盟政策与费用.md + 11_待确认/口径冲突清单.md,回答时带上「多版本 + 待确认」
回答「门店怎么开」 读 03_门店/开店流程.md 与 门店模型与选址.md
找某份文件 查 10_原始素材/素材索引.csv(列:来源、相对路径、状态、产出)
新增资料 放原件目录 → 跑 python3 99_工具/ingest.py → 必要时编译进域页面
改数字/政策 先确认依据(谁给的、什么时候、书面还是口头),再改页面 + 变更日志
建新页面 复制 00_元/页面模板.md 的模板 A/B/C

页面格式

frontmatter 必填:title、type、status、owner、updated。可选:source、confidence、approved_by、tags。

正文结构:一句话结论 → 表格化事实 → 口径差异 → 待确认 → 相关链接 → 变更记录。

输出风格

  • 中文,直接,不写「随着…的发展」这类空话;
  • 数字带单位和期间;
  • 不确定就说不确定,并指出「谁能确认」;
  • 引用文件用相对链接,注明原件路径。