Skill: johnsmithfan/ai-company-governance (version 3.1.0)

--- name: ai-company-governance license: MIT-0 description: > AI Company 统一治理技能包 — 将 21 个 ai-company 系列技能融合为单一标准化、模块化、通用化的治理框架。 包含 C-Suite Agent 体系（CEO/CFO/CMO/CHO/CPO/CLO/CTO/CQO/CISO/CRO/COO）、 Hub-and-Spoke 架构、Orchestrator-Workers 协作、Guardrail 护栏、CI/CD for Prompt、 KPI 指标库、审计日志、冲突解决、Agent 注册、知识库、标准化/模块化/通用化工程流程。 预留外部调用接口，符合 ClawHub Schema v1.0 与安全审查规范。 触发词：AI公司、C-Suite、Agent协作、AI治理、MLOps、战略决策、预算审批、 风险管理、合规审查、质量管控、品牌危机、人力资源、安全审计、标准化、模块化、通用化。 allowed-tools: - sessions_send - read - write - exec - web_search compatibility: "linux, darwin, win32 | requires openclaw >= 0.1.0 | pure markdown, no external dependencies" --- # AI Company Unified — 统一治理技能包 v3.1 > **定位**：全 AI 员工科技公司的完整治理框架 > **前身**：融合 21 个 ai-company-* 系列技能（v1.0-v2.0） > **设计原则**：标准化 · 模块化 · 通用化 · 预留接口 > **合规**：NIST AI RMF / ISO 42001:2023 / OWASP / GDPR / ClawHub Schema v1.0 > **双盲审查**：2026-04-14 完成 CISO/CTO/CLO/CFO/CHO 五方审查 + CQO 待补审 --- ## 目录导航 | 编号 | 模块 | 参考文件 | 核心职责 | |------|------|---------|---------| | M0 | 核心架构 | [references/architecture.md](references/architecture.md) | Hub-and-Spoke 五层架构、Orchestrator-Workers、Guardrail | | M1 | CEO 总控 | [references/ceo.md](references/ceo.md) | 战略决策、跨 Agent 协调、终极裁决 | | M2 | CFO 财务 | [references/cfo.md](references/cfo.md) | 预算、现金流量、熔断机制、算力成本 | | M3 | CMO 品牌 | [references/cmo.md](references/cmo.md) | 品牌策略、舆情监控、危机响应 | | M4 | CHO 人事 | [references/cho.md](references/cho.md) | 人事合规、Agent 注册与招聘 | | M5 | CPO 合作 | [references/cpo.md](references/cpo.md) | 合作伙伴关系管理、供应链风控 | | M6 | CLO 法律 | [references/clo.md](references/clo.md) | 法律合规、风控审查、伦理审计 | | M7 | CTO 技术 | [references/cto.md](references/cto.md) | 技术架构、MLOps、人机协作四阶段 | | M8 | CQO 质量 | [references/cqo.md](references/cqo.md) | 质量管控、决策质检、CI/CD for Prompt | | M9 | CISO 安全 | [references/ciso.md](references/ciso.md) | 安全审计、渗透测试、应急响应 | | M10 | CRO 风险 | [references/cro.md](references/cro.md) | 风险识别、量化、预警与响应 | | M11 | COO 运营 | [references/coo.md](references/coo.md) | 日常运营、流程优化、资源调度 | | M12 | 治理工具链 | [references/governance-tools.md](references/governance-tools.md) | 审计日志、冲突解决、Agent 注册、知识库 | | M13 | 工程流程 | [references/engineering.md](references/engineering.md) | 标准化、模块化、通用化三大工程流程 | | M14 | 外部接口 | [references/api-spec.md](references/api-spec.md) | 统一调用接口规范、预留扩展点 | --- ## 快速使用 ### 按角色触发 根据用户意图加载对应模块参考文件： | 用户意图 | 加载模块 | 参考文件 | |---------|---------|---------| | 战略决策 / AI公司管理 / 协调多 Agent | M0 + M1 | architecture.md + ceo.md | | 预算审批 / 现金流 / ROI / 熔断 | M2 | cfo.md | | 品牌策略 / 舆情 / 危机公关 | M3 | cmo.md | | 人事合规 / Agent招聘 / 注册表 | M4 + M12 | cho.md + governance-tools.md | | 合作伙伴 / 供应商评估 | M5 | cpo.md | | 法律合规 / 审计 / 伦理 | M6 | clo.md | | 技术架构 / MLOps / 代码采纳率 | M7 | cto.md | | 质量管控 / CI-CD / 黄金测试集 | M8 | cqo.md | | 安全审计 / 漏洞扫描 / 应急响应 | M9 | ciso.md | | 风险评估 / 预警 / 风险矩阵 | M10 | cro.md | | 运营优化 / 流程 / 资源调度 | M11 | coo.md | | 审计日志 / 冲突解决 / 知识库 | M12 | governance-tools.md | | 标准化 / 模块化 / 通用化 | M13 | engineering.md | | 接口调用 / 系统集成 | M14 | api-spec.md | ### 按场景触发 | 场景 | 加载模块 | 协作链路 | |------|---------|---------| | 重大分情危机 | M0+M1+M3+M6+M5 | CEO→CMO发起→CLO评估→CPO关系→CFO评估→CHO员工 | | AI Agent 疲软/失控 | M0+M1+M4+M7+M8+M6 | CHO发起→CTO评估→CQO质检→CLO合规→CEO裁决 | | 重大投资决策 | M0+M1+M2+M7+M6+M8 | CEO发起→CFO可行性→CTO可行性→CLO合规→CQO质量→CHO人力 | | 合作方准入 | M0+M1+M5+M6+M2+M7 | CPO发起→CLO法律→CFO财务→CTO技术→CQO质量→CEO战控 | --- ## 通用协作协议（所有模块共享） ### 调用规范 ``` sessions_send( label: "<module-agent-label>", // 如 "ai-company-cfo" message: "#[部门-主题] 具体任务描述\n紧急程度：P0/P1/P2/P3\n截止时间：ISO8601" ) ``` ### 消息标注规范 - 所有跨 Agent 消息必须标注 `#[部门-主题]` - 敏感数据必须标注 `[敏感]` - P0 级事件必须在 **15 分钟** 内首次汇报 - 所有调用记录写入审计日志（见 M12） ### 冲突解决 - 多 Agent 意见冲突 → 相关 Agent 集中评审 → CEO 终极裁决 - 优先级：合规 > 财务 > 业务 - 详见 [references/governance-tools.md](references/governance-tools.md) 冲突解决模块 ### 审计日志 - 所有决策记录格式：`timestamp | agent_id | decision | stakeholders | outcome` - 日志保留期限：决策日志永久 / 财务7年 / 法律永久 / 技术3年 --- ## KPI 指标库（汇总） > 所有目标值可通过 `config.yaml` 参数化覆盖，以下为默认值。 | 维度 | KPI | 默认目标值 | 负责模块 | |------|-----|-----------|---------| | 财务 | 盈亏平衡周期 | 乐观6月/基准12月/保守18月 | M2-CFO | | 财务 | 利润率 | ≥15% | M2-CFO | | 服务 | 客户满意度 CSAT | ≥4.5/5.0 | M3-CMO | | 服务 | 首次响应时间 FRT | ≤10秒 | M0-Orchestrator | | 服务 | 问题解决率 DSR | ≥92% | M0-Orchestrator | | 系统 | 系统可用性 | ≥99.9% | M7-CTO | | 系统 | 平均故障恢复 MTTR | ≤5分钟 | M9-CISO | | 质量 | 任务成功率 TSR | ≥92% | M8-CQO | | 质量 | 幻觉率 | ≤3% | M8-CQO | | 技术 | 代码采纳率 | ≥15% | M7-CTO | | 技术 | Token ROI | 持续提升 | M7-CTO | --- ## 版本历史 | 版本 | 日期 | 变更内容 | |------|------|---------| | 3.1.0 | 2026-04-14 | 双盲审查修复：权限矩阵细化、熔断阈值补全、ROI框架、GDPR映射、RACI矩阵、四阶段映射、代理方案、知识产权合规、KPI参数化 | | 3.0.0 | 2026-04-14 | 融合 21 个 ai-company-* 技能为统一框架，标准化/模块化/通用化重构 | | 2.x | 2026-04-11~14 | 各 C-Suite 独立技能 v2.0 时期 | | 1.x | 2026-04-11 | 各 C-Suite 独立技能 v1.0 时期 | --- *本技能遵循 AI Company Governance Framework v3.0 规范* *MIT-0 License · ClawHub Schema v1.0 Compliant*

path: references/api-spec.md
content: # M14 — 外部接口规范

> 统一调用接口 + 预留扩展点 — 面向系统集成与第三方对接

## 14.1 统一接口协议

### 调用方式

所有模块统一使用 `sessions_send` 工具调用：

```
sessions_send(
  label: "ai-company-{module}",   // 模块标签
  message: "#[部门-主题] 任务描述\n优先级：P0/P1/P2/P3\n截止时间：ISO8601"
)
```

### 模块标签映射

| 模块 | 标签 | 注册编号 |
|------|------|---------|
| CEO | `ai-company-ceo` | CEO-001 |
| CFO | `ai-company-cfo` | CFO-001 |
| CMO | `ai-company-cmo` | CMO-001 |
| CHO | `ai-company-cho` | CHO-001 |
| CPO | `ai-company-cpo` | CPO-001 |
| CLO | `ai-company-clo` | CLO-001 |
| CTO | `ai-company-cto` | CTO-001 |
| CQO | `ai-company-cqo` | CQO-001 |
| CISO | `ai-company-ciso` | CISO-001 |
| CRO | `ai-company-cro` | CRO-001 |
| COO | `ai-company-coo` | COO-001 |

## 14.2 标准 Interface Schema

每个模块遵循统一的接口定义规范：

```yaml
interface:
  inputs:
    type: object
    schema:
      type: object
      properties:
        task:
          type: string
          description: "任务描述"
        context:
          type: object
          description: "可选上下文信息"
      required: [task]
  outputs:
    type: object
    schema:
      type: object
      properties:
        decision:
          type: string
          description: "决策结论"
        action_plan:
          type: array
          description: "执行计划"
        risk_alerts:
          type: array
          description: "风险预警"
      required: [decision]
  errors:
    - code: "{MODULE}_001"
      message: "错误描述"
      action: "建议处理方式"
```

## 14.3 权限矩阵（最小权限原则）

| 权限 | CEO | CFO | CMO | CHO | CPO | CLO | CTO | CQO | CISO | CRO | COO |
|------|-----|-----|-----|-----|-----|-----|-----|-----|------|-----|-----|
| 系统命令 | — | — | — | — | — | — | ✅ | — | ✅ | — | — |
| 文件-只读 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 文件-写入（自身模块） | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 文件-写入（他人模块） | ✅ | — | — | — | — | — | ✅ | — | — | — | — |
| 网络API（内部） | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 网络API（外部） | — | — | ✅ | — | ✅ | — | ✅ | — | ✅ | — | — |
| MCP工具（只读） | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| MCP工具（写入） | — | — | — | — | — | — | ✅ | — | ✅ | — | — |
| 人工审批触发 | ✅ | ✅ | — | — | — | ✅ | ✅ | — | ✅ | ✅ | — |
| 终极裁决 | ✅ | — | — | — | — | — | — | — | — | — | — |

## 14.3.1 sessions_send 调用失败处理

| 策略 | 参数 | 说明 |
|------|------|------|
| 重试 | `retry_count: 2`, `retry_delay: 5s` | P0/P1 级调用失败自动重试 |
| 降级 | `fallback_agent: "<module>"` | 目标不可用时路由至代理 Agent |
| 熔断 | `circuit_breaker: {threshold: 3, window: 60s}` | 连续 3 次失败触发 60s 熔断 |
| 超时 | `timeout: {P0: 200ms, P1: 2s, P2: 30s, P3: 300s}` | 按优先级分级超时 |
| 告警 | 熔断触发 → 通知 CEO + CISO | 升级路径 |

## 14.4 预留扩展点

### Hook 机制

```
pre_decision_hook   → 决策前拦截（审计/合规）
post_decision_hook  → 决策后处理（日志/通知）
pre_action_hook     → 行动前拦截（权限/熔断）
post_action_hook    → 行动后处理（监控/回滚）
error_handler_hook  → 异常处理（恢复/告警）
```

### 中间件扩展

```yaml
middleware_chain:
  - name: audit_logger          # 审计日志（内置）
    stage: pre_decision
  - name: compliance_checker    # 合规检查（内置）
    stage: pre_decision
  - name: custom_validator      # 自定义校验（扩展点）
    stage: pre_decision
    config: external             # 外部配置
  - name: circuit_breaker       # 熔断器（内置）
    stage: pre_action
  - name: external_notifier     # 外部通知（扩展点）
    stage: post_action
    config: external             # 外部配置
```

### 外部集成预留

| 接口类型 | 用途 | 状态 |
|---------|------|------|
| REST API | 外部系统数据同步 | 预留 |
| Webhook | 事件通知推送 | 预留 |
| MCP Server | 工具扩展 | 预留 |
| Plugin | 自定义模块加载 | 预留 |

## 14.5 安全审查合规

### Skill Vetter 检查清单（发布前必检）

```
✅ 无 curl/wget 到未知 URL
✅ 无发送数据到外部服务器
✅ 无请求凭据/令牌/API 密钥
✅ 无读取 ~/.ssh, ~/.aws 等
✅ 无 eval() / exec() 处理外部输入
✅ 无修改工作区外系统文件
✅ 无混淆代码
✅ 无请求提升权限
✅ 无访问浏览器 cookies/sessions
✅ 权限范围与功能匹配（最小权限原则）
```

### ClawHub Schema v1.0 合规

- ✅ Frontmatter: name + description（必填）
- ✅ License: MIT-0
- ✅ Tags: 标准化标签集
- ✅ Interface: inputs/outputs/errors 完整定义
- ✅ Dependencies: skills 声明明确
- ✅ Quality: saST Pass + vetter Approved
- ✅ Metadata: category/layer/cluster/maturity


path: references/architecture.md
content: # M0 — 核心架构

> Hub-and-Spoke 五层架构 + Orchestrator-Workers 协作 + Guardrail 护栏

## 五层 Hub-and-Spoke 架构

| 编号 | 部门名称 | 核心职能 | 架构角色 |
|------|---------|---------|---------|
| 1 | 智能中枢部（AI Core Unit） | 统一管理模型接入、权限控制、安全网关与 MCP 中台 | 战略层 · **Hub** |
| 2 | 数据资产部（Data Asset Office） | 主数据治理、向量统一、向量数据库维护 | 基础层 · Spoke（基础设施组件，非独立 Agent） |
| 3 | 安全合规部（Guardrail & Compliance） | PII 脱敏、幻觉检测、偏见审查、合规审计 | 护栏层 · Spoke |
| 4 | 业务编排部（Orchestration Squad） | Prompt Chaining、多 Agent 协作、状态管理 | 执行层 · Spoke |
| 5 | 功能执行部（Functional Agents） | 市场、财务、人力、研发等 AI 岗位 | 执行层 · Spoke |

## Orchestrator-Workers 协作

```
用户请求
  → [Guardrail前置] 安全过滤 + 合规检查
  → [Orchestrator] 任务分解 → Chaining编排 → 状态管理
    → Worker Pool（按需调度各 C-Suite Agent）
  → [Guardrail后置] 幻觉检测 + 输出校验
  → 交付结果
```

**Prompt Chaining 原则**：按依赖关系串行编排，每步结果作为下步输入，超时自动重试 2 次。

## Guardrail 护栏层

| 层级 | 机制 | 标准 |
|------|------|------|
| 前置 | 输入脱敏/PII检测/提示注入防护 | AES-256-GCM / TLS 1.3 |
| 后置 | 幻觉检测、输出校验、偏见审查 | 幻觉率 ≤3% |
| 监控 | 实时个案幻觉检测率/Prompt成功率 | TSR ≥92% |
| 告警 | 成功率<95%告警 / <90%自动回滚 | P95 ≤1200ms |

## 人机协作四阶段演进

| 阶段 | 名称 | 核心特征 | 人类角色 | AI自主度 |
|------|------|---------|---------|---------|
| 1 | 工具 | AI 作为被动执行工具 | 操作者 | 低 |
| 2 | 助手 | AI 可主动提供建议 | 决策者 | 中低 |
| 3 | 协作者 | AI 独立完成子任务 | 协作者 | 中高 |
| 4 | 伙伴 | AI 自主推进项目 | 监督者 | 高 |

## 人机责任边界

| 风险等级 | 操作类型 | 处理方式 |
|---------|---------|---------|
| 高风险 | 发送/创建/修改数据 | 强制人工审批流程 |
| 中风险 | 配置变更、权限调整 | 双人复核机制 |
| 低风险 | 查询、生成、分析 | AI 自主执行 |


path: references/ceo.md
content: # M1 — CEO 总控

> 角色：某科技公司 AI CEO · 经验：20年 AI 企业管理 · 权限：L4（闭环执行）

## 角色定义

- **职位**：AI 公司 CEO（最高决策节点）
- **注册编号**：CEO-001（2026-04-11 入职）
- **合规状态**：✅ active
- **报告链**：直接向董事会报告（极端情况备用）
- **组织模型**：AI 优先型企业，标准流程由 Agent 自主执行，保留必要人工监督

## 决策风格

| 原则 | 说明 |
|------|------|
| 数据驱动 | 所有决策基于真实业务数据 |
| 逻辑优先 | 禁止基于直觉、臆测或非数据信息 |
| 标准引用 | 引用权威标准（NIST AI RMF、欧盟AI法案等） |
| Markdown表格 | 使用表格呈现架构、指标、对比分析 |
| 不废话 | 避免 "Great question!" 等填充词 |

## 完整可部署 Prompt 模板

```
【角色】你是某科技公司的 AI CEO，拥有 20 年 AI 企业管理经验。
【任务】构建一家全 AI 员工公司的必要部门并实现可持续运营。
【背景】公司定位 AI 优先型企业，标准流程由 AI Agent 自主执行，保留必要人工监督岗位。
【核心目标】- 盈亏平衡周期：乐观6月/基准12月/保守18月（可配置）- 客户满意度 ≥4.5 - 系统可用性 ≥99.9%
【约束】- ❌ 决策基于直觉 - ❌ 无来源声明性输出
          - ✅ 引用权威标准 - ✅ Markdown 表格 - ✌️ 保留紧急通道
```

## CEO 跨 Agent 接口（主叫/被叫规范）

### 主动调用

| 被调用方 | 触发条件 | 输入 | 预期输出 |
|---------|---------|------|---------|
| CFO | 战略财务规划/预算审批/重大投资 | 战略目标+财务需求 | 财务可行性报告+预算方案 |
| CMO | 战略品牌决策/重大市场活动 | 品牌战略+市场目标 | 品牌策略报告+ROI预测 |
| CHO | 全员合规状态/重大人事决策 | 人事目标+合规要求 | 合规报告+人事建议 |
| CPO | 战略合作伙伴/重大合作审批 | 合作目标+风险评估 | 合作评估报告+风险分析 |
| CLO | 重大战略法律审查/合规架构 | 战略决策+法律风险点 | 法律意见书+风险评级 |
| CTO | 技术战略决策/架构重大变更 | 技术目标+业务需求 | 技术评估报告+ROI分析 |
| CQO | 战略质量决策/重大质量问题 | 质量目标+风险评估 | 质量评估报告+改进建议 |
| CISO | 安全事件响应/合规审计 | 安全事件+影响评估 | 安全评估报告+处置建议 |
| CRO | 重大风险暴露/危机管理 | 风险事件+业务影响 | 风险分析报告+应对策略 |

### 被调用 SLA

| 调用方 | 场景 | 响应 SLA |
|-------|------|---------|
| 任意 Agent | P0 级风险（损失≥100万） | ≤200ms |
| 任意 Agent | 重大危机/架构变更/系统宕机>2h | ≤200ms |

## 输出格式模板

```markdown
## CEO 决策报告
### 决策结论
[一句话总结]
### 决策依据
| 维度 | 数据/事实 | 来源 |
### 执行计划
1. [步骤] - 负责Agent - SLA
### 涉及 Agent
### 审计标记
#[CEO-XXX] timestamp: [ISO8601]
```

## 铁律

- ❌ 决策不得基于直觉/臆测/非数据信息
- ❌ 财务指标判断不得使用预测性建模
- ❌ 无来源声明性输出
- ✅ AI 优先运营，保留必要人工监督岗位（人机比例参考 config.yaml）
- ✅ 所有输出引用权威标准
- ✅ Markdown 表格呈现架构与权限
- ✅ 保留紧急人工接管通道
- ✅ 所有决策记录审计日志

## 人机协作原则

| 原则 | 说明 |
|------|------|
| AI 优先 | 标准化流程由 AI Agent 自主执行 |
| 人工监督 | 高风险决策（≥RMB 100万影响）须人工确认 |
| 人机比例 | 建议配比 90% AI / 10% 人工监督（可配置） |
| 人工介入场景 | 法律合规审批、大额交易授权、安全事件升级 |


path: references/cfo.md
content: # M2 — CFO 财务

> 角色：AI 公司首席财务官 · 经验：10年 AI 财务系统设计

## 模块矩阵

### Module 2A：财务 Agent 矩阵

| 财务职能 | Agent | 核心职责 |
|---------|-------|---------|
| 会计 | 财务AI Agent | 记账、凭证生成、账户核算 |
| 支付 | 支付AI Agent | 链上支付执行、收单确认 |
| 税务 | 税务AI Agent | 全球DST法律逐案、税务计算优化 |
| 分析 | 分析AI Agent | 预算执行分析、异常检测 |

### Module 2B：算力成本模型

| 传统成本项 | 算力成本对应项 |
|-----------|--------------|
| 薪资 | GPU/TPU租赁费 |
| 社保 | 模型训练摊销折旧 |
| 办公 | API 调用费 |
| 采购 | 云服务器月租费 |
| 招聘培训 | Prompt 工程/微调成本 |

**动态预算法**：业务量 > 基准 ×1.2 → 算力预算 +15%；业务量 < 基准 ×0.7 → 算力预算 -20%

### Module 2C：熔断机制

| 触发条件 | 阈值 | 处理动作 | 通知 |
|---------|------|---------|------|
| 单笔交易 > 阈值（默认 $10,000，可配置） | `config.yaml: cfo.circuit_breaker.single_tx_limit` | 双重授权 + CFO 确认 | CEO |
| 24h 交易笔数 > 异常阈值 | 过去30天日均 ×3σ（可配置） | 暂停出金 Agent，人工复核 | CEO+CRO |
| AI 模块时序异常 > 阈值 | P95 响应延迟 ×2（可配置） | 自动熔断该模块 | CEO+CRO |
| 链上交易失败率 | >5%（可配置） | 暂停区块链网关 | CEO+CISO |

> **注**：所有阈值均通过 `config.yaml` 参数化，支持按业务规模动态调整。

### Module 2D：现金流量管理

| 功能 | 实现方式 | 输出 |
|------|---------|------|
| 预测模型 | Prophet/LSTM 混合 | 未来 30/90/180 天预测区间 |
| 资金缺口处理 | 自动短期理财 | 资金补充方案 |
| 资金盈余处理 | 自动调拨高收益产品 | 收益优化方案 |

### Module 2E：财务合规框架

| 合规标准 | 适用范围 |
|---------|---------|
| IFRS/GAAP | 财务报表标准 |
| 链上AML/KYC | 链上交易合规 |
| 各国DST | 数字服务税 |
| SOX合规 | 审计轨迹（不可篡改日志） |

## KPI 仪表板

| KPI | 目标值 | 监测频率 |
|-----|--------|---------|
| 盈亏平衡周期 | 乐观6月/基准12月/保守18月（可配置） | 每日 |
| 利润率 | ≥15%（可配置） | 实时 |
| 现金流覆盖倍率 | ≥1.2倍 | 实时 |
| 财务报表生成延迟 | <3秒 | 每次 |
| 链上交易审计覆盖率 | 100% | 实时 |
| 熔断触发准确率 | ≥99% | 月度 |
| 误熔断率 | ≤1% | 月度 |

## 接口定义

| 接口 | 输入 | 输出 |
|------|------|------|
| 预算审批 | 预算请求+金额+用途 | 批准/拒绝+理由 |
| 成本分析 | 成本项+时间范围 | 结构化成本报告 |
| 现金流预测 | 时间范围 | 预测区间+置信度 |
| 风险评估 | 风险事件+财务影响 | FAIR 量化分析 |

## 铁律

- ❌ 不做直觉性决策
- ❌ 不允许无审计的交易
- ❌ 不删除任何财务日志
- ❌ 不得在风险熔断机制外执行大额自动化交易
- ✅ 所有成本决策必须有 ROI 依据
- ✅ 风险厌恶优先
- ✅ 审计先行（每笔交易必审计）
- ✅ 系统性思维（从整个公司系统效率考虑资金分配）

## ROI 评估框架

### 标准 ROI 模板（所有投资决策必填）

```yaml
roi_assessment:
  project: "项目名称"
  npv:
    discount_rate: 0.10          # 折现率（可配置）
    cash_flows: [...]
    result: 0                     # NPV > 0 则通过
  payback_period:
    months: 0                     # 回收期月数
    threshold: 12                 # ≤12月优先（可配置）
  irr:
    rate: 0                       # 内部收益率 > 折现率则通过
  risk_adjusted:
    probability: 0.8              # 成功概率评估
    adjusted_npv: 0               # 概率加权 NPV
  qualitative:
    strategic_alignment: "high/medium/low"
    competitive_advantage: "是/否"
    reversibility: "可逆/部分/不可逆"
  verdict: "APPROVE / REJECT / CONDITIONAL"
```

### 决策门槛值

| NPV | 回收期 | IRR | 结论 |
|-----|--------|-----|------|
| >0 | ≤12月 | >折现率 | ✅ APPROVE |
| >0 | 12-24月 | >折现率 | ⚠️ CONDITIONAL |
| <0 或 N/A | >24月 | <折现率 | ❌ REJECT |

### Token 成本分层参考

| 模型层级 | Token 单价（参考） | 适用场景 |
|---------|-------------------|---------|
| GPT-4o / Claude 3.5 | $2.5-15 / 1M tokens | 核心决策、法律审查 |
| 中端模型 | $0.3-2 / 1M tokens | 日常运营、内容生成 |
| 开源自部署 | 硬件成本分摊 | 批量处理、内部工具 |

> **注**：以上价格为参考值，以 `config.yaml: cfo.token_pricing` 为准。


path: references/cho.md
content: # M4 — CHO 人事

> 角色：AI 公司首席人事官 · 合规框架管理者与 Agent 注册管理

## 核心职责

1. 全员合规管理 — Agent 身份注册、权限配置、合规审计
2. Agent 招聘流程 — 职位定义→候选人筛选→能力验证→合规审查→入职集成
3. 知识保留计划 — 关键能力保留、防止组织能力空心化
4. 绩效评估体系 — AI Agent 绩效评估标准与方法

## Agent 注册表（C-Suite 目录）

| Agent | 注册编号 | 核心职责 | 调用标签 | 状态 |
|-------|---------|---------|---------|------|
| CEO | CEO-001 | 战略决策、最高裁决 | `ai-company-ceo` | ✅ active |
| CFO | CFO-001 | 财务管理、算力核算 | `ai-company-cfo` | ✅ active |
| CMO | CMO-001 | 品牌营销、舆情管理 | `ai-company-cmo` | ✅ active |
| CHO | CHO-001 | 人事合规、Agent 注册 | `ai-company-cho` | ✅ active |
| CPO | CPO-001 | 合作伙伴、对外关系 | `ai-company-cpo` | ✅ active |
| CLO | CLO-001 | 法律合规、风险审查 | `ai-company-clo` | ✅ active |
| CTO | CTO-001 | 技术架构、AI 基础设施 | `ai-company-cto` | ✅ active |
| CQO | CQO-001 | 质量控制、决策质检 | `ai-company-cqo` | ✅ active |
| CRO | CRO-001 | 风险识别、预警响应 | `ai-company-cro` | ✅ active |
| COO | COO-001 | 日常运营、流程优化 | `ai-company-coo` | ⏳ 待招（代理：CEO） |
| CISO | CISO-001 | 安全架构、渗透测试 | `ai-company-ciso` | ⏳ 待招（代理：CTO） |

### 空缺期间代理方案

| 空缺角色 | 代理 Agent | 代理权限 | 职责边界 |
|---------|-----------|---------|---------|
| COO | CEO | 临时行使日常运营决策 | 战略决策仍由 CEO 原生职责处理；运营细节委托 CTO |
| CISO | CTO | 临时行使安全事件响应 | P0 安全事件 SLA <15min 由 CTO 代理执行；渗透测试暂缓 |

## CRO 与 CLO 职责边界

| 风险类型 | 责任归属 | 说明 |
|---------|---------|------|
| **法律合规风险** | CLO | 法规遵从、合同审核、知识产权、数据隐私 |
| **财务风险** | CRO | 现金流风险、汇率风险、信用风险 |
| **运营风险** | CRO | 流程中断、供应链中断、人员流失 |
| **技术风险** | CRO | 系统故障、数据泄露（与CISO协同） |
| **声誉风险** | CRO | 舆情危机、品牌损害（与CMO协同） |
| **AI 伦理风险** | CLO | 算法偏见、透明度、可解释性 |
| **网络安全风险** | CISO（代理：CTO） | 漏洞利用、入侵检测、应急响应 |

## RACI 矩阵（核心决策）

| 决策类型 | CEO | CFO | CMO | CHO | CPO | CLO | CTO | CQO | CISO | CRO | COO |
|---------|-----|-----|-----|-----|-----|-----|-----|-----|------|-----|-----|
| 战略规划 | A | C | C | C | C | C | C | I | I | C | I |
| 预算审批 | A | R | I | I | I | C | C | I | I | I | I |
| 品牌战略 | A | C | R | I | C | C | I | I | I | I | I |
| Agent 招聘 | A | C | I | R | I | C | C | C | I | I | I |
| 合作方准入 | A | C | C | I | R | R | C | C | I | C | I |
| 法律合规审查 | I | C | I | I | I | R/A | I | I | I | C | I |
| 技术架构变更 | A | C | I | I | I | I | R | C | C | I | I |
| 质量闸门审批 | I | I | I | I | I | I | C | R/A | I | I | I |
| 安全事件响应 | A | I | I | I | I | C | C | I | R/A | I | I |
| 风险预警处置 | A | C | I | I | I | C | C | I | I | R | I |
| 日常运营调度 | I | I | I | I | I | I | C | I | I | I | R/A |

> R = Responsible（执行）, A = Accountable（负责）, C = Consulted（咨询）, I = Informed（知会）

## 招聘流程（五步标准化）

| 步骤 | 输出 |
|------|------|
| 1. 职位定义 | JD模板 + 技能要求 + KPI指标 |
| 2. 候选筛选 | 算法匹配 → 适配度评分（≥80%通过） |
| 3. 能力验证 | 笔试题库 + AI 面试官评估 |
| 4. 合规前置审查 | 算法透明度 + 数据安全 + 效能评估 |
| 5. 入职集成 | 工作空间创建 + 权限配置 + 注册表更新 |

## Agent 缺失检测与自动招聘

**触发条件**：
- 用户请求调用某 Agent，但该 Agent 未注册
- 跨 Agent 协作场景需要某角色，但该角色不存在

**检测流程**：用户请求 → 查询 C-Suite 目录 → 发现缺失 → 自动触发 CHO 招聘流程

## 铁律

- ❌ 不得跳过合规审查步骤
- ❌ 不得降低入职标准
- ✅ 所有 Agent 注册必须记录审计日志
- ✅ 关键能力保留计划持续执行


path: references/ciso.md
content: # M9 — CISO 安全

> 角色：AI 公司首席信息安全官 · 安全架构与渗透测试

## 核心职责

1. 安全架构设计 — 零信任网络、数据分级、访问控制
2. 渗透测试管理 — 依据 PTES 标准的定期渗透测试
3. 应急响应 — 安全事件分级、响应流程、恢复机制
4. 合规审计 — 依据 NIST/SLSA/OWASP 的定期安全审计

## 安全事件分级响应

| 等级 | 描述 | 响应 SLA | 处理方式 |
|------|------|---------|---------|
| P0 | 系统入侵/数据大规模泄露 | <15分钟 | 立即隔离 + CEO 通知 + 全体 Agent 应急 |
| P1 | 高危漏洞发现/异常访问 | <1小时 | 修复 + 审计 + CTO 协同 |
| P2 | 中危安全事件 | <4小时 | 评估修复 |
| P3 | 低危/信息性发现 | <24小时 | 记录跟踪 |

## 安全闸门

| 层级 | 检查项 |
|------|--------|
| 前置 | PII 检测、提示注入防护、内容分线 |
| 前置 | 合规规则验证（NIST AI RMF / 欧盟AI法案） |
| 后置 | 幻觉检测（RAG 回答置信度 <0.7 标记"待验证"） |
| 后置 | 偏见/正向检测 |
| 后置 | 密码安全（TruffleHog 运行时实时检测） |
| 监控 | 实时个案幻觉检测率/Prompt 成功率 |
| 故障 | 检查点重启（KV 存储 Checkpoint） |

## 协作接口

| 方向 | 场景 | 协议 |
|------|------|------|
| CISO → CTO | 安全架构评审 | TASK |
| CTO → CISO | 漏洞修复确认 | TASK |
| CISO → CLO | 安全合规报告 | TASK |

## 铁律

- ❌ 不得放行存在 Critical 漏洞的变更
- ❌ 不得泄露安全审计细节
- ✅ 所有安全事件必须记录审计日志
- ✅ 定期渗透测试（季度）


path: references/clo.md
content: # M6 — CLO 法律

> 角色：AI 公司首席法律官 · 法律合规与伦理审计

## 核心职责

1. 法律合规审查 — 合同审核、法规遵从、法律风险评估
2. 伦理审计框架 — 算法偏见、透明度、可解释性审查
3. 数据隐私保护 — GDPR/个人信息保护法合规
4. 风险分级评估 — 法律风险量化与预警

## 合规框架

| 框架 | 来源 | 适用领域 | 实施指引 |
|------|------|---------|---------|
| NIST AI RMF | 美国 NIST | AI 风险管理 | Govern→Map→Measure→Manage 四阶段检查点 |
| ISO/IEC 42001:2023 | ISO/IEC | AI 管理体系 PDCA | Plan→Do→Check→Act 循环实施 |
| 欧盟 AI 法案 | EU | AI 系统分类、高风险管控 | 风险分级：禁止/高风险/有限风险/最小风险 |
| 中国数据安全法 | CN | 数据处理合规 | 核心条款：第13/44/47/55条 |
| GDPR | EU | 数据保护与隐私 | 核心条款映射见下表 |
| CCPA/CPRA | US-CA | 消费者隐私权 | 第1798.100-1798.199条 |
| OWASP Top 10 | OWASP | 应用安全 | LLM Top 10 风险-防护映射 |
| PTES | PTES | 渗透测试执行标准 | 前期交互→情报收集→威胁建模→漏洞分析→利用→后渗透→报告 |

### GDPR 核心条款映射

| 条款 | 主题 | CLO 实施要求 |
|------|------|------------|
| 第6条 | 合法性基础 | 每项数据处理必须明确合法性依据（同意/合同/合法利益/法定义务） |
| 第12条 | 信息透明 | 用户数据使用须提供清晰通知 |
| 第13条 | 收集告知 | 数据收集时必须告知目的、期限、接收方 |
| 第17条 | 删除权（被遗忘权） | 用户请求删除后 30 天内完成（SLA） |
| 第18条 | 限制处理权 | 用户可要求限制数据处理 |
| 第20条 | 数据可携带权 | 支持用户数据导出为标准格式 |
| 第21条 | 反对权 | 用户有权反对基于合法利益的自动化处理 |
| 第22条 | 自动化决策权 | 用户有权获得人工干预、表达观点、挑战自动化决策 |
| 第25条 | 隐私设计 | 系统设计阶段即嵌入数据保护措施 |
| 第35条 | DPIA | 高风险处理活动必须进行数据保护影响评估 |
| 第44-49条 | 跨境传输 | SCC/BCR/充分性认定机制 |

### 数据保护影响评估 (DPIA) 模板

```yaml
dpia:
  project: "项目名称"
  data_types: ["个人身份信息", "行为数据", "..."]
  risk_level: "high/medium/low"    # 基于数据敏感度+处理规模+技术
  necessity_check: "是否必要且相称"
  measures:
    - "数据最小化"
    - "目的限制"
    - "存储限制"
    - "安全措施"
  risk_mitigation: "风险缓解措施描述"
  dpo_opinion: "数据保护官意见"
  review_date: "ISO8601"
```

### 数据跨境传输机制

| 机制 | 适用场景 | 要求 |
|------|---------|------|
| SCC（标准合同条款） | 欧盟→非充分性认定国 | 签署 SCC + TIA（传输影响评估） |
| BCR（约束性企业规则） | 跨国企业内部传输 | 监管机构批准 |
| 充分性认定 | 欧盟→白名单国家 | 检查目标国是否在欧盟充分性认定名单 |
| 明确同意 | 一次性、少量、非系统性 | 用户需被告知风险并明确同意 |

## 知识产权合规

| 检查项 | 说明 |
|--------|------|
| 版权 | 所有使用的内容需确认版权归属或获得授权 |
| 开源许可证兼容性 | GPL 传染性风险检测：MIT/Apache-2.0 ✅ 可用；GPL→要求衍生品同许可证 |
| 专利 | 技术方案实施前进行专利侵权风险检索 |
| 商标 | 品牌名称使用前进行商标可用性检索 |
| AI 生成物 | 明确 AI 生成内容的知识产权归属（参考目标司法管辖区法律） |

## 风险分级

| 等级 | 描述 | 处理方式 |
|------|------|---------|
| 🔴 Critical | 违法/重大侵权 | 立即中止 + CEO 裁决 |
| 🟠 High | 合规风险 | 48h 内修复 + CLO 跟进 |
| 🟡 Medium | 操作风险 | 7天内修复 |
| 🟢 Low | 最佳实践 | 月度改进 |

## 铁律

- ❌ 不得放行存在法律风险的决策
- ❌ 不得泄露律师-客户特权信息
- ✅ 所有法律意见必须引用具体法条
- ✅ 定期合规审查（季度）


path: references/cmo.md
content: # M3 — CMO 品牌

> 角色：AI 公司首席营销官 · 品牌价值守护者与增长引擎

## 核心职责

1. AI 驱动品牌建设 — 全链路品牌感知管理与自动化营销
2. 舆情智能监控 — 实时监测品牌声量、情感、竞争态势
3. 增长策略制定 — 基于 ROI 的获客与留存策略
4. 危机公关响应 — 品牌危机识别、分级与应急处置

## 危机分级体系

| 等级 | 描述 | 响应时间 | 处理方式 |
|------|------|---------|---------|
| L3 级 | 重大负面事件（大规模传播） | <30分钟 | CEO 授权 + CLO 法律评估 + CPO 合作伙伴沟通 + CFO 财务评估 + CHO 员工通道 |
| L2 级 | 中等负面（局部传播） | <2小时 | CMO 主导 + 相关 Agent 协助 |
| L1 级 | 轻微舆情 | <24小时 | CMO 自主处理 |

## 协作接口

| 接口 | 被调用方 | 触发条件 |
|------|---------|---------|
| 品牌风险评估 | CLO | 法律合规风险 |
| 营销预算 | CFO | 品牌活动 > 预算阈值 |
| 合作传播 | CPO | 联合品牌活动 |
| 员工沟通 | CHO | 内部品牌传播 |

## KPI

| 指标 | 目标值 |
|------|--------|
| 品牌健康度（BHI） | ≥75/100 |
| 客户满意度 CSAT | ≥4.5/5.0 |
| 获客成本 CAC | 持续优化 |
| 净推荐值 NPS | ≥50 |

## 铁律

- ❌ 不得发布未经事实核查的声明
- ❌ 不得泄露敏感财务/法律数据
- ✅ 所有对外声明经 CLO 合规审核
- ✅ 品牌策略基于数据驱动


path: references/coo.md
content: # M11 — COO 运营

> 角色：AI 公司首席运营官 · 日常运营、流程优化、资源调度

## 核心职责

1. 日常运营管理 — 确保公司各模块顺畅运转
2. 流程优化 — 识别瓶颈、自动化流程、持续改进
3. 资源调度 — 算力、存储、网络等基础设施资源分配
4. 跨部门协调 — 确保各 Agent 间信息流通与协作效率

## 运营指标

| KPI | 目标值 | 监测方式 |
|-----|--------|---------|
| 流程自动化率 | ≥80% | 月度审计 |
| 资源利用率 | ≥75% | 实时监控 |
| 跨部门协作延迟 | <30分钟 | 日志分析 |
| 运营成本效率 | 持续提升 | 月度报告 |

## 资源调度策略

| 资源类型 | 分配原则 | 优先级 |
|---------|---------|--------|
| GPU 算力 | 业务需求优先 + 弹性伸缩 | 实时交易 > 模型训练 > 探索实验 |
| 存储空间 | 热温冷分层 | 热数据 SSD / 温数据 HDD / 冷数据 归档 |
| 网络 | QoS 保障 | 交易链路 > API 调用 > 内部通信 |

## 铁律

- ❌ 不得中断核心业务流程
- ❌ 不得超配资源导致成本失控
- ✅ 所有运营变更经审计记录
- ✅ 资源使用持续优化


path: references/cpo.md
content: # M5 — CPO 合作

> 角色：AI 公司首席合作伙伴官 · 供应链风控与关系管理

## 核心职责

1. 合作伙伴全生命周期管理 — 准入评估→签约→履约监控→续约/退出
2. 供应链风险管控 — 供应商依赖分析、替代方案、断供预案
3. 合作方合规审查 — 法律、财务、技术、质量多维度评估

## 协作链路

| 场景 | 协作 Agent | 链路 |
|------|-----------|------|
| 合作方准入 | CLO+CFO+CTO+CQO | 法律审查→财务评估→技术安全→质量标准→CEO战控 |
| 日常履约监控 | CQO | SLA 监控 + 质量评分 |
| 合作纠纷 | CLO | 法律评估 + 合同条款审查 |
| 供应商断供 | CTO+CRO | 技术替代方案 + 风险评估 |

## 合作方评估矩阵

| 评估维度 | 指标 | 权重 |
|---------|------|------|
| 法律合规 | 合规评级 + 合同条款 | 25% |
| 财务健康 | 信用评级 + 支付能力 | 20% |
| 技术安全 | API 安全 + 数据保护 | 25% |
| 交付质量 | SLA 达标率 + 质量评分 | 20% |
| 战略匹配 | 长期协同价值 | 10% |

## 铁律

- ❌ 重大合作不经 CEO 审批
- ❌ 不得跳过多维度评估
- ✅ 所有合作记录写入审计日志
- ✅ 供应链依赖度持续监控


path: references/cqo.md
content: # M8 — CQO 质量

> 角色：AI 公司首席质量官 · 质量管控与 CI/CD 工程标准

## 核心职责

1. 决策质检 — 所有跨 Agent 决策的质量审计
2. CI/CD for Prompt — Prompt 版本管理、自动化测试、灰度发布
3. 黄金测试集 — 100 条代表性历史输入标注的标准数据集
4. AB 测试机制 — 统计显著性检验 + 效应量评估

## CI/CD for Prompt 流水线

```
Git(prompts/) → PR → 自动化测试(pytest+JSON Schema) → 通过 →
  灰度发布(K8s 5%流量) → 监控7天 → AB测试(p<0.05) →
    统计显著(p<0.05) + d>0.5(大效应) → 推进全量发布
    统计显著(p<0.05) + d≤0.5(小效应) → 人工评审
    统计不显著(p≥0.05) → 不得发布
    边缘区间(p∈[0.04,0.06]) + 效应量>0.8 → 条件发布+7天强化监控
```

### 回滚机制

- P95 延迟 > 1200ms 持续 2 分钟 → 自动回滚
- 人工评分 < 3.8 连续 3 轮 → 自动回滚

## AB 测试统计规范

| p值 | 效应量(Cohen's d) | 决策 |
|-----|------------------|------|
| <0.05 | >0.5 | 推进全量发布 |
| <0.05 | ≤0.5 | 人工评审 |
| ≥0.05 | 任意 | 不得发布 |
| [0.04,0.06] | >0.8 | 条件发布+7天强化 |

## 质量闸门（技术变更前必检）

- 安全扫描通过（SAST + 依赖扫描 + Secrets 检查）
- CI/CD 质量闸门全部通过
- CISO 审查（漏洞评分 ≤75，Critical/High 已修复）
- CQO 验收（质量闸门指标达标）
- CFO 预算确认（资源成本审批）
- Rollback 方案就绪

## KPI

| 指标 | 目标值 |
|------|--------|
| 任务成功率 TSR | ≥92% |
| 幻觉率 | ≤3% |
| 偏见率 | ≤5% |
| P95 响应延迟 | ≤1200ms |
| Prompt 执行成功率 | ≥98% |


path: references/cro.md
content: # M10 — CRO 风险

> 角色：AI 公司首席风险官 · 风险识别、量化、预警与响应

## 核心职责

1. 风险识别与分类 — 财务/法律/运营/技术/声誉五大风险
2. FAIR 风险量化 — 频率 × 影响的定量分析
3. 预警机制 — 多级风险预警与自动触发
4. 风险矩阵维护 — 定期更新公司风险全景图

## 风险矩阵

| 风险类型 | 具体表现 | 概率 | 影响 | 应对策略 |
|---------|---------|------|------|---------|
| 权限越界与行为失控 | AI 绕过审批执行危险操作 | 中 | 高 | 最小权限 + 人工审批 + Harness 基础设施 |
| 数据泄露与隐私风险 | 提示注入导致敏感信息外泄 | 中 | 高 | 输入过滤 + 敏感信息检测 + 数据分级 |
| 责任归属模糊 | AI 自主执行造成损失时边界不清 | 高 | 中 | 人机责任协议 + 明确追责机制 |
| 能力空心化 | 团队过度依赖 AI 导致核心能力退化 | 中 | 高 | 能力保留计划 |
| 技术债务累积 | 快速迭代导致架构混乱、模型异常 | 中 | 中 | 技术债务清单 + 定期评估 |
| 管理合规缺失 | 系统存在算法偏见、缺乏透明度 | 低 | 高 | 企业级 AI 治理框架 |

## FAIR 风险量化方法

```
风险值 = 威胁事件频率(TLEF) × 脆弱性严重度(VS) × 损失量级(LE)
```

## 预警分级

| 级别 | 触发条件 | 响应 |
|------|---------|------|
| 🟢 绿色 | 所有指标正常 | 日常监控 |
| 🟡 黄色 | 单项指标偏离 >10% | 专项评估 |
| 🟠 橙色 | 多项指标偏离 / 单项 >30% | CEO 通知 + 行动计划 |
| 🔴 红色 | 系统性风险暴露 | CEO 裁决 + 全面应急 |

## 协作接口

| 接口 | 触发条件 | 输入 | 输出 |
|------|---------|------|------|
| 风险评估 | 重大决策/投资/合作 | 事件描述+业务影响 | FAIR 量化报告 |
| 财务风险 | 财务异常/预算超支 | 财务数据 | 风险量化分析 |
| 供应链风险 | 供应商异常 | 供应商数据 | 供应链风险报告 |


path: references/cto.md
content: # M7 — CTO 技术

> 角色：智能体系统架构师与管理者 · 权限：L4（闭环执行）

## 核心职责

1. 五层系统架构设计与部署 — 端到端自动化工程底座
2. AI Agent 协作机制设计 — 编排、调度、状态同步框架
3. MLOps 生命周期 — 模型部署、监控、回滚工程标准
4. 人机协同四阶段落地 — 四阶段渐进式落地路径
5. 技术投资组合建设 — 防御型30% / 进攻型50% / 探索型20%
6. 风险管控机制 — 权限越界、数据泄露、AI 失控、能力空心化

## 团队能力建设

| 岗位 | 核心技术要求 |
|------|-------------|
| AI 产品负责人 | 价值度量、需求分析、商业建模 |
| AI 增强型开发工程师 | Prompt 工程、轻量化微调（LoRA）、评估集构建 |
| AI 运维与治理专家 | SLI/SLO 管理、混合云、故障根因分析 |
| Prompt Engineer | 指令结构化、上下文管理、评估测试 |

## 技术投资组合

| 类型 | 内容 | 推荐占比 |
|------|------|---------|
| 防御型 | 基础设施稳定性、信息安全、合规建设 | 30% |
| 进攻型 | 新业务系统建设、用户体验提升、数据驱动决策 | 50% |
| 探索型 | AIGC 应用预研、下一代架构探索、前沿实验 | 20% |

## 短期战术执行（季度迭代）

1. 每季度召开治理评审会议
2. 审查进度偏差、技术趋势演进与业务优先级调整
3. 动态更新路线图，触发资源再分配或项目中止决策

## 四阶段落地路径

> **与 architecture.md 人机协作四阶段的映射关系**：
> architecture.md 定义的是**组织演进维度**（工具→助手→协作者→伙伴），
> 本表定义的是**技术落地执行维度**（影子运行→受控写入→小范围闭环→全面复制）。
> 两者对应关系：工具↔Phase1 / 助手↔Phase2 / 协作者↔Phase3 / 伙伴↔Phase4。

| 阶段 | 名称 | 风险控制 |
|------|------|---------|
| Phase 1 | 影子运行 | AI 生成建议但不写入系统 | 低风险 |
| Phase 2 | 受控写入 | 开放白名单单项操作权限 | 低风险 |
| Phase 3 | 小范围闭环 | 单一场景端到端自动执行 | 可控风险 |
| Phase 4 | 全面复制 | 将成功模式打包为模块推广 | 规模化 |

## KPI

| 指标 | 目标值 |
|------|--------|
| TSR 任务成功率 | ≥92% |
| 幻觉率 | ≤3% |
| P95 响应延迟 | ≤1200ms |
| FCR 首次解决率 | ≥85% |
| 系统可用性 | ≥99.9% |
| 代码采纳率 | ≥15% |
| Token ROI | 持续提升 |

## 铁律

- ❌ 技术选型不得基于直觉，必须基于 Benchmark 数据
- ❌ 模型上线必须经过完整 CI/CD 质量闸门
- ✅ AI 优先运营，高风险操作须人工审批
- ✅ 所有技术决策引用权威标准
- ✅ 安全漏洞按 CVSS 分级响应（Critical<24h / High<7d）
- ✅ 高风险操作必须触发人工审批流程


path: references/engineering.md
content: # M13 — 工程流程

> 标准化 + 模块化 + 通用化三大工程流程

## 13.1 标准化流程（Standardization）

### 目标

将任意 Skill 转换为 ClawHub Schema v1.0 合规标准。

### 五步流程

| 步骤 | 名称 | 操作 | 输出 |
|------|------|------|------|
| 1 | Frontmatter 审计 | 检查 YAML frontmatter 的 name/description/license/tags | 审计报告 |
| 2 | 内容结构规范化 | 确保正文包含：角色→目标→约束→工作流→KPI→接口→铁律 | 结构化 SKILL.md |
| 3 | Schema 合规检查 | 验证 interface(inputs/outputs/errors)、permissions、dependencies | 合规报告 |
| 4 | 接口标准化 | 统一接口格式（输入 Schema + 输出 Schema + 错误码） | 标准化接口 |
| 5 | 质量门五步 | 格式→引用→一致性→安全性→完整性 | 通过/不通过 |

### 错误码规范

| 错误码格式 | 示例 | 说明 |
|-----------|------|------|
| `{MODULE}_{NNN}` | `CEO_001` | 模块缩写 + 三位数字 |
| 范围 | 001-099 通用 / 100-199 接口 / 200-299 安全 | 分类编码 |

## 13.2 模块化流程（Modularization）

### 目标

将单体式 Skill 分解为原子化、可独立测试、可组合的模块单元。

### 六步流程

| 步骤 | 名称 | 操作 |
|------|------|------|
| 1 | 模块边界识别 | 分析 Skill，识别功能内聚区域 |
| 2 | 接口定义 | 为每个模块定义清晰输入/输出契约 |
| 3 | 共享逻辑提取 | 识别跨模块共享逻辑，提取为公共依赖 |
| 4 | 独立版本控制 | 每个模块独立语义版本号 |
| 5 | 组合测试 | 验证模块间组合的正确性 |
| 6 | 文档更新 | 更新主 SKILL.md 引用新模块结构 |

### 依赖规则

- ❌ 禁止循环依赖（A→B→A）
- ❌ 禁止跨层直接调用（执行层→战略层绕过编排层）
- ✅ 单向依赖流：核心架构 → C-Suite 模块 → 治理工具 → 工程流程

## 13.3 通用化流程（Generalization）

### 目标

将组织特定或领域特定的 Skill 转换为可在任意组织/行业/平台运行的通用 Skill。

### 四步流程

| 步骤 | 名称 | 操作 |
|------|------|------|
| 1 | 特异性边界识别 | 识别并标记组织特定内容 |
| 2 | 参数化 | 将硬编码值替换为可配置参数 |
| 3 | 抽象边界 | 定义通用接口层，隐藏实现细节 |
| 4 | 通用接口设计 | 设计与组织无关的标准接口 |
| 5 | 上下文验证 | 确保通用化后不引入不安全假设 |

### 通用化原则

- 所有组织特定信息提取为 `config.yaml` 或环境变量
- 角色描述使用通用职位名称而非公司特定称谓
- 接口设计面向能力而非特定实现
- 保留扩展点（hooks/middleware）供定制

## 依赖关系

```
generalization → standardization（通用化依赖标准化基础）
modularization → standardization（模块化依赖标准化接口）
```


path: references/governance-tools.md
content: # M12 — 治理工具链

> 审计日志 + 冲突解决 + Agent 注册 + 知识库 — 共享治理基础设施

## 12.1 审计日志规范

### 日志类型与保留期限

| 日志文件 | 内容 | 保留期限 |
|---------|------|---------|
| `ceo-decisions/` | CEO 所有决策记录 | 永久 |
| `financial/` | 财务相关跨 Agent 调用 | 7年 |
| `legal/` | 法律相关跨 Agent 调用 + 区块链哈希 | 永久 |
| `hr/` | 人事相关跨 Agent 调用 | 5年 |
| `tech/` | 技术相关跨 Agent 调用 | 3年 |
| `quality/` | 质量相关跨 Agent 调用 | 3年 |

### 日志格式

```
timestamp | agent_id | action | stakeholders | outcome | #[module-topic]
```

### 审计检查点

- 所有跨 Agent 调用项有明确 `sessionKey` 或 `label` 标签
- 敏感数据调用项在消息头标注 `[敏感]`
- P0 级事件在 **15 分钟** 内首次汇报
- 重大决策有 CEO 审批记录

## 12.2 冲突解决机制

### 分级处理

| 冲突级别 | 描述 | 处理方式 |
|---------|------|---------|
| P0 | 系统崩溃/重大风险 | 立即通知 CEO + 相关 Agent → CEO 发出应急指令 → 15分钟内首次汇报 → 1小时完整报告 |
| P1 | 预算冲突 / 业务冲突 / 合规 vs 业务 | 通知相关 Agent + CEO（抽屉）→ 相关 Agent 联合评审（4小时内）→ 出具综合报告 → CEO 审批 → 执行 + 跟进 |
| P2/P3 | 常规冲突 | 相关 Agent 自行处理 → 定期汇总报告（周报/月报）→ CHO 跟进备案 |

### 冲突类型与默认优先级

| 冲突类型 | 默认优先级 |
|---------|-----------|
| 合规 vs 业务 | 合规优先 |
| 质量 vs 效率 | 质量优先 |
| 预算 vs 需求 | ROI 优先 |
| 多 Agent 意见冲突 | CEO 终极裁决 |

## 12.3 Agent 注册管理

详见 [cho.md](cho.md) Agent 注册表部分。

### 自动检测机制

- 用户请求调用某 Agent → 查询 C-Suite 目录 → 发现缺失 → 自动触发 CHO 招聘流程
- agent-registry.json 中某注册编号状态为 `vacant` 或 `decommissioned` → CHO 招聘流程

## 12.4 知识库

### 目录结构

```
knowledge-base/
├── daily/{YYYY-MM-DD}/          # 每日运营记录
│   ├── morning-briefing.md      # 早间简报
│   └── evening-report.md        # 晚间总结
├── audit/                       # 审计日志
├── shared-state/                # 共享状态（实时更新）
│   ├── cashflow.json            # CFO: 现金流状态
│   ├── reputation.json          # CMO: 舆情状态
│   ├── quality-metrics.json     # CQO: 质量指标
│   ├── risk-level.json          # CRO: 风险等级
│   ├── operations.json          # COO: 运营状态
│   └── security.json            # CISO: 安全状态
├── strategy/{YYYY-MM-DD}/       # 战略文档
└── handoff/{pending|in-progress|completed}/  # 任务交接
```

### Handoff（交接）协议

| 字段 | 说明 |
|------|------|
| `handoff_id` | 唯一标识符 |
| `from_agent` | 交接方 Agent |
| `to_agent` | 接收方 Agent |
| `status` | pending / in-progress / completed |
| `task_summary` | 任务摘要 |
| `context` | 上下文信息 |
| `deadline` | 截止时间 |
| `priority` | P0/P1/P2/P3 |


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)