Communitygithub.com

ASoudy/AGS

生成结构化决策支持工具——分步指南、偏见检查器、情景探索器和交互式仪表板。适用于需要进行系统分析的重大选择。支持多种认知风格和输出格式。

AGS 是什么?

这个技能旨在帮助用户系统性地思考重大决策,生成交互式工具而非单纯的分析报告。它遵循“引导而非决策”的原则,通过渐进式展示降低认知负荷,并提供多种框架(如第一性原理测试、偏见检查表、情景矩阵等)来照亮决策空间。技能支持交互式HTML向导、Markdown框架、语音摘要和PDF报告等多种输出格式,适用于机会评估、资源分配、风险评估和权衡分析等四大决策类型。该技能强调无障碍和认知包容性,支持屏幕阅读器、键盘导航、高对比度和减少动画模式,并提供个人主义、集体主义、权力距离和不确定性容忍度等文化视角的调整选项。它与品牌品牌、会议转录分析、PDF生成和TTS工具链集成良好,能够从零开始或基于现有文档(如会议记录)生成决策工具。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/decision-toolkit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

决策工具包

概述

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

理念

原则

  1. 引导,而非决定 — 工具照亮决策空间;人类做选择
  2. 一次只做一件事 — 通过渐进式展示降低认知负荷
  3. 多重视角 — 通过不同框架审视同一决策,发现盲点
  4. 偏见可见 — 让认知偏见明确化并可核查
  5. 可操作的输出 — 以具体的后续步骤而非抽象结论收尾

无障碍优先

  • 支持屏幕阅读器(语义HTML、ARIA标签)
  • 键盘可导航(Tab键顺序、焦点状态)
  • 默认高对比度(至少满足WCAG AA标准)
  • 提供减少动画选项
  • 无JavaScript也能工作(优雅降级)
  • 移动友好触摸目标(至少44px)

认知包容性

不同的人以不同方式处理决策:

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

何时使用

当用户面临以下情况时调用此技能:

  • 合作/合伙决策
  • 职业或工作变动
  • 投入大量时间/金钱
  • 项目优先级排序
  • 技术/工具选型
  • 任何具有多重因素和不确定性的选择

不适用于:琐碎决定、紧急响应,或用户仅需要信息时。

决策类型

类型1:机会评估

我应该追求这个机会吗?

  • 合伙、工作邀请、投资、项目

类型2:资源分配

我应该把时间/金钱/注意力投到哪里?

  • 优先级排序、预算编制、专注领域

类型3:风险评估

可能出现什么问题,值不值得?

  • 新事业、变革、实验

类型4:权衡导航

在众多选项中如何选择?

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

决策之旅

九步,每一步聚焦一个维度:

┌─────────────────────────────────────────────────────────────┐
│  1. 背景             这个决策是什么?                       │
│  2. 第一性原理       它解决的是真正的问题吗?               │
│  3. 时机             现在是合适的时机吗?                   │
│  4. 利益相关者       还有谁涉及?他们稳定吗?               │
│  5. 偏见             什么可能蒙蔽我的判断?                 │
│  6. 机会成本         我正在放弃什么?                       │
│  7. 情景             可能发生什么?                         │
│  8. 问题             我还需要了解什么?                     │
│  9. 综合             总结 + 决策                            │
└─────────────────────────────────────────────────────────────┘

输出格式

1. 交互式HTML指南(主要)

分步向导,包含:

  • 进度指示器
  • 每屏一个问题
  • 跨步骤的状态持久化
  • 聚合所有输入的最终摘要
  • 键盘导航
  • 适合打印的CSS

2. Markdown框架

用于离线/文本使用:

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

3. 语音摘要

用于音频收听:

  • 5-7段执行摘要
  • Orpheus TTS标记以增强情感层次
  • 关键决策 + 理由

4. PDF报告

用于文档化/分享:

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

框架参考

第一性原理测试

1. 这个方案解决什么问题?
2. 我能自己解决吗?
3. 这是最佳方案吗?
4. 我在做什么假设?
5. 如果从今天开始,我会选择这个吗?

偏见检查表

□ FOMO(错失恐惧症)——我在害怕错过吗?
□ 沉没成本——我在计算过去的投入吗?
□ 权威——我在盲从权威吗?
□ 社会认同——我在跟风吗?
□ 承诺——我觉得被过去的表态束缚了吗?
□ 乐观——我在假设问题会自动解决吗?
□ 近因——我是否过度重视近期事件?
□ 确认偏差——我是否只寻找验证信息?
□ 闪亮新事物——新鲜感在分散我的注意力吗?
□ 损失厌恶——我是否过度关注潜在损失?

机会成本计算器

小时数/周 × 周数 × 小时费率 = 直接成本
+ 这些时间还能产出什么?
+ 哪些关系/机会可能会受损?
= 真正的机会成本

情景矩阵

| 情景 | 概率 | 结果 | 期望值 |
|----------|-------------|---------|----------------|
| 最差 | X%  | ...   | ...            |
| 较差 | X%  | ...   | ...            |
| 中性 | X%  | ...   | ...            |
| 较好 | X%  | ...   | ...            |
| 最佳 | X%  | ...   | ...            |

事前验尸

想象现在是[未来日期]。这个决策失败了。原因是什么?

可能的原因:
1. ...
2. ...
3. ...

哪些原因在我的控制范围内?
我应该关注哪些预警信号?

10-10-10框架

我在以下时间点会如何看待这个决策:
- 10分钟后?
- 10个月后?
- 10年后?

遗憾最小化

想象你80岁回望过去。
你会后悔做了这件事吗?
你会后悔没做这件事吗?

实现指南

第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品牌:

  • 导入品牌技能 CSS 变量
  • 使用粗野主义风格
  • 应用 Geist/EB Garamond 字体

无障碍实现

语义HTML

<main role="main" aria-label="决策指南">
  <nav aria-label="进度">
    <ol role="list">...</ol>
  </nav>
  <section aria-labelledby="step-title">
    <h1 id="step-title">...</h1>
  </section>
</main>

键盘导航

// 确保所有交互元素可聚焦
// Tab键顺序遵循视觉顺序
// Enter/Space激活按钮
// 方向键导航选项

屏幕朗读器播报

<div role="status" aria-live="polite" id="announcer">
  <!-- 播报步骤变更、选择、结果 -->
</div>

颜色对比度

/* 普通文本最小对比度4.5:1,大文本3:1 */
--text-on-light: #000000;  /* 白色背景上 21:1 */
--text-on-dark: #ffffff;   /* 黑色背景上 21:1 */
--text-on-primary: #ffffff; /* 检查每种颜色 */

减少动画

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

文化考量

个人主义框架

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

集体主义框架

  • “这如何影响你的团队/家庭?”
  • 人际关系影响
  • 团体和谐考量

权力距离意识

  • 某些文化倾向于顺从权威人物
  • 偏见检查应包含“我是否在不当服从?”
  • 明确包含利益相关者观点

不确定性容忍度

  • 有些人喜欢详细的情景分析
  • 另一些人会觉得这引发焦虑
  • 提供详细视图和简化视图两种选择

调用示例

从会议记录出发

用户:分析这份会议记录,并创建决策工具包
Claude:[从记录中提取决策、利益相关者、选项]
        [生成交互式HTML指南]
        [创建语音摘要]

从零开始

用户:我需要决定是否接受一份新工作邀请
Claude:[提出澄清性问题]
        [生成决策框架]
        [针对职业决策类型定制]

快速分析

用户:帮我思考这个合作决策,直接给我框架就行
Claude:[提供Markdown框架]
        [跳过交互式工具]
        [专注于关键问题]

文件

  • 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步旅程。状态对象在步骤之间持续保存选择。摘要汇聚所有内容。

无障碍说明:高对比度的粗野主义风格实际上有助于无障碍——清晰的边框、明确的状态、没有微妙的渐变。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相关技能