clickhouse-architecture-advisor

修复 yaml 语法 (#33) 转义分号以避免错误（包括 GitHub UI 中的错误）

添加 clickhouse-architecture-advisor 技能 (#19) # 提议的 PR：添加 `clickhouse-architecture-advisor` 技能 ## 摘要 此 PR 添加了一个新技能 `clickhouse-architecture-advisor`，旨在 补充现有的 `clickhouse-best-practices` 技能。 新技能**不会**取代官方最佳实践。相反，它 提供了一个工作负载感知的架构决策层，帮助代理 和用户推理： - 何时应用特定的 ClickHouse 模式 - 为什么某个模式适合给定的工作负载 - 如何将最佳实践转化为具体的架构 ## 为什么这属于 `agent-skills` 当前的 `clickhouse-best-practices` 技能在 基于规则的架构设计、查询优化和 数据摄取指导方面非常出色。此提案填补了一个不同的空白： - 多步骤架构设计 - 工作负载分类 - 权衡驱动的决策 - 明确区分官方指导和现场经验法则 这对以下场景特别有用： - 早期客户架构 - 实时设计研讨会 - 工作负载规模讨论 - POC 设计 - SA/TAM 咨询工作流 ## 此 PR 包含的内容 ### 新技能 - `skills/clickhouse-architecture-advisor/` ### 新组件 - `SKILL.md` - `README.md` - `AGENTS.md` - `metadata.json` - `schemas/recommendation_schema.yaml` - `mappings/doc_links.yaml` ### 决策规则 - `decision-ingestion-strategy.md` - `decision-partitioning-timeseries.md` - `decision-join-enrichment.md` - `decision-late-arriving-upserts.md` - `decision-real-time-preaggregation.md` ### 示例 - `observability-high-throughput.md` - `finserv-market-surveillance.md` - `siem-security-analytics.md` ## 推荐模型 每条推荐都明确分类为以下之一： - `official` — 直接由官方文档支持 - `derived` — 从官方文档和 ClickHouse 行为推断 - `field` — 基于经验，并明确标注为此类 这使该技能与文档仍是 事实来源的原则保持一致，同时仍允许架构指导在 现实场景中有用。 ## 非目标 此 PR 不会： - 覆盖 `clickhouse-best-practices` - 引入商业推荐 - 创建并行文档系统 - 将现场经验法则呈现为官方指导 ## 建议的审查重点 - 技能的命名和范围 - official / derived / field 分类是否是合适的 模式 - 决策规则应保持独立还是部分合并 到现有的 best-practices 技能中 - 特定规则中是否需要更明确的文档链接 ## 备注 此提案有意保持保守： - 它引用官方文档 - 它标记经验法则 - 它使用示例展示架构层如何补充 现有规则