ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

awesome-copilot 中的 Droid 自定义代理:Droid CLI 安装与 droid exec 自动化实战指南

awesome-copilot 中的 Droid 自定义代理:Droid CLI 安装与 droid exec 自动化实战指南 awesome-copilot 中的 Droid 自定义代理Droid CLI 安装与 droid exec 自动化实战指南【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot本指南围绕开源仓库 awesome-copilot 中社区贡献的自定义代理配置 agents/droid.agent.md 展开系统讲解 Droid CLI 的安装验证、droid exec非交互执行模式、--auto自主级别、会话延续与工具编排等高级参数并覆盖 CI/CD、GitHub PR 审查、Docker 沙箱等集成场景与安全实践。读完本文你将能把 Droid CLI 以可控制风险的方式接入脚本与流水线也能理解这份自定义代理文件如何在 GitHub Copilot 编码代理环境中落地使用。从一个代理文件认识 Droid CLI在 awesome-copilot 仓库中droid代理以 Markdown YAML frontmatter 的形式存放于 agents/droid.agent.md其元数据声明如下--- name: droid description: Provides installation guidance, usage examples, and automation patterns for the Droid CLI, with emphasis on droid exec for CI/CD and non-interactive automation tools: [read, search, edit, shell] model: claude-sonnet-4-5-20250929 ---这四组字段正是 GitHub Copilot 自定义代理的核心配置name代理标识名即用户在聊天中引用的名字description说明代理职责边界——为开发者提供 Droid CLI 的安装引导、用法示例与自动化模式重点放在面向 CI/CD 与非交互自动化的droid exectools允许代理使用的能力白名单本文件使用read、search、edit、shell四个标准工具别名model指定代理运行所绑定的模型claude-sonnet-4-5-20250929该模型字符串同时出现在本文后续--model用法示例中两者相互印证。这一 frontmatter 结构与仓库 CONTRIBUTING.md 中「Adding an Agent」一节给出的标准格式一致name、description、model、tools字段文件以.agent.md命名并存放于agents/目录并已被收录进 docs/README.agents.md 的代理清单标题为 Droid。需要注意awesome-copilot 中的所有自定义项均来自第三方开发者README 建议在使用前自行审阅代理及其说明。从角色设定看该代理被描述为「Droid CLI 助手」负责帮助开发者安装与使用 Droid CLI尤其擅长自动化、集成与 CI/CD 场景它被允许执行 shell 命令来实地演示droid exec、验证安装结果、展示自动化示例并测试集成模式——这解释了为何shell出现在工具列表中。Droid CLI 的安装与验证主安装方式Droid CLI 提供一键安装脚本在终端中执行curl -fsSL https://app.factory.ai/cli | sh该脚本实际完成三件事为当前平台下载最新版 Droid CLI 二进制文件安装到/usr/local/bin或在无法写入时将其加入你的PATH设置运行所需的权限。提示若目标系统不允许普通用户写入/usr/local/bin安装脚本可能提示权限不足此时需要配合sudo执行以获得系统级安装权限。安装验证安装完成后依次执行两条命令确认 CLI 可用droid --version droid --helpdroid --version输出版本号验证二进制完整性droid --help输出帮助信息验证基本解析与子命令注册正常。若提示command not found请检查/usr/local/bin是否在PATH中见后文「故障排查」。认识 droid exec非交互执行模式droid exec是 Droid CLI 的非交互命令执行模式即一次调用、直接完成任务、不依赖人工逐步确认。它尤其适合以下四类场景CI/CD 流水线自动化Shell 脚本集成SDK 与工具链集成自动化工作流编排其基础语法非常直观droid exec [options] your prompt here与交互式聊天不同droid exec把「自然语言任务描述」变成可以被脚本、流水线调用的一次性命令这是它与 GitHub Actions、定时任务等自动化设施衔接的基石。用 --auto 自主级别掌控变更风险Droid CLI 通过--auto参数把任务划分为四个风险梯度代理文档按「影响越小、越可逆」的原则给出了逐级示例这也是把 AI 自动化安全地接入流水线的关键设计。只读分析默认行为不带--auto时droid exec默认执行安全、只读操作不修改任何文件适合代码评审、文档生成与架构分析# 代码审查与分析 droid exec Review this codebase for security vulnerabilities and generate a prioritized list of improvements # 文档生成 droid exec Generate comprehensive API documentation from the codebase # 架构分析 droid exec Analyze the project architecture and create a dependency graph安全操作--auto low--auto low面向低风险、易于回滚的文件操作例如修改拼写、补充注释与生成样板文件# 修复拼写与格式 droid exec --auto low fix typos in README.md and format all Python files with black # 补充注释与文档 droid exec --auto low add JSDoc comments to all functions lacking documentation # 生成样板文件 droid exec --auto low create unit test templates for all modules in src/开发任务--auto medium--auto medium允许具有可恢复副作用的开发类操作如依赖管理、环境搭建与依赖升级# 依赖管理安装依赖、运行测试并修复失败用例 droid exec --auto medium install dependencies, run tests, and fix any failing tests # 环境搭建 droid exec --auto medium set up development environment and run the test suite # 更新与迁移 droid exec --auto medium update packages to latest stable versions and resolve conflicts生产级操作--auto high--auto high对应影响生产系统的关键操作如完整部署、数据库迁移与系统发布务必仅在你明确信任任务结果的受控环境中使用# 完整部署工作流修复关键缺陷、跑全量测试、提交并推送主分支 droid exec --auto high fix critical bug, run full test suite, commit changes, and push to main branch # 数据库操作 droid exec --auto high run database migration and update production configuration # 系统部署 droid exec --auto high deploy application to staging after running integration tests四个级别的取舍可以归纳为下表级别参数典型风险适用任务只读默认不加--auto无副作用评审、分析、文档低--auto low低风险、易回滚拼写修正、注释、样板文件中--auto medium可恢复的开发副作用依赖、测试、升级高--auto high影响生产系统部署、迁移、发布实践建议是从--auto low起步只在确有必要时逐级提高把自主程度与风险偏好解耦。高级功能会话、工具与模型控制会话延续Session Continuationdroid exec默认每次调用是独立的若想在后续调用中延续前一次的上下文而不重放历史消息可利用会话 ID。先拿到上一次运行的 session ID再通过-s续接# 从上次运行中取出 session ID droid exec analyze authentication system --output-format json | jq .sessionId # 基于该会话继续追问 droid exec -s session-id what specific improvements did you suggest?第一条命令使用--output-format json让输出成为机器可读的 JSON再交给jq提取.sessionId字段第二条用-s session-id进入既有会话。这一组合非常适合在流水线的多个步骤之间维护对话记忆。工具发现与定制Droid 执行任务前可先探查自己拥有哪些工具也可显式限定工具集合# 列出所有可用工具 droid exec --list-tools # 只允许使用指定工具 droid exec --enabled-tools Read,Grep,Edit analyze only using read operations # 排除指定工具此处禁止执行命令 droid exec --auto medium --disabled-tools Execute analyze without running commands--enabled-tools与--disabled-tools分别从正、反两个方向收敛工具面。例如「仅用只读工具分析」既保证了结果不受写操作干扰也缩小了权限攻击面--disabled-tools Execute则明确禁止实际命令执行适合纯静态分析。模型选择通过--model可按任务复杂度选择模型——复杂架构设计交给能力更强的模型简单格式化交给响应更快、成本更低的模型# 复杂任务微服务架构设计 droid exec --model gpt-5.1 design comprehensive microservices architecture # 代码分析React 组件审查与重构 droid exec --model claude-sonnet-4-5-20250929 review and refactor this React component # 轻量任务JSON 格式化 droid exec --model claude-haiku-4-5-20251001 format this JSON file注意示例中使用的模型标识均为具体字符串如claude-sonnet-4-5-20250929、claude-haiku-4-5-20251001可用模型清单会随 Droid CLI 版本演进实际可用值请以droid exec --help输出为准。从文件读取任务长提示或易变提示适合写成文件用-f加载并可与其他参数叠加# 从文件执行任务 droid exec -f task-description.md # 与自主级别组合使用 droid exec -f deployment-steps.md --auto high第二条命令把「部署步骤」这种通常偏高风险的任务封装为文件 --auto high的组合调用适合部署流程相对固定、需要反复执行的场景。集成实战PR 审查、CI/CD 与 DockerGitHub PR 审查自动化把droid exec直接作为 PR 评审工具使用产出结构化反馈# 自动化 PR 审查 droid exec Review this pull request for code quality, security issues, and best practices. Provide specific feedback and suggestions for improvement.更进一步可以在 GitHub Actions 工作流中以 step 方式调用并把 JSON 结果落盘供后续 job 解析- name: AI Code Review run: | droid exec --model claude-sonnet-4-5-20250929 Review PR #${{ github.event.number }} for security and quality \ --output-format json review.json这里github.event.number提供了当前 PR 号--output-format json保证输出可被下游工具如评论机器人、质量看板消费。从仓库的实际集成语境看droid exec在 GitHub Actions runner 中执行的前提是该 runner 已安装并完成 Droid CLI 认证见「安全最佳实践」。CI/CD 流水线集成在流水线中最常见的三种用法是测试修复、质量门槛与构建部署# 测试自动化与修复 droid exec --auto medium run test suite, identify failing tests, and fix them automatically # 质量门槛覆盖率不达标时以非零退出码终止流水线 droid exec --auto low check code coverage and generate report || exit 1 # 构建与部署 droid exec --auto high build application, run integration tests, and deploy to staging|| exit 1是管道中常见的「质量闸门」写法当droid exec任务判定失败返回非零退出码时立即终止后续步骤防止不合规产物继续流动。Docker 容器隔离使用对于高风险或需要干净环境的操作可以把droid exec放进一次性容器中执行# 在隔离环境中使用务必谨慎 docker run --rm -v $(pwd):/workspace alpine:latest sh -c droid exec --skip-permissions-unsafe install system deps and run tests 该命令通过--rm用完即删、-v $(pwd):/workspace把当前目录挂载为工作区并在容器内使用--skip-permissions-unsafe跳过权限校验以便执行依赖安装等操作。容器消失后主机环境不受污染适合在沙箱中演练部署或安装类任务。安全最佳实践代理文档给出五条安全基线是把 Droid CLI 接入任何自动化前都应落实的约束API Key 管理通过FACTORY_API_KEY环境变量注入凭据避免把密钥硬编码进脚本或提交到仓库自主级别递进一律从--auto low开始仅在充分理解后果后逐步提级沙箱化对高风险操作使用 Docker 容器隔离运行见上节用法结果复核应用任何droid exec产出的变更前先人工审查其输出与 diff会话隔离利用会话 ID 维护上下文边界避免不同任务间上下文串扰。第 1 条直接决定了 CI 场景下的认证方式在 GitHub Actions 等平台中通常把FACTORY_API_KEY配置为加密的 Secret再以env注入运行环境。故障排查常见问题与对策Permission denied权限被拒安装脚本写入/usr/local/bin需要系统级权限必要时用sudo重跑安装命令Command not found命令找不到确认/usr/local/bin已加入当前 shell 的PATH或显式改用完整路径执行API authentication认证失败确认已设置FACTORY_API_KEY环境变量且密钥有效。开启调试日志排查疑难问题时可通过环境变量打开 verbose 日志DEBUG1 droid exec test command获取帮助与示例# 查看完整帮助 droid exec --help # 只查看帮助中针对各自主级别的示例段 droid exec --help | grep -A 20 Examples第二条命令用grep -A 20 Examples截取帮助文本中 Examples 之后的 20 行能快速定位可复制的用法样例。命令快速参考任务命令安装curl -fsSL https://app.factory.ai/cli | sh验证droid --version分析代码droid exec review code for issues修复拼写droid exec --auto low fix typos in docs运行测试droid exec --auto medium install deps and test部署droid exec --auto high build and deploy延续会话droid exec -s id continue task列出工具droid exec --list-tools该代理如何融入 GitHub Copilot作为自定义代理droid服务于 GitHub Copilot 的编码代理环境其部署形态与仓库内所有.agent.md一致作用范围作为仓库级自定义代理在 GitHub Copilot Chat 中按需调用可用于仓库内的开发任务工具能力通过read、search、edit、shell四个标准别名读写文件、检索内容、编辑并执行 shell 命令配置方式frontmatter 遵循 GitHub 自定义代理配置规范对应本仓库 CONTRIBUTING.md 中的示例格式版本管理代理配置由 Git 提交 SHA 版本化可在不同分支保留不同版本。启用步骤将本文件放入你的仓库通常位于.github/copilot/目录下在 awesome-copilot 中则统一归档于agents/在 GitHub Copilot Chat 中引用该代理配置文件代理将携带仓库上下文与已配置工具开始工作期间产生的所有 shell 命令都在你的开发环境中执行。从仓库层面看docs/README.agents.md 提供了各代理的安装入口与「下载*.agent.md并加入你的仓库」的标准使用方式本文主题对应的代理条目可直接从该表获取。使用建议审慎使用shell工具它主要用于现场演示droid exec的用法在接入 CI/CD 之前务必先在本地验证每条droid exec命令的输出与退出码行为集成模式先本地测试通过再推广到生产工作流由于该自定义项来源于第三方社区贡献安装前请先阅读其完整说明确认其行为符合你的安全预期。相关仓库资料agents/droid.agent.md本文核心文档Droid 自定义代理的完整配置与系统提示docs/README.agents.md仓库内全部自定义代理清单与安装使用入口CONTRIBUTING.md自定义代理的标准 frontmatter 格式与提交规范「Adding an Agent」一节README.mdawesome-copilot 整体结构、插件安装方式与使用须知。【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表