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 或市場入口提供的九種有紀律推理「技能」即插即用集合。它為代理提供以事實為先、自我批判的工作流，使其更擅長應對複雜、多步驟的問題。