llm-friendly-site-architect

LLM 友好型网站架构师

在语义核心、URL 架构、内链图谱以及技术 SEO/schema 基础搭建完成后，使用此技能。

制定完整的 LLM 发现计划前，请阅读 references/llm-readable-architecture.md。

负责范围

• llms.txt 结构；
• LLM 发现计划；
• 面向用户可见的答案块和简明摘要；
• 来源链路；
• 面向 Agent 的实体页面和主题图谱；
• Markdown 替代版本策略；
• AI 爬虫策略交接；
• 面向 LLM 可读内容的防重复内容约束。

不负责

• 执行 Search Console 或助手引用监控；
• 技术 schema 实现；
• URL/canonical 决策；
• 隐藏内容；
• 外部权威网站的投放。

工作流

1. 阅读 url-map.yaml、internal-link-graph.yaml、schema/head 策略和可见内容模型。
2. 确定应供助手发现的规范公开页面。
3. 起草或审查 llms.txt 各部分，只包含公开且有用的 URL。
4. 仅在页面角色适用时，定义可见的直接答案、TLDR、事实、来源或 FAQ 区块。
5. 定义来源链路和可供引用的证据展示面。
6. 在有用时，为长文/文档页面定义 Markdown 替代版本规则，并酌情采用 noindex 或替代版本策略。
7. 定义实体页面和主题页面，阐明网站的主体、内容及运作方式。
8. 记录需要通过当前一手来源核实的爬虫策略事项。
9. 使用 assets/llm-discovery-report.template.md 生成 LLM 发现报告。

不可妥协的原则

• 优先提供面向用户可见的内容。
• 不提供仅供机器人访问的隐藏事实。
• 不创建门页。
• 除非 FAQ 对用户可见，否则不使用 FAQPage schema。
• 默认不为每篇简短新闻页面自动添加 TLDR。
• 不在已声明的内容模型之外增加公开故事正文。
• llms.txt 是一种实用惯例，并非有保证的排名或引用因素。
• 在生产环境中变更前，必须通过一手来源核实爬虫名称、策略和 IP。

页面角色指南

• news_brief：提供简明的可见摘要、来源链接，以及在有长文时提供对应的长文链接。如果简讯本身已经是短篇形式，不要强行添加 TLDR。
• longform_article：可包含可见摘要、关键事实、来源链路、主题/实体链接和 Markdown 替代版本。
• topic：适合作为直接答案和实体/主题说明页面。
• project：适合提供能力摘要、仓库链接、证据和相关文章。
• author：适合提供人物/实体背景和可信度信号。
• home：可简要说明网站用途并提供栏目导航。

安全与隐私边界

• 不要在 llms.txt、Markdown 替代版本、来源链路或实体图谱中包含管理页面、API、私有仪表板、原始分析数据、原始 IP 日志、机密信息、未发布草稿、预发布 URL 或内部规划笔记。
• 不要为了让助手访问而放宽 WAF、身份验证、CSP、CORS、Cookie、速率限制或私有内容边界。
• 没有带时间戳的证据时，不要声称爬虫、AI 助手或搜索引擎会引用该网站。

验证

将工作标记为完成前：

• 每个面向 LLM 的 URL 都是公开、规范、有用且非私有的；
• 每个答案/来源区块都对用户可见；
• 每个 Markdown 替代版本都有对应的规范 HTML 页面；
• 未引入重复的公开故事正文；
• 爬虫策略事项均已标记为已核实或待核实；
• 引用/监控声明已交接给监控任务。

使用以下命令验证技能编辑：

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/llm-friendly-site-architect
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

前向测试位于 evals.json。

输出格式

返回：

1. LLM 可读架构摘要。
2. llms.txt 分节计划。
3. 可见答案/来源/实体区块计划。
4. Markdown 替代版本策略。
5. 爬虫核实需求。
6. 拒绝或延期的事项。