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。