用途:将 Chief 框架安装进当前项目。属于惰性安装,安装时只放置子代理定义与 AGENTS.md,.chief/(project.md、里程碑、规则)由 chief-agent 在运行时按需创建。
主要能力与安装内容:克隆仓库后执行 setup.sh,安装 .agents/agents/*.md(chief、builder、tester、answer-verifier 等子代理)、AGENTS.md(不存在则新建,已存在则追加在 <!-- chief-framework:begin --> 块中),以及 claude-code / copilot 的集成文件(.claude/agents/、.github/agents/)。不会创建 .chief/。
参数:第一个参数为目标版本,可选。无参数则装最新稳定版;canary 为开发分支;v1.0.0 等为具体标签。
使用方式:先检查是否已安装(.agents/agents/chief-agent.md 是否存在、AGENTS.md 是否含 Chief 或 chief-agent),已装则建议改用升级(npx skills@latest add thaitype/chief --skill chief-upgrade 或 /chief-upgrade)。随后询问使用的编码代理(claude-code、opencode、codex、cursor、copilot、gemini-cli、amp、windsurf、kiro、aider)与安装模式(link 或 copy;Windows 上 link 需开发者模式并执行 git config --global core.symlinks true)。接着执行: git clone --depth 1 --branch <version> https://github.com/thaitype/chief.git .chief-agent-tmp bash .chief-agent-tmp/scripts/setup.sh --agent <agent> --mode <mode> 脚本失败时可手动安装,最后验证文件、清理 .chief-agent-tmp,并提示运行 /chief-init 引导项目上下文,随后可 /chief-plan 开始规划。
限制与规则:不得在未经用户确认时覆盖已有文件;AGENTS.md 已存在时只追加块;已安装应建议升级而非重装;始终清理临时目录;不为新项目安装 review-plan-agent;缺模型名等信息时需向用户询问,claude-code 自动用 opus 与 sonnet;未提供的信息暂未说明。