AgentSkillsCN

add-config-field

在 .agents.yml 配置架构中新增字段(更新 init.md 模板、版本号、迁移方案)。

SKILL.md
--- frontmatter
name: add-config-field
description: Add new field to .agents.yml config schema (updates init.md templates, version, migration)
allowed-tools: Read, Edit, Glob, Grep

Add Config Field

Add a new field to the .agents.yml config schema with proper versioning and migration support.

Files Changed

FilePurpose
plugins/majestic-engineer/commands/workflows/init.md4 YAML templates that generate .agents.yml
plugins/majestic-engineer/config-schema-versionSchema version number
plugins/majestic-engineer/agents/config-reader.mdChangelog + migration logic
plugins/majestic-engineer/.claude-plugin/plugin.jsonPlugin version
.claude-plugin/marketplace.jsonMarketplace version

Input

  • Field name: e.g., auto_commit
  • Default value: e.g., false or multi-line YAML
  • Section: Where in template (Workflow, Quality Gate, etc.)
  • Comment: Inline explanation
  • Used by: Agent/command that reads this field

Steps

1. Update init.md Templates

File: plugins/majestic-engineer/commands/workflows/init.md

Add field to ALL 4 templates (Rails, Python, Node, Generic). Find the appropriate section and add:

yaml
new_field: value # Comment explaining purpose

Or for multi-line:

yaml
new_field: # Comment
  - item1
  - item2

2. Bump Schema Version

File: plugins/majestic-engineer/config-schema-version

Increment: 1.11.2

3. Update config-reader.md

File: plugins/majestic-engineer/agents/config-reader.md

A) Add to Version Changelog table:

markdown
| 1.2 | `new_field` | Description |

B) Update migration YAML block (in "Outdated config_version" section):

yaml
new_field: default_value

4. Bump Plugin Versions

Files:

  • plugins/majestic-engineer/.claude-plugin/plugin.json: 3.15.03.16.0
  • .claude-plugin/marketplace.json: Update majestic-engineer entry version

5. Update Consumer Docs (if needed)

If a specific agent/command reads this field, update its documentation to mention the config.

Verification

bash
# 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