入门

这一部分面向系统使用者与项目拥有者，优先解决“怎么装、安装后怎么调用、怎么选 workflow、什么时候需要 runtime check”。

推荐阅读顺序

1. 快速开始
2. 安装
3. 使用 Agent Skills
4. 任务场景
5. 多 Agent 运行指南
6. CLI 参考
7. 故障排除

内容说明

• 快速开始：最小安装入口、首个工作区、paper route 和质量门上下文。
• 安装：原生 plugin、bootstrap、npm、pipx 等安装面。
• 使用 Agent Skills：安装后在 Codex、Claude Code、Antigravity、Hermes 和 shell 中该如何调用。
• 任务场景：按“我要做什么”来选 stages、Task IDs 和 skills。
• 多 Agent 运行指南：解释 runtime routing、本地 agent execution 和认证规则。
• 示例：按 systematic-review、empirical、qualitative、methods、theory 查看标准推荐路线。
• 升级：npm asset refresh、完整运行时 package update、无 Python bootstrap、Python CLI 升级、长期 clone 维护。
• 故障排除：统一错误码与定位建议。

什么时候离开这一部分

• 如果你要理解系统分层或契约关系，转到 系统架构 或 规范约定。
• 如果你要配置 MCP / Zotero / 外部 Provider，转到 高级文档。
• 如果你要修改系统本身，转到 维护者文档。

更新边界

• 在 npm/npx 下，用 qiongli update 或 qiongli refresh 从当前 package 重新应用 assets。
• 在 npm/npx 下，用 qiongli upgrade 从当前 package 执行覆盖式 asset refresh。
• 完整运行时的 package self-update，包括 qiongli self-update，需要先安装 Python 完整运行时：pipx install qiongli。