AgentSkillsCN

accept-adr

当用户表示“接受 {feature-name} 的 ADR”时,或在用户提供 feature-name 与 ADR 文件名时,可将已实现的 ADR 从功能目录移至 docs/adr/,作为正式收录的文档。在此过程中,需确认实现工作已完整无缺,精简内容,更新状态为“已接受”,并最终移至指定位置。

SKILL.md
--- frontmatter
name: accept-adr
description: >
  Move an implemented ADR from feature folder to docs/adr/ as accepted documentation.
  Use when user says "accept ADR for {feature-name}" or provides feature-name and adr-filename.
  Verifies implementation is complete, trims content, updates status to Accepted, and moves to final location.

Accept Implemented ADR

Move an implemented ADR from feature folder to docs/adr/ as accepted documentation.

Usage: When user says "accept ADR for {feature-name}" or provides {feature-name} {adr-filename}

Instructions

  1. Verify implementation is complete: The feature described in the ADR should be implemented and working

  2. Read the proposed ADR from docs/features/{feature-name}/{adr-filename}.md

  3. Final trim pass - Remove any content that's not needed for documentation:

    • No implementation notes or TODOs
    • No phase tracking or status checklists
    • Keep only: Context, Decision, Consequences
    • Ensure it's concise (fits on one screen ideally)
  4. Update status:

    • Change **Status**: Proposed to **Status**: Accepted
    • Update date to current date
  5. Move to docs/adr/:

    • Copy file to docs/adr/{adr-filename}.md
    • Verify it follows naming convention: adr-{YYMM}-{topic}.md
  6. Update feature status:

    • Change readme.md status to "Complete"
    • Update Decision section with link to final ADR location
  7. Output: Confirm the ADR was accepted and show final location

Post-Acceptance

The feature folder remains for historical context. The investigations document the exploration process; the accepted ADR in docs/adr/ is the authoritative decision record.

Future changes that supersede this ADR should:

  1. Create a new feature area (or reuse existing)
  2. Reference the original ADR being superseded
  3. Follow the full investigation -> ADR flow