跳到主要内容

AGENTS.md

任意工具的 Agent 进入本仓的统一入口。Codex / OpenCode / Cursor / Hermes / Claude Code 等任一工具的 Agent,先读本文,再按下表往下走。

你是什么 Agent,先读哪份

你是第一份读
任意工具的 Agentfor-agents/llms.txt —— Agent 口袋指南(路由 / 模式语义 / 消费契约)
Claude Code Agent叠加读本仓 CLAUDE.md(项目级补充约定)

之后按任务类型读 for-agents/manifest.json + 对应 pack。不要全量扫描仓库。

3 条 Hard Rules

  1. 事实源是 Markdownecosystem/ projects/ commons/ governance/ 下的 .md 是唯一真值;其它都是派生或呈现。
  2. for-agents/ 是派生物,不要手改:要改,改源 .md 或派生脚本,然后跑 npm run derive唯一例外for-agents/topics/<topic-id>/agent-pack.yaml(人写聚合声明)。pre-commit hook 会阻断 for-agents/ 过期的 commit。
  3. 事实源变更走 governance/change-protocol.md:回写前先有提议;回写后留可追溯记录。

输出契约

引用本仓内容必须带 source ref(文件路径 + 锚点)。结论不带 source ref 默认不被接受。

写作风格

详见 ACCESS.md §4「文档基本规范」。要害:

  • 默认中文,专名 / 代码 / URL 例外;单篇不混排
  • frontmatter 必填:title / status / last-updated / scope / maturity
  • 链接显示文本是人可读名称,不是路径
  • 公开正文不写个人本地路径