菜单
Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build the project and automatically fix any build errors, compilation failures, or type mismatches. Use when the project fails to build, shows "broken" states, or after making significant changes.
Perform a "hard reset" of the development environment. Use when dependencies are corrupted, lockfiles are out of sync, or environment tools (Trunk/uv) are in an inconsistent state.
Fix a GitHub issue end-to-end. Use when given an issue number to fix, implementing bug fixes, or addressing reported problems.
Self-improvement skill for evolving Claude Code configuration. Use when you notice repeated mistakes, want to add new workflows, or optimize the development experience. Enables Claude to improve its own CLAUDE.md, skills, hooks, and agents.
Run linters and fix violations, formatting errors, or style mismatches using Trunk. Use when code quality checks fail, before submitting PRs, or to repair "broken" linting states.
Manage changelogs using Changie. Provides tools to initialize, add change fragments, batch releases, and merge version notes.
| name | manage-adr |
| description | Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution. |
Architecture Decision Records (ADRs) are a lightweight way to document the "why" behind significant technical choices.
list).If ADRs are not yet initialized in the project, run:
adr init docs/adr
This ensures records are created in docs/adr.
To create a new ADR, use the provided script to ensure non-interactive creation:
.cursor/skills/manage-adr/scripts/create-adr.sh "Title of the ADR"
After creation, the script will output the filename. You MUST then edit the file to fill in the Context, Decision, and Consequences.
If a new decision replaces an old one, use the -s flag:
.cursor/skills/manage-adr/scripts/create-adr.sh -s <old-adr-number> "New Decision Title"
To link two existing ADRs (e.g., ADR 12 amends ADR 10):
adr link 12 Amends 10 "Amended by"
adr listread_file docs/adr/NNNN-title.mdadr generate tocadr generate graph | dot -Tpng -o adr-graph.pngreferences/adr-concepts.md for more details on the ADR philosophy.assets/template.md as a guide.