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…

这是什么?Qiushi-Skill 是一套 AI 智能体技能集,从经典辩证唯物主义和实践哲学中提炼出一条核心原则(实事求是)和九个方法论工具,目的是让 AI 智能体先做调查、抓住主要矛盾、通过实践检验,并持续推进直到任务真正完成。
这是一个独立的智能体,还是加载到我现有 AI 里的一组技能文件?它是一组插入宿主智能体的技能规范:每个方法论技能只保留五个部分(何时用/不用、流程、输出模板、纪律、交接),因此体量足够小,可以注入会话,而不是作为独立程序运行。
怎么把这些技能安装到我的编程智能体里?运行 `npx qiushi-skill`,它会交互式检测已安装的智能体宿主并把技能文件写入正确的目录(各平台的目标目录列在 docs/platforms.md 中);它也发布在 Claude Code Marketplace 上。
安装它需要 Node.js 吗?推荐的 `npx qiushi-skill` 安装器需要 Node.js >=18.17;如果没有 Node,可以完全跳过它,直接把 skills/ 文件夹复制到宿主的技能目录里。
每个方法都会在每次请求时触发吗?不会——宿主 AI 会根据具体场景判断某个方法论工具是否值得调用;单纯执行类的任务不会触发任何下游技能,而且如果宿主已有等效的工作流,则以宿主自身的流程优先。
包含的九个方法论工具是什么?矛盾分析、实践认识论、调查研究、群众路线、批评与自我批评、持久战略、集中力量、星火燎原(渐进式根据地建设)和全局统筹——每一项都出自特定的经典文本,如《矛盾论》或《论持久战》。
项目里包含可调度的子智能体吗?有——agents/investigator.md 是一个只读的研究者,产出「事实/推断/未知」报告;agents/self-critic.md 则以全新视角审查已完成的工作,只评判成果本身,而不听作者的解释。
这个项目是政治表态吗?作者明确将其定位为方法论研究,而非政治或宣传:所有引文均出自公开著作,纯粹用于提炼实用方法,不带有政治立场或重新阐释的意图。
这和让 AI 扮演历史人物有什么不同?作者完全反对人设模拟,认为 LLM 不应该冒充历史人物;这些技能只是把经过验证的方法打包成可复用的认知工具,而不是角色扮演。
Creator
HughYau
Size
3.8 MB
Stars
3.8K
Updated
CommitOct 01
Age
6mo
Commits · 90 Days