qiushi-skill 是什么?

qiushi-skill 是一套面向 AI agent 的方法论 skills。它用一个常驻入口把事实核对、矛盾分析、调查研究、实践验证、优先级和自我批评等方法路由到九个独立 skill,并提供四种组合 workflow。

⭐ 3,182 Stars 🍴 237 Forks JavaScript MIT 作者: HughYau
来源:github.com/HughYau/qiushi-skill 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方仓库仍在 2026 年 9 月维护,package.json 已到 2.0.0,也没有充值、订阅、转售或付费安装漏斗,因此保留并优先改造。

来源:github.com/HughYau/qiushi-skill

核心功能

入口 kernel 与按需路由

会话开始时注入约 50 行的 arming-thought 入口,先区分事实、推断和未知,再按任务选择下游 skill,简单执行任务不必全部调用。

来源:github.com/HughYau/qiushi-skill
九个方法论 skill

仓库包含矛盾分析、实践认识、调查研究、群众路线、批评与自我批评、持久战略、集中兵力、星火燎原和统筹兼顾九个方法目录。

来源:github.com/HughYau/qiushi-skill
命令、workflow 与子代理

commands 提供手动入口,workflows 组合多个方法;investigator 和 self-critic 分别负责只读调查与独立审查。

来源:github.com/HughYau/qiushi-skill
多宿主安装和校验

npm CLI 可检测 Claude Code、Cursor、Codex、OpenCode、OpenClaw、Hermes 和 Nanobot,并提供 install、uninstall、validate 命令。

来源:github.com/HughYau/qiushi-skill

技术架构

bin/qiushi-skill.mjs 负责检测宿主、把内容写入目标目录并执行校验。skills/ 保存入口和九个方法论的 SKILL.md,部分目录另有原文及参考文件;commands/ 提供手动命令,hooks/ 负责会话注入,agents/ 放 investigator 与 self-critic,workflows/SKILL.md 定义跨 skill 组合。运行时主要依赖宿主 agent 读取 Markdown 指令,没有独立后端服务。

来源:github.com/HughYau/qiushi-skill

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Node.js >=18.17(npx 路径)Node.js >=18.1… Claude Code、Cursor、Codex、OpenCode、OpenClaw、Hermes 或 Nanobot 之一Claude Code、C… 无 Node.js 时可手工复制 skills 目录无 Node.js 时可… 入口 kernel 与按需路由 九个方法论 skill 命令、workflow 与子代理命令、workflow 与子… 多宿主安装和校验 qiushi-skill 项目本体 核心功能 关键依赖

技术栈

语言Markdown 指令与 JavaScript 安装器框架Agent Skills 目录约定、各宿主插件或命令入口
Node.js >=18.17(npx 路径)Claude Code、Cursor、Codex、OpenCode、Op…无 Node.js 时可手工复制 skills 目录
没有项目后端;安装器写入用户级或项目级 skills、commands、hooks 等目录,实际模型请求仍由宿主 agent 处理
来源:github.com/HughYau/qiushi-skill/blob/main/package.json

快速上手

先检查仓库中的 skills、hooks 和 bin 安装逻辑,再用 npx qiushi-skill install --target codex --scope user 安装到单一测试宿主。执行 npx qiushi-skill validate 核对目录和版本,开新会话确认 arming-thought 注入;若出现重复路由或上下文过长,先卸载用户级副本,再改用项目级手动复制。
来源:github.com/HughYau/qiushi-skill

使用场景

适合需要先调查再下结论、为长任务设置阶段检查、在交付前加入独立批评,或用固定 workflow 组合多种分析方法的 agent 用户。单步格式转换、明确的小修复和已有严格流程的任务可能不需要入口 kernel 和下游方法。

来源:github.com/HughYau/qiushi-skill

优势与局限

优势

  • 触发边界、操作规程、输出模板和交接写在各 skill 内
  • 提供原文、参考表、只读调查员与独立审查员
  • 安装器覆盖多个宿主并有 validate 与 uninstall
  • MIT 许可且没有外部服务依赖

局限

  • 方法论指令不能保证模型遵守或结果正确
  • 会话注入和多个 skill 会占用上下文
  • 用户级安装会影响多个项目,版本冲突时需清理旧副本
  • hooks 和指令会影响 agent 行为,安装前应人工审查
  • 仓库没有 GitHub Releases,版本信息要同时核对 package.json 和 CHANGELOG
来源:github.com/HughYau/qiushi-skill

最新版本

截至 2026-09-23,仓库没有 GitHub Release;package.json 版本为 2.0.0,要求 Node.js >=18.17。GitHub API 显示 main 最近推送于 2026-09-06,因此版本表述应引用 package.json,不能写成已发布 GitHub release。

来源:github.com/HughYau/qiushi-skill/blob/main/package.json

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、package.json、CHANGELOG、skills/、commands/、hooks/ 和 GitHub Releases API  |  limitations: 未执行 npx,未写入任何宿主目录,未触发 Session hook,也未在真实任务中比较安装前后的输出质量  |  observed_output: package.json 当前版本为 2.0.0,Node.js 下限是 18.17;GitHub 没有正式 Release;官方 README 给出 npx 安装、卸载和 validate 命令

来源:github.com/HughYau/qiushi-skill/blob/main/package.json

同类项目对比

Anthropic 的 skills 仓库提供通用技能规范、示例和文档/表格等专业 skill,内容更偏任务能力与参考模板;qiushi-skill 聚焦一套分析与执行方法,并用入口 kernel、九个方法和 workflow 串联。需要标准示例和具体产物能力可先看 Anthropic skills;需要固定调查、取舍和复盘步骤时可评估 qiushi-skill。

来源:github.com/anthropics/skills

总结评价

适合需要先调查再下结论、为长任务设置阶段检查、在交付前加入独立批评,或用固定 workflow 组合多种分析方法的 agent 用户。单步格式转换、明确的小修复和已有严格流程的任务可能不需要入口 kernel 和下游方法。采用前需要核对:方法论指令不能保证模型遵守或结果正确。

来源:github.com/HughYau/qiushi-skill

常见问题

qiushi-skill 2.0.0 有 GitHub Release 吗?

没有。官方仓库当前没有正式 GitHub Release,2.0.0 来自 package.json;安装前还应核对 CHANGELOG、npm 包版本和目标 commit。

qiushi-skill 为什么会在每次会话注入内容?

arming-thought 作为约 50 行的入口 kernel,用来先约束事实判断,再按任务决定是否加载下游 skill。它会占用部分上下文,简单任务可避免继续调用其他方法。

qiushi-skill 安装后如何确认目录没有写错?

运行 npx qiushi-skill validate,并检查目标宿主的实际 skills、commands 和 hooks 目录。若同时有用户级和项目级副本,应删除旧版本,避免重复注入或版本不一致。

qiushi-skill 的 original-texts 会自动全部进入上下文吗?

不会。官方说明原文文件供按需查阅,各 skill 的常驻内容只保留触发边界、操作规程、输出模板、纪律和交接等部分。

qiushi-skill 和 Anthropic skills 怎样选?

qiushi-skill 集中处理调查、矛盾、实践、优先级和复盘方法;Anthropic skills 提供更通用的规范与具体任务示例。二者可以并存,但应检查同名命令、重复 hook 和上下文占用。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件