关于 brandfy-setup
brandfy-setup 是用于准备项目 Brandfy 工作区和治理文件的 Agent 技能。它会保留现有内容、明确记录缺失信息,并检查设置是否可重复执行。
主要功能
- 01仅创建缺失的设置文件
- 02将旧版手册迁移至 BRAND.md
- 03更新 AGENTS.md 中的 Brandfy 区块
- 04检查设置能否重复执行
适用场景
- 01为项目准备 Brandfy 工作区
- 02迁移旧版品牌手册
- 03检查现有设置中的未完成配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ promovaweb/ brandfy --skill brandfy-setup安装后在 Claude Code 中输入/brandfy-setup确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/agents-consumer.mdscripts/setup.mjs详细介绍
配置 Brandfy
操作协议
- 计划和进度: 制定可见的计划,并在检查、配置和验证后更新状态。
- 事实来源: 阅读项目的
AGENTS.md、.brandfy/中现有的文件以及参考文档 agents-consumer.md。 - 范围和幂等性: 保留现有配置和产物。设置过程只创建缺失的文件,将旧版手册迁移到
BRAND.md,并且只替换AGENTS.md中的 Brandfy 区块。 - 验证: 写入后使用
--check运行设置,并检查git diff。 - 最终总结: 说明创建的文件、保留的文件、验证结果和待办事项。
流程
-
找到项目根目录并阅读其中的说明。
-
执行:
node <caminho-da-skill>/scripts/setup.mjs --project . -
打开
.brandfy/config.yaml,与用户一起调整品牌名称、国家、语言、目标和阶段。 -
如果简报尚未完整,使用
$brandfy-entrevista引导探索并填写文件,不得凭空编造答案。 -
仅将已确认的事实填入
.brandfy/brief.md。明确保留未解决的问题,并注明问题和负责人。 -
检查
AGENTS.md中由brandfy:consumer标记的区块。 -
执行:
node <caminho-da-skill>/scripts/setup.mjs --project . --check
设置完成后,打开 .brandfy/config.yaml、BRAND.md 和 brand/README.md,确认目标、指南和索引。再次运行应不产生任何更改;任何差异都表明配置尚未完成,或代理区块仍为旧版。
在旧项目中,如果手册仍位于 brand/README.md,则将其移至 BRAND.md;必要时在 brand/archive/ 中保留一份副本。
专家推理
将设置视为治理准备,而不是品牌创建。确认答案和审批的负责人、证明材料的位置、规范文件以及解决待办事项的方式。结构完整但信息薄弱的项目仍然是不完整的项目。
评论
支持 Markdown