Token导航 LogoToken导航TokenDH.com
待分类需要联网github未标认证来源可访问许可证需确认审计通过

thinking-margin-of-safety思考安全边际

Agent Skill

thinking-margin-of-safety 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

449

周安装

18

GitHub Stars

46

下载量

145
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:thinking-margin-of-safety(思考安全边际)
来源仓库:https://github.com/tjboudreaux/cc-thinking-skills
仓库路径:skills/thinking-margin-of-safety
安装命令:
npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-margin-of-safety
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-margin-of-safety

简介

思考安全边际用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息。

  • 适合在发布前评估技术风险、测试覆盖缺口与回滚预案。
  • 量化不确定性因素,提出缓冲措施与监控指标阈值。
  • 安装命令:npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-margin-of-safety
  • 分类标记为“待分类”,实际应用场景尚不明确,需参考原始文档补充说明。

SKILL.md

Margin of Safety

Overview

Margin of Safety, borrowed from Benjamin Graham's investment philosophy and structural engineering, is the practice of building in buffers to account for unknown unknowns. In a world of uncertainty, systems optimized to the edge are brittle. Robust systems have slack, reserves, and room for error.

Core Principle: Build in buffers. The world is uncertain. Systems without margin fail when stressed.

When to Use

  • Capacity planning
  • Deadline and timeline estimation
  • Architecture design
  • Resource allocation
  • Risk management
  • SLA commitments
  • Infrastructure provisioning
  • Any commitment under uncertainty

Decision flow:

Making a commitment or design?
  → Is there uncertainty? → yes → BUILD IN MARGIN
  → Are you optimizing tightly? → yes → ADD SLACK
  → What if your estimates are wrong? → Consider margin

The Margin of Safety Framework

Step 1: Identify Your Estimate

What's your best guess for the requirement?

Estimate: Need 100 requests/second capacity
Estimate: Project will take 6 weeks
Estimate: Need 500GB storage for year 1

Step 2: Quantify Your Uncertainty

How confident are you, and what could you be missing?

## Uncertainty Analysis

| Factor | Your Estimate | Uncertainty | Possible Range |
|--------|---------------|-------------|----------------|
| Traffic | 100 RPS | ±50% | 50-150 RPS |
| Spike multiplier | 3x | ±100% | 1.5x-6x |
| Growth rate | 20%/year | ±50% | 10-30%/year |
| Unknown unknowns | - | +50-100% | - |

Step 3: Calculate Required Margin

Different contexts need different margins:

ContextTypical MarginRationale
Capacity planning2-3xTraffic spikes unpredictable
Time estimation1.5-2xEverything takes longer
Infrastructure2x headroomScaling takes time
SLA commitment1.5x bufferReputation at stake
New/unknown domain2-3xHigh uncertainty
Well-understood domain1.3-1.5xLower uncertainty

Step 4: Apply Margin

Base estimate: 100 RPS
Margin: 2x (moderate uncertainty, spikes possible)
Provision: 200 RPS capacity

Base estimate: 6 weeks
Margin: 1.5x (experienced team, some unknowns)
Commit: 9 weeks

Step 5: Monitor and Adjust

Track actuals against estimates to calibrate future margins:

## Calibration Log

| Estimate | Margin Applied | Actual | Margin Accuracy |
|----------|----------------|--------|-----------------|
| 100 RPS | 2x (200) | 180 | Adequate |
| 6 weeks | 1.5x (9) | 10 weeks | Insufficient |
| 500 GB | 2x (1TB) | 400 GB | Excessive |

Insight: Time estimates need higher margin; storage was overprovisioned

Margin Patterns

Capacity Margin

## Capacity Planning with Margin

Base load: 1,000 RPS
Peak multiplier: 3x (historical)
Margin for unknowns: 1.5x
Margin for growth: 1.3x (6 months runway)

Required capacity: 1,000 × 3 × 1.5 × 1.3 = 5,850 RPS
Round up: 6,000 RPS

Rationale: Can handle 6x normal load, or 4x peak, or growth + peak

Time Margin

## Project Estimation with Margin

Task estimates:
- Feature A: 2 weeks
- Feature B: 3 weeks
- Integration: 1 week
- Testing: 1 week
Base total: 7 weeks

Adjustments:
- Optimistic bias: +30%
- Unknowns: +20%
- Dependencies: +15%
Margin total: 1.65x

Commitment: 7 × 1.65 = 11.5 → 12 weeks

Rule of thumb: Hofstadter's Law - "It always takes longer than you expect,
               even when you take into account Hofstadter's Law."

Financial Margin

## Budget with Margin

Infrastructure estimate:
- Compute: $5,000/month
- Storage: $2,000/month
- Network: $1,000/month
Base: $8,000/month

Margin considerations:
- Traffic growth: +25%
- Unplanned incidents: +15%
- New features: +20%

Budget request: $8,000 × 1.6 = $12,800/month
Actual budget: $13,000/month (round up)

Design Margin

## Architectural Margin

Connection pool:
- Normal usage: 50 connections
- Peak: 100 connections
- Margin: 2x peak
- Configure: 200 connections

Queue depth:
- Normal processing: 1,000 messages
- Burst: 10,000 messages
- Margin: 2x burst
- Configure: 20,000 max depth

Timeout:
- P99 latency: 500ms
- Margin: 2x
- Set timeout: 1000ms

When to Use Different Margins

High Margin (2-3x)

  • New domain or technology
  • Critical system (failure is very costly)
  • External dependencies (unpredictable)
  • Customer-facing SLAs
  • Irreversible commitments

Moderate Margin (1.5-2x)

  • Familiar domain with some unknowns
  • Internal systems (can recover from issues)
  • Controlled dependencies
  • Reversible decisions

Low Margin (1.2-1.5x)

  • Well-understood domain
  • Historical data available
  • Low consequence of being wrong
  • Short time horizons
  • Easy to adjust

No Margin (Optimize to Edge)

Almost never appropriate for:

  • Public commitments
  • Production systems
  • External dependencies

Acceptable for:

  • Internal experiments
  • Temporary systems
  • Cost optimization after proving stable

The Cost of Margin

Margin isn't free. Balance:

## Margin Cost-Benefit

High margin:
+ Handles unexpected loads
+ Reduces stress/heroics
+ Enables growth without emergency scaling
- Higher infrastructure cost
- Potentially wasted resources

Low margin:
+ Lower cost
+ Efficient resource use
- Risk of outages
- Constant firefighting
- Technical debt from quick fixes

Sweet spot: Margin where cost of buffer < expected cost of margin-breach × probability

Margin of Safety Template

# Margin of Safety Analysis: [Context]

## Base Estimate
What: [What you're estimating]
Estimate: [Your point estimate]
Confidence: [How confident you are]

## Uncertainty Factors
| Factor | Impact | Probability | Adjustment |
|--------|--------|-------------|------------|
| [Factor 1] | +X% | Medium | |
| [Factor 2] | +Y% | Low | |
| Unknown unknowns | +Z% | - | |

## Margin Calculation
Base: [X]
Uncertainty multiplier: [1.X]
Context multiplier: [1.Y] (high/medium/low stakes)
Total margin: [X × all multipliers]

## Final Commitment/Design
With margin: [Final number]
Rationale: [Why this margin]

## Monitoring Plan
How will you know if margin is adequate/excessive?
- [Metric to track]
- [Threshold for concern]
- [Review cadence]

Verification Checklist

  • Identified base estimate
  • Quantified uncertainty factors
  • Selected appropriate margin for context
  • Applied margin to commitment/design
  • Considered cost of margin vs. cost of breach
  • Have monitoring to validate margin adequacy
  • Calibrating based on actual outcomes

Key Questions

  • "What happens if my estimate is wrong by 2x?"
  • "How much margin does this uncertainty warrant?"
  • "Am I building for best case or realistic case?"
  • "What's the cost of being wrong vs. cost of margin?"
  • "Have I accounted for unknown unknowns?"
  • "Am I optimizing to the edge when I shouldn't be?"

Graham's Wisdom

"The margin of safety is always dependent on the price paid."

In engineering: The margin needed depends on the cost of failure. Critical systems need more margin. Experiments can run leaner.

"Confronted with the challenge to distill the secret of sound investment into three words, we venture the motto, Margin of Safety."

In systems: When in doubt, build in margin. The cost of over-provisioning is usually much less than the cost of under-provisioning when things go wrong.

"The function of the margin of safety is, in essence, that of rendering unnecessary an accurate estimate of the future."

You don't need to predict perfectly if you have adequate margin. Margin is insurance against your own estimation errors.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

39.31%
按下载量换算57

Claude

28.2%
按下载量换算41

Cursor

16.72%
按下载量换算24

Gemini CLI

9.68%
按下载量换算14

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills