HughYau/qiushi-skill

Qiushi-Skill: Build agents that investigate first, focus on the main contradiction, validate in practice, and keep pushing until the work is actually done. 求是Skill——从经典唯物辩证法与实践哲学中提炼出一条总原则和九大方法论工具武装AI大脑。

什么是 Qiushi‑Skill？

Qiushi‑Skill 是一个 AI代理的“技能”（插件模块）库。它将马克思主义-列宁主义哲学中的九种经典方法论工具（矛盾分析、实践认识、调查研究、群众路线、批评与自我批评、持久战略、集中兵力、星火燎原、统筹兼顾）打包，并提供为即用型、自包含的技能定义，可注入到对话式代理运行时（如 Claude Code、Cursor、Codex 等）中。

每个技能包含：

一个简短的 触发规则（何时应使用该技能）
一个 操作指南（代理应执行的逐步操作）
一个 输出模板（代理返回的结构化结果）
硬性约束（必须遵守的纪律规则）
一个 交接规范（下一步该做什么）

该库还附带参考文本（原始著作中的引文）、子代理（如“调查者”生成事实/猜测/未知报告），以及可将多个技能串联的工作流定义。

为何存在

作者认为，许多当前的 AI 代理虽然能“思考”，但不会“思考如何思考”：它们会跳到答案、忽视证据，并在问题困难时放弃。通过赋予代理一种有纪律、以证据为先的方法论，Qiushi‑Skill 旨在使其：

以事实为驱动 – 结论必须基于已验证的证据。
自我批判 – 定期进行检查和批评循环。
具有战略思维 – 为任务选择合适的“武器”（技能）并集中资源。

如何获取

1️⃣ 一行安装（推荐）

npx qiushi-skill

CLI 会检测宿主代理（Claude Code、Cursor 等），将适当的技能文件写入宿主的插件目录，并注册入口技能（arming‑thought）。

你也可以指定特定宿主或作用域，例如：

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

2️⃣ Claude Code 市场

通过内置市场命令添加插件：

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

若没有 Node.js，只需将 skills/ 文件夹复制到宿主的技能目录中即可。

使用技能

安装后，“武装思想”（Arming Thought） 内核会在每个会话开始时自动加载（约 50 行持久代码）。它强制执行顶层原则 实事求是（从实际出发寻求真理），并根据当前上下文判断是否调用九种方法论技能中的任意一种。

手动斜杠命令（如果宿主支持 Markdown 斜杠命令）

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

每个命令会打开对应的 SKILL.md（或运行子代理），并返回结构化结果，供主代理消费。

项目结构（概览）

qiushi-skill/
├─ .claude-plugin/   # Claude Code 市场元数据
├─ .cursor-plugin/   # Cursor 插件元数据
├─ bin/qiushi-skill.mjs   # CLI 入口点
├─ commands/          # Markdown 斜杠命令文件
├─ hooks/             # 会话启动注入脚本（POSIX, PowerShell, CMD）
├─ agents/            # 子代理（调查者、自我批评者）
├─ skills/            # 每个方法论技能一个文件夹 + 入口内核
│   ├─ arming-thought/   # 入口内核（实事求是 + 路由）
│   ├─ contradiction-analysis/
│   ├─ practice-cognition/
│   └─ …（其他7个技能）…
│   └─ workflows/        # 跨技能工作流定义
├─ tests/             # 所有平台的验证脚本
├─ docs/              # 静态网站和平台特定安装指南
└─ package.json

谁会用它？

开发定制 AI 助手的开发者（Claude Code、Cursor、Codex 等），希望内置一个哲学基础明确的决策层。
实验代理提示的科研人员，需要可复现、结构化的推理模式。
希望在任何 LLM 驱动的自动化中强制执行证据优先、自我批判工作流的团队。

许可与社区

MIT 许可证 – 可自由使用、修改和重新分发。
讨论、示例和第三方集成列在 README 中（例如，“零基础 AI” 书籍、“Ralph Qiushi” 工作流、用户提交的案例研究）。
作者还维护 AcademicForge，一个用于跨平台安装多个代理技能的元工具。

TL;DR

Qiushi‑Skill 是一个通过小型 Node 基础 CLI 或市场入口提供的九种有纪律推理“技能”即插即用集合。它为代理提供以事实为先、自我批判的工作流，使其更擅长应对复杂、多步骤的问题。