SuperAPI AI 工具集

brand-voice

设计与创作

查看项目

更新于 10-15 20:28

技能介绍

用途:治理品牌写作声音文档 BRAND-VOICE.md,作为项目根目录下与 DESIGN.md 并列的规范文件,供写作类技能消费。

主要能力:支持 extract(从来源合成规范文档)、update(基于新来源刷新并保留手动段落)、diff(git 感知的版本对比)、validate/lint/check(按规范格式校验,输出 GREEN/YELLOW/RED 与 CI 友好退出码)、show(打印可测试规则)。来源可组合使用 -u 网址、-n Notion 页面、-d 目录、-f 单文件,无来源时走访谈问题库。

使用方式:默认写入 ./BRAND-VOICE.md,可用 -o 覆盖路径;extract 拒绝覆盖已有文件,刷新需用 update。加 -s 时另写一份到 ~/.agents/output/{project}/brand-voice/brand-voice-{slug}.md。校验命令:python3 "$SKILL_DIR"/scripts/voice_lint.py ./BRAND-VOICE.md;规则解析:python3 "$SKILL_DIR"/scripts/extract_rules.py --resolved-json ./BRAND-VOICE.md。

适用场景:品牌跨仓库分发(品牌工作区、monorepo、git submodule、npm 包、复制加 diff、Notion 作为真源)、多语境(RFC、落地页、社交)与子品牌继承(voice.extends)。

限制:本技能不负责改写文稿,应用声音由 humanize-en -f BRAND-VOICE.md 等消费技能完成;Notion MCP 未安装时 -n 会报错,需先导出 Markdown 再用 -d;继承解析需用 --resolved-json,直接读本地 YAML 无法解析 voice.extends。具体收费、平台与效果资料暂未提供。