Architecture - sxxcwj/b2b-sdr-hermes-skill GitHub Wiki
Architecture:仓库结构与文件作用
b2b-sdr-hermes-skill/ # 本仓库(结构与上游一致)
├── SKILL.md # Skill 入口:元数据、配置项、完整流程与 cron
├── README.md # 项目说明(中文,合并了上游英文版信息)
├── AGENTS.md # 面向 coding agent 的协作守则(权威)
├── CLAUDE.md / GEMINI.md # 厂商指针文件,指向 AGENTS.md
├── CHANGELOG.md # 变更记录
├── LICENSE # MIT(© 2026 思啸)
├── LICENSE.upstream # 上游 MIT(© 2026 PulseAgent (iPythoning))
├── workspace/
│ ├── AGENTS.md # SDR 运行手册(含 {{brand}} 等模板变量)
│ └── SOUL.md # SDR 人格、沟通风格、硬规则
├── cron/sdr-schedules.yaml # 7 个定时任务定义
├── examples/auto-parts-exporter.md # 行业配置示例
└── docs/
├── HANDOFF.md # 跨 agent 交接状态
└── adr/ # 架构决策记录(README + 0000-template)
文件说明
| 文件 | 作用 |
|---|---|
| SKILL.md | Skill 主文件。front matter 定义 name: b2b-sdr-agent、version: 1.0.0、标签、依赖与 4 个配置项;正文是首次配置流程、核心身份、消息长度规则、10 阶段流程、cron、安全与记忆协议 |
| workspace/AGENTS.md | 更细的 SDR 运行手册:报价锁定与超时、谈判授权矩阵、按市场的渠道优先级、动态 ICP、时区表、敏感操作授权、反滥用上限、4 层记忆。模板变量:{{brand}}、{{crm_type}}、{{admin_phone_1}}、{{admin_phone_2}} |
| workspace/SOUL.md | SDR 的"人格":核心特质、工作方式、对客户/对 owner 的表达规则、提示注入防御、GDPR。模板变量:{{industry}}、{{owner_language}} |
| cron/sdr-schedules.yaml | 定时任务参考,见 Cron-Schedules |
| examples/auto-parts-exporter.md | 示例配置,见 Examples |
| AGENTS.md | 给维护本仓库的 coding agent(Claude Code / Codex / Cursor / Gemini 等)的守则:开工三步、收尾三件套、ADR、Git 纪律、工程原则、安全红线 |
| docs/HANDOFF.md | 当前任务状态的唯一权威来源,开工必读、收工必更新 |
| docs/adr/README.md | ADR 规则:复制 0000-template.md,编号递增,一个决策一个文件,被推翻时改状态不删除 |
维护者协作约定
- 阅读顺序:
README* → AGENTS.md → docs/HANDOFF.md → docs/adr/ → git log -10 --oneline - 提交使用 Conventional Commits,写清"为什么"
- 安全红线:不提交密钥、证书、证件与客户隐私数据
- ⚠️ 目前仓库尚无自动化验证命令(AGENTS.md 与 HANDOFF.md 均标注待补)
变更记录
| 日期 | 内容 |
|---|---|
| 2026-08-01 | 部署跨 agent 交接架构:AGENTS.md、docs/HANDOFF.md、docs/adr/、厂商指针文件 |
详见 CHANGELOG.md。