LLM Friendly Site Architect 是一个用于设计网站中面向 AI 助手、RAG 与智能体搜索的“人类可见、机器可读”层的技能。按照资料说明，它应在语义核心、URL 架构、内部链接图谱以及技术 SEO/schema 基础已经存在之后使用。在产出完整的 LLM 发现方案之前，需要先阅读 references/llm-readable-architecture.md。
用途与定位
该技能面向需要让 AI 助手和智能体搜索可发现的公开页面进行结构化规划。它负责 LLM 可读架构的设计与审计，输出发现方案和报告，而不是直接执行监测或实现 schema。
主要能力（Owns）
- llms.txt 结构；
- LLM discovery plan（LLM 发现方案）；
- 可见答案块与简明摘要；
- 来源线索（source trails）；
- 面向智能体的实体页与主题地图；
- markdown alternate policy（Markdown 替代策略）；
- AI crawler policy handoff（AI 爬虫策略交接）；
- 针对 LLM 可读界面的防重复内容护栏。
不负责范围（Does Not Own）
- Search Console 或助手引用监测执行；
- 技术 schema 实现；
- URL/canonical 决策；
- 隐藏内容；
- 外部权威布置。
工作流程
- 读取 url-map.yaml、internal-link-graph.yaml、schema/head 策略以及可见内容模型。
- 识别应当可被助手发现的规范公开页面。
- 起草或审计 llms.txt 各节，仅包含公开且有用的 URL。
- 仅在页面角色支持时，定义可见的直接回答、TLDR、事实、来源或 FAQ 块。
- 定义来源线索与可用于引用的证据界面。
- 在有用时为长文/文档页面定义 Markdown 替代规则，并酌情采用 noindex 或 alternate 策略。
- 定义能够说明网站“是谁、是什么、如何运作”的实体页与主题页。
- 记录需要当前一手来源核验的爬虫策略项。
- 使用 assets/llm-discovery-report.template.md 产出 LLM 发现报告。
页面角色指引
- news_brief：简明可见摘要、来源链接，若有则配对长文链接。若简讯本身已是短形式，不要强行加 TLDR。
- longform_article：可包含可见摘要、关键事实、来源线索、主题/实体链接与 Markdown 替代。
- topic：适合直接回答与实体/主题解释。
- project：适合能力摘要、仓库链接、证据与相关故事。
- author：适合提供 Person/实体上下文与信任信号。
- home：可包含简明的网站目的与章节地图。
安全与隐私边界
不得在 llms.txt、Markdown 替代、来源线索或实体地图中包含 admin、API、私有仪表盘、原始分析、原始 IP 日志、密钥、未发布草稿、staging URL 或内部规划笔记。不得为助手访问而放宽 WAF、auth、CSP、CORS、cookies、速率限制或私有内容边界。不得在没有带时间戳证据的情况下声称某爬虫、AI 助手或搜索引擎会引用该站点。
验证要求
完成前需确认：每个面向 LLM 的 URL 都是公开、规范、有用且非私有的；每个答案/来源块对人类可见；每个 Markdown 替代都有对应的规范 HTML 页面；没有引入重复的公开故事正文；爬虫策略项被标记为已验证或需要验证；引用/监测声明已交接给监测任务。技能编辑使用以下命令验证：
python3 <codex-skills-dir>/senior-skill-architect/scripts/lint_production_skill.py ./skills/llm-friendly-site-architect python3 ./plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py .
Forward tests 位于 evals.json。
输出形态
返回：LLM 可读架构摘要；llms.txt 章节方案；可见答案/来源/实体块方案；Markdown 替代策略；爬虫验证需求；被拒绝或推迟的项目。
限制与说明
llms.txt 是一种有用的约定，并非保证的排名或引用因素。爬虫名称、策略与 IP 在生产变更前需要一手来源核验。关于收费、价格、平台或效果的信息暂未提供。