为什么对代理友好

代理先读

招聘人员、招聘经理和客户在自己阅读页面之前，越来越常先问一位 AI 助手： “Summarise this candidate”、“Is this person a fit for our Head of AI role?”、“Who could help us with an AI strategy?” 代理会抓取、阅读、筛选并总结。若个人网站只是好看的页面，就会让代理摸不着头脑——去扒布局、丢上下文、用臆测去填空。

Jenks 的工作始终聚焦于这种杠杆。他花了多年时间让平台真正可被其他建设者使用：在 Xero 打造 API 和 SDK，在 Linktree 推进开发者平台，在 Filecoin 和 Babylon 发展生态系统。他的领导箴言——“I lead by helping my team glow”——也自然延伸到 AI：构建接口，让其他代理能做好工作。因此，他自己的网站也按他建议公司构建平台的方式来搭建：为人类用户和代理用户服务。

在这里，“对代理友好”意味着什么

• 可发现：根目录的 llms.txt 列出代理所需的一切；/brief.md 是单页起点；/.well-known/site-agent.json 和 /openapi.json 描述接口。
• 结构化：/experience.json 和 /llms-full.txt 提供带标签、角色视角、日期与关键成果的完整语料，便于代理筛选而非猜测。
• 可调用：远程 MCP 服务器、REST API 与 CLI（同时可作为本地 MCP 服务器）——同一规范生成、处处同样的工具。
• 诚实：回答有据可依，区分已经做过与可以去做，并明确空白（见溯源与诚实）。
• 为代理编写的文档：这些文档遵循 Diátaxis——教程、操作指南、参考与阐释——且每个页面也可作为原始 Markdown 提供。
• 多语言：支持七种语言，并保持相同结构。

为什么是 Diátaxis

代理与人类的需求不同：学习系统、完成任务、查精确参数，或理解设计取舍。把这些混在一起会让每个页面都变差。Diátaxis 让每页只做一件事，也让代理更容易检索并引用页面内容。

项目规则

有两条规则确保站点在扩展中仍然对代理友好。它们写在代码库的 AGENTS.md 中，以便任何在此工作的 AI 都会遵循：

1. 每个新功能要同时登陆所有界面。 如果为人类界面新增了能力，也必须补充到规范中——从而进入 REST API、MCP 服务器、CLI 与自动生成的参考文档——并在代理页面重新构建并发布可下载的 CLI 二进制文件。
2. 每次变更覆盖所有语言。 内容与界面文案需同时更新到全部七种语言：以英文创作，其余六种语言在发布前按术语表重新生成并校对。

收益

能够以 lens=solution-architect 调用 list_experience 的代理，能在数秒内给出准确、有出处的答案。这对提问的人更好，对 Jenks 更好，也是 Jenks 帮助公司打造的“AI 就绪”组织的一个可运行范例。