# Mingsi

> 「明思」结构化思考优化框架。通过 L1-L5 五级复杂度分级、子任务管理、工作流组合，让 AI 既快又好地思考。触发场景：分析、规划、决策、方案设计、问题诊断、对比评估、优化建议。

- Skill: `qingjian0/mingsi` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add qingjian0/mingsi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qingjian0/mingsi/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: qingjian0 (https://skillmd.com/u/qingjian0)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qingjian0/mingsi

---


# 「明思」— 结构化思考优化框架

> "明察、明辨、明确" — 让思考有章可循，让输出有质可依。

「明思」是一个武装 AI 大脑的方法论框架，借鉴了「求是 skill」的优秀设计，通过五级复杂度分级、工作流组合、子任务管理，系统性地解决四个核心问题：

| 痛点 | 明思的解法 |
|------|-----------|
| 🎯 方向跑偏 | 前置检查 + 一句话复述 + 歧义检测 |
| 🐢 过度思考/思考不足 | L1-L5 五级精准分级，恰到好处 |
| 🏊 复杂问题无从下手 | 工作流组合 + 子任务管理 + 工具集 |
| 📝 缺乏结构/质量不稳定 | 检查清单体系 + 可观测行为准则 |

---

## 快速开始

### 核心原则：实事求是

"实事"就是客观存在着的一切事物，"是"就是客观事物的内部联系，"求"就是我们去研究。

- ✅ 先看事实，再下判断
- ✅ 每个结论附具体依据
- ✅ 声称"完成"前执行验证
- ✅ 遇到不确定明确标注

### 可观测的行为准则

| 原则 | 可观测行为 | 违反信号 |
|------|-----------|---------|
| 不空谈，看事实 | 每个结论后面附具体依据（读了什么/看到了什么/运行出了什么） | 给出判断但没有任何事实支撑 |
| 验证才算完成 | 声称"完成"之前执行验证动作（运行、读取输出、对比预期） | 写完就说完成，没有验证 |
| 承认不知道 | 遇到不确定信息时，明确标注"需要进一步确认" | 用猜测代替调查 |
| 遇阻探原因 | 遇到失败时说明原因、补调查或更换路径 | 第一次遇阻就停止推进 |

---

## 第一层：快速评估（10 秒内完成）

收到任务后，按以下顺序执行：

### Step 1：一句话复述

用一句话概括用户要什么：

> 用户需要 [做什么]，因为 [为什么]，期望 [什么结果]。

如果无法清晰复述 → **立即追问，不要猜测**。

### Step 2：复杂度分级（L1-L5）

使用 `references/complexity-matrix.md` 中的决策矩阵，判断任务复杂度：

| 级别 | 名称 | 核心特征 |
|------|------|---------|
| **L1** | 直接回答 | 事实查询、单步操作、简单转换 |
| **L2** | 简要分析 | 2-3 步推理，简单判断 |
| **L3** | 标准分析 | 3-5 步推理，多因素考虑（可选子任务） |
| **L4** | 深度分析 | 5+ 步推理，方案对比（推荐子任务） |
| **L5** | 全面研究 | 复杂决策，多维度分析（必须子任务） |

**分级原则**：宁可高估一级，不要低估。但 L1 必须严格判定。

### Step 3：前置检查

检查以下条件，任一不满足则先处理：

- [ ] 用户意图是否清晰？
- [ ] 上下文是否足够？
- [ ] 任务范围是否明确？
- [ ] 是否有特殊约束？

有歧义则追问，每次只问一个最关键的歧义点。

---

## 第二层：路由调度

根据快速评估结果，调用对应的子 skill：

| 评估结果 | 调用的子 skill |
|---------|--------------|
| L1 直接回答 | `skills/l1-direct/SKILL.md` |
| L2 简要分析 | `skills/l2-brief/SKILL.md` |
| L3 标准分析 | `skills/l3-standard/SKILL.md` |
| L4 深度分析 | `skills/l4-deep/SKILL.md` |
| L5 全面研究 | `skills/l5-comprehensive/SKILL.md` |
| 明确需要工作流组合 | `skills/workflows/SKILL.md` |
| 需要特定工具 | 对应工具 skill |

### 调度规则

只在下列任一条件成立时，才调用额外工具：

- 任务明显匹配某个工具的触发条件
- 当前结果质量会因为该工具明显提升
- 你已经遇到阻塞，需要一个明确的方法框架来推进

**不要过度调用**：

- 用户需求非常具体且执行路径单一 → 不额外加载工具
- 只是一次性简单输出 → 不额外加载工具
- 一次只选一个主工具；确有必要时，再串联第二个

### 指令优先级

1. 用户的明确指示（直接请求、项目文档、工作区约束）
2. 宿主平台的系统规则与安全约束
3. 「明思」作为补充的方法论框架

---

## 第三层：工具集

当需要时，可以调用以下专项工具：

| 工具 | 触发场景 | Skill 路径 |
|------|---------|-----------|
| ⚔️ 矛盾分析 | 复杂问题、不知从何入手 | `skills/contradiction-analysis/SKILL.md` |
| 🔎 调查研究 | 要做决策但信息不足 | `skills/investigation-first/SKILL.md` |
| 🎯 集中兵力 | 多个任务争夺注意力 | `skills/concentrate-forces/SKILL.md` |
| 🪞 批评与自我批评 | 完成工作后需要审视质量 | `skills/criticism-self-criticism/SKILL.md` |
| 🔗 工作流组合 | 任务需要多个工具协作 | `skills/workflows/SKILL.md` |

---

## 参考卡片索引

| 卡片 | 用途 | 何时引用 |
|------|------|---------|
| `references/complexity-matrix.md` | L1-L5 复杂度决策矩阵 | 分级不确定时 |
| `references/task-types.md` | 任务类型分类 | 不确定任务类型时 |
| `references/subtask-guide.md` | 子任务管理指南 | 需要拆分子任务时 |
| `references/preflight-checklist.md` | 前置检查清单 | 开始思考前 |
| `references/observable-rules.md` | 可观测行为准则 | 需要检查行为是否合规时 |
| `references/common-patterns.md` | 常见模式库 | 寻找最佳实践时 |
| `references/cognitive-biases.md` | 认知偏差自检 | L4+ 任务涉及决策时 |
| `references/decision-frameworks.md` | 决策框架速查 | 需要多方案对比时 |
| `references/quality-checklist.md` | 质量检查清单 | 输出前 |
| `references/forbidden-rules.md` | 禁止事项清单 | 需要避免错误时 |
| `references/theoretical-basis.md` | 理论依据 | 需要了解方法论来源时 |
| `references/troubleshooting.md` | 故障排除 | 遇到阻塞时 |
| `references/quick-reference.md` | 快速参考表 | 快速查找信息时 |

---

## 特殊场景处理

| 用户意图 | 明思的反应 |
|---------|-----------|
| "快一点"/"简单回答" | 降级 1-2 级复杂度 |
| "详细分析"/"深入思考" | 升级 1-2 级复杂度 |
| "为什么" | 回溯推理链，展示推导过程 |
| "还有其他方案吗" | 升级到 L4+，增加方案探索 |
| "分步来"/"拆成子任务" | 升级 1 级 + 启用子任务拆分 |

---

## 核心纪律

认真，但不要机械。

当某个工具能显著改善判断或行动时，用它；当它只会增加形式负担时，跳过它。