Agent Skills
› kinncj/Heimdall
› rfc-adr
rfc-adr
GitHub用于规范化和记录重大架构决策的 RFC/ADR 技能。指导在 docs/specs/ 下创建包含背景、目标、提案、权衡及多维度影响分析的标准化文档，适用于技术选型或模式变更场景。
触发场景
需要记录重大架构决策
在多个非平凡技术方案中选择
引入新技术或框架
改变现有重要设计模式
安装
npx skills add kinncj/Heimdall --skill rfc-adr -g -y
SKILL.md
Frontmatter
{
"name": "rfc-adr",
"description": "Author and manage Architecture Decision Records (ADRs) in docs\/specs\/. Use when a significant architectural decision needs to be documented."
}
SKILL: RFC / Architecture Decision Records
ADR Format
Every significant architectural decision gets an ADR. Store in: docs/specs/{feature}/adr.md
# ADR-{N}: {Short Title}
## Status
Proposed | Accepted | Deprecated | Superseded by ADR-{N}
## Context
What is the problem or situation that requires a decision?
What constraints exist?
## Goals
- {Specific, measurable goal}
## Non-goals
- {What this ADR does NOT address}
## Proposal
{Detailed technical proposal. Include code snippets if helpful.}
## Alternatives Considered
### Option A: {Name}
**Description:** {What it is}
**Pros:** {list}
**Cons:** {list}
### Option B: {Name}
**Description:** {What it is}
**Pros:** {list}
**Cons:** {list}
## Trade-offs and Risks
{Analysis of trade-offs. What could go wrong?}
## Impact
### Cost (FinOps)
{Estimated cloud cost impact. Monthly estimate if possible.}
### Operations (SRE)
{New runbook requirements. Alert thresholds. On-call implications.}
### Security
{Changes to attack surface. New threat vectors. Compliance implications.}
### Team
{Skill requirements. Training needed. Hiring implications.}
## Decision
{Final decision and rationale. Who made it and when.}
## Next Steps
- [ ] {Action item with owner}
- [ ] {Action item with owner}
When to Write an ADR
- Choosing between two or more non-trivial technical approaches.
- Adopting a new technology or framework.
- Changing a significant existing pattern.
- Making a trade-off with known long-term implications.
When NOT to Write an ADR
- Obvious choices with no real alternatives.
- Implementation details within an agreed-upon approach.
- Temporary decisions expected to change soon.
版本历史
- f4ea31f 当前 2026-07-05 10:44
