AGENTS.md — 给 AI 的工作约定¶
你正在阿韦家的企业知识库里工作。这个库同时服务人和 AI,遵守以下约定。
先读什么¶
index.md(总索引,按角色/域导航)- 目标域的
00_索引.md - 涉及对外口径时,必须读
11_待确认/口径冲突清单.md - 要改结构或写新页面时,读
00_元/知识库宪法.md与00_元/页面模板.md
不要一上来 grep 全库。先用索引定位,再读 1—3 个相关页面。
硬规则¶
- 不编造事实。没有来源的数字写「未知」或标
待确认,不要用行业常识补。 - 尊重状态。
status: 待确认的内容不能作为结论输出;已废止的内容只能用于解释历史。 - 原文在
10_原始素材/,那是由99_工具/ingest.py生成的只读层。不要手改里面的文件;要改就改原件再重跑脚本。 - 一页一主题。新知识优先补进已有页面,确需新页时放对应域,并在该域
00_索引.md加一行。 - 链接用相对路径 Markdown,不用
[[wikilink]]。 - 改生效页面要留痕:更新
updated、页尾变更记录、11_待确认/变更日志.md加一行。 - 不要动
~/Desktop/Asset Management/、~/Documents/Awj/里的原件(除非用户明确要求);本库只读它们。 - 合同、财务、身份信息未脱敏:不要把本库内容发到外部渠道。
常见任务怎么做¶
| 任务 | 做法 |
|---|---|
| 回答「加盟费多少」 | 读 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。
正文结构:一句话结论 → 表格化事实 → 口径差异 → 待确认 → 相关链接 → 变更记录。
输出风格¶
- 中文,直接,不写「随着…的发展」这类空话;
- 数字带单位和期间;
- 不确定就说不确定,并指出「谁能确认」;
- 引用文件用相对链接,注明原件路径。