decision-toolkit

决策工具包

概述

创建结构化的决策支持材料，帮助人们系统地思考重大选择。这项技能产出的是交互式工具，而不仅仅是分析，旨在赋能决策者，而不是替他们做决定。

理念

原则

1. 引导，而非决策 — 工具帮助厘清决策空间；由人来选择
2. 一次处理一件事 — 通过渐进式呈现降低认知负担
3. 多种视角 — 用不同框架审视同一项决策，有助于发现盲点
4. 让偏见显而易见 — 明确指出认知偏差，并使其可供检查
5. 输出可执行 — 以具体的后续步骤收尾，而非抽象结论

无障碍优先

• 支持屏幕阅读器（语义化 HTML、ARIA 标签）
• 支持键盘导航（Tab 顺序、焦点状态）
• 默认提供高对比度（至少符合 WCAG AA）
• 提供减少动态效果的选项
• 无需 JavaScript 也能使用（优雅降级）
• 适配移动设备的触控目标（至少 44px）

认知包容性

不同的人处理决策的方式各不相同：

风格	适配方式
分析型	数字、矩阵、加权评分
直觉型	直觉检查提示、“感觉如何？”
视觉型	图表、进度条、颜色编码
言语型	书面摘要、问题提示
循序型	逐步向导流程
全局型	提供仪表板概览选项

适用场景

在用户面临以下情况时调用此技能：

• 合作／伙伴关系决策
• 职业或工作变动
• 投入大量时间／金钱
• 项目优先级排序
• 技术／工具选择
• 任何涉及多个因素且存在不确定性的选择

不适用于：琐碎决策、紧急情况，或用户只需要信息的情形。

决策类型

类型 1：机会评估

我应该把握这个机会吗？

• 合作关系、工作邀请、投资、项目

类型 2：资源分配

我应该把时间／金钱／精力投入到哪里？

• 优先级排序、预算编制、重点领域

类型 3：风险评估

可能出什么问题，是否值得一试？

• 新业务、变更、实验

类型 4：权衡取舍

如何从多个备选方案中做出选择？

• 工具选择、招聘决策、战略选择

决策历程

九个步骤，每个步骤聚焦于一个维度：

┌─────────────────────────────────────────────────────────────┐
│  1. CONTEXT         What is the decision?                   │
│  2. FIRST PRINCIPLES Does this solve a real problem?        │
│  3. TIMING          Is now the right moment?                │
│  4. STAKEHOLDERS    Who else is involved? Are they stable?  │
│  5. BIASES          What might cloud my judgment?           │
│  6. OPPORTUNITY COST What am I giving up?                   │
│  7. SCENARIOS       What could happen?                      │
│  8. QUESTIONS       What do I still need to learn?          │
│  9. SYNTHESIS       Summary + decision                      │
└─────────────────────────────────────────────────────────────┘

输出格式

1. 交互式 HTML 指南（首选）

逐步引导向导，包含：

• 进度指示器
• 每个屏幕仅显示一个问题
• 在各步骤间保留状态
• 汇总所有输入的最终摘要
• 键盘导航
• 适合打印的 CSS

2. Markdown 框架

适用于离线／纯文本场景：

• 结构化提示
• 复选框式偏见审查
• 填空模板

3. 语音摘要

适用于音频收听：

• 5-7 段执行摘要
• 用于呈现情感层次的 Orpheus TTS 标记
• 关键决策及其理由

4. PDF 报告

适用于记录／分享：

• 专业排版
• 应用所有框架
• 附录包含原始分析

框架参考

第一性原理测试

1. What problem does this solve?
2. Can I solve it myself?
3. Is this the best solution?
4. What assumptions am I making?
5. If starting fresh today, would I choose this?

偏见检查清单

□ FOMO — Am I afraid of missing out?
□ Sunk Cost — Am I factoring past investment?
□ Authority — Am I deferring to credentials?
□ Social Proof — Am I following the crowd?
□ Commitment — Do I feel locked in by past statements?
□ Optimism — Am I assuming problems will resolve?
□ Recency — Am I overweighting recent events?
□ Confirmation — Am I seeking validating info only?
□ Shiny Object — Is novelty distracting me?
□ Loss Aversion — Am I overweighting potential losses?

机会成本计算器

Hours/week × Weeks × Hourly rate = Direct cost
+ What else could those hours produce?
+ What relationships/opportunities might suffer?
= True opportunity cost

情景矩阵

| Scenario | Probability | Outcome | Expected Value |
|----------|-------------|---------|----------------|
| Worst    | X%          | ...     | ...            |
| Bad      | X%          | ...     | ...            |
| Neutral  | X%          | ...     | ...            |
| Good     | X%          | ...     | ...            |
| Best     | X%          | ...     | ...            |

事前验尸分析

Imagine it's [future date]. This decision failed. Why?

Possible causes:
1. ...
2. ...
3. ...

Which causes are within my control?
Which warning signs should I watch for?

10-10-10 框架

How will I feel about this decision in:
- 10 minutes?
- 10 months?
- 10 years?

遗憾最小化

Imagine you're 80 looking back.
Would you regret doing this?
Would you regret NOT doing this?

实施指南

步骤 1：收集背景信息

向用户询问：

• 要做出什么决策？
• 有哪些选项？
• 时间安排是怎样的？
• 有什么利害关系？
• 是否有相关背景信息？

也可以从现有文档中提取信息（会议记录、笔记）。

步骤 2：选择输出格式

根据用户偏好和具体情况选择：

• 复杂决策且时间充裕 → 交互式 HTML
• 快速分析 → Markdown 框架
• 随时随地收听 → 语音摘要
• 需要与他人分享 → PDF 报告

步骤 3：生成工具

使用 templates/ 目录中的模板：

• decision-guide-template.html — 完整的交互式向导
• decision-framework.md — 基于文本的分析
• decision-voice-summary.md — 音频脚本模板

步骤 4：自定义

替换占位符：

• {{DECISION_TITLE}} — 要做出的决定
• {{CONTEXT}} — 背景信息
• {{OPTIONS}} — 可选方案
• {{STAKEHOLDERS}} — 涉及的人员／团队
• {{TIMELINE}} — 相关日期
• {{FACTORS}} — 关键评估标准

步骤 5：应用品牌风格（可选）

如果使用 Agency 品牌：

• 导入 brand-agency 技能的 CSS 变量
• 使用新粗野主义风格
• 应用 Geist/EB Garamond 字体排版

无障碍实现

语义化 HTML

<main role="main" aria-label="Decision Guide">
  <nav aria-label="Progress">
    <ol role="list">...</ol>
  </nav>
  <section aria-labelledby="step-title">
    <h1 id="step-title">...</h1>
  </section>
</main>

键盘导航

// Ensure all interactive elements are focusable
// Tab order follows visual order
// Enter/Space activate buttons
// Arrow keys navigate options

屏幕阅读器播报

<div role="status" aria-live="polite" id="announcer">
  
</div>

色彩对比度

/* Minimum 4.5:1 for normal text, 3:1 for large text */
--text-on-light: #000000;  /* 21:1 on white */
--text-on-dark: #ffffff;   /* 21:1 on black */
--text-on-primary: #ffffff; /* Check each color */

减少动态效果

@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}

文化考量

个人主义式表述

• “你想要什么？”
• 个人目标与价值观
• 个人机会成本

集体主义式表述

• “这会对你的团队／家庭产生什么影响？”
• 对人际关系的影响
• 对群体和谐的考量

权力距离意识

• 有些文化倾向于服从权威人士
• 偏见检查应包含“我是否不恰当地服从他人？”
• 明确纳入利益相关者的观点

不确定性容忍度

• 有些人更喜欢详细的情景分析
• 另一些人会因此感到焦虑
• 同时提供详细视图和简化视图

调用示例

从会议记录开始

User: Analyze this meeting transcript and create a decision toolkit
Claude: [Extracts decision, stakeholders, options from transcript]
        [Generates interactive HTML guide]
        [Creates voice summary]

从头开始

User: I need to decide whether to take a new job offer
Claude: [Asks clarifying questions]
        [Generates decision framework]
        [Customizes for career decision type]

快速分析

User: Help me think through this partnership decision, just give me the frameworks
Claude: [Provides markdown framework]
        [Skips interactive tool]
        [Focuses on key questions]

文件

• SKILL.md — 本文件
• templates/decision-guide-template.html — 交互式向导模板
• templates/decision-framework.md — 基于文本的分析模板
• templates/decision-voice-summary.md — 音频脚本模板
• references/bias-encyclopedia.md — 偏见的详细说明
• references/framework-deep-dives.md — 框架的扩展说明

集成

适用于：

• brand-agency — 应用视觉品牌风格
• transcript-analyzer — 从会议中提取决策
• pdf-generation — 创建可分享的报告
• elevenlabs-tts — 生成音频摘要

经验总结

2026-01-09

背景：根据 Synthius 决策会议创建初始技能

关键见解：一次性展示所有内容的仪表板会让人应接不暇。每个屏幕只讲解一个概念的分步向导能显著提升可用性。

架构：涵盖所有主要决策维度的 9 步流程。状态对象会在各步骤间保留用户的选择。摘要会汇总所有内容。

无障碍说明：高对比度的新粗野主义风格实际上有助于提升无障碍性——边框清晰、状态分明，没有细微的渐变。