用途：把能力或架构问题转化为有据可查的云原生技术候选清单。CNCF Landscape 是发现与证据来源，不是推荐引擎。适用于：询问当前技术栈中没有的能力对应哪些项目；想按成熟度、类别、仓库信号、许可证等比较 CNCF 项目；需要为架构决策、概念验证、技术雷达条目或自建与采购讨论准备候选清单；在读项目文档或源码前先发现项目。不适用于：配置或运维某个具名技术，应改用其运维技能或权威文档；技术采纳/暂缓治理流程应使用 technology-radar，本技能只做候选发现与取证；无 Landscape 发现问题的平台、数据或 API 架构设计应使用相应方法论技能；采购、合同、出口管制或许可建议应另行取得专业审查。
决策流程：先界定决策，记录能力、工作负载、接口、运行时与拓扑、规模与 SLO、数据敏感性、部署模型、团队归属、运维技能、预算、时间线、许可证约束与可接受的成熟度风险，区分硬约束与偏好；信息不足时只问最小缺口。随后用随附工具从实时 API 发现候选： python3 scripts/landscape_query.py --help python3 scripts/landscape_query.py --category "Observability and Analysis" --subcategory Observability --search tracing --maturity graduated --has-license --has-release --sort stars --limit 10 选择端点或解读字段时加载 references/api.md。候选来自 projects；members 与 end-users 仅作生态背景，会员身份不代表产品质量。先应用硬过滤（能力、类别、明确要求的成熟度、许可证、仓库证据、部署约束），除非用户要求，否则不要擅自把 stars、贡献者数或 CNCF 成熟度当作硬条件。用 projects/all.json 返回的 id 获取各项目记录端点，记录 API 端点与获取时间，再阅读项目自身文档、支持的部署路径、发布历史、源码仓库、许可证与安全公告，之后才做实现层面的结论。比较适配度而非名气，区分“观察到”“推断”“未知”，不得仅凭 stars、成熟度、会员身份或生成的分数排名。推荐须带条件：仅在给定约束下给出最佳匹配，列出可信替代方案、被排除项及原因、重大权衡、可逆性与迁移顾虑，以及能推翻该推荐的下一步实验。最后给出验证计划，用有界的 PoC 或文档/源码审查覆盖真实接口、工作负载、安全边界、可运维性、升级路径与故障模式；Landscape 记录只能指出该调研什么，不能证明生产就绪。
查询工具：scripts/landscape_query.py 是只读、非交互、仅用标准库的客户端，抓取一个已生成的 JSON 快照，本地过滤后把 JSON 写到 stdout，诊断输出到 stderr，失败返回非零退出码。支持 --search、--category、--subcategory、可重复的 --maturity、--license、--country、--oss-only、--has-license、--has-release、--min-stars、--min-contributors、--sort、--limit 等过滤；默认 limit 有边界，仅在需要完整结果集时用 --limit 0。该工具不评分、不推荐；应保留原始记录，并在决策产物中说明任何排序或加权。
限制：每次调用只抓取一个生成的 JSON 快照，反映该快照的时效而非仓库实时状态，也无法替你阅读项目文档或源码。CNCF 成熟度描述的是项目在 CNCF 的生命周期状态，不代表适配性、安全性、支持合同或运维简易度；stars 与贡献者是带快照和仓库选择偏差的方向性活跃信号，不构成采纳、可靠性或支持保证；许可证字段是发现信号而非法律结论，需核对具体仓库、版本、依赖与组织政策；最新发布字段不保证发布质量、兼容性、补丁政策或支持期；类别标签只帮助找候选，不代表项目实现了所请求能力的全部部分。API 不可用或返回非 JSON 时应如实报告，不得凭记忆编造当前目录、数量或项目状态。前置条件：Python 3.8+ 仅标准库，无需第三方包或 API 密钥；需对 landscape.cncf.io 的出站 HTTPS，可用 --base-url 指向镜像或离线测试服务器。