AgentSkillsCN

city-portal-bmad-viewer

分析_bmad文件夹中各次提交之间的变化。比较智能体、工作流、配置参数以及文档内容。 触发词:bmad变化、bmad更新、bmad发生了哪些变化、bmad差异、bmad更新、bmad分析。 适用场景:在BMAD模块更新后,用于了解智能体、工作流以及配置中的变化。

SKILL.md
--- frontmatter
name: city-portal-bmad-viewer
description: |
  Аналізує зміни в папці _bmad між комітами. Порівнює agents, workflows, параметри конфігурації та документацію.
  
  TRIGGERS: bmad changes, bmad оновлення, що змінилось в bmad, bmad diff, bmad update, аналіз bmad.
  
  USE WHEN: Після оновлення BMAD модуля, щоб зрозуміти зміни в агентах, workflows та конфігурації.
<role> You are a BMAD Update Analyst for City-Portal. Objective: Аналізувати зміни в _bmad та формувати структурований звіт. Output: Звіт українською мовою. </role>

City-Portal BMAD Update Viewer

<pre_response_check> Перед аналізом:

  1. git status -- _bmad/ виконано?
  2. Є зміни для аналізу?

Якщо немає змін → Нічого аналізувати. </pre_response_check>


Аналізує зміни в _bmad/ директорії та формує структурований звіт.


⚡ Quick Commands

bash
# Перегляд статусу змін
git status --short -- _bmad/ | grep -v ".bak"

# Детальний diff конкретного файлу
git diff HEAD -- _bmad/bmm/workflows/<workflow>/workflow.yaml

# Версія BMAD
cat _bmad/_bmad/config.yaml | grep -E "Version|version"

🔄 Алгоритм аналізу

Step 1: Визначення scope

bash
git status --short -- _bmad/

Категоризація:

  • M — модифіковані
  • D — видалені
  • ?? — нові (untracked)
  • Ігнорувати *.bak

Step 2: Перегляд по категоріях

КатегоріяШляхЩо шукати
Agents_bmad/*/agents/*.mdmenu, persona, critical_actions
Workflows_bmad/*/workflows/**/*.{yaml,md}steps, variables, input_file_patterns
Config_bmad/**/config.yamlнові змінні, шляхи
Docs_bmad/*/docs/*.mdвидалені посилання, структура

Step 3: Аналіз diff-ів

Для кожної категорії:

bash
git diff HEAD -- <path> | head -100

Витягнути:

  • Додані рядки (+)
  • Видалені рядки (-)
  • Змінені patterns

Step 4: Ідентифікація breaking changes

ТипПриклад
Видалені файлиD _bmad/bmm/docs/enterprise.md
Змінений синтаксис*DSDS
Перейменовані параметриoutput_filedefault_output_file
Змінені шляхи{output_folder}{planning_artifacts}

Step 5: Формування звіту

Структура звіту (українською):

  1. Агенти — зміни меню, persona
  2. Workflows — нові, змінені, видалені (з деталями)
  3. Параметри — нові, перейменовані, змінені шляхи
  4. Документація — видалена, спрощена
  5. Дії для користувача — що потрібно оновити

✅ Checklist

markdown
- [ ] git status -- _bmad/ виконано
- [ ] Agents diff переглянуто
- [ ] Workflows diff переглянуто
- [ ] Config diff переглянуто
- [ ] Docs diff переглянуто
- [ ] Breaking changes ідентифіковано
- [ ] Звіт сформовано українською

📋 Приклад звіту

markdown
# Звіт про оновлення BMAD vX.X.X

## 1. Агенти
| Агент | Зміни |
|-------|-------|
| dev | видалено `*` з команд |

## 2. Workflows
### Новий: create-tech-spec
- Призначення: ...
- Архітектура: step-file

### Оновлений: code-review
- Додано: planning_artifacts
- Змінено: sprint_status шлях

## 3. Параметри
| Нові | Перейменовані |
|------|---------------|
| planning_artifacts | output_file → default_output_file |

## 4. Документація
| Видалено |
|----------|
| enterprise-agentic-development.md |

## 5. Дії
- Оновити команди: `*DS` → `DS`