為何對代理友善

代理優先閱讀

招募方、招聘經理與客戶愈來愈常在自己閱讀頁面之前，先問一個 AI 助理： 「總結一下這位候選人」、「這個人是否適合我們的 Head of AI 職位？」、「誰能幫我們做 AI 策略？」 代理會先擷取、閱讀、篩選並總結。如果個人網站只是一個好看的頁面，代理就得猜測——刮取版面、遺漏脈絡、用想像補洞。

Jenks 的工作一直在追求這種槓桿。他多年來讓平台能被其他建設者使用：在 Xero 做 API 與 SDK、在 Linktree 打造開發者平台、在 Filecoin 與 Babylon 建立生態系。他的領導座右銘——「我以讓團隊發光的方式領導」——自然延伸到 AI：打造介面，讓其他代理能做好工作。因此，他自己的網站也用他會建議公司打造平台的方式來建：同時為人與為代理服務。

在此處所謂的對代理友善

• 可被發現：根目錄的 llms.txt 列出代理需要的一切；/brief.md 是單頁起點；/.well-known/site-agent.json 與 /openapi.json 描述介面。
• 結構良好：/experience.json 與 /llms-full.txt 提供含標籤、角色視角、日期與關鍵成果的完整語料，代理能篩選而非猜測。
• 可呼叫：有遠端 MCP 伺服器、REST API 與同時可作為本機 MCP 伺服器的 CLI——同一份規格產生各處可用的相同工具。
• 誠實：答案有依據，分清「已完成」與「可勝任」，並揭示缺口（見 Grounding and honesty）。
• 為代理而寫的文件：這些文件遵循 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 就緒型組織」的一個可運作示例。