Agent Skills
› kinncj/Heimdall
› rfc-adr
rfc-adr
GitHub用于创建和管理架构决策记录（ADR），规范存储于docs/specs/目录。涵盖格式模板及适用场景，旨在记录重大技术选型、模式变更及其权衡利弊，确保决策可追溯并评估对成本、运维、安全的影响。
Trigger Scenarios
需要记录重大架构决策
在多个非平凡技术方案间进行选择
引入新技术或框架
改变现有显著模式
Install
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.
Version History
- f4ea31f Current 2026-07-05 10:41
