AGENTS.md
任意工具的 Agent 进入本仓的统一入口。Codex / OpenCode / Cursor / Hermes / Claude Code 等任一工具的 Agent,先读本文,再按下表往下走。
你是什么 Agent,先读哪份
| 你是 | 第一份读 |
|---|---|
| 任意工具的 Agent | for-agents/llms.txt —— Agent 口袋指南(路由 / 模式语义 / 消费契约) |
| Claude Code Agent | 叠加读本仓 CLAUDE.md(项目级补充约定) |
之后按任务类型读 for-agents/manifest.json + 对应 pack。不要全量扫描仓库。
3 条 Hard Rules
- 事实源是 Markdown:
ecosystem/projects/commons/governance/下的.md是唯一真值;其它都是派生或呈现。 for-agents/是派生物,不要手改:要改,改源.md或派生脚本,然后跑npm run derive。唯一例外:for-agents/topics/<topic-id>/agent-pack.yaml(人写聚合声明)。pre-commit hook 会阻断for-agents/过期的 commit。- 事实源变更走
governance/change-protocol.md:回写前先有提议;回写后留可追溯记录。
输出契约
引用本仓内容必须带 source ref(文件路径 + 锚点)。结论不带 source ref 默认不被接受。
写作风格
详见 ACCESS.md §4「文档基本规范」。要害:
- 默认中文,专名 / 代码 / URL 例外;单篇不混排
- frontmatter 必填:
title / status / last-updated / scope / maturity - 链接显示文本是人可读名称,不是路径
- 公开正文不写个人本地路径