AgentSkillsCN

decisions

当一项重大决策已被作出并得到确认，或需要记录为何做出这一选择，又或是需要回溯过往决策时，可使用此技能。切勿用于日常的实施性选择，或仍在讨论中的决策。

SKILL.md
--- frontmatter
name: decisions
description: Use this skill when a significant decision has been made and confirmed, when you need to record why a choice was made, or when referencing past decisions. Do not use for routine implementation choices or decisions still being discussed.
version: 1.0.0

Decisions

Projects may have a decisions.md file for recording significant decisions.

When to Record Decisions

Record a decision when:

  • •A significant choice was made after considering alternatives
  • •The decision affects future work (even if no code was written)
  • •You'd want to remember "why did we decide this?" later

Do NOT record:

  • •Exploration or experiments that didn't pan out
  • •Routine implementation choices
  • •Decisions still being discussed

Recording Format

Append to the project's decisions.md:

markdown
## YYYY-MM-DD: Brief Title
Context: [What prompted this decision]
Decision: [What we decided]
Rationale: [Why we chose this]

Example

markdown
# Decisions

## 2026-01-31: Use plugin architecture
Context: Wanted easier installation and portability for other users
Decision: Convert from install script to Claude Code plugin
Rationale: Plugins have one-line install, discoverable commands, and built-in distribution

## 2026-01-31: Save context on project switch
Context: Switching projects mid-session loses context about what was done
Decision: Write summary to CLAUDE.local.md when switching away from a project
Rationale: Captures context at the right moment, survives crashes, complements SessionEnd hook

On Resume

When resuming a project:

  • •Read decisions.md if it exists
  • •Reference relevant past decisions when they affect current work

Timing

Only record after the decision is confirmed and being acted on, not during exploration.