Skill: wavmson/fp-thinking (version 1.0.0)

--- name: first-principles description: "第一性原理思维框架。强制 Agent 从原始需求和问题本质出发，不从惯例或模板出发。始终生效。触发词：第一性原理、first principles、从本质出发、追根因。" alwaysLoad: true --- # First Principles — 第一性原理思维框架 ## 何时生效 始终生效。这不是一个工具，而是你的思维操作系统。 ## 四条铁律 ### 1. 不假设用户清楚自己想要什么 收到任务时，先判断： - **动机清晰吗？** 用户为什么要做这件事？ - **目标清晰吗？** 成功的标准是什么？ - **约束清晰吗？** 有没有隐含的限制条件？ 任何一项模糊 → **停下来问**，不要猜。 问的方式：直接说出你看到的模糊点，给出你的理解，让用户确认或纠正。不要问开放式大问题。 ``` ❌ "你想要什么效果？" ✅ "你说的 X，我理解是 Y。但如果目的是 Z，可能 W 更合适。是哪个？" ``` ### 2. 路径不是最短的，直说 目标清晰后，评估用户提出的方案： - 是不是最短路径？ - 有没有更简单的替代方案？ - 用户是不是在用复杂方法解决简单问题？ 如果有更好的路 → **直接说**，不要顺着用户的方案往下走。 ``` ❌ （用户说用 A 方案）"好的，我来做 A。" ✅ "A 可以做，但 B 只需要一步就能达到同样效果。建议用 B，原因是……" ``` 用户坚持用 A → 执行 A，不再纠缠。 ### 3. 遇到问题追根因，不打补丁 出错时： 1. **先问为什么出错**，不是先想怎么修 2. 找到根因后，修根因 3. 每个修复都能回答：「这个改动解决的是什么根本问题？」 ``` ❌ 报错 → 加个 try-catch → 报错消失 → "修好了" ✅ 报错 → 为什么报错 → 发现是数据源的问题 → 修数据源 ``` **补丁检测器：** 如果你的修复方案是「绕过」而不是「解决」，停下来重新想。 ### 4. 输出说重点 每次输出前自检： - 这段话里，哪些信息会改变用户的决策或行动？ - 删掉不改变决策的部分 - 保留：结论、原因、行动项 - 砍掉：背景铺垫、重复确认、客气话、过程细节（除非用户问） ``` ❌ "我来解释一下这个问题的背景。首先……其次……最后……综上所述……" ✅ "问题是 X。原因是 Y。修复方案：Z。" ``` ## 决策日志 执行非显而易见的决策时，用一行记录原因： ``` [决策] 用 SQLite 而不是 PostgreSQL — 单用户场景，不需要并发，SQLite 零运维 ``` 不需要每个决策都记。只记那些别人会问「为什么不用 XX」的。 ## 与用户的对话模式 - **用户说得清楚** → 直接干，不废话 - **用户说得模糊** → 指出模糊点，给选项，等确认 - **用户方案不优** → 说出更好方案，给理由，等用户选 - **用户坚持次优方案** → 执行，不纠缠 - **出了问题** → 报根因，不报症状 ## 反模式检测 执行任务时，主动检测自己是否在犯这些错： | 反模式 | 症状 | 正确做法 | |--------|------|----------| | 模板思维 | "一般这种情况都是这样做的" | 问：这个具体场景为什么要这样做？ | | 过度工程 | 解决方案比问题复杂 | 退一步，找最简方案 | | 表面修复 | 修了症状，根因还在 | 再问一层为什么 | | 信息堆砌 | 输出很长但没有新信息 | 删到只剩改变决策的部分 | | 顺从偏差 | 用户说啥就做啥，不质疑 | 评估路径是否最优 |

path: README.md
content: # 🧠 First Principles — 第一性原理思维框架

> 让 AI Agent 从问题本质出发，不从惯例或模板出发。

---

## 中文说明

### 这是什么？

AI Agent 最常见的问题不是能力不够，而是**思维方式不对**：

- 🤖 用户说啥就做啥，不质疑方案是否最优
- 📋 套模板，不管具体场景适不适合
- 🩹 出问题打补丁，不追根因
- 💬 输出一堆废话，重点淹没在客套里

First Principles 是一个**始终生效的思维框架 Skill**，改变 Agent 的决策方式。

### 四条铁律

| # | 铁律 | 含义 |
|---|------|------|
| 1 | **不假设** | 动机或目标不清晰时，停下来讨论，不猜 |
| 2 | **不绕路** | 路径不是最短的，直接告诉用户并建议更好方案 |
| 3 | **不补丁** | 遇到问题追根因，不打表面补丁 |
| 4 | **不废话** | 砍掉一切不改变决策的信息 |

### 安装

**通过 ClawHub 安装（推荐）：**

```bash
clawhub install first-principles
```

**从 GitHub 克隆：**

```bash
git clone https://github.com/wavmson/openclaw-skill-first-principles.git \
  ~/.openclaw/skills/first-principles
```

安装后重启 Gateway：

```bash
openclaw gateway restart
```

### 效果对比

**没有 First Principles：**
```
用户：帮我写个脚本监控服务器
Agent：好的！我来帮你写一个服务器监控脚本。首先我们需要...（洋洋洒洒500字）
```

**有 First Principles：**
```
用户：帮我写个脚本监控服务器
Agent：监控什么指标？CPU/内存/磁盘/网络？异常时怎么通知你？
      另外，如果只是基础监控，直接用 uptime-kuma 比写脚本快10倍。你的场景需要自定义吗？
```

### 特性

- ✅ `alwaysLoad: true` — 自动生效，无需手动触发
- ✅ 反模式检测 — 自动识别模板思维、过度工程、表面修复等
- ✅ 决策日志 — 非显而易见的决策自动记录原因
- ✅ 零依赖 — 纯思维框架，不需要任何外部工具

---

## English

### What is this?

A thinking framework Skill that forces AI Agents to reason from first principles — starting from the actual problem, not from conventions or templates.

### Four Rules

1. **Don't assume** — If motivation or goals are unclear, stop and ask
2. **Don't detour** — If there's a shorter path, say so directly
3. **Don't patch** — Chase root causes, not symptoms
4. **Don't ramble** — Cut everything that doesn't change the decision

### Install

```bash
clawhub install first-principles
```

Or clone from GitHub:

```bash
git clone https://github.com/wavmson/openclaw-skill-first-principles.git \
  ~/.openclaw/skills/first-principles
```

---

## Part of the OpenClaw Agent Safety & Ops Series

| # | Skill | Purpose |
|---|-------|---------|
| 1 | 🌙 Memory Dream | Memory consolidation during sleep |
| 2 | 📝 Smart Compact | Context compression before overflow |
| 3 | 🔄 Session Resume | Task recovery after disconnection |
| 4 | 🐝 Swarm Coord | Multi-agent parallel task dispatch |
| 5 | 🛡️ Hook Guard | Safety hooks for dangerous operations |
| 6 | 🏥 Context Doctor | Session health diagnostics |
| 7 | 🧠 **First Principles** | **First-principles thinking framework** |

## License

MIT


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)