用途：这是 @salesforce/agents（forcedotcom/agents）的开发指南，面向为该库贡献代码的开发者。该库是管理 Salesforce 智能体预览、发布、编译、测试等全部 API 调用的基础库，CLI 插件与 VS Code 扩展均消费它以保证跨平台业务逻辑一致。
主要能力与生态：库为 TypeScript 核心库，提供智能体生命周期 API；下游包括 plugin-agent（Oclif 核心插件，命令 sf agent generate|deploy|preview|test 等）、vscode-agents（VS Code 扩展，提供预览、发布、测试 UI、会话管理）以及 afv-library（vibe coding 技能）。库内模板或逻辑变更会自动惠及所有下游。
使用方式：常用命令包括 yarn install、yarn build、yarn compile、yarn lint、yarn test、yarn test:nuts、yarn docs、yarn local:link <path>、yarn local:unlink <path>、yarn local:install <path>、yarn fix-license。跨仓库开发时先 yarn build，再用 yarn local:link 链接到 plugin-agent 或 vscode-agents 测试，用 yarn local:install 验证已发布产物。
开发流程与规范：从 main 分支切出（前缀 <developer-name>/），用 rebase 保持更新；新代码覆盖率 95%+；提交用 type: message 格式（Husky + commitizen 强制），PR 以 squash 合并，PR 标题成为最终提交信息，PR 正文需含 GUS 工作项 @W-XXXXXXXX@。禁止 any 类型，公共 API 显式类型，新导出须加入 src/index.ts，用户可见字符串放 messages/*.md，每个新 .ts 文件加 Apache 2.0 头。
测试：单元测试用 Mocha + Chai，NUT 需 scratch org 与 @salesforce/cli-plugins-testkit，HTTP 用 test/mocks/ 夹具，支持本地模拟 Apex 调用。
限制与已知问题：会话存储为功能优先、可维护性不足，需重构；扩展中偶发竞态条件；编译器缺少模拟模式，实时测试可能要求 org 中存在特定 Apex 类；scratch org 中途过期会引发连接问题。发布方面，合并到 main 后自动发布到 npmjs，CLI 约一周后进入生产，VS Code 扩展需手动升版本。具体收费、价格等资料暂未提供。