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エージェント向けの「スキル」（プラグインモジュール）のライブラリ です。マルクス・レーニン主義哲学から導かれた9つの古典的手法（矛盾分析、実践認識、調査研究、群衆路線、批判と自己批判、持久戦略、兵力集中、星火燎原、統籌兼顧）をパッケージ化し、Claude Code、Cursor、Codexなど、会話型エージェントランタイムに即座に組み込める、自己完結型のスキル定義として提供します。

各スキルには以下の要素が含まれます：

短い トリガー規則（どの状況でスキルを使用すべきか）
操作ガイド（エージェントが実行すべきステップバイステップの行動）
出力テンプレート（エージェントが返す構造化された結果）
ハード制約（守らなければならない規律ルール）
ハンドオフ仕様（次に何を行うか）

このライブラリには、参照テキスト（元典からの引用）、サブエージェント（例：事実／推測／未知を報告する「調査者」）、複数のスキルを連鎖させるためのワークフロー定義も同梱されています。

なぜこのプロジェクトが存在するのか

著者は、現在の多くのAIエージェントは「思考」できるが、「思考の仕方」について考えないという点に問題があると主張しています。答えに飛びついたり、証拠を無視したり、問題が難しくなると諦めてしまう傾向があるのです。Qiushi‑Skillは、エージェントに体系的で証拠第一のアプローチを提供することで、以下の点を実現することを目指しています：

事実主導 – 結論は検証済みの証拠に基づくべき。
自己批判 – 定期的なチェックと批判のループを実施。
戦略的 – タスクに適した「武器」（スキル）を選択し、リソースを集中。

インストール方法

1️⃣ 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 Marketplace

組み込みのマーケットプレイスコマンドでプラグインを追加します：

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

Node.jsが利用できない場合、単に skills/ フォルダをホストのスキルディレクトリにコピーするだけでOKです。

スキルの使い方

インストール後、「武装思想」（Arming Thought） カーネルがセッション開始時に自動的に読み込まれます（約50行の永続コード）。このカーネルはトップレベルの原則 实事求是（事実に基づいて真実を求める）を強制し、現在の文脈に基づいて、9つの方法論スキルのいずれかを呼び出すかどうかを判断します。

マークダウンスラッシュコマンドに対応している場合（手動コマンド）

コマンド	スキル
`/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/            # 1つの方法論スキルごとに1フォルダ + エントリカーネル
│   ├─ 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またはマーケットプレイスエントリを通じて提供される、AIエージェント向けの9つの体系的推論「スキル」の即時利用可能なコレクションです。事実第一、自己批判的なワークフローをエージェントに与え、複雑で多段階の問題に優れた対処能力をもたらします。