qiushi-skill 教程：安装前先看 hook 写了什么
qiushi-skill 把调查研究、矛盾分析、实践验证、优先级和复盘方法写成可被 agent 读取的 skills。一个约 50 行的 arming-thought 入口会在会话开始时注入，再按任务决定是否加载九个下游方法和四种组合 workflow。
1. 仓库里会装进哪些内容
skills/ 保存入口和九个方法论目录；commands/ 提供手动命令；hooks/ 负责会话注入；agents/ 包含只读调查员 investigator 和独立审查员 self-critic。部分 skill 另有 original-texts.md 和检查表，这些资料按需读取。
安装器支持 Claude Code、Cursor、Codex、OpenCode、OpenClaw、Hermes 和 Nanobot。它需要向宿主的 skills、commands 或 hooks 目录写文件。用户级 scope 会影响该账号下的多个项目，项目级 scope 更便于先做小范围验证。
2. 先审查，再安装到单一宿主
先阅读官方仓库中的 bin/、skills/ 和 hooks/。确认目标目录后，只选一个测试宿主：
npx qiushi-skill install --target codex --scope user npx qiushi-skill validate
若不想运行 npm 安装器，可以按官方 platforms 文档手工复制 skills/。手工路径仍要核对宿主识别的目录名、文件权限和旧版本。
3. 验证入口有没有过度触发
新开一个会话，用三类任务测试：简单的格式转换、需要事实调查的问题、需要复盘的长任务。简单任务应避免加载全部下游方法；调查任务应区分事实、推断与未知；交付前再调用 self-critic 检查制品。
效果不能只凭主观感受。可以准备固定任务集，记录安装前后的答案正确率、工具调用次数、上下文长度和完成时间。若 token 增长明显而质量没有改善，就收紧入口条件或仅手动调用命令。
4. 冲突与卸载
同一宿主若同时存在用户级和项目级副本，可能重复注入或出现版本不一致。先运行 validate，再直接查看目标目录。需要回退时执行：
npx qiushi-skill uninstall --target codex
卸载后新开会话验证 hook 已消失。旧会话可能保留先前上下文，不能用它判断卸载是否生效。
5. 与 Anthropic skills 对比
Anthropic skills提供通用技能规范、示例和文档、表格等具体任务 skill。qiushi-skill 集中处理调查、矛盾、实践、优先级和复盘，并用入口 kernel 做路由。需要标准示例和具体产物能力时先看 Anthropic skills；需要一套固定分析步骤时再评估 qiushi-skill。二者一起用时要检查命令名、hook 和上下文重复。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合需要先调查再下结论、为长任务设置阶段检查、在交付前加入独立批评，或用固定 workflow 组合多种分析方法的 agent 用户。单步格式转换、明确的小修复和已有严格流程的任务可能不需要入口 kernel 和下游方法。
采用建议
适合需要先调查再下结论、为长任务设置阶段检查、在交付前加入独立批评，或用固定 workflow 组合多种分析方法的 agent 用户。单步格式转换、明确的小修复和已有严格流程的任务可能不需要入口 kernel 和下游方法。采用前需要核对：方法论指令不能保证模型遵守或结果正确。
原教程未展开的系统信息
核心功能
九个方法论 skill
仓库包含矛盾分析、实践认识、调查研究、群众路线、批评与自我批评、持久战略、集中兵力、星火燎原和统筹兼顾九个方法目录。
技术栈和运行条件
语言
Markdown 指令与 JavaScript 安装器
框架
Agent Skills 目录约定、各宿主插件或命令入口
关键依赖
- Node.js >=18.17（npx 路径）
- Claude Code、Cursor、Codex、OpenCode、OpenClaw、Hermes 或 Nanobot 之一
- 无 Node.js 时可手工复制 skills 目录
运行环境
没有项目后端；安装器写入用户级或项目级 skills、commands、hooks 等目录，实际模型请求仍由宿主 agent 处理
常见问题
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 和上下文占用。