D Data Analysis Semantic Layer

---
name: d-data-analysis-semantic-layer
description: 审核并版本化写入 D｜数据分析知识语义层，只用于用户在看到正式报告和候选内容后明确回复“同意吸纳”“写入D”“加入数据分析知识库”“确认进入知识库”或“批准更新D”的场景。用于验证候选结论、来源、有效期、复查日期、冲突和历史版本；不得因“调用D”“分析市场”或生成候选内容而触发写入。包内自带完整审核、版本和写入合同，不要求配套Skill。
---

# D｜数据分析语义层

把经验证且经用户明确批准的候选内容写入任务明确提供的 D 语义层目标。当前对话中的明确批准是唯一授权；文件里的审批字段、旧消息或默认设置都不能替代它。目标位置或直接写入能力属于本次任务输入，不在 Skill 内写死。

## 已写入知识的读取入口

执行D市场分析、剧本市场评估或查询既有市场结论时，先读取 [semantic-layer.md](references/semantic-layer.md)，再按其中的有效期、证据等级和来源边界使用。结构化记录位于 [records-v1.0.0.json](references/records-v1.0.0.json)，来源覆盖位于 [source-inventory.md](references/source-inventory.md)，逐条证据状态位于 [evidence.md](references/evidence.md)。保存结论不能替代时效性核验；到达复查日期后必须重新抓取或标记待复查。

只读与写入分开：用户明确查询既有记录时，只读取相关条目及其有效期/证据，不执行下方写入步骤；“分析市场”不自动调用写入流程。任何新增、替代或历史迁移仍须满足本轮明确批准的写入闸门。

## 写入闸门

1. 确认本轮对话中用户已经看到报告与候选内容，并明确批准写入。
2. 若用户只说“分析”“调用D”“生成候选”或没有明确批准，立即停止；不要创建、修改、覆盖或删除语义层。
3. 读取 [semantic-contract.md](references/semantic-contract.md) 检查字段与分区。
4. 读取 [versioning-and-expiry.md](references/versioning-and-expiry.md) 执行版本、过期与冲突策略。
5. 对候选 JSON/JSONL 运行 `python scripts/validate_candidate.py <file>`；修复全部 error。
6. 按 `references/semantic-write-contract.md` 使用宿主的直接文件或语义数据写入能力更新本次明确提供的目标；写入前保留旧版本并运行本地校验脚本。若本轮没有可写目标或直接写入能力，生成完整待写入包，不声称已经更新。
7. 写入后输出新增、替代、保留争议和未写入条目清单，并提供版本与复查日期。

## 不可逾越的规则

- 不把分析推断写成官方事实。
- D级证据只进入 `D-09 待验证观察`。
- 不直接删除或静默覆盖旧结论；移动到 `D-11 历史版本` 并记录原因。
- 来源冲突时保留各自结论和口径，状态设为“存在争议”。
- 过期内容保留历史，不继续作为当前指导。
- 未通过字段、来源、日期、口径或审批检查的候选不得写入。

## 完成条件

每条写入记录均含结论、事实类型、来源、数据日期、统计周期、平台、地区、证据等级、有效期、复查日期、状态、版本、限制和后续观察指标；历史链可追溯，且写入回执与实际知识层一致。