decision-toolkit
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseDecision Toolkit
决策工具包
Overview
概述
Create structured decision support materials that help humans think through significant choices systematically. This skill produces interactive tools, not just analysis — empowering the decision-maker rather than deciding for them.
创建结构化的决策支持材料，帮助人们系统地思考重大选择。该技能生成的是交互式工具，而非单纯的分析内容——赋能决策者而非替他们做决定。
Philosophy
设计理念
Principles
核心原则
- Guide, don't decide — Tools illuminate the decision space; humans choose
- One thing at a time — Reduce cognitive load through progressive disclosure
- Multiple lenses — Same decision viewed through different frameworks reveals blind spots
- Biases visible — Make cognitive biases explicit and checkable
- Actionable output — End with concrete next steps, not abstract conclusions
- 引导而非决策——工具用于明晰决策空间，最终由人类做出选择
- 一次聚焦一点——通过渐进式信息披露降低认知负荷
- 多视角分析——从不同框架审视同一决策，发现盲区
- 偏见可视化——明确呈现认知偏见并可进行检查
- 输出可落地——最终给出具体下一步行动，而非抽象结论
Accessibility First
无障碍优先
- Support screen readers (semantic HTML, ARIA labels)
- Keyboard navigable (tab order, focus states)
- High contrast by default (WCAG AA minimum)
- Reduced motion option
- Works without JavaScript (graceful degradation)
- Mobile-friendly touch targets (44px minimum)
- 支持屏幕阅读器（语义化HTML、ARIA标签）
- 可通过键盘导航（合理的Tab顺序、焦点状态）
- 默认高对比度（至少符合WCAG AA标准）
- 提供减少动效选项
- 无JavaScript环境下仍可正常使用（优雅降级）
- 适配移动端的触摸目标（最小44px）
Cognitive Inclusivity
认知包容性
Different people process decisions differently:
| Style | Accommodation |
|---|---|
| Analytical | Numbers, matrices, weighted scores |
| Intuitive | Gut-check prompts, "how does this feel?" |
| Visual | Diagrams, progress bars, color coding |
| Verbal | Written summaries, question prompts |
| Sequential | Step-by-step wizard flow |
| Global | Dashboard overview option |
不同人群的决策思维方式存在差异：
| 思维风格 | 适配方案 |
|---|---|
| 分析型 | 数据表格、矩阵、加权评分 |
| 直觉型 | 直觉校验提示、“这给你的感受如何？” |
| 视觉型 | 图表、进度条、颜色编码 |
| 语言型 | 书面摘要、问题引导 |
| 顺序型 | 分步向导流程 |
| 全局型 | 仪表盘概览选项 |
When to Use
使用场景
Invoke this skill when user faces:
- Collaboration/partnership decisions
- Career or job changes
- Investment of significant time/money
- Project prioritization
- Technology/tool selection
- Any choice with multiple factors and uncertainty
Not for: Trivial decisions, emergency responses, or when user just needs information.
当用户面临以下情况时可调用该技能：
- 合作/伙伴关系决策
- 职业或工作变动
- 投入大量时间/资金的决策
- 项目优先级排序
- 技术/工具选型
- 任何涉及多因素和不确定性的选择
不适用于：琐碎决策、应急响应，或用户仅需获取信息的场景。
Decision Types
决策类型
Type 1: Opportunity Evaluation
类型1：机会评估
Should I pursue this opportunity?
- Partnership, job offer, investment, project
我是否应该抓住这个机会？
- 合作机会、工作邀约、投资、项目
Type 2: Resource Allocation
类型2：资源分配
Where should I invest my time/money/attention?
- Prioritization, budgeting, focus areas
我应该将时间/资金投入到何处？
- 优先级排序、预算分配、聚焦领域
Type 3: Risk Assessment
类型3：风险评估
What could go wrong and is it worth it?
- New ventures, changes, experiments
可能会出现哪些问题？是否值得尝试？
- 新业务、变革举措、实验项目
Type 4: Trade-off Navigation
类型4：权衡决策
Which option among alternatives?
- Tool selection, hire decisions, strategic choices
在多个选项中该如何选择？
- 工具选型、招聘决策、战略选择
The Decision Journey
决策流程
Nine steps, each focused on one dimension:
┌─────────────────────────────────────────────────────────────┐
│ 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. 背景梳理 决策的核心内容是什么？ │
│ 2. 第一性原理检验 这是否真的解决了实际问题？ │
│ 3. 时机判断 现在是合适的时机吗？ │
│ 4. 利益相关方分析 涉及哪些主体？他们的状态是否稳定？ │
│ 5. 偏见识别 哪些因素可能影响我的判断？ │
│ 6. 机会成本计算 我将放弃哪些其他可能性？ │
│ 7. 场景推演 可能会出现哪些结果？ │
│ 8. 待澄清问题 我还需要了解哪些信息？ │
│ 9. 综合决策 总结+最终决策 │
└─────────────────────────────────────────────────────────────┘Output Formats
输出格式
1. Interactive HTML Guide (Primary)
1. 交互式HTML指南（首选）
Step-by-step wizard with:
- Progress indicator
- One question per screen
- State persistence across steps
- Final summary aggregating all inputs
- Keyboard navigation
- Print-friendly CSS
分步向导包含：
- 进度指示器
- 每页一个问题
- 跨步骤状态持久化
- 汇总所有输入的最终摘要
- 键盘导航支持
- 打印友好的CSS样式
2. Markdown Framework
2. Markdown框架
For offline/text-based use:
- Structured prompts
- Checkbox-style bias audit
- Fill-in-the-blank templates
适用于离线/文本场景：
- 结构化提示
- 复选框式偏见审核表
- 填空式模板
3. Voice Summary
3. 语音摘要
For audio consumption:
- 5-7 paragraph executive summary
- Orpheus TTS markup for emotional texture
- Key decision + rationale
适用于音频收听：
- 5-7段的执行摘要
- 用于情感渲染的Orpheus TTS标记
- 核心决策+理由
4. PDF Report
4. PDF报告
For documentation/sharing:
- Professional formatting
- All frameworks applied
- Appendix with raw analysis
适用于文档留存/分享：
- 专业格式排版
- 应用所有决策框架
- 包含原始分析的附录
Frameworks Reference
框架参考
First Principles Test
第一性原理检验
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?1. 这解决了什么问题？
2. 我自己能否解决这个问题？
3. 这是最优解决方案吗？
4. 我做出了哪些假设？
5. 如果从零开始，我还会选择这个方案吗？Bias Checklist
偏见检查清单
□ 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?□ 错失恐惧（FOMO）——我是否害怕错过机会？
□ 沉没成本——我是否考虑了过去的投入？
□ 权威效应——我是否过度信任资历？
□ 社会认同——我是否在随大流？
□ 承诺偏差——我是否因过去的表态而被束缚？
□ 乐观偏差——我是否默认问题会自行解决？
□ 近因效应——我是否过度重视近期事件？
□ 确认偏差——我是否只寻找验证自己观点的信息？
□ 新奇效应——新事物是否分散了我的注意力？
□ 损失厌恶——我是否过度放大潜在损失？Opportunity Cost Calculator
机会成本计算器
Hours/week × Weeks × Hourly rate = Direct cost
+ What else could those hours produce?
+ What relationships/opportunities might suffer?
= True opportunity cost每周投入时长 × 周数 × 时薪 = 直接成本
+ 这些时间原本可创造的其他价值
+ 可能受影响的关系/机会
= 真实机会成本Scenario Matrix
场景矩阵
| Scenario | Probability | Outcome | Expected Value |
|----------|-------------|---------|----------------|
| Worst | X% | ... | ... |
| Bad | X% | ... | ... |
| Neutral | X% | ... | ... |
| Good | X% | ... | ... |
| Best | X% | ... | ... || 场景 | 概率 | 结果 | 预期价值 |
|----------|-------------|---------|----------------|
| 最坏情况 | X% | ... | ... |
| 不利情况 | X% | ... | ... |
| 中性情况 | X% | ... | ... |
| 有利情况 | X% | ... | ... |
| 最佳情况 | X% | ... | ... |Pre-mortem
事前验尸法
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?想象现在是[未来日期]，这个决策失败了。原因是什么？
可能的原因：
1. ...
2. ...
3. ...
哪些原因在我的可控范围内？
我需要关注哪些预警信号？10-10-10 Framework
10-10-10框架
How will I feel about this decision in:
- 10 minutes?
- 10 months?
- 10 years?做出这个决策后，我在以下时间点会有什么感受：
- 10分钟后？
- 10个月后？
- 10年后？Regret Minimization
遗憾最小化框架
Imagine you're 80 looking back.
Would you regret doing this?
Would you regret NOT doing this?想象你80岁时回顾人生。
你会后悔做了这个决定吗？
你会后悔没做这个决定吗？Implementation Guide
实现指南
Step 1: Gather Context
步骤1：收集背景信息
Ask user for:
- What is the decision?
- What are the options?
- What's the timeline?
- What's at stake?
- Any relevant background?
Or extract from existing documents (meeting transcripts, notes).
向用户询问：
- 决策的核心内容是什么？
- 有哪些可选方案？
- 时间线是怎样的？
- 涉及哪些关键利益？
- 有哪些相关背景信息？
或从现有文档（会议记录、笔记）中提取信息。
Step 2: Choose Output Format
步骤2：选择输出格式
Based on user preference and context:
- Complex decision + time available → Interactive HTML
- Quick analysis → Markdown framework
- On-the-go consumption → Voice summary
- Need to share with others → PDF report
根据用户偏好和场景选择：
- 复杂决策+充足时间 → 交互式HTML指南
- 快速分析 → Markdown框架
- 移动场景下使用 → 语音摘要
- 需要分享给他人 → PDF报告
Step 3: Generate Tool
步骤3：生成工具
Use templates in directory:
templates/- — Full interactive wizard
decision-guide-template.html - — Text-based analysis
decision-framework.md - — Audio script template
decision-voice-summary.md
使用目录下的模板：
templates/- — 完整交互式向导模板
decision-guide-template.html - — 文本分析模板
decision-framework.md - — 音频脚本模板
decision-voice-summary.md
Step 4: Customize
步骤4：自定义内容
Replace placeholders:
- — What's being decided
{{DECISION_TITLE}} - — Background information
{{CONTEXT}} - — Available choices
{{OPTIONS}} - — People/teams involved
{{STAKEHOLDERS}} - — Relevant dates
{{TIMELINE}} - — Key evaluation criteria
{{FACTORS}}
替换占位符：
- — 决策主题
{{DECISION_TITLE}} - — 背景信息
{{CONTEXT}} - — 可选方案
{{OPTIONS}} - — 涉及的人员/团队
{{STAKEHOLDERS}} - — 关键日期
{{TIMELINE}} - — 核心评估标准
{{FACTORS}}
Step 5: Apply Branding (Optional)
步骤5：应用品牌样式（可选）
If using Agency brand:
- Import brand-agency skill CSS variables
- Use neobrutalism styling
- Apply Geist/EB Garamond typography
如果使用代理品牌：
- 导入brand-agency技能的CSS变量
- 使用新粗野主义（neobrutalism）样式
- 应用Geist/EB Garamond字体
Accessibility Implementation
无障碍实现细节
Semantic HTML
语义化HTML
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>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>Keyboard Navigation
键盘导航
javascript
// Ensure all interactive elements are focusable
// Tab order follows visual order
// Enter/Space activate buttons
// Arrow keys navigate optionsjavascript
// Ensure all interactive elements are focusable
// Tab order follows visual order
// Enter/Space activate buttons
// Arrow keys navigate optionsScreen Reader Announcements
屏幕阅读器播报
html
<div role="status" aria-live="polite" id="announcer">
<!-- Announce step changes, selections, results -->
</div>html
<div role="status" aria-live="polite" id="announcer">
<!-- Announce step changes, selections, results -->
</div>Color Contrast
颜色对比度
css
/* 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 */css
/* 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 */Reduced Motion
减少动效
css
@media (prefers-reduced-motion: reduce) {
* {
animation: none !important;
transition: none !important;
}
}css
@media (prefers-reduced-motion: reduce) {
* {
animation: none !important;
transition: none !important;
}
}Cultural Considerations
文化适配考虑
Individualist Framing
个人主义视角
- "What do YOU want?"
- Personal goals and values
- Individual opportunity cost
- “你自己的需求是什么？”
- 个人目标与价值观
- 个人机会成本
Collectivist Framing
集体主义视角
- "How does this affect your team/family?"
- Relationship implications
- Group harmony considerations
- “这会如何影响你的团队/家庭？”
- 关系影响
- 群体和谐考量
Power Distance Awareness
权力距离意识
- Some cultures defer to authority figures
- Bias check should include "Am I deferring inappropriately?"
- Include stakeholder perspectives explicitly
- 部分文化倾向于服从权威
- 偏见检查应包含“我是否过度服从？”
- 明确纳入利益相关方的视角
Uncertainty Tolerance
不确定性容忍度
- Some prefer detailed scenario analysis
- Others find it anxiety-inducing
- Offer both detailed and simplified views
- 部分人群偏好详细的场景分析
- 部分人群会因此感到焦虑
- 同时提供详细版和简化版选项
Example Invocations
示例调用
From Meeting Transcript
从会议记录生成
User: Analyze this meeting transcript and create a decision toolkit
Claude: [Extracts decision, stakeholders, options from transcript]
[Generates interactive HTML guide]
[Creates voice summary]用户：分析这份会议记录并创建一个决策工具包
Claude：[从记录中提取决策内容、利益相关方、可选方案]
[生成交互式HTML指南]
[创建语音摘要]From Scratch
从零开始创建
User: I need to decide whether to take a new job offer
Claude: [Asks clarifying questions]
[Generates decision framework]
[Customizes for career decision type]用户：我需要决定是否接受新的工作邀约
Claude：[询问澄清问题]
[生成决策框架]
[针对职业决策场景进行定制]Quick Analysis
快速分析
User: Help me think through this partnership decision, just give me the frameworks
Claude: [Provides markdown framework]
[Skips interactive tool]
[Focuses on key questions]用户：帮我梳理这个合作决策，只需要提供框架即可
Claude：[提供Markdown框架]
[跳过交互式工具]
[聚焦核心问题]Files
相关文件
- — This file
SKILL.md - — Interactive wizard template
templates/decision-guide-template.html - — Text-based analysis template
templates/decision-framework.md - — Audio script template
templates/decision-voice-summary.md - — Detailed bias descriptions
references/bias-encyclopedia.md - — Extended framework explanations
references/framework-deep-dives.md
- — 本文档
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
Integration
集成能力
Works well with:
- brand-agency — Apply visual branding
- transcript-analyzer — Extract decisions from meetings
- pdf-generation — Create shareable reports
- elevenlabs-tts — Generate audio summaries
可与以下技能协同使用：
- brand-agency — 应用视觉品牌样式
- transcript-analyzer — 从会议中提取决策信息
- pdf-generation — 创建可分享的报告
- elevenlabs-tts — 生成音频摘要
Learnings
经验总结
2026-01-09
2026-01-09
Context: Initial skill creation from Synthius decision session
Key Insight: Dashboard-everything-at-once overwhelms. Step-by-step wizard with one concept per screen dramatically improves usability.
Architecture: 9-step journey covering all major decision dimensions. State object persists selections across steps. Summary aggregates everything.
Accessibility Note: High contrast neobrutalism actually helps accessibility — clear borders, distinct states, no subtle gradients.
背景：基于Synthius决策会议创建初始技能
核心洞察：一次性展示所有信息会造成信息过载。采用分步向导、每次聚焦一个概念的方式可显著提升可用性。
架构设计：覆盖所有主要决策维度的9步流程。状态对象跨步骤保存选择信息。摘要部分汇总所有输入内容。
无障碍注意事项：高对比度的新粗野主义风格实际上有助于无障碍体验——清晰的边框、明确的状态、无微妙渐变。