mcpField
B
brandfy-setup

brandfy-setup

github.com/promovawebAgent 工作流13157 次安装2 周前更新
代码仓库

关于 brandfy-setup

brandfy-setup 是用于准备项目 Brandfy 工作区和治理文件的 Agent 技能。它会保留现有内容、明确记录缺失信息,并检查设置是否可重复执行。

主要功能

  1. 01仅创建缺失的设置文件
  2. 02将旧版手册迁移至 BRAND.md
  3. 03更新 AGENTS.md 中的 Brandfy 区块
  4. 04检查设置能否重复执行

适用场景

  1. 01为项目准备 Brandfy 工作区
  2. 02迁移旧版品牌手册
  3. 03检查现有设置中的未完成配置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/promovaweb/brandfy --skill brandfy-setup

安装后在 Claude Code 中输入/brandfy-setup确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
agents-consumer.md
scripts/
setup.mjs

详细介绍

配置 Brandfy

操作协议

  • 计划和进度: 制定可见的计划,并在检查、配置和验证后更新状态。
  • 事实来源: 阅读项目的 AGENTS.md、.brandfy/ 中现有的文件以及参考文档 agents-consumer.md。
  • 范围和幂等性: 保留现有配置和产物。设置过程只创建缺失的文件,将旧版手册迁移到 BRAND.md,并且只替换 AGENTS.md 中的 Brandfy 区块。
  • 验证: 写入后使用 --check 运行设置,并检查 git diff。
  • 最终总结: 说明创建的文件、保留的文件、验证结果和待办事项。

流程

  1. 找到项目根目录并阅读其中的说明。

  2. 执行:

    node <caminho-da-skill>/scripts/setup.mjs --project .
    
  3. 打开 .brandfy/config.yaml,与用户一起调整品牌名称、国家、语言、目标和阶段。

  4. 如果简报尚未完整,使用 $brandfy-entrevista 引导探索并填写文件,不得凭空编造答案。

  5. 仅将已确认的事实填入 .brandfy/brief.md。明确保留未解决的问题,并注明问题和负责人。

  6. 检查 AGENTS.md 中由 brandfy:consumer 标记的区块。

  7. 执行:

    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