关于 add-config-field
add-config-field 是为 majestic-engineer 插件向 `.agents.yml` 配置架构添加字段的开发技能。它涵盖模板、架构版本、迁移逻辑和插件版本更新,并提供验证步骤。
主要功能
- 01向四种配置模板添加字段
- 02递增架构版本
- 03更新变更记录与迁移默认值
- 04同步插件及市场版本
- 05通过命令验证配置更新
适用场景
- 01为 `.agents.yml` 增加配置项
- 02维护配置架构的版本迁移
- 03更新读取新字段的 Agent 或命令文档
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill add-config-field安装后在 Claude Code 中输入/add-config-field确认已加载。
详细介绍
添加配置字段
向 .agents.yml 配置架构添加新字段,并提供适当的版本管理和迁移支持。
变更文件
| 文件 | 用途 |
|---|---|
plugins/majestic-engineer/commands/workflows/init.md | 用于生成 .agents.yml 的 4 个 YAML 模板 |
plugins/majestic-engineer/config-schema-version | 架构版本号 |
plugins/majestic-engineer/agents/config-reader.md | 更新日志 + 迁移逻辑 |
plugins/majestic-engineer/.claude-plugin/plugin.json | 插件版本 |
.claude-plugin/marketplace.json | 市场版本 |
输入
- 字段名称:例如,
auto_commit - 默认值:例如,
false或多行 YAML - 所属部分:模板中的位置(Workflow、Quality Gate 等)
- 注释:行内说明
- 使用方:读取此字段的 Agent/命令
步骤
1. 更新 init.md 模板
文件: plugins/majestic-engineer/commands/workflows/init.md
在全部 4 个模板(Rails、Python、Node、Generic)中添加字段。找到合适的部分并添加:
new_field: value # Comment explaining purpose
多行内容示例:
new_field: # Comment
- item1
- item2
2. 提升架构版本
文件: plugins/majestic-engineer/config-schema-version
递增:1.1 → 1.2
3. 更新 config-reader.md
文件: plugins/majestic-engineer/agents/config-reader.md
A)添加到版本更新日志表:
| 1.2 | `new_field` | Description |
B)更新迁移 YAML 块(位于“过时的 config_version”部分):
new_field: default_value
4. 提升插件版本
文件:
plugins/majestic-engineer/.claude-plugin/plugin.json:3.15.0→3.16.0.claude-plugin/marketplace.json:更新 majestic-engineer 条目版本
5. 更新使用方文档(如需要)
如果某个 Agent/命令会读取此字段,请更新其文档,说明该配置。
验证
# Count field in init.md (should be 4 - one per template)
grep -c "new_field" plugins/majestic-engineer/commands/workflows/init.md
# Check schema version
cat plugins/majestic-engineer/config-schema-version
# Check changelog entry
grep "new_field" plugins/majestic-engineer/agents/config-reader.md
评论
支持 Markdown