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:42
