Agent API 文档Skills
品牌档案 Brand Profile
使用 md2wechat Brand Profile 保存品牌语气、主题偏好、排版偏好和转化规则，让 Agent 稳定复用。
品牌档案 Brand Profile
Brand Profile 是给 md2wechat Agent 使用的品牌记忆。
文件位置是：
~/.config/md2wechat/brand.md它是 Markdown，不是 YAML。CLI 只负责创建和返回原文，不解析里面的字段。真正读取这些内容的是 Agent。
什么时候该用
如果你希望多次处理文章时保持一致，就应该使用 Brand Profile：
- 写作语气
- 常用主题
- 常用排版模块
- 引导动作
- 禁用表达
- 示例句式
- 读者定位
这对经常让 Agent 写发布说明、教程、服务页、公众号草稿的团队尤其有用。
初始化文件
运行：
md2wechat brand init再查看：
md2wechat brand show --json如果文件存在，命令会在 data.content 返回 Markdown 原文，在 data.path 返回文件路径。
可以写什么
一个实用的 Brand Profile 可以很短：
# Brand Profile
我们写给需要稳定发布公众号内容的运营者、创作者和团队。
语气：
- 直接、清楚、实用
- 不写空泛口号
- 先讲清取舍，再给命令
排版：
- 优先使用一个开头模块、一个证据模块、一个 CTA
- 不堆太多装饰模块
- 需要高级排版时使用 API 模式
转化：
- 引导读者试用 md2wechat Agent API
- 产品表述必须具体、可验证Agent 判断优先级
如果信息冲突，Agent 应按这个顺序判断：
- 明确传入的命令参数
- 用户本轮要求
- Brand Profile 文本
config.yaml- 当前 CLI 发现结果
- Agent 保守默认值
Brand Profile 是长期偏好，不应该覆盖用户本轮的明确要求。
使用前先验证偏好
如果 Brand Profile 里写了某个主题或排版模块，使用前先验证：
md2wechat themes list --json
md2wechat layout list --json
md2wechat themes show wechat-native --json不要在主题无效时偷偷换成随机主题。应该说明不匹配，或者选择一个已经验证过的替代项。