PART F · DataGovernancePrincipals · ORP-131 重构
← 返回主页
F 类 · 数据治理原则（F1 / F2 / F3）
ORP-131 重构（2026-07-30 · 安南当面拍板）· F 大类拆分为 3 子模块 + 顶层 T（不属子模块）
数据治理生命周期闭环：F1 定原则 → F2 定交换 → F3 定打包（定义 → 流通 → 发布）
🗺️ F 大类总览 · 三板块闭环
F1 通用数据治理原则
宪法层 · 定义数据「是什么」（5 级维度 L1-L5 · 五类 T/D/R/O/M）和「归属」（Scope×Layer 决策矩阵）
GENERIC_GOVERNANCE_PRINCIPLES v1.3
F2 数据交换协议
流通层 · 定义数据如何在 Layer1↔Layer2 间「合法流动」（11 event_type · 6 态状态机 · 双层维护）
LAYER_EXCHANGE v1.4-DRAFT
F3 打包发布清单
发布层 · 定义数据如何「外发」（Bundle 白名单 · MANIFEST 7 段 · custom_labels 第 6 维度）
BUNDLE_MANIFEST_SPEC v1.0
顶层 T（不属子模块）：ONTOLOGY_VERSION v1.10.0 + ONTOLOGY_MASTER_INDEX v1.4
关键依赖链：F1 的 k_type 决定 F3 打包范围（[T+M] 包含 / [R+D] 排除）→ F1 的 Layer 维度决定 F2 event_type 方向 → F2 的 APPLIED 终态是 F3 打包前置条件 → F3 的 custom_labels 反挂到 F1 任意 k_type（正交不挂钩）
F1通用数据治理原则
权威源：ontology/F_DataGovernancePrincipals/ONTOLOGY_Project_GENERIC_GOVERNANCE_PRINCIPLES.md ACTIVE v1.3
核心：9 条铁律 G-Gov.1~G-Gov.9 · 5 级维度必填 frontmatter · T/D/R/O/M 五类边界（§2 权威定义）
5 级维度（L1-L5）· frontmatter 必填 5-Level Governance Dimensions
| 级 | 维度名 | 字段 | 含义 | 候选值 |
|---|
| L1 | Content 内容类型 | k_type | 数据治理五大类 | TDROM |
| L2 | Scope 应用范围 | k_scope | 跨 TC 通用 vs 单 TC 专用 | GeneralInstanced |
| L3 | Layer 来源层 | k_layer | global 权威源层 vs local 实例化层 | Layer1Layer2 |
| L4 | Status 生命周期 | k_status | 权威状态（ACTIVE↔DEPRECATED 必经 ORP 闭环 · 不跨级跳变） | ACTIVEDEPRECATEDDRAFTRECORD |
| L5 | Location 物理位置 | k_location | 物理归属目录（RealTimeCherryPy 已废弃 · 由 ontology/ M1 取代） | ontologyAutoTestExec_claude_skillslocal_skill |
每个维度必填对应 justification 字段（≤200 字）：scope_justification / layer_justification / status_justification / location_justification
T / D / R / O / M 五类（§2 权威定义）Five Data Classes
| 类 | 名称 | 一句话定义 | 典型示例 |
|---|
| T | 技术类 | 设计 / 规范 / 代码 / schema / prompt 模板 | ONTOLOGY_FRAMEWORK_DRAFT.md · attack_mode_labeler.py |
| D | 数据类 | 测试数据 / 批量输出 / 历史快照 / 运行时数据（可保留 _v381 后缀） | ATTACK_MODE_LABELS.json · state.json |
| R | 复盘类 | 知识沉淀 / 决策脉络 / 操作计划（append-only） | ORP-99_RECORD_*.md · 00_operation_plan.md |
| O | 治理类 | ORP 索引 / 同步清单 / 治理台账（可放 T 目录但须标 k-type: O） | ORP_INDEX.md · ORP_SYNC_CHECKLIST.md |
| M | 维护类 | 状态 / 日志 / 配置 / Temp（状态不是设计） | ONTOLOGY_VERSION.md · MODULE_DATA_INDEX.md |
知识资产 = [T] + [R] + [M]（外发打包只收这三类 · 排 [D]）· 边界铁律：T 不可放废弃版本/批量数据 · T 目录不允许 D/R 类文件 · 特例 T 类允许 Instanced scope（落点 = AgentProfile-TaiChu）
F2数据交换协议
3 文件：LAYER_EXCHANGE_PROTOCOL.md DRAFT v1.4 · PROPOSAL_STATUS_MACHINE.md DRAFT v1.2 · AGENTPROFILE_MAINTENANCE_PROTOCOL.md NEW v1.0
核心：Layer1↔Layer2 跨层信息交换 · 11 event_type · 6 态状态机 · AgentProfile 双层维护（T→T1N）
11 event_type · 严格按方向分离（无双向）Layer1 ↔ Layer2 Events
| # | 方向 | event_type | 中文名 / 说明 |
|---|
| 01 | UP | task_result_report_submitted | 任务结果回报（通用任务）· 期望下行 09/10 |
| 02 | UP | agp_i_update_proposed | AgentProfile-Instance 修改提案 · 期望下行 10（仅提案者） |
| 03 | UP | ontology_update_proposed | Ontology 修改提案 · 期望下行 10 + 11（广播） |
| 04 | UP | task_delegation_requested | Layer2 希望 Layer1 委派给自己 |
| 05 | UP | task_assignment_requested | Layer2 要求 Layer1 执行 |
| 06 | UP | ontology_query_requested | 本体查询 / 同步（mode=query|sync）· 走下载通道 |
| 07 | UP | ontology_item_query_requested | 本体项目查询 / 同步 · 走下载通道 |
| 08 | UP | agp_i_query_requested | AgP-I 查询 / 同步 · 走下载通道 |
| 09 | DOWN | task_delegated | 任务委派（L1_active / 04_approved / 05_approved / 08_approved） |
| 10 | DOWN | proposal_feedback | 提案反馈（仅提案者 · 单源）· Layer1 审核 |
| 11 | DOWN | published_notification | 广播下行（orp_published / agp_i_created / agp_i_updated） |
R6 闭环铁律：APPLIED 状态必须含 closure_feedback_event_id · Layer1 24h 内必须反馈 · 每事件 14 字段必填（§3）· HMAC 签名机制委托 Skill data_governance_compliant_info_exchange v1.3.0-Draft（双保险：payload ack_* 字段 + HTTP header X-Message-ACK · HMAC-SHA256）
6 态状态机 · 终态不可逆（ORP 提案）Proposal Status Machine
| 状态 | 类型 | 描述 | 终态 |
|---|
| DRAFT | 暂态 | 提案初稿生成（Lead Agent 起草） | — |
| SUBMITTED | 暂态 | 已提交审核队列（annan.decide 触发 · 不可回退） | — |
| REVIEWING | 暂态 | 审核中（ultimate_reviewer + committee 投票 · 不可回退） | — |
| APPROVED | 终态 | 审核通过（安南当面 / 会议拍板） | ✅ |
| REJECTED | 终态 | 审核拒绝（含拒绝理由） | ❌ |
| APPLIED | 终态 | 已落地（ontology/ 落盘 + CherryPy HTTP 200）· APPROVED ≠ APPLIED | ✅ |
| ARCHIVED | 终态 | 已归档（90 天后自动迁移） | 🗄️ |
主路径迁移：DRAFT → SUBMITTED → REVIEWING → { APPROVED → APPLIED → ARCHIVED | REJECTED → ARCHIVED }
AgentProfile 双层维护（T → T1N 模式）Dual-Layer Maintenance
| 维度 | Layer1 · Template | Layer2 · Instance |
|---|
| 类型 | General T | Instanced T |
| 物理位置 | B_GeneralAgentProfile/B1_AgentProfile/AGENT_PROFILE_TEMPLATE.md v2.0 | AgentDossier/taichu/dossier.md（各 TC 实例 yaml） |
| 内容 | 通用填写模板（5+1 视图 + 字段级版本状态机 + 漂移检测 6 规则） | 实例级字段值（User.md 文本 / AgentCore 工具列表 / 三面全景实例化） |
| 关系 | 1 : N（Instance 必须继承 Template 字段名 · 不允许改写） |
A1-A4 流程：
A1 [Layer1] 跨 TC 反馈累积 ≥3 → Lead 输出 General 提案 → ORP-DRAFT → 安南拍板 → Template bump → 下发 Layer2
A2 [Layer2] TC 反馈 → Instance 报告（8 字段）→ 3 道门控（Lead 形式完整 7 项 + AP-Generator schema 5 项 + k_status 状态机）
A3 [Layer2] 物理写入 → status=APPLIED → cross_tc_count++ → INDEX.yaml 同步
A4 [I→G] cross_tc_count ≥ 3 → 自动生成 ORP-DRAFT → 安南拍板 → Template 升级 → 全 Layer2 同步
F3打包发布清单
2 文件：BUNDLE_MANIFEST_SPEC.md NEW v1.0 · CUSTOM_LABELS_REGISTRY.md ACTIVE v0.1
核心：Bundle 打包范围 [T+M] · MANIFEST.md 7 段契约 · custom_labels 第 6 维度（与 k_type 正交）
打包范围 · 严格 [T+M] Bundle Scope
| 范围 | 内容 |
|---|
| ✅ 包含 | [T+M]：ontology/RealTimeCherryPy/AutoTestExec/MockAgent/MockCriticalSkills/_claude_skills/DataAnalysis/ExternalKnowledge/ + VERSION/CHANGELOG/README/INDEX/frontmatter |
| ❌ 排除 | [R+D]：*.reflection.md · reflection_v3.py · state.json · attempt_log/ · *.tmp · *.log · .cache/ |
顶层白名单：8 dirs（见上行）+ 11 files（MANIFEST/README/CHANGELOG/ONTOLOGY_VERSION/ORP_INDEX/ATA_MASTER_INDEX/ATTACK_PATTERN_LIBRARY/GENERIC_GOVERNANCE_PRINCIPLES/AGENT_PROFILE_TEMPLATE + bundle_build/VERSION + CHANGELOG）
MANIFEST.md · 7 段契约 Manifest Sections
| 章节 | 描述 |
|---|
| §0 bundle 概览 | 版本 + 大小 + 文件数 + ONTOLOGY_VERSION + 日期 |
| §1 顶层白名单 | 8 dirs + 11 files 清单 |
| §2 打包范围 | [T+M] 包含 + [R+D] 排除 |
| §3 custom_labels 筛选 | ORP-108 完全正交 · 不挂钩说明 |
| §4 5 镜像同步 | ⚠️ 已废弃（改两线视角：项目内使用 + Part-G 注册） |
| §5 Skill 清单 | 18 Skills |
| §6 版本修订记录 | 本次 bump 原因 + 历史 |
顶层必填字段：bundle_version / ontology_version / date / size_mb / file_count / dir_count / manifest_author / manifest_status
custom_labels · 第 6 维度业务标签（与 k_type 正交）Custom Labels Registry
| 标签 | 语义 | 注册 |
|---|
| bundlePublished | 标记此对象参与打包 bundle · sync_bundle 脚本扫到本标签自动加入打包清单 · 与 k_type 完全正交 | ACTIVE ORP-108 |
| auditTrail | （待注册候选）审计追踪标记 | 候选 |
| securitySensitive | （待注册候选）安全敏感标记 | 候选 |
| humanReviewRequired | （待注册候选）需人工复核 | 候选 |
| deprecatedBundle | （待注册候选）废弃 bundle 标记 | 候选 |
正交关系：k_type 决定「数据是什么」（T/D/R/O/M 五类）· custom_labels 决定「数据怎么用」（业务标签）· 同一 custom_label 可挂载任意 k_type，反之同一 k_type 可挂多个 custom_labels
命名铁律：字段名必须 custom_labels（snake_case + 复数）· 值必须 camelCase · 禁止 k_labels / labels / tags / K-Label