# token_efficiency_governance - Design Spec

> Human-readable design narrative — rationale, audience, style, color choices, content outline. Machine-readable execution contract: `spec_lock.md`.

## I. Project Information

| Item | Value |
| ---- | ----- |
| **Project Name** | token_efficiency_governance |
| **Canvas Format** | PPT 16:9 (1280×720) |
| **Page Count** | 12 |
| **Design Style** | Top Consulting + 企业级 AI 治理咨询风 |
| **Target Audience** | 公司管理层、AI 工具治理负责人、研发/运营团队负责人 |
| **Use Case** | 内部汇报、治理方案评审、推进会 |
| **Created Date** | 2026-06-10 |

---

## II. Canvas Specification

| Property | Value |
| -------- | ----- |
| **Format** | PPT 16:9 |
| **Dimensions** | 1280×720 |
| **viewBox** | `0 0 1280 720` |
| **Margins** | left/right 40px, top 42px, bottom 30px |
| **Content Area** | x=40, y=130, w=1200, h=535 |

---

## III. Visual Theme

### Theme Style

- **Style**: Top Consulting + 企业级 AI 治理咨询风
- **Theme**: Light theme
- **Tone**: 克制、决策导向、数字治理、企业级科技感

### Color Scheme

| Role | HEX | Purpose |
| ---- | --- | ------- |
| **Background** | `#FFFFFF` | Page background |
| **Secondary bg** | `#F4F7FB` | Card background, section background |
| **Muted bg** | `#EAF1F8` | Tinted panels and bands |
| **Primary** | `#0B2E4A` | Titles, top bars, strategic emphasis |
| **Accent** | `#1E88E5` | Data highlights, selected route, key arrows |
| **Secondary accent** | `#2E7D32` | Efficiency, healthy usage, positive states |
| **Warning** | `#F57C00` | Budget alerts, misuse warnings |
| **Danger** | `#C62828` | Risk and leakage markers |
| **Light blue** | `#E8F2FE` | Accent background tint |
| **Light green** | `#EAF6EC` | Positive background tint |
| **Light orange** | `#FFF3E0` | Warning background tint |
| **Dark bg** | `#081F33` | Cover and closing hero blocks |
| **Body text** | `#1F2933` | Main body text |
| **Secondary text** | `#5B677A` | Captions and annotations |
| **Tertiary text** | `#8A94A6` | Footer and page numbers |
| **Border/divider** | `#D9E2EC` | Card borders and dividers |

---

## IV. Typography System

### Font Plan

**Typography direction**: CJK-primary modern business sans, conclusion-first consulting tone.

| Role | Chinese | English | Fallback tail |
| ---- | ------- | ------- | ------------- |
| **Title** | `Microsoft YaHei` | `Arial` | `sans-serif` |
| **Body** | `Microsoft YaHei` | `Arial` | `sans-serif` |
| **Emphasis** | `Microsoft YaHei` | `Arial` | `sans-serif` |
| **Code** | — | `Consolas`, `Courier New` | `monospace` |

**Per-role font stacks**:

- Title: `"Microsoft YaHei", Arial, sans-serif`
- Body: `"Microsoft YaHei", Arial, sans-serif`
- Emphasis: `"Microsoft YaHei", Arial, sans-serif`
- Code: `Consolas, "Courier New", monospace`

### Font Size Hierarchy

**Baseline**: Body font size = 18px.

| Purpose | Current Project | Weight |
| ------- | --------------- | ------ |
| Cover title | 60px | Bold |
| Section opener | 40px | Bold |
| Page title | 32px | Bold |
| Hero number | 36px | Bold |
| Subtitle | 24px | SemiBold |
| Body content | 18px | Regular |
| Annotation / caption | 13–14px | Regular |
| Footer | 13px | Regular |

Formula rendering policy: `text-only`. The source contains no formula-worthy expressions.

---

## V. Layout Principles

### Page Structure

- **Header area**: 0–120px. 6px gradient top rule, assertion title at y=50, takeaway strip at y=78–118 for most content pages.
- **Content area**: 130–665px. Alternates between cards, roadmaps, matrices, decision trees and dashboard wireframes.
- **Footer area**: 680–705px. Source note, confidential marker, page number.

### Layout Pattern Library

- Cover and closing: negative-space-driven hero page with dark block and geometric accent.
- Executive and principles pages: 2×2 cards and pyramid logic.
- Dashboard and risk pages: dense tables/wireframes with one high-level takeaway.
- Routing and roadmap pages: left-to-right flow with clear decision gates.
- ClawPro page: hub-and-spoke ecosystem around a central platform.

### Spacing Specification

| Element | Current Project |
| ------- | --------------- |
| Safe margin from canvas edge | 40px |
| Content block gap | 24–32px |
| Icon-text gap | 10–14px |
| Card gap | 20–28px |
| Card padding | 22–28px |
| Card border radius | 12px |

---

## VI. Icon Usage Specification

### Source

- **Built-in icon library**: `phosphor-duotone`
- **Usage method**: SVG placeholder `<use data-icon="phosphor-duotone/icon-name" .../>`
- **Rule**: One stylistic icon library throughout; no brand icons.

### Recommended Icon List

| Purpose | Icon Path | Page |
| ------- | --------- | ---- |
| 治理目标 | `phosphor-duotone/target` | P02 |
| 报表和看板 | `phosphor-duotone/chart-bar` | P04–P05 |
| 成本健康度 | `phosphor-duotone/gauge` | P05 |
| 安全治理 | `phosphor-duotone/shield-check` | P11 |
| 风险预警 | `phosphor-duotone/warning` | P11 |
| Agent / AI | `phosphor-duotone/robot` | P06–P07 |
| 团队协作 | `phosphor-duotone/users-three` | P08 |
| 知识资产 | `phosphor-duotone/database` | P08–P09 |
| 组织共识 | `phosphor-duotone/brain` | P08 |
| 工程化机制 | `phosphor-duotone/gear-six` | P07 |
| Chatbot 分流 | `phosphor-duotone/chat-circle-text` | P06 |
| 流程路由 | `phosphor-duotone/flow-arrow` | P06 |
| 任务筛选 | `phosphor-duotone/funnel-simple` | P06 |
| 汇报场景 | `phosphor-duotone/presentation-chart` | P01 |
| 预算成本 | `phosphor-duotone/coins` | P04 |
| 激励奖项 | `phosphor-duotone/trophy` | P04/P12 |
| 清单执行 | `phosphor-duotone/list-checks` | P12 |
| 增长提效 | `phosphor-duotone/trend-up` | P12 |
| 完成确认 | `phosphor-duotone/check-circle` | P12 |

---

## VII. Visualization Reference List

No chart-library template is locked. All visualizations are hand-drawn native SVG consulting infographics: governance flywheel, dashboard wireframe, decision tree, roadmap, hub-and-spoke platform diagram, and risk-control matrix.

---

## VIII. Image Resource List

No external image assets. No AI-generated images. No formula PNGs.

---

## IX. Content Outline

### Part 1: Situation and strategic answer

#### Slide 01 - 封面

- **Layout**: Dark hero panel + white title + governance keywords.
- **Title**: AI Token 提效治理方案
- **Subtitle**: 从不可控成本到可预算、可度量、可优化的生产资源
- **Info**: Powellli · 2026-06-10

#### Slide 02 - 背景与目标

- **Layout**: Left problem statement + right four objective cards.
- **Title**: AI 使用规模化后，token 需要从“消耗项”变成“生产资源”
- **Core message**: 目标不是限制 AI，而是让 token 与业务产出之间建立可解释、可优化的关系。
- **Visualization**: Four-objective card grid.
- **Content**:
  - 当前按量付费模式下，研发、文档、客户方案、测试和运营都在消耗 token，成本可控性与产出可见性成为管理问题。
  - 成本可控 · 效率最大化 · 组织可复用 · 文化建设

#### Slide 03 - 治理原则

- **Layout**: Pyramid header + six principle blocks.
- **Title**: 治理原则必须同时约束成本、保障效率，并避免压制创新
- **Core message**: 以业务价值为核心，用可视化和分层管理代替一刀切限制。
- **Visualization**: Principle pyramid and supporting blocks.
- **Content**:
  - 业务价值驱动是顶层准则，token 使用不是目标，业务产出才是关键。
  - 可视化、分层管理、渐进推进、分工分层使用、国产优先与国外兜底共同构成治理边界。

### Part 2: Short-term governance

#### Slide 04 - 短期治理措施

- **Layout**: 0–2 month action stack, grouped by control, visibility, routing and culture.
- **Title**: 短期先建立可见性和轻约束，让组织快速形成成本意识
- **Core message**: 前 2 个月的重点不是复杂系统，而是让用量、异常、申请、激励四件事先跑起来。
- **Visualization**: Four-lane operating model.
- **Content**:
  - 个人额度与超额申请：系统自动生成会话数、平均 token、Top 高成本会话、模型占比和项目归因。
  - 报表 MVP 与管理看板：覆盖个人视图、团队视图、项目归因、异常提醒和预算预警。
  - Chatbot 分流、国产优先、专项奖项与日志能力构成短期治理闭环。

#### Slide 05 - 管理分析看板

- **Layout**: Dashboard wireframe with six management modules.
- **Title**: 管理看板的价值是做决策、看节奏、抓异常，而不是制造个人排名
- **Core message**: 管理者需要看到趋势、结构、异常和候选样板，避免把指标误用成绩效工具。
- **Visualization**: Executive dashboard mockup.
- **Content**:
  - 总览层：团队 token 趋势、人均消耗、活跃用户占比、Chatbot vs Agent 占比、国产/国外模型占比。
  - 诊断层：额度申请分析、高成本会话排行、模型选择健康度、预算预警。
  - 文化层：专项奖项候选池自动发现低单位 token 成本、高复用 Prompt 和跨团队分享案例。

#### Slide 06 - 工具与模型分层

- **Layout**: Decision tree from demand type to tool/model path.
- **Title**: 默认路径应是“先 Chatbot，后工具；工具默认国产，复杂规划用国外”
- **Core message**: 明确边界能把高成本 Agent 资源集中到真正需要持久上下文、沉淀产出物和复杂规划的任务上。
- **Visualization**: Tool routing decision tree.
- **Content**:
  - 一次性问答、文案润色、PPT 文案、流程梳理和知识查询默认走免费或低成本 Chatbot。
  - 需要持久上下文、沉淀产出物、批量处理或敏感数据时，进入 ClawPro、Batch 或内网私有通道。
  - 高度复杂规划性任务才申请国外高价模型与专项预算。

### Part 3: Mid-term systemization

#### Slide 07 - 中期治理体系

- **Layout**: Three-layer capability architecture.
- **Title**: 中期治理从“看见成本”升级为“工具干预 + Harness 工程化”
- **Core message**: 2–6 个月内应把提效能力嵌入任务前置、执行过程和复盘沉淀。
- **Visualization**: Capability architecture with tool, task and harness layers.
- **Content**:
  - 工具支持：Prompt 前置助手、Batch 提交工具、Token Review 工具。
  - 任务体系：建立 8–12 个任务类型，使模型建议、Prompt 检查和指标统计具备可比性。
  - Harness 工程化：Subagent、上下文选择器、状态压缩、预算熔断、规格化任务和测试闭环。

#### Slide 08 - ClawPro协作中枢

- **Layout**: Hub-and-spoke ecosystem centered on ClawPro.
- **Title**: ClawPro 是从个人提效走向团队协作与知识共识的中枢
- **Core message**: 真正的 token 节省来自共享上下文、共享资产和统一路由，而不是每个人重复加载同一套背景。
- **Visualization**: Platform hub and six governance spokes.
- **Content**:
  - 会话、Prompt、Skill、Subagent 配置统一归档，形成团队共享资产。
  - 多人协同共享上下文、共享记忆和共享任务清单，降低重复加载成本。
  - 权限归因、模型路由、知识共识和专项 KPI 让平台成为持续治理抓手。

### Part 4: Long-term operating model

#### Slide 09 - 长期治理蓝图

- **Layout**: Operating model map across project, assets, vendors and culture.
- **Title**: 长期目标是把 token 管理嵌入项目责任制和组织能力资产
- **Core message**: 6–18 个月后，治理对象不再是单次调用，而是项目额度、知识资产、模型供应链和 AI 原生文化。
- **Visualization**: Four-pillar operating model.
- **Content**:
  - 双额度体系与项目 AI Token Owner 明确项目级责任。
  - Prompt、流程、Batch、测试脚本、知识库、领域 Agent 和模型路由策略沉淀为组织资产。
  - 国产模型为主、国外高价值兜底的供应链结构长期化。

#### Slide 10 - 阶段推进路线

- **Layout**: 0–2 / 2–6 / 6–18 month roadmap.
- **Title**: 三阶段路线应先让治理可见，再让流程标准化，最后沉淀组织能力
- **Core message**: 路线节奏要避免一步到位的重系统建设，先轻量启动，再工程化深化，最终形成项目责任制。
- **Visualization**: Horizontal roadmap with milestones.
- **Content**:
  - 短期：AI Gateway 日志、个人额度、报表 MVP、管理分析看板、模型规范和专项奖项启动。
  - 中期：Prompt Coach、Batch、Token Review、任务类型体系、Harness 工程化、ClawPro 协作和 Chatbot 挑战。
  - 长期：项目额度、Token Owner、知识库、模板库、领域 Agent、供应商治理和年度化提效文化。

#### Slide 11 - 关键风险对策

- **Layout**: Risk-control matrix.
- **Title**: 治理成功的关键，是把“控成本”设计成低摩擦的协助机制
- **Core message**: 风险不只来自成本，也来自员工抵触、数据安全、指标误用和工具边界不清。
- **Visualization**: Six-row risk-control matrix.
- **Content**:
  - 员工负担：自动生成报表、简化申请材料、轻量审批。
  - 高价模型滥用与 Agent 失控：模型建议、预算告警、熔断机制和异常告警。
  - 数据安全与指标滥用：脱敏、内网私有模型、敏感项目隔离，只看趋势与项目归因。

#### Slide 12 - 总结行动建议

- **Layout**: Closing hero statement + first 30 days action list.
- **Title**: Token 提效治理的本质，是把 AI 能力变成可复用的组织生产力
- **Core message**: 通过短中长期分层推进，公司可以把 token 从不可控成本转化为可预算、可度量、可优化的生产资源。
- **Visualization**: Three-action closing plan.
- **Content**:
  - 先建报表和看板，形成可见性。
  - 再用工具和 Harness 机制降低无效消耗。
  - 最后以 ClawPro、项目责任制和文化激励沉淀组织能力。

---

## X. Speaker Notes Requirements

One speaker note file per page, saved to `notes/`. The integrated file is `notes/total.md` and will be split by `total_md_split.py`. Tone: conclusion-first, executive-facing, concise Chinese spoken prose.

---

## XI. Technical Constraints Reminder

1. viewBox: `0 0 1280 720`.
2. Background uses `<rect>` elements.
3. Text wrapping uses `<tspan>`; `<foreignObject>` is forbidden.
4. Transparency uses `fill-opacity` / `stroke-opacity`; `rgba()` is forbidden.
5. Forbidden: `mask`, `<style>`, `class`, `foreignObject`, `textPath`, animation, script, iframe.
6. HTML named entities are forbidden; XML reserved characters must be escaped.
7. Icon placeholders must use `phosphor-duotone` only.