SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场install-chief

install-chief

智能体与模型

查看项目

更新于 10-16 04:01

技能介绍

用途

install-chief 用于将 Chief Agent Framework 安装到当前项目中。它以仓库内的 setup.sh 作为主要安装手段，并在脚本失败时提供完整的手动安装回退路径，随后对安装结果进行验证与修复。

主要能力

  • 安装前检测：通过检查 .agents/agents/chief-agent.md 是否存在、.chief/ 目录是否存在、根目录 AGENTS.md 或 CLAUDE.md 内容是否包含关键字 “Chief Agent Framework” 来判断是否已安装。若已安装，会警告并建议改用升级方式，只有用户明确确认后才继续全新安装。
  • 版本选择：第一个参数可指定目标版本（分支或标签），可选。无参数时安装最新稳定版（最高 semver 标签），可通过 git ls-remote --tags https://github.com/thaitype/chief-agent-framework.git 查找；canary 表示最新 canary 分支；也可指定 v1.0.0、v2.0.0 等具体标签。
  • 代理与模式选择：支持 claude-code、opencode、codex、cursor、copilot、gemini-cli、amp、windsurf、kiro、aider。安装模式对 claude-code 与 copilot 有意义，分为 link（推荐，从代理专属目录符号链接到 .agents/）与 copy（复制文件）。Windows 上 link 模式需要开启 Developer Mode 并设置 git config --global core.symlinks true，否则建议 copy。其他代理直接读取 AGENTS.md 与 .agents/，模式不影响行为。
  • 安装执行：通过 git clone --depth 1 --branch <version> https://github.com/thaitype/chief-agent-framework.git .chief-agent-tmp 克隆，并运行 bash .chief-agent-tmp/scripts/setup.sh --agent <agent> --mode <mode>。若脚本整体失败（非零退出或崩溃），则进入完整手动安装回退。
  • 手动安装回退：从 template/ 复制核心文件（.agents、.chief、AGENTS.md）；对 claude-code 额外建立 CLAUDE.md 符号链接或复制、并在 .claude/agents、.claude/skills 下建立链接或复制；对 copilot 额外在 .github/agents 下建立链接或复制；其他代理无需额外步骤。对非 claude-code 代理，会询问 Thinking Model 与 Coding Model 名称并替换对应占位符（claude-code 自动替换为 opus 与 sonnet；copilot 更新 .github/agents/ 下文件；其他代理更新 .agents/agents/ 下文件）。已存在的文件或目录会被跳过并警告用户。
  • 安装验证：检查核心文件（chief-agent.md、builder-agent.md、tester-agent.md、review-plan-agent.md、grill-me/SKILL.md、.chief/project.md、.chief/_rules/、AGENTS.md）是否存在；claude-code 场景检查 CLAUDE.md、.claude/agents 下 4 个代理、.claude/skills 下 grill-me；copilot 场景检查 .github/agents 下 4 个代理；link 模式下验证符号链接能否正确解析；确认模型占位符是否已按用户输入替换。
  • 问题修复：缺失核心文件时从 .chief-agent-tmp/template/ 复制，若临时目录不存在则重新克隆并复制指定文件；缺失 CLAUDE.md 时创建链接或复制；缺失 .claude/ 链接时逐个创建；链接损坏时删除并重建；模式不符时按正确模式重建。
  • 清理与后续：删除 .chief-agent-tmp；提示用户编辑 .chief/project.md、检查并定制 AGENTS.md，以及让 chief-agent 规划第一个里程碑。

使用方式

以技能形式调用，可传入目标版本作为第一个参数。调用过程会按检测、询问代理与模式、克隆并执行 setup.sh、验证、修复、清理、后续提示的顺序进行。

适用场景

需要把 Chief Agent Framework 接入当前项目的初始化或搭建阶段；在脚本不可用、需要手动安装与结构校验、或需要按不同编码代理生成对应集成文件时同样适用。

限制

严格遵守重要规则：未经用户明确批准不得覆盖已有文件；若已安装应建议 /upgrade-chief；即使安装取消或失败也要清理 .chief-agent-tmp；脚本失败时先尝试手动修复再放弃；所有验证结果均需向用户报告（包括成功的项）。Windows 上使用 link 模式需要 Developer Mode 与 git 符号链接配置。其余收费、价格、平台等信息资料未提供。