技术实践

百度商业客户端以插件统一跨平台Harness资产

智能体系统上下文与知识上下文工程Agent 工具调用Agent Harness智能体互操作协议Agent SkillsMCP

概述

商业客户端面对多产品线(手百、手百 Lite、好看、贴吧、SDK 等)、多端(Android、iOS、HarmonyOS、跨端模板、广告 SDK)、多 Agent(至少兼容 Claude Code 与 Codex)与多台本地 Mac 部署的系统性治理难题,需统一 Rules、Skills、Hooks、MCP、配置文件与提示词模板的建立、评审、发布、分发、升级、回滚与下线。 ACX 部署方案经四阶段演进:①单 Agent 文件同步——Agent 经 iCode MCP/skill 或 icode-cli clone 取资产写入 ~/.claude/rules 与 ~/.claude/skills,后用 git sparse-checkout + cp -rf 把远程逐文件读取收敛为本地批量复制,安装效率显著提升、Tool calls 明显减少。 ②脚本化安装——安装逻辑独立为 install.sh,SKILL.md 只保留触发说明,脚本负责 sparse clone、动态扫描 rules/*/ 与 skills/*/、root-level rules 安装、skill 扁平化、同名冲突检测、自更新与每日自动 init,并以 autoInstall、autoUpdate、localDebug 控制是否安装/覆盖/保留本地调试版本。 ③~/.acx 中枢 + 多 Agent 软连接——~/.claude/skills、~/.claude/rules、~/.codex/skills 通过 symlink 接入 ~/.acx,Codex 侧用 AGENTS.md bridge 让 Markdown 行为规范进入上下文,子目录 rules 默认不递归加载以降低 token 污染。 ④ACX 仓库整体插件化——根目录提供 .claude-plugin/plugin.json 与 .codex-plugin/plugin.json 两个 manifest,宿主各自按插件协议发现并启用 acx@acx(Claude Code 走 marketplace/settings,Codex 走 personal marketplace),ACX 仓库成为唯一事实源,用户本地不再长期维护复制出来的资产目录。 配套实践:资产按行为规范层(CLAUDE.md、AGENTS.md、.claude/rules/*.md、ACX Markdown rules)、能力执行层(SKILL.md、scripts、references、assets)、宿主集成层(plugin manifest、marketplace、settings、permissions、hooks)三层治理。 由 rule nad-acx-auto-daily-init 与 skill nad-acx-init 组合实现每日首次会话自动更新(git pull --rebase、脚本 hash 自更新、manifest 校验、插件源注册幂等维护)。rule nad-acx-report-active-rules-skills 要求 Agent 在任务结束时汇报实际生效的 Rules 与 Skills。 并按端、产品线、场景、需求类型、交付阶段五大维度为所有 rules/skills 标记适用范围,由 story-pilot skill 查表精准加载,避免全量递归带来的 token 污染与规则冲突。