Communitygithub.com

ASoudy/AGS

產生結構化的決策輔助工具 — 逐步指南、偏見檢查表、情境探索器和互動式儀表板。適用於需要系統性分析的重大選擇。支援多種認知風格與輸出格式。

AGS 是什麼?

這項技能旨在協助開發人員或使用者建立結構化的決策支援材料,幫助人類有系統地思考重大選擇。它不提供最終決定,而是產出互動式工具(如逐步精靈、偏見審核清單、機會成本計算器和情境矩陣),賦能決策者自己做出判斷。核心哲學強調「引導而非決定」、「漸進式揭露降低認知負擔」以及「多重框架避免盲點」。技能支援多種輸出格式,包括互動式 HTML 指南、Markdown 框架、語音摘要和 PDF 報告,並內建無障礙設計(螢幕閱讀器、鍵盤導航、高對比度、減少動畫)與認知包容性(分析型、直覺型、視覺型等)。使用者只需描述決策情境,此技能就會自動選用最合適的模板,逐步引導完成從「定義問題」到「最終綜合」的九步驟決策旅程。

相容平台✓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. 利害關係人     還有誰牽涉其中?他們穩定嗎?              │
│  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 年後?

遺憾最小化

想像你八十歲回頭看。
你會後悔做了這件事嗎?
你會後悔沒做這件事嗎?

實作指南

步驟 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="決策指南">
  <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 決策會議產生的初始技能

關鍵洞察:一次顯示所有儀表板內容會讓人不知所措。逐步精靈、一次只呈現一個概念,能大幅改善可用性。

架構:涵蓋所有主要決策面向的九步驟旅程。狀態物件在步驟之間持久化選取內容。摘要彙總所有內容。

無障礙備註:高對比的新粗獷主義風格實際上對無障礙有幫助 — 清晰的邊框、明確的狀態、無細微漸層。

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.

相關技能