核心用途
canonical-data-map 是 OpenClaw 希腊会计系统的单一数据源（Single Source of Truth），为所有技能提供文件系统路径、命名约定、标识符格式和目录结构的绝对权威规范。任何技能的路径定义若与此冲突，以此文档为准。
关键规范
目录架构（16个顶级目录）
| 目录 | 用途 | 写入权限 |
|:---|:---|:---|
| `/data/incoming/` | 原始文档入口（发票、银行对账单等） | `accounting-workflows` |
| `/data/clients/{AFM}/` | **客户主记录唯一真相源** | `client-data-management` 独占写入 || `/data/processing/` | 管道临时工作区，**禁止作为最终数据源** | 各管道技能 |
| `/data/compliance/` | 政府申报文件（TAXIS、myDATA、EFKA） | `greek-compliance-aade` |
| `/data/memory/` | **v1.1新增**：智能体记忆、失败日志、学习模式 | `memory-feedback` |
强制命名规则
- AFM 格式：
EL+ 9位数字，必须大写（例：EL123456789），禁止纯9位数字形式 - 文件名格式：
{AFM}_{YYYY-MM}_{type}_{detail}.{ext}，全小写类型，无空格无希腊字符 - 日期存储：JSON 中一律 UTC ISO 格式（
2026-02-18T14:30:00Z），显示层才转换为希腊格式DD/MM/YYYY - 货币存储：纯数字保留两位小数，禁止含 € 符号的字符串
加密要求（GDPR 合规）
| 分类 | 目录 | 加密 |
|:---|:---|:---|
| Restricted | `/data/auth/` | **强制 AES-256-GCM** |
| Confidential | `/data/clients/`, `/data/compliance/`, `/data/efka/`, `/data/gdpr-exports/` | **强制** |
| Internal | `/data/reports/`, `/data/system/` | 推荐 |
主密钥通过环境变量 OPENCLAW_ENCRYPTION_KEY 或 HSM 管理，严禁存储于 `/data/` 或 SKILL.md 中。
审计与合规
- 统一审计事件：所有技能须写入
/data/system/logs/audit/{YYYY-MM-DD}_audit.jsonl，保留10年 - 专业责任声明：所有客户可见文档必须附加希腊语/英语免责声明，明确非专业税务建议
- 废弃路径清单：明确列出
/data/alpha-bank/、/data/scanned-documents/等15条废弃路径及对应规范替代
显著优点
1. 绝对权威性：文档末尾明确声明"When a path in a skill conflicts with this document, this document wins"
2. 企业级安全：AES-256-GCM 加密、10年审计保留、GDPR 72小时泄露通知支持
3. 智能体原生设计：v1.1 新增 /data/memory/ 目录，支持失败模式学习、GitHub PR 自动提案（Skill 19 专属）
4. 希腊本地化深度：VAT 税率校验（24%/13%/6%/0%）、员工姓名拉丁转写规则、希腊财政年度处理
局限性与风险
| 风险点 | 说明 |
|:---|:---|
| 版本锁定严格 | 禁止任何技能在未经版本更新的情况下引入新的顶级目录，可能拖慢迭代速度 |
| 单点写入瓶颈 | `/data/clients/` 仅允许 `client-data-management` 写入，高并发场景可能成为瓶颈 |
| 废弃路径维护负担 | 需持续维护15条废弃路径的映射关系，历史技能升级成本高 |
| 内存目录容量限制 | `/data/memory/` 2GB 硬上限，90% 容量时系统停止写入，需主动监控 |
| 外部依赖 | 依赖 GitHub 集成进行模式改进提案，网络中断时反馈循环中断 |
适合人群
- 构建希腊本地化会计系统的开发团队
- 需要符合希腊税法（Law 4624/2019）和 GDPR 的企业
- 采用多技能智能体架构、需严格数据治理的技术组织
使用建议
1. 将此文档作为代码审查的强制检查点，任何路径变更必须同步更新此处
2. 部署 system-integrity-and-backup（Skill 17）每周验证加密状态
3. 为 /data/memory/ 配置独立监控告警，避免 2GB 上限导致学习中断