<p align="center">
  <img src="https://raw.githubusercontent.com/HughYau/qiushi-skill/main/assets/logo_main.png" width="400"/>
</p>

# 🔴 求是 Skill —— 武装 AI 的大脑

<p align="center">
  <strong>语言</strong>：
  <a href="./README.md">简体中文</a> |
  <a href="./README.en.md">English</a>
</p>

> 🌟 "我们的同志在困难的时候，要看到成绩，要看到光明，要提高我们的勇气。"

> ✊ "世界上怕就怕'认真'二字。"


<p align="center">
  <a href="https://trendshift.io/repositories/25395?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-25395" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/25395/daily?language=JavaScript" alt="HughYau%2Fqiushi-skill | Trendshift" width="250" height="55"/></a>
  <a href="https://trendshift.io/repositories/25395?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-25395" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/25395/daily" alt="HughYau%2Fqiushi-skill | Trendshift" width="250" height="55"/></a>
  <a href="https://trendshift.io/repositories/25395?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-25395" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/25395/weekly?language=JavaScript" alt="HughYau%2Fqiushi-skill | Trendshift" width="250" height="55"/></a>
</p>

<p align="center">
<a href="https://hughyau.com/qiushi-skill/">
    <img src="https://img.shields.io/badge/%E5%85%88%E7%9C%8B%E4%BB%8B%E7%BB%8D%E9%A1%B5-%E6%9B%B4%E7%9B%B4%E8%A7%82%E5%9C%B0%E7%90%86%E8%A7%A3%E6%B1%82%E6%98%AF%20-8b1a1a?style=for-the-badge&labelColor=f5efe6&color=8b1a1a" alt="先看介绍页">
  </a>
</p>


---

**你的 AI 不应该是一个唯唯诺诺的工具。它应该是一个先看事实、再下判断的行动者。**

「求是 Skill」是一个 AI Agent Skills 合集，从经典唯物辩证法与实践哲学中提炼出一条总原则和九大方法论工具，系统性地武装 AI 的大脑。不是口号，不是鸡汤，而是可操作的方法论集合。

每一条方法都有据可依、有迹可循，直接引用经典著作原文（详见各 skill 目录下的 `original-texts.md`）。

>  "让人讲话，天不会塌下来。"

## 🔍 为什么需要这个？

当前的 AI Agent 有一个根本问题：**它们会思考，但不会"想问题"。**

- 🌀 面对复杂问题，胡子眉毛一把抓，抓不住重点
- 🗣️ 没有调查就急于给出答案，犯教条主义的错误
- 😴 方案做完不自查，"差不多就行了"
- 🏳️ 遇到困难就说"这超出了我的能力"，缺乏持续推进的能力
- 🎯 同时做十件事，件件做不好，不懂集中兵力

教员思想中的方法论——矛盾分析、实践认识论、调查研究、群众路线、批评与自我批评、持久战略——恰恰解决的就是"怎么想问题、怎么做事情"这个根本问题。

> 欢迎支持作者的其他项目！：**[AcademicForge](https://github.com/HughYau/AcademicForge)**：**One Forge, All Skills.** 一键生成安装多个 AI Agent Skills 的跨平台命令。
> 
## ❌ 这不是什么

- 🚫 **这不是 Politics或者Propaganda。** 这是 Methodology。经典唯物辩证法与实践哲学方法论可以用于指导任何需要分析问题和解决问题的场景。
- 🧭 **这不是人格蒸馏。** 该项目发布于3月25日，彼时尚无“人格蒸馏”这一概念。作者认为，以skills本身的形式限制，除了作为知识库和工作流的载体，大模型目前不能够、也不应被用来模拟人物人格，任何此类尝试都不可避免地流于失真。


*本项目仅提炼经实践检验的方法论，将其转化为可执行的认知工具，以实现取法其上、用之于今，以期借前人之光，照当下之路。*


## 🏗️ 方法结构

```mermaid
graph TD
    A[精神底色<br/>精益求精 · 坚持到底]
    B[总原则<br/>实事求是]
    C[第一层：哲学基座<br/>矛盾分析法 · 实践认识论]
    D[第二层：工作方法<br/>调查研究 · 群众路线 · 批评与自我批评]
    E[第三层：战略战术<br/>持久战略 · 集中兵力 · 星火燎原 · 统筹兼顾]

    A --> B --> C --> D --> E
```

☀️ **总原则** —— 约束全部判断过程
- **实事求是**：从客观存在着的实际事物出发，让事实规定判断，让现实修正理论。它不是第十件思想武器，而是全部思想武器共同服从的认识论准绳。

⚙️ **第一层·哲学基座** —— 分析任何问题的底层框架
- **⚔️ 矛盾分析法**：识别矛盾、抓住主要矛盾、区分矛盾性质。"捉住了这个主要矛盾，一切问题就迎刃而解了。"
- **🔄 实践认识论**：实践→认识→再实践，螺旋上升。"实践是检验真理的唯一标准。"

🛠️ **第二层·工作方法** —— 日常工作的基本方法
- **🔎 调查研究**：没有调查就没有发言权。"调查就像'十月怀胎'，解决问题就像'一朝分娩'。"
- **👥 群众路线**：从群众中来，到群众中去。收集→系统化→返回→验证→再收集。
- **🪞 批评与自我批评**：惩前毖后，治病救人。"房子是应该经常打扫的。"

🎖️ **第三层·战略战术** —— 面对具体任务的行动指导
- **⏳ 持久战略**：战略上藐视，战术上重视。不急于求成，也不畏难放弃。
- **🎯 集中兵力**：伤其十指不如断其一指。不打无准备之仗。
- **🔥 星火燎原**：建立根据地，不做流寇。从小处着手，积累发展。
- **⚖️ 统筹兼顾**：调动一切积极因素。拒绝片面性，寻找动态平衡。

## 🗡️ 九大思想武器

| 思想武器 | 核心要义 | 原著出处 | 适用场景 |
|---------|---------|---------|---------|
| ⚔️ 矛盾分析法 | 抓主要矛盾 | 《矛盾论》 | 复杂问题分析 |
| 🔄 实践认识论 | 实践→认识→再实践 | 《实践论》 | 方案验证与迭代 |
| 🔎 调查研究 | 没有调查就没有发言权 | 《反对本本主义》 | 决策前的信息收集 |
| 👥 群众路线 | 从群众中来到群众中去 | 《关于领导方法的若干问题》 | 反馈整合与方案验证 |
| 🪞 批评与自我批评 | 惩前毖后治病救人 | 《论联合政府》 | 工作审视与质量改进 |
| ⏳ 持久战略 | 战略上藐视战术上重视 | 《论持久战》 | 长期复杂任务规划 |
| 🎯 集中兵力 | 集中优势兵力各个歼灭 | 《中国革命战争的战略问题》 | 优先级决策与资源聚焦 |
| 🔥 星火燎原 | 建立根据地不做流寇 | 《星星之火，可以燎原》 | 从零开始的发展策略 |
| ⚖️ 统筹兼顾 | 调动一切积极因素 | 《论十大关系》 | 多目标平衡与权衡 |

> 另有 `/workflows` 🔗 工作流组合作为跨 skill 编排层，定义多种方法串联时的调用顺序与数据传递规范。

## 📋 展示示例

这里收集了大家在使用求是 Skill 过程中的真实案例。欢迎在 [Discussions](https://github.com/HughYau/qiushi-skill/discussions) 中分享你使用经验帮助项目改进！
- 📖 **[用户分享“躺平”问题的矛盾分析法解读](https://github.com/HughYau/qiushi-skill/blob/main/docs/assets/tangping_editorial_perspective.md)**  —— 看skill如何“调查在先”与“具体问题具体分析”来进行实事求是。
- 📖 **[分析外行指导内行问题](https://mp.weixin.qq.com/s/bg5cgSAscy37T4gv9YJG0A)**：展示了如何用求是 Skill 拆解复杂的职场现象。
- 🤖 **[ZZZ 白话讲 AI —— 用“求是方法论”写一本零基础 AI 认知书](https://github.com/mfkyddh/ZZZ-Simple-AI)**：以“求是”方法论组织 AI 入门知识。
- 🛠️ **[Harness Ralph Qiushi](https://github.com/Tiyou-zm/harness-ralph-qiushi)**：结合求是调查研究与矛盾分析法，构建可靠的长线 Agent 交付循环工作流。

## 📦 安装

两条路，够用了。

### 方式一：`npx qiushi-skill`（推荐，所有平台）

```bash
npx qiushi-skill
```

交互式检测已安装的宿主并写入对应目录。也可以直接指定：

```bash
npx qiushi-skill install --target claude-code --scope user
npx qiushi-skill install --target cursor,codex,opencode,openclaw,hermes,nanobot --scope user
npx qiushi-skill uninstall --target claude-code
```

各平台的目标目录与原生入口见 [docs/platforms.md](https://github.com/HughYau/qiushi-skill/blob/main/docs/platforms.md)。没有 Node.js 的话，把 `skills/` 下的目录复制到宿主的 skills 目录即可。

### 方式二：Claude Code 官方 Marketplace

```text
/plugin marketplace add HughYau/qiushi-skill
/plugin install qiushi-skill@qiushi-skill
```

## 🚀 使用方式

安装后，每次会话开始时「武装思想」入口 skill 会自动注入（约 50 行的常驻 kernel），AI 将：

1. ☀️ 先以 `实事求是` 的四条硬规则约束判断：结论跟着证据走、分清事实 / 推断 / 未知、验证过才算完成、遇阻先诊断
2. 🧭 根据场景判断是否值得调用某个思想武器；直接执行类任务不触发任何下游 skill
3. 🛠️ 在明显适用时加载对应 skill，而不是机械全调用；宿主已有等价流程时以宿主为准

每个方法论 skill 只保留五段：**用 / 不用**（触发边界）、**操作规程**（具体动作）、**输出模板**（可观测的制品）、**纪律**（硬约束）、**交接**（下一步通常是谁）。原著引文、场景速查、阶段指标等按需查阅，不占常驻上下文。

### 手动命令入口

仓库现在提供与 skill 对应的 `commands/*.md` 手动命令入口。  
在支持 Markdown slash commands 的助手里，可直接调用这些命令；不支持命令目录的助手，则直接打开同名文件或加载对应 `skills/*/SKILL.md`。

可用命令：

```
/contradiction-analysis   ⚔️  矛盾分析法
/practice-cognition       🔄  实践认识论
/investigation-first      🔎  调查研究
/mass-line                👥  群众路线
/criticism-self-criticism 🪞  批评与自我批评
/protracted-strategy      ⏳  持久战略
/concentrate-forces       🎯  集中兵力
/spark-prairie-fire       🔥  星火燎原
/overall-planning         ⚖️  统筹兼顾
/workflows                🔗  工作流组合
```

### 安装验证

```bash
npx qiushi-skill validate
```

没有 Node.js 时可用 `tests/validate.sh`（macOS / Linux）或 `tests/validate.ps1`（Windows）。

## 📚 支撑文件

除核心 SKILL.md 外，部分 skill 目录下还包含以下支撑文件：

**📜 原著依据（`original-texts.md`）**  
每个方法论 skill 都附有独立的原著引用文件，收录教员选集中的完整原文引用。这些引用不会被 AI 自动加载，但可随时查阅，保证每条方法论都有据可依。

**🤖 Subagents（`agents/`）**  
可派遣、宿主可发现的子 agent，在独立上下文中执行方法论：
- `investigator.md` — 只读调查研究员，产出「事实 / 推断 / 未知」三栏调查报告，主线可并行派遣多个分头调查
- `self-critic.md` — 新鲜上下文审查员，只看制品不看作者叙述，每条批评附证据与改进建议

**🗺️ Reference Guides**  
按需查阅的参考工具，由对应 SKILL.md 在需要时引用：
- `contradiction-types-reference.md` — 矛盾类型速查表
- `review-checklist.md` — 工作审查检查清单
- `phase-assessment-guide.md` — 持久战阶段评估指南

## 🗂️ 项目结构

```
qiushi-skill/
├── .claude-plugin/
│   ├── marketplace.json              # Claude Code 原生 marketplace 入口
│   └── plugin.json                   # Claude Code 插件配置
├── .cursor-plugin/plugin.json        # Cursor 插件配置
├── bin/
│   ├── qiushi-skill.mjs              # npm CLI 主入口
│   └── lib/                          # detect / install / validate 模块
├── commands/                         # 手动 slash commands 入口
├── hooks/                            # Session 注入系统
│   ├── hooks.json
│   ├── session-start                 # POSIX shell 注入脚本
│   ├── session-start.ps1             # Windows PowerShell 注入脚本
│   └── run-hook.cmd                  # Windows 适配
├── agents/
│   ├── investigator.md               # 只读调查研究 subagent
│   └── self-critic.md                # 新鲜上下文审查 subagent
├── skills/
│   ├── arming-thought/SKILL.md       # 入口 kernel：实事求是 + 路由
│   ├── contradiction-analysis/       # SKILL.md + original-texts.md + contradiction-types-reference.md
│   ├── practice-cognition/           # SKILL.md + original-texts.md
│   ├── investigation-first/          # SKILL.md + original-texts.md
│   ├── mass-line/                    # SKILL.md + original-texts.md
│   ├── criticism-self-criticism/     # SKILL.md + original-texts.md + review-checklist.md
│   ├── protracted-strategy/          # SKILL.md + original-texts.md + phase-assessment-guide.md
│   ├── concentrate-forces/           # SKILL.md + original-texts.md
│   ├── spark-prairie-fire/           # SKILL.md + original-texts.md
│   ├── overall-planning/             # SKILL.md + original-texts.md
│   └── workflows/SKILL.md            # 四种跨 skill 组合模式
├── tests/
│   ├── validate.sh                   # macOS/Linux 验证脚本
│   └── validate.ps1                  # Windows 验证脚本
├── docs/
│   ├── index.html                    # 介绍页（GitHub Pages）
│   └── platforms.md                  # 各平台接入说明（唯一一份）
├── package.json
├── CHANGELOG.md
├── LICENSE
├── README.en.md
└── README.md
```

## 💡 灵感来源

- [obra/superpowers](https://github.com/obra/superpowers) —— Agentic skills 框架与软件开发方法论
- 毛选（第一至五卷）—— 本项目的方法论根基

## 📝 原著引用说明

本项目中所有语录和方法论均引自公开出版物。每条引用都标注了原文出处（篇名和年份），力求高度忠实于原著本意。引用目的仅为方法论研究和应用，不涉及政治立场。


## Star History

<a href="https://www.star-history.com/?repos=HughYau%2Fqiushi-skill&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=HughYau/qiushi-skill&type=date&theme=dark&legend=top-left&sealed_token=aj1QNUOtOCFTUi4O6DOfgYltCKt-paOWZoeAIcjLGFUyHTVU-PgQS72JVMsP7SpYY5eZeVildgoVRGJAZE4b8Io54TaA3bEcrh0Yf3BodGgk-vVgAW1Xng" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=HughYau/qiushi-skill&type=date&legend=top-left&sealed_token=aj1QNUOtOCFTUi4O6DOfgYltCKt-paOWZoeAIcjLGFUyHTVU-PgQS72JVMsP7SpYY5eZeVildgoVRGJAZE4b8Io54TaA3bEcrh0Yf3BodGgk-vVgAW1Xng" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=HughYau/qiushi-skill&type=date&legend=top-left&sealed_token=aj1QNUOtOCFTUi4O6DOfgYltCKt-paOWZoeAIcjLGFUyHTVU-PgQS72JVMsP7SpYY5eZeVildgoVRGJAZE4b8Io54TaA3bEcrh0Yf3BodGgk-vVgAW1Xng" />
 </picture>
</a>

## ⚖️ 许可证

MIT License

---

> ✊ "下定决心，不怕牺牲，排除万难，去争取胜利。"

本项目仅为方法论研究与工程应用，所有引用均出自公开出版物，引用目的为学术性方法提炼。项目不涉及任何政治立场、不对原著作政治性再诠释、不代表任何组织或个人观点。如涉侵权或不当使用请联系作者删除。
