7d4412782e
- merge-config.py und merge-help-csv.py: Docstrings mit Aufrufkontext, Zweck, Idempotenz-Verhalten und Beispielen - GLOSSAR.md: DSA5-Abkürzungen, Eigenschaften, Abenteuer-Schmiede- und BMAD-Fachbegriffe Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
72 lines
2.3 KiB
Python
72 lines
2.3 KiB
Python
#!/usr/bin/env python3
|
|
"""Merge Abenteuer-Schmiede module-help.csv into BMAD help.csv.
|
|
|
|
Called by: BMAD module installer (npx bmad-method install)
|
|
When: During module installation, NOT during as-setup workflow
|
|
Purpose: Registers all Abenteuer-Schmiede skills/workflows in the
|
|
central BMAD help system so they appear in agent menus
|
|
and the BMAD help command.
|
|
Idempotent: Yes — only adds entries whose canonicalId doesn't exist yet.
|
|
|
|
Usage:
|
|
python merge-help-csv.py <bmad-root-path>
|
|
|
|
Example:
|
|
python merge-help-csv.py /path/to/my-project
|
|
|
|
Source file: skills/as-setup/assets/module-help.csv (10 entries)
|
|
Target file: <bmad-root>/_config/help.csv
|
|
|
|
CSV columns: canonicalId, moduleName, moduleCode, skillType, skillId,
|
|
skillName, description, filePath
|
|
"""
|
|
|
|
import csv
|
|
import sys
|
|
import os
|
|
|
|
def merge_help(bmad_root):
|
|
help_path = os.path.join(bmad_root, "_config", "help.csv")
|
|
module_help = os.path.join(os.path.dirname(__file__), "..", "assets", "module-help.csv")
|
|
|
|
if not os.path.exists(module_help):
|
|
print(f"Module help CSV not found: {module_help}")
|
|
sys.exit(1)
|
|
|
|
# Read module help entries
|
|
with open(module_help, "r", encoding="utf-8") as f:
|
|
reader = csv.reader(f)
|
|
header = next(reader)
|
|
new_rows = list(reader)
|
|
|
|
# Read existing BMAD help (or create new)
|
|
existing_ids = set()
|
|
existing_rows = []
|
|
if os.path.exists(help_path):
|
|
with open(help_path, "r", encoding="utf-8") as f:
|
|
reader = csv.reader(f)
|
|
existing_header = next(reader)
|
|
for row in reader:
|
|
existing_ids.add(row[0])
|
|
existing_rows.append(row)
|
|
|
|
# Merge: only add rows whose canonicalId doesn't exist yet
|
|
added = 0
|
|
for row in new_rows:
|
|
if row[0] not in existing_ids:
|
|
existing_rows.append(row)
|
|
added += 1
|
|
|
|
# Write back
|
|
with open(help_path, "w", encoding="utf-8", newline="") as f:
|
|
writer = csv.writer(f)
|
|
writer.writerow(header)
|
|
writer.writerows(existing_rows)
|
|
|
|
print(f"Merged {added} new entries into BMAD help.csv.")
|
|
|
|
if __name__ == "__main__":
|
|
if len(sys.argv) < 2:
|
|
print("Usage: python merge-help-csv.py <bmad-root-path>")
|
|
sys.exit(1)
|
|
merge_help(sys.argv[1])
|