SuperAPI AI 工具集

copilot-cli-agent

智能体与模型

查看项目

更新于 10-16 08:00

技能介绍

用途:这是一个基于角色的 Copilot CLI 子代理系统,用于把大型上下文通过管道交给 GitHub Copilot 模型执行专项分析,如安全审计、架构评审、QA。它由 agent-orchestrator 编排,定位为「内层小循环专家」;当通用编码能力不足、需要安全、QA、架构等专门技能时使用。CLI 上下文天然隔离(无 git、无工具),因此被视为安全的隔离内层循环。

主要能力与核心模式:作为子代理调度者,把带角色的提示词与输入通过管道传给 Copilot CLI,并将结果写入文件。核心模式为:cat <PERSONA_PROMPT> | copilot -p "<INSTRUCTION>" <INPUT> > <OUTPUT>。Copilot 使用 -p 或 --prompt 进行非交互式脚本运行。

使用方式与最佳实践:

  1. 令牌效率——用管道而非加载:不要把大文件读入代理内存再传递;直接使用 copilot -p "Analyze this log" < large.log > analysis.md。
  2. 提示词自包含:CLI 在独立上下文中运行,无法访问代理工具或记忆;应加入“Do NOT use tools. Do NOT search filesystem.”,并确保提示词与管道输入包含全部必要上下文。
  3. 输出到文件:始终重定向到文件(> output.md),再用 view_file 查看。
  4. 严重性分层约束:调度代码审查、架构或安全分析时,要求使用严重性分层输出模式,格式为 🔴 CRITICAL、🟡 MODERATE、🟢 MINOR,便于外层循环确定性地解析结果。

安全提示:Copilot CLI 有显式权限标志(如 --allow-all-tools、--allow-all-paths);对于隔离子代理,不要提供这些标志,以确保安全的无头执行。

冒烟测试:可用最小命令 copilot -p "Reply with exactly: COPILOT_CLI_OK" 验证 CLI 可调用并返回输出,预期打印 COPILOT_CLI_OK 并成功退出。若失败,确认 copilot 在 PATH 上、已在 Copilot CLI 会话中完成认证,并去掉权限标志后重试。

模型支持警告:若指定模型(如 --model gpt-5.3-codex)后收到 CAPIError: 400 The requested model is not supported,说明该模型未对当前 Copilot 等级授权;去掉 --model 标志以使用默认路由。

角色类别:安全(security-auditor,用于红队、漏洞扫描);开发(14 个角色,涵盖后端、前端、React、Python、Go 等);质量(architect-review、code-reviewer、qa-expert、test-automator、debugger,用于设计验证、测试规划);数据/AI(8 个角色,覆盖 ML、数据工程、数据库优化);基础设施(5 个角色,覆盖云、CI/CD、事件响应);业务(product-manager,产品策略);专项(api-documenter、documentation-expert,技术写作)。全部角色位于 plugins/personas/。

推荐的审计循环:先由红队(安全审计)找出漏洞,再由架构师验证设计未增加复杂度,然后由 QA 专家找出未测试的边界情况;架构师应在红队之后运行,以捕捉安全修复带来的副作用。

限制:资料未提供具体价格、平台支持范围、性能数据或完整的角色清单细节;使用需依赖 Copilot CLI 可用与已认证。