[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M751NXKTP5JJJRY5MM5S5WKA":3,"skill-same:01M751NXKTP5JJJRY5MM5S5WKA":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":6,"ownerHtmlUrl":35,"ownerBlogUrl":36,"ownerDescription":37,"updatedAt":38,"install":39,"resources":51},"01M751NXKTP5JJJRY5MM5S5WKA","x-generate-release-changelog",null,"Changelog generator v2: hybrid format combining narrative Highlights block (derived from 'Entrega de Valor' of merged v2 epics) with Keep-a-Changelog sections (Added\u002FChanged\u002FFixed\u002FBreaking\u002FDeprecated). Stack-aware via documentation.changelog.format config. Falls back gracefully when EPIC-0070 epics unavailable (D-R10).","review-bench\u002Federcnj_ia-dev-environment","review-bench","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286778065?v=4","01M7517F9NTEPDZDAXJBR30FWT","ReviewBench","01M7517FAC9F4P7TGWCNJ8VYVW",0,"MIT","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-generate-release-changelog\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: x-generate-release-changelog\ndescription: \"Changelog generator v2: hybrid format combining narrative Highlights block (derived from 'Entrega de Valor' of merged v2 epics) with Keep-a-Changelog sections (Added\u002FChanged\u002FFixed\u002FBreaking\u002FDeprecated). Stack-aware via documentation.changelog.format config. Falls back gracefully when EPIC-0070 epics unavailable (D-R10).\"\nuser-invocable: true\nmodel: sonnet\nallowed-tools: Read, Write, Edit, Bash, Grep, Glob\nargument-hint: \"[version-tag | --unreleased | --full] [--format hybrid|keep-a-changelog|conventional-only]\"\nrequires-capabilities: [governance.doc-as-dod]\n---\n\n## Global Output Policy\n\n- **Language**: English ONLY.\n- **Tone**: Technical, Direct, and Concise.\n- **Efficiency**: Remove all conversational fillers and greetings to save tokens.\n\n# Skill: Changelog Generator v2\n\n## Purpose\n\nGenerates or updates `CHANGELOG.md` for {{PROJECT_NAME}} in **hybrid format** (default): a narrative `### Highlights` block derived from `## Entrega de Valor` sections of merged EPIC-0070 v2 epics, followed by rigorously structured Keep-a-Changelog sections populated from Conventional Commits.\n\nFormat is configurable via `documentation.changelog.format` in the project YAML:\n- `hybrid` (default): Highlights block + Keep-a-Changelog sections\n- `keep-a-changelog`: Keep-a-Changelog only (no Highlights), same as v1 behavior\n- `conventional-only`: Raw Conventional Commit grouping without KaC normalization\n\nWhen v2 epic content is unavailable, degrades gracefully per **D-R10**: empty Highlights + visible WARN + exit 0 (never blocks release).\n\n## Triggers\n\n- `\u002Fx-generate-release-changelog` — generate hybrid changelog for unreleased changes\n- `\u002Fx-generate-release-changelog v3.10.0` — generate entry for version v3.10.0\n- `\u002Fx-generate-release-changelog --unreleased` — unreleased changes since last tag\n- `\u002Fx-generate-release-changelog --full` — regenerate entire changelog from all tags\n- `\u002Fx-generate-release-changelog --format keep-a-changelog` — v1 format (no Highlights)\n- `\u002Fx-generate-release-changelog --format conventional-only` — raw commit grouping\n\n## Parameters\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| Version tag | No | Target version (e.g., `v3.10.0`). Default: unreleased. |\n| `--unreleased` | No | Only unreleased changes since last tag. |\n| `--full` | No | Regenerate entire changelog from all tags. |\n| `--format` | No | Output format: `hybrid` (default), `keep-a-changelog`, `conventional-only`. Overrides `documentation.changelog.format` from YAML. |\n| `--highlights-min` | No | Minimum Highlights paragraphs. Default: 3. |\n| `--highlights-max` | No | Maximum Highlights paragraphs before truncation. Default: 8. |\n\n**Format validation:** if `documentation.changelog.format` or `--format` contains a value outside `{hybrid, keep-a-changelog, conventional-only}`, exit `INVALID_CHANGELOG_FORMAT` and list valid values on stderr.\n\n## Workflow\n\n```\n1. DETECT      -> Determine version range from tags; load format config\n2. EPICS       -> Collect merged EPIC-0070 v2 epics in range (for Highlights)\n3. PARSE       -> Extract commits in range, parse Conventional Commits\n4. HIGHLIGHTS  -> Generate narrative Highlights block (hybrid mode only)\n5. GROUP       -> Map commit types to KaC sections\n6. GENERATE    -> Create or update CHANGELOG.md (incremental)\n7. REPORT      -> Summary of entries added\n```\n\n### Step 1 — Detect Version Range and Load Config\n\n```bash\n# List all version tags, sorted by version\ngit tag --list 'v*' --sort=-v:refname\n\n# Determine range\n# If version tag given: previous_tag..version_tag\n# If --unreleased: latest_tag..HEAD\n# If --full: process all tags\n# If no argument: latest_tag..HEAD (same as --unreleased)\n```\n\nLoad `documentation.changelog.format` from project YAML:\n\n```bash\ncat iadev.yaml 2>\u002Fdev\u002Fnull | grep \"changelog\" | grep \"format\"\n```\n\nIf not found: default to `hybrid`. Apply `--format` flag override if present.\n\nValidate format value: if not in `{hybrid, keep-a-changelog, conventional-only}` → exit 1 `INVALID_CHANGELOG_FORMAT`.\n\n### Step 2 — Collect EPIC-0070 v2 Epics in Range (hybrid mode only)\n\nIdentify epic markdown files added\u002Fmodified in the git range:\n\n```bash\ngit log {previous_tag}..{target} --diff-filter=AM --name-only -- 'ai\u002Fepics\u002Fepic-*\u002Fepic-*.md' 2>\u002Fdev\u002Fnull\n```\n\nFor each epic file found, read the `## Entrega de Valor` section (or `## 2. Persona & Cenário de Uso` + `## 3. Hipótese de Valor` as fallback):\n\n```bash\n# Extract Entrega de Valor content from epic markdown\nawk '\u002F^## (2\\. )?Entrega de Valor\u002F,\u002F^## [0-9]\u002F' {epic_file} | head -50\n```\n\nApply v2 template detection: epic uses v2 if it contains `## 1. Visão & Problema` (not `## Packages — Hexagonal`).\n\n**D-R10 — Fallback when no v2 epics found:**\n- No epic files in range, OR\n- All epic files found are v1 (contain `## Packages — Hexagonal`), OR\n- `ai\u002Fepics\u002F` directory absent:\n\n```\nWARN [x-generate-release-changelog] No EPIC-0070 v2 epics found in range {range} — Highlights will be empty.\n     Install\u002Fmerge EPIC-0070 epics to enable narrative Highlights. (D-R10 degraded mode)\n```\n\nSet Highlights to empty; proceed without blocking.\n\n### Step 3 — Parse Conventional Commits\n\n```bash\n# Extract commits in range\ngit log {previous_tag}..{target} --format=\"%H|%s|%b|%an|%ai\" --no-merges\n```\n\nParse each commit as Conventional Commit:\n```\n\u003Ctype>(\u003Cscope>): \u003Cdescription>\n```\n\nExtract: type, scope, description, breaking flag (`!` after type or `BREAKING CHANGE:` in body), body.\n\nSkip commits that don't follow the convention (log WARN, do not abort).\n\n### Step 4 — Generate Highlights Block (hybrid mode only)\n\nWhen `format = hybrid` and ≥ 1 v2 epic was found:\n\n1. For each v2 epic with `## Entrega de Valor`, extract the section content (sanitized).\n2. Consolidate across epics into a narrative block targeting 3–8 paragraphs:\n   - Each epic contributes up to 2 paragraphs (value statement + metric).\n   - Remaining paragraph budget filled with top `feat:` entries summarized by scope.\n3. **Minimum (3 paragraphs):** if fewer than 3 paragraphs can be derived from epic content, expand with bullet-point summaries of `feat:` commits until minimum is reached.\n4. **Maximum (8 paragraphs):** if more than 8 paragraphs would be generated, truncate with trailing `...` and emit:\n   ```\n   WARN [x-generate-release-changelog] Highlights truncated at 8 paragraphs — review manually.\n   ```\n\n**Content sanitization:** strip markdown link syntax (`[text](url)`) that references internal CI paths. Escape `\u003C`, `>`, `&` characters. Never include paths matching `\u002Fhome\u002F`, `\u002Ftmp\u002F`, `\u002Fvar\u002F`, `\u002FUsers\u002F` (CI runner internals). Remove environment variables (`$VAR`, `${VAR}`).\n\n**Highlights format:**\n```markdown\n### Highlights\n\n{paragraph_1 — value statement for epic 1}\n\n{paragraph_2 — metric\u002Fimpact for epic 1}\n\n{paragraph_3 — value statement for epic 2 or feat: summary}\n```\n\nWhen `format = keep-a-changelog` or `conventional-only`: skip this step (no Highlights block).\n\n### Step 5 — Map to Changelog Sections\n\n| Commit Type | Hybrid \u002F KaC Section | Conventional-only |\n|------------|---------------------|-------------------|\n| `feat` | **Added** | `feat` |\n| `fix` | **Fixed** | `fix` |\n| `refactor` | **Changed** | `refactor` |\n| `perf` | **Changed** | `perf` |\n| `docs` | **Documentation** (optional) | `docs` |\n| `chore` | *(skip)* | `chore` |\n| `build`, `ci`, `test`, `style` | *(skip)* | *(skip)* |\n| `BREAKING CHANGE` \u002F `feat!` \u002F `fix!` | **Breaking Changes** (top) | `breaking` |\n| `deprecate` | **Deprecated** | `deprecate` |\n| `revert` | **Removed** | `revert` |\n\nSection order (hybrid + keep-a-changelog): Breaking Changes > Highlights (hybrid only) > Added > Changed > Deprecated > Removed > Fixed > Security.\n\n### Step 6 — Generate CHANGELOG.md\n\n**Template:** uses `_TEMPLATE-CHANGELOG-ENTRY.md` to render each version entry.\n\n**If CHANGELOG.md does not exist**, create with header:\n\n```markdown\n# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https:\u002F\u002Fkeepachangelog.com\u002Fen\u002F1.1.0\u002F),\nand this project adheres to [Semantic Versioning](https:\u002F\u002Fsemver.org\u002Fspec\u002Fv2.0.0.html).\n\n## [Unreleased]\n```\n\n**If CHANGELOG.md exists**, insert new version section after header \u002F after `[Unreleased]`:\n\n```markdown\n## [{version}] — YYYY-MM-DD\n\n### Highlights\n\n{highlights_block}\n\n### Breaking Changes\n\n- {breaking entries}\n\n### Added\n\n- {feat entries}\n\n### Changed\n\n- {refactor\u002Fperf entries}\n\n### Fixed\n\n- {fix entries}\n```\n\nOnly include sections that have entries (omit empty sections). Update `[Unreleased]` section (clear entries that moved to this version).\n\n**Entry format:**\n```markdown\n- {description} ([#{PR_number}]({PR_url})) — when PR linkable\n- {description} ({commit_hash_short}) — when no PR\n```\n\n**Version comparison links** (bottom of CHANGELOG):\n```markdown\n[unreleased]: https:\u002F\u002Fgithub.com\u002F{owner}\u002F{repo}\u002Fcompare\u002F{latest_tag}...HEAD\n[3.10.0]: https:\u002F\u002Fgithub.com\u002F{owner}\u002F{repo}\u002Fcompare\u002Fv3.9.0...v3.10.0\n```\n\n### Step 7 — Report\n\n```\nCHANGELOG.md updated:\n  Version:    {version or Unreleased}\n  Format:     {hybrid | keep-a-changelog | conventional-only}\n  Epics v2:   {count found} (Highlights: {paragraphs} paragraphs)\n  Entries:    {count}\n  Sections:   Breaking ({n}), Added ({n}), Changed ({n}), Fixed ({n})\n  Range:      {from_tag}..{to_ref}\n  Warnings:   {any D-R10 or truncation warnings}\n```\n\n## D-R10 — Degraded Mode (EPIC-0070 Unavailable)\n\nWhen v2 epic content is absent (no `ai\u002Fepics\u002F` directory, no v2 epics in range, or EPIC-0070 not installed):\n\n1. Emit visible WARN: `\"EPIC-0070 not available or no v2 epics in range — Highlights manual or degraded\"`.\n2. Generate changelog WITHOUT Highlights block (or with empty Highlights placeholder).\n3. Proceed with Keep-a-Changelog sections from Conventional Commits (always available).\n4. **Exit 0 — never block release.**\n\nD-R10 degraded output:\n```markdown\n## [v3.10.0] — YYYY-MM-DD\n\n\u003C!-- WARN: Highlights not generated (EPIC-0070 v2 epics not found in range). Update manually. -->\n\n### Added\n- {feat entries}\n```\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| No tags found | Use all commits from initial commit |\n| No Conventional Commits in range | Report \"No conventional commits found in range\" |\n| Non-conventional commit | Skip with WARN |\n| CHANGELOG.md has unexpected format | Append new section at the end with WARN |\n| Version tag already in CHANGELOG | Exit 0 \"Version already documented\" |\n| `format` value invalid | Exit 1 `INVALID_CHANGELOG_FORMAT`; list valid values on stderr |\n| `## Entrega de Valor` absent in v2 epic | Skip epic for Highlights; use feat: summaries as filler |\n| Content sanitization fails | Strip offending content; log WARN; proceed |\n\n## Performance Contract\n\n- Total generation time: \u003C 60s for ranges with 100+ commits and 10 merged epics.\n- Epic file reading: ≤ 50 lines per epic file (only `## Entrega de Valor` section).\n\n## Integration Notes\n\n| Skill | Relationship | Context |\n|-------|-------------|---------|\n| `x-release` | called-by | Release Step 5 changelog generation |\n| `x-generate-docs` | called-by | When `--type changelog` delegated |\n| `x-internal-write-report` | uses | Template rendering for CHANGELOG entry |\n","## Global Output Policy\n\n- **Language**: English ONLY.\n- **Tone**: Technical, Direct, and Concise.\n- **Efficiency**: Remove all conversational fillers and greetings to save tokens.\n\n# Skill: Changelog Generator v2\n\n## Purpose\n\nGenerates or updates `CHANGELOG.md` for {{PROJECT_NAME}} in **hybrid format** (default): a narrative `### Highlights` block derived from `## Entrega de Valor` sections of merged EPIC-0070 v2 epics, followed by rigorously structured Keep-a-Changelog sections populated from Conventional Commits.\n\nFormat is configurable via `documentation.changelog.format` in the project YAML:\n- `hybrid` (default): Highlights block + Keep-a-Changelog sections\n- `keep-a-changelog`: Keep-a-Changelog only (no Highlights), same as v1 behavior\n- `conventional-only`: Raw Conventional Commit grouping without KaC normalization\n\nWhen v2 epic content is unavailable, degrades gracefully per **D-R10**: empty Highlights + visible WARN + exit 0 (never blocks release).\n\n## Triggers\n\n- `\u002Fx-generate-release-changelog` — generate hybrid changelog for unreleased changes\n- `\u002Fx-generate-release-changelog v3.10.0` — generate entry for version v3.10.0\n- `\u002Fx-generate-release-changelog --unreleased` — unreleased changes since last tag\n- `\u002Fx-generate-release-changelog --full` — regenerate entire changelog from all tags\n- `\u002Fx-generate-release-changelog --format keep-a-changelog` — v1 format (no Highlights)\n- `\u002Fx-generate-release-changelog --format conventional-only` — raw commit grouping\n\n## Parameters\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| Version tag | No | Target version (e.g., `v3.10.0`). Default: unreleased. |\n| `--unreleased` | No | Only unreleased changes since last tag. |\n| `--full` | No | Regenerate entire changelog from all tags. |\n| `--format` | No | Output format: `hybrid` (default), `keep-a-changelog`, `conventional-only`. Overrides `documentation.changelog.format` from YAML. |\n| `--highlights-min` | No | Minimum Highlights paragraphs. Default: 3. |\n| `--highlights-max` | No | Maximum Highlights paragraphs before truncation. Default: 8. |\n\n**Format validation:** if `documentation.changelog.format` or `--format` contains a value outside `{hybrid, keep-a-changelog, conventional-only}`, exit `INVALID_CHANGELOG_FORMAT` and list valid values on stderr.\n\n## Workflow\n\n```\n1. DETECT      -> Determine version range from tags; load format config\n2. EPICS       -> Collect merged EPIC-0070 v2 epics in range (for Highlights)\n3. PARSE       -> Extract commits in range, parse Conventional Commits\n4. HIGHLIGHTS  -> Generate narrative Highlights block (hybrid mode only)\n5. GROUP       -> Map commit types to KaC sections\n6. GENERATE    -> Create or update CHANGELOG.md (incremental)\n7. REPORT      -> Summary of entries added\n```\n\n### Step 1 — Detect Version Range and Load Config\n\n```bash\n# List all version tags, sorted by version\ngit tag --list 'v*' --sort=-v:refname\n\n# Determine range\n# If version tag given: previous_tag..version_tag\n# If --unreleased: latest_tag..HEAD\n# If --full: process all tags\n# If no argument: latest_tag..HEAD (same as --unreleased)\n```\n\nLoad `documentation.changelog.format` from project YAML:\n\n```bash\ncat iadev.yaml 2>\u002Fdev\u002Fnull | grep \"changelog\" | grep \"format\"\n```\n\nIf not found: default to `hybrid`. Apply `--format` flag override if present.\n\nValidate format value: if not in `{hybrid, keep-a-changelog, conventional-only}` → exit 1 `INVALID_CHANGELOG_FORMAT`.\n\n### Step 2 — Collect EPIC-0070 v2 Epics in Range (hybrid mode only)\n\nIdentify epic markdown files added\u002Fmodified in the git range:\n\n```bash\ngit log {previous_tag}..{target} --diff-filter=AM --name-only -- 'ai\u002Fepics\u002Fepic-*\u002Fepic-*.md' 2>\u002Fdev\u002Fnull\n```\n\nFor each epic file found, read the `## Entrega de Valor` section (or `## 2. Persona & Cenário de Uso` + `## 3. Hipótese de Valor` as fallback):\n\n```bash\n# Extract Entrega de Valor content from epic markdown\nawk '\u002F^## (2\\. )?Entrega de Valor\u002F,\u002F^## [0-9]\u002F' {epic_file} | head -50\n```\n\nApply v2 template detection: epic uses v2 if it contains `## 1. Visão & Problema` (not `## Packages — Hexagonal`).\n\n**D-R10 — Fallback when no v2 epics found:**\n- No epic files in range, OR\n- All epic files found are v1 (contain `## Packages — Hexagonal`), OR\n- `ai\u002Fepics\u002F` directory absent:\n\n```\nWARN [x-generate-release-changelog] No EPIC-0070 v2 epics found in range {range} — Highlights will be empty.\n     Install\u002Fmerge EPIC-0070 epics to enable narrative Highlights. (D-R10 degraded mode)\n```\n\nSet Highlights to empty; proceed without blocking.\n\n### Step 3 — Parse Conventional Commits\n\n```bash\n# Extract commits in range\ngit log {previous_tag}..{target} --format=\"%H|%s|%b|%an|%ai\" --no-merges\n```\n\nParse each commit as Conventional Commit:\n```\n\u003Ctype>(\u003Cscope>): \u003Cdescription>\n```\n\nExtract: type, scope, description, breaking flag (`!` after type or `BREAKING CHANGE:` in body), body.\n\nSkip commits that don't follow the convention (log WARN, do not abort).\n\n### Step 4 — Generate Highlights Block (hybrid mode only)\n\nWhen `format = hybrid` and ≥ 1 v2 epic was found:\n\n1. For each v2 epic with `## Entrega de Valor`, extract the section content (sanitized).\n2. Consolidate across epics into a narrative block targeting 3–8 paragraphs:\n   - Each epic contributes up to 2 paragraphs (value statement + metric).\n   - Remaining paragraph budget filled with top `feat:` entries summarized by scope.\n3. **Minimum (3 paragraphs):** if fewer than 3 paragraphs can be derived from epic content, expand with bullet-point summaries of `feat:` commits until minimum is reached.\n4. **Maximum (8 paragraphs):** if more than 8 paragraphs would be generated, truncate with trailing `...` and emit:\n   ```\n   WARN [x-generate-release-changelog] Highlights truncated at 8 paragraphs — review manually.\n   ```\n\n**Content sanitization:** strip markdown link syntax (`[text](url)`) that references internal CI paths. Escape `\u003C`, `>`, `&` characters. Never include paths matching `\u002Fhome\u002F`, `\u002Ftmp\u002F`, `\u002Fvar\u002F`, `\u002FUsers\u002F` (CI runner internals). Remove environment variables (`$VAR`, `${VAR}`).\n\n**Highlights format:**\n```markdown\n### Highlights\n\n{paragraph_1 — value statement for epic 1}\n\n{paragraph_2 — metric\u002Fimpact for epic 1}\n\n{paragraph_3 — value statement for epic 2 or feat: summary}\n```\n\nWhen `format = keep-a-changelog` or `conventional-only`: skip this step (no Highlights block).\n\n### Step 5 — Map to Changelog Sections\n\n| Commit Type | Hybrid \u002F KaC Section | Conventional-only |\n|------------|---------------------|-------------------|\n| `feat` | **Added** | `feat` |\n| `fix` | **Fixed** | `fix` |\n| `refactor` | **Changed** | `refactor` |\n| `perf` | **Changed** | `perf` |\n| `docs` | **Documentation** (optional) | `docs` |\n| `chore` | *(skip)* | `chore` |\n| `build`, `ci`, `test`, `style` | *(skip)* | *(skip)* |\n| `BREAKING CHANGE` \u002F `feat!` \u002F `fix!` | **Breaking Changes** (top) | `breaking` |\n| `deprecate` | **Deprecated** | `deprecate` |\n| `revert` | **Removed** | `revert` |\n\nSection order (hybrid + keep-a-changelog): Breaking Changes > Highlights (hybrid only) > Added > Changed > Deprecated > Removed > Fixed > Security.\n\n### Step 6 — Generate CHANGELOG.md\n\n**Template:** uses `_TEMPLATE-CHANGELOG-ENTRY.md` to render each version entry.\n\n**If CHANGELOG.md does not exist**, create with header:\n\n```markdown\n# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https:\u002F\u002Fkeepachangelog.com\u002Fen\u002F1.1.0\u002F),\nand this project adheres to [Semantic Versioning](https:\u002F\u002Fsemver.org\u002Fspec\u002Fv2.0.0.html).\n\n## [Unreleased]\n```\n\n**If CHANGELOG.md exists**, insert new version section after header \u002F after `[Unreleased]`:\n\n```markdown\n## [{version}] — YYYY-MM-DD\n\n### Highlights\n\n{highlights_block}\n\n### Breaking Changes\n\n- {breaking entries}\n\n### Added\n\n- {feat entries}\n\n### Changed\n\n- {refactor\u002Fperf entries}\n\n### Fixed\n\n- {fix entries}\n```\n\nOnly include sections that have entries (omit empty sections). Update `[Unreleased]` section (clear entries that moved to this version).\n\n**Entry format:**\n```markdown\n- {description} ([#{PR_number}]({PR_url})) — when PR linkable\n- {description} ({commit_hash_short}) — when no PR\n```\n\n**Version comparison links** (bottom of CHANGELOG):\n```markdown\n[unreleased]: https:\u002F\u002Fgithub.com\u002F{owner}\u002F{repo}\u002Fcompare\u002F{latest_tag}...HEAD\n[3.10.0]: https:\u002F\u002Fgithub.com\u002F{owner}\u002F{repo}\u002Fcompare\u002Fv3.9.0...v3.10.0\n```\n\n### Step 7 — Report\n\n```\nCHANGELOG.md updated:\n  Version:    {version or Unreleased}\n  Format:     {hybrid | keep-a-changelog | conventional-only}\n  Epics v2:   {count found} (Highlights: {paragraphs} paragraphs)\n  Entries:    {count}\n  Sections:   Breaking ({n}), Added ({n}), Changed ({n}), Fixed ({n})\n  Range:      {from_tag}..{to_ref}\n  Warnings:   {any D-R10 or truncation warnings}\n```\n\n## D-R10 — Degraded Mode (EPIC-0070 Unavailable)\n\nWhen v2 epic content is absent (no `ai\u002Fepics\u002F` directory, no v2 epics in range, or EPIC-0070 not installed):\n\n1. Emit visible WARN: `\"EPIC-0070 not available or no v2 epics in range — Highlights manual or degraded\"`.\n2. Generate changelog WITHOUT Highlights block (or with empty Highlights placeholder).\n3. Proceed with Keep-a-Changelog sections from Conventional Commits (always available).\n4. **Exit 0 — never block release.**\n\nD-R10 degraded output:\n```markdown\n## [v3.10.0] — YYYY-MM-DD\n\n\u003C!-- WARN: Highlights not generated (EPIC-0070 v2 epics not found in range). Update manually. -->\n\n### Added\n- {feat entries}\n```\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| No tags found | Use all commits from initial commit |\n| No Conventional Commits in range | Report \"No conventional commits found in range\" |\n| Non-conventional commit | Skip with WARN |\n| CHANGELOG.md has unexpected format | Append new section at the end with WARN |\n| Version tag already in CHANGELOG | Exit 0 \"Version already documented\" |\n| `format` value invalid | Exit 1 `INVALID_CHANGELOG_FORMAT`; list valid values on stderr |\n| `## Entrega de Valor` absent in v2 epic | Skip epic for Highlights; use feat: summaries as filler |\n| Content sanitization fails | Strip offending content; log WARN; proceed |\n\n## Performance Contract\n\n- Total generation time: \u003C 60s for ranges with 100+ commits and 10 merged epics.\n- Epic file reading: ≤ 50 lines per epic file (only `## Entrega de Valor` section).\n\n## Integration Notes\n\n| Skill | Relationship | Context |\n|-------|-------------|---------|\n| `x-release` | called-by | Release Step 5 changelog generation |\n| `x-generate-docs` | called-by | When `--type changelog` delegated |\n| `x-internal-write-report` | uses | Template rendering for CHANGELOG entry |\n",{"name":5,"model":24,"description":7,"allowed-tools":25,"argument-hint":26,"user-invocable":27,"requires-capabilities":28},"sonnet","Read, Write, Edit, Bash, Grep, Glob","[version-tag | --unreleased | --full] [--format hybrid|keep-a-changelog|conventional-only]",true,[29],"governance.doc-as-dod","main","952a630c6f38d193a349d86fa18db1de8843e837","src\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-generate-release-changelog",1,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment","https:\u002F\u002Fgithub.com\u002Freview-bench","https:\u002F\u002Freview-bench.ai","An open benchmark for AI code review.","2026-10-27 06:56:37",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":27},[41,44,47],{"tool":42,"command":43},"npx","npx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-generate-release-changelog",{"tool":45,"command":46},"bunx","bunx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-generate-release-changelog",{"tool":48,"command":49},"pnpm","pnpm dlx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-generate-release-changelog","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-generate-release-changelog\u002FSKILL.md",[52],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"README.md","REFERENCE","参考文档",1654,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Fmain\u002Fresources\u002Ftargets\u002Fclaude\u002Fskills\u002Fcore\u002Fops\u002Fx-generate-release-changelog\u002FREADME.md",[59,66,73,80,87,94],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M757M8J48TQ1Y3X25GSJBXAS","x-parallel-eval","Detects and classifies file-collision risks between work units (tasks, stories, or epic phases) before parallel execution. Reads ## File Footprint blocks produced by x-task-plan \u002F x-story-plan, applies the parallelism-heuristics knowledge pack (hard \u002F regen \u002F soft categories + hotspot overrides), and emits a collision matrix + serialization recommendation in Markdown (default) or JSON.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fx-parallel-eval\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M757M57XMR9546S69466HDWT","parallelism-heuristics","Canonical catalog of file-collision heuristics for parallel task, story, and epic execution. Defines the File Footprint block format, the three Conflict Categories (hard \u002F regen \u002F soft), a hotspot list of high-contention paths, and the degrade-with-warning policy. Consumed by x-task-plan, x-story-plan, x-epic-map, x-parallel-eval, and x-dev-*-implement.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fparallelism-heuristics\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M757M11SZ8P1VCQABT08QVYA","x-watch-pr-ci","Polls a PR's CI checks and Copilot review status, blocking until checks complete or timeout. Returns one of 8 stable exit codes (SUCCESS=0, CI_PENDING_PROCEED=10, CI_FAILED=20, TIMEOUT=30, PR_ALREADY_MERGED=40, NO_CI_CONFIGURED=50, PR_CLOSED=60, PR_NOT_FOUND=70). Writes a versioned state-file for session resume.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-watch-pr-ci\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M757KW53K8KFPGADFB4PH949","x-validate-docs","Documentation freshness gate: validates 6 dimensions (readme, api-specs, grpc-proto, adr, skill-docs, system-architecture) against code changes in a PR. Stack-aware — only validates targets declared\u002Fauto-detected from ProjectConfig.documentation.targets. Returns exit non-zero on staleness; produces structured report.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-validate-docs\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M757KQZHSA10MKC0CR571D60","x-update-system-architecture","Incrementally updates docs\u002Farchitecture\u002Fsystem.md after an epic completes. Appends new entries to the Decision Log (§11) using x-internal-write-report --append (dedup by ## ID: marker) and surgically inserts component\u002Fintegration changes into sections 1-10 via Edit. Idempotent: re-running with the same epic produces a byte-identical system.md.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-update-system-architecture\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M757KKBT5Q1SVF8DMJBVF46M","x-update-architecture","Incrementally updates the service architecture document with changes from architecture plans. Adds new components, integrations, flows, and ADR references without rewriting existing content. Use after implementation to keep architecture documentation current.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-update-architecture\u002FSKILL.md",[],[]]