ARTICLE DETAIL

资讯详情

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

opcode CC Agents 预置智能体指南:从导入导出到源码级实现原理

opcode CC Agents 预置智能体指南:从导入导出到源码级实现原理 桌面应用AI 应用AI Agent【免费下载链接】opcodeA powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.项目地址https://gitcode.com/GitHub_Trending/claudia1/opcode点击查看免费下载opcode 是一款为 Claude Code 打造的 GUI 工具与工具包其CC AgentsClaude Code Agents模块允许用户创建、管理并后台执行自定义 AI Agent。本指南以仓库cc_agents/目录中的三个预置智能体及配套文档为核心完整讲解智能体的导入、导出、.opcode.json文件格式并结合 src-tauri/src/commands/agents.rs 与 src/components/CCAgents.tsx 等源码深入剖析其底层的存储、校验、去重、执行与实时监控实现帮助你既能开箱即用地运行这些智能体也能理解并自行编写可贡献的高质量智能体。 预置智能体一览cc_agents/目录存放了三个开箱即用的预置智能体全部由 Claude Code 驱动覆盖开发中最常见的自动化场景Agent模型说明默认任务 Git Commit BotbotSonnet分析 Git 仓库变更按 Conventional Commits 规范生成提交信息并推送到远程Push all changes.️ Security Scanner️shieldOpus基于 AI 的静态应用安全测试SAST通过派生子代理完成代码库情报收集、STRIDE 威胁建模、OWASP Top 10/CWE 漏洞扫描、利用验证、修复设计与报告生成Review the codebase for security issues. Unit Tests BotcodeOpus全自动单元测试生成分析代码结构、制定测试计划、按项目风格编写测试、执行验证、优化覆盖率整体 80%关键路径 100%并生成文档Generate unit tests for this codebase.三个智能体的系统提示词分别封装在 git-commit-bot.opcode.json、security-scanner.opcode.json 和 unit-tests-bot.opcode.json 中均可直接在 opcode 中导入运行也可作为你编写自定义智能体的参考模板。可用的图标选项创建智能体时可以从以下图标中选择帮助你在网格界面中快速辨识bot- 通用用途shield- ️ 安全相关code- 开发相关terminal- ️ 系统/CLIdatabase- ️ 数据操作globe- 网络/Webfile-text- 文档git-branch- 版本控制在前端实现中图标定义于 src/components/IconPicker.tsx 的ICON_MAP并由 src/components/CCAgents.tsx 导出为AGENT_ICONS渲染时若图标名未命中会回退到botCCAgents.tsx 第 252-255 行。智能体模型选型指南Haiku适合简单任务响应快、成本低Sonnet通用任务首选Git Commit Bot 即采用该模型Opus复杂推理任务Security Scanner 与 Unit Tests Bot 均采用该模型因为它们需要多阶段推理与子代理编排。 导入智能体两种方式方式一从 GitHub 导入推荐在 opcode 中进入CC Agents界面点击Import下拉按钮选择From GitHub浏览官方仓库中可用的智能体预览智能体详情后点击Import Agent。该流程由 GitHubAgentBrowser.tsx 实现界面提供搜索框可按名称过滤点击某个智能体后通过fetchGitHubAgentContent拉取其download_url内容进行预览再调用importAgentFromGitHub完成导入。方式二从本地文件导入从本仓库下载一个.opcode.json文件例如cc_agents/下的三个预置智能体在 opcode 中进入CC Agents点击Import下拉按钮选择From File选中下载的.opcode.json文件。前端通过 Tauri 原生文件对话框tauri-apps/plugin-dialog的open选择文件后调用api.importAgentFromFile完成导入CCAgents.tsx 第 219-245 行。导入的后端校验与去重逻辑无论哪种方式最终都会汇聚到 Rust 端的import_agent命令agents.rs 第 1702-1777 行其处理流程如下解析 JSON将文件内容解析为AgentExport结构格式错误直接报 Invalid JSON format版本校验仅支持version 1否则返回 Unsupported export version从本地文件导入时还会先剥离 BOM 并 trim 首尾空白import_agent_from_file自动去重按name查询已存在的智能体若重名则在原名后追加(Imported)后缀避免命名冲突写入数据库以enable_file_read1、enable_file_write1、enable_network0的默认权限入库与agents表的列默认值一致见 agents.rs 第 229-244 行。从 GitHub 导入时fetch_github_agents调用 GitHub API 拉取cc_agents目录内容并只保留*.opcode.json且类型为file的条目agents.rs 第 1826-1868 行import_agent_from_github则会先下载内容并做同样的版本校验后复用上述导入逻辑。 导出智能体导出你的自定义智能体在 opcode 中进入CC Agents在网格中找到目标智能体点击Export按钮选择保存.opcode.json文件的路径。前端会先弹出原生保存对话框save默认文件名由智能体名转换而来小写、空格替换为连字符如Git Commit Bot→git-commit-bot.opcode.json见 CCAgents.tsx 第 190-217 行再调用 Tauri 命令export_agent_to_file写入磁盘。导出格式与内部实现Rust 端export_agent从数据库读取name、icon、system_prompt、default_task、model、hooks六个字段组装为带版本与时间戳的 JSON 结构agents.rs 第 1529-1562 行{ version: 1, exported_at: 2025-01-23T14:29:58.15606300:00, agent: { name: Your Agent Name, icon: bot, model: opus|sonnet|haiku, system_prompt: Your agents instructions..., default_task: Default task description } }exported_at使用 RFC 3339 时间戳chrono::Utc::now().to_rfc3339()version固定为 1。对照仓库中的三个真实导出文件可发现实际导出可能额外包含hooks字段用于挂载 Claude Code hooks 配置与 api.ts 中的 AgentExport 类型 一致。 技术实现导入/导出如何工作智能体的导入/导出体系构建在 TauriRust 后端 React/TypeScript前端架构之上。后端Rust/Tauri存储SQLite 数据库agents.db位于应用数据目录存储智能体配置agents表包含id、name、icon、system_prompt、default_task、model、enable_file_read、enable_file_write、enable_network、hooks、created_at、updated_at等字段并建有agent_runs表记录每次执行含statuspending/running/completed/failed/cancelled两表通过外键agent_id关联、ON DELETE CASCADEagents.rs 第 216-346 行导出将智能体数据序列化为带版本控制的 JSON导入解析、校验版本并自动去重GitHub 集成通过 GitHub API 拉取官方仓库中的智能体清单与内容。前端React/TypeScriptUI 组件CCAgents.tsx - 智能体管理主界面网格展示、分页每页 9 个、执行/编辑/导出/删除操作GitHubAgentBrowser.tsx - GitHub 仓库浏览器搜索、预览、导入CreateAgent.tsx - 智能体创建/编辑表单文件操作使用 Tauri 原生文件对话框完成导入/导出实时更新通过agent-output:{run_id}、agent-error:{run_id}、agent-complete:{run_id}等事件通道实时推送执行状态与输出agents.rs 第 948-952 行、第 1126-1127 行。关键特性版本控制每次导出都包含版本元数据导入时强制校验仅支持 v1重复预防重名智能体自动追加(Imported)后缀模型选择在 Opus、Sonnet、Haiku 之间自由切换GitHub 集成可直接从官方仓库导入。 执行机制智能体如何跑起来虽然 README 未展开执行细节但源码清晰地展示了智能体执行的完整链路对理解预置智能体的实际运行至关重要agents.rs 第 679-785 行execute_agent读取智能体配置若配置了hooks会在项目目录生成.claude/settings.json以claude二进制启动进程参数包括-p task默认任务、--system-prompt system_prompt智能体指令、--model model、--output-format stream-json、--verbose与--dangerously-skip-permissions从 stdout 的 JSONL 输出中提取session_id并实时写回数据库前端通过AgentExecution.tsx与AgentRunsList.tsx实时展示进度运行结束后从 Claude 的.claude/projects/encoded-project/session_id.jsonl读取会话内容并解析出时长、Token 用量与成本等指标AgentRunMetrics::from_jsonlagents.rs 第 99-167 行。例如在目标仓库执行Git Commit Bot的默认任务 Push all changes.智能体会读取本地 git 状态、分析 diff、生成 Conventional Commits 格式的提交信息并推送远程执行Unit Tests Bot的 Generate unit tests for this codebase. 则会按六个阶段产出测试文件与覆盖率报告。 深度剖析三个预置智能体的提示词工程Git Commit Bot把 Git 工作流变成智能体任务git-commit-bot.opcode.json 采用结构化提示词task声明角色目标instructions规定操作顺序notes给出兜底策略。其核心指令流程为先git fetch检查本地是否落后于远程若存在未同步提交则git pull冲突时按保守优先、保持既有行为的原则手动解决分析git diff与git status识别增删改文件、变更性质修复/新功能/重构与影响范围按 Conventional Commits 规范撰写提交信息类型从feat、fix、docs、style、refactor、perf、test、chore中选取必要时加(scope)描述用一般现在时可附加多行说明、破坏性变更与关联 issue最终推送到远程无法确定分支名时默认使用main。Security Scanner子代理编排的六阶段 SASTsecurity-scanner.opcode.json 是最复杂的预置智能体采用编排者 子代理模式通过Task工具派生子代理依次执行六个阶段代码库情报收集Codebase Intelligence Analyzer提取语言/框架/依赖、架构模式、认证机制、数据存储、外部集成、输入校验、加密实现、会话管理与已知 CVE威胁建模Threat Modeling Specialist识别资产、信任边界、入口点并对每个组件做 STRIDE伪装、篡改、否认、信息泄露、拒绝服务、权限提升分析漏洞扫描Vulnerability Scanner针对注入、认证与会话、访问控制、数据暴露、密码学问题、业务逻辑与配置错误七大清单逐项扫描并要求从 source 到 sink 追踪完整数据流、映射 CWE利用开发与验证Exploit Developer为每个漏洞编写最小 PoC验证可复现性与真实性、排除误报修复设计Security Architect给出即时修复、长期方案与纵深防御主修复 补偿控制 检测机制 应急响应报告生成Security Report Writer产出包含执行摘要、技术摘要、HackerOne 格式详细发现、修复路线图1 天 / 1-7 天 / 7 天与附录的专业报告。该智能体还内嵌了完整的漏洞报告模板含 CVSS 3.1 评分、CWE/OWASP 映射、数据流分析、PoC、影响与修复代码示例与严重级别分类标准Critical/High/Medium/Low/Informational并设有一份质量保证清单可验证性、source-to-sink 确认、修复已测试、无误报、业务上下文考量、CWE/OWASP 映射准确。Unit Tests Bot六阶段自动化测试流水线unit-tests-bot.opcode.json 同样采用子代理编排分六阶段推进代码库分析确认语言/框架、既有测试框架与模式、代码风格约定、目录结构与测试文件位置测试规划识别全部可测模块并按优先级分类critical/high/medium/low定义各模块场景、边界条件与覆盖率目标测试生成为每个模块派发 Test Writer要求遵循既有测试约定、含正/负/边界场景、合理 mock 外部依赖、保证测试独立可重复测试验证执行测试套件、捕获失败项、检查 flaky 测试、度量覆盖率、验证隔离性与无副作用覆盖率优化针对未覆盖路径与分支补测兼顾变异测试mutation testing抵抗性文档生成产出测试套件总览、覆盖率汇总、运行与维护指南、CI/CD 集成说明。此外该智能体还固化了风格一致性规则命名/结构/导入/断言/注释风格与主代码库保持一致、测试质量准则单一目的、命名含预期结果、可任意顺序运行、失败要有意义、关注行为而非实现细节与最终检查清单所有源文件有对应测试、覆盖率达标、测试稳定通过、无硬编码与环境依赖、文档完整、CI/CD 已配置。 贡献你的智能体欢迎向仓库贡献新的智能体官方推荐的流程如下创建智能体在 opcode 中设计并测试你的智能体确保用途清晰、聚焦导出智能体导出为.opcode.json文件取一个描述性名称提交 Pull RequestFork 本仓库将.opcode.json文件放入cc_agents目录更新本 README补充你的智能体信息提交 PR 并说明智能体功能。智能体编写指南单一职责每个智能体只专精于一个特定任务文档清晰编写完整的系统提示词参考上面三个预置智能体的task/instructions/notes分层结构模型选择简单任务用 Haiku通用任务用 Sonnet复杂推理用 Opus命名规范使用能清晰表明功能的描述性名称。从源码可进一步印证system_prompt是智能体的灵魂它会被完整注入 Claude Code 的--system-prompt参数agents.rs 第 756-768 行因此提示词质量直接决定智能体行为表现同时default_task会在网格卡片点击执行时作为默认任务传入。 许可证这些智能体与 opcode 项目采用相同的许可证详见仓库根目录的 LICENSE。总而言之cc_agents/目录既是三个可直接投入使用的 AI 智能体Git Commit Bot、Security Scanner、Unit Tests Bot也是一套完整的智能体分发格式 导入导出 执行调度 实时监控工程实践范本。借助.opcode.json这一带版本控制的交换格式任何人都可以低成本地复用、改写并反向贡献智能体这正是 opcode CC Agents 设计的核心价值所在。赞分享桌面应用AI 应用AI Agent【免费下载链接】opcodeA powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.项目地址https://gitcode.com/GitHub_Trending/claudia1/opcode点击查看免费下载相关推荐BenchmarkDotNet JSON 导出器JsonExporter完全指南从预设配置到源码原理BenchmarkDotNet JSON 导出器JsonExporter完全指南从预设配置到源码原理 BenchmarkDotNet 内置了一组功能完善的性能测试开发工具SIMP生态系统探秘集成ELK、GitLab与监控工具的企业级运维架构SIMP生态系统探秘集成ELK、GitLab与监控工具的企业级运维架构 SIMPSystem Integrity Management Platform是Ant Design Tour 漫游式引导组件实战指南从入门配置到源码级原理Ant Design Tour 漫游式引导组件实战指南从入门配置到源码级原理 本文围绕 ant design 仓库中 components/tour/inde前端UI组件设计系统上一篇MTKClient刷机工具终极指南掌握联发科设备刷机与调试下一篇MTKClient刷机工具新手入门完整指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表