qiushi-skill README

The project's README from github.com/HughYau/qiushi-skill. As one markdown file: README.md.

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

语言: 简体中文 | English

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

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

HughYau%2Fqiushi-skill | Trendshift HughYau%2Fqiushi-skill | Trendshift HughYau%2Fqiushi-skill | Trendshift

先看介绍页


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

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

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

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

🔍 为什么需要这个?

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

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

欢迎支持作者的其他项目!:AcademicForge:One Forge, All Skills. 一键生成安装多个 AI Agent Skills 的跨平台命令。

❌ 这不是什么

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

🏗️ 方法结构

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

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

☀️ 总原则 —— 约束全部判断过程

⚙️ 第一层·哲学基座 —— 分析任何问题的底层框架

🛠️ 第二层·工作方法 —— 日常工作的基本方法

🎖️ 第三层·战略战术 —— 面对具体任务的行动指导

🗡️ 九大思想武器

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

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

📋 展示示例

这里收集了大家在使用求是 Skill 过程中的真实案例。欢迎在 Discussions 中分享你使用经验帮助项目改进!

📦 安装

两条路,够用了。

方式一:npx qiushi-skill(推荐,所有平台)

npx qiushi-skill

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

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。没有 Node.js 的话,把 skills/ 下的目录复制到宿主的 skills 目录即可。

方式二:Claude Code 官方 Marketplace

/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                🔗  工作流组合

安装验证

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,在独立上下文中执行方法论:

🗺️ Reference Guides
按需查阅的参考工具,由对应 SKILL.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

💡 灵感来源

📝 原著引用说明

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

Star History

Star History Chart

⚖️ 许可证

MIT License


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

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

qiushi-skill (HughYau/qiushi-skill)

Searching Database…

What is this?Qiushi-Skill is a collection of AI Agent Skills that distills one core principle (seeking truth from facts) and nine methodology tools from classical dialectical materialism and practical philosophy, aimed at making AI agents investigate first, focus on the main contradiction, validate through practice, and keep pushing until a task is actually finished.
Is this a standalone agent or a set of skill files I load into my existing AI?It is a set of skill specs plugged into a host agent: each methodology skill keeps only five sections (when to use / not use, procedure, output template, discipline, handoff) so it stays small enough to inject into a session rather than running as its own program.
How do I install the skills into my coding agent?Run `npx qiushi-skill`, which interactively detects installed agent hosts and writes the skill files into the right directory (per-platform target directories are listed in docs/platforms.md); it is also published on the Claude Code Marketplace.
Do I need Node.js to install this?The recommended `npx qiushi-skill` installer needs Node.js >=18.17; if you don't have Node, you can skip it entirely and just copy the skills/ folders straight into your host's skills directory.
Will every method fire on every request?No - the host AI judges per-scenario whether a given methodology tool is worth invoking; tasks that are straightforward execution don't trigger any downstream skill, and if the host already has an equivalent workflow, the host's own process takes precedence.
What are the nine methodology tools included?Contradiction analysis, practice-based epistemology, investigation and research, the mass line, criticism and self-criticism, protracted strategy, concentration of forces, igniting-prairie-fires (incremental base-building), and holistic coordination - each sourced from a specific classic text like 'On Contradiction' or 'On Protracted War'.
Does the project include dispatchable subagents?Yes - agents/investigator.md is a read-only researcher that produces a fact / inference / unknown report, and agents/self-critic.md reviews finished work with fresh eyes, judging only the artifact and not the author's explanation.
Is this project a political statement?The author explicitly frames it as methodology research, not politics or propaganda: all quotes are cited from public works purely for practical method extraction, with no political stance or reinterpretation intended.
How is this different from giving the AI a historical persona?The author rejects persona simulation entirely, arguing LLMs shouldn't impersonate historical figures; the skills only package proven methods as reusable cognitive tools, not character role-play.
Creator
HughYau
Size
3.8 MB
Stars
3.8K
Updated
CommitOct 01
Age
6mo
Commits · 90 Days