gsd:milestone-summary

Agent Skills › davepoon/buildwithclaude › gsd:milestone-summary

gsd:milestone-summary

GitHub

读取项目里程碑相关文档（如ROADMAP、REQUIREMENTS等），自动生成结构化的项目总结，涵盖概述、架构、决策等内容，旨在帮助新成员快速了解已完成的项目进展与细节。

plugins/gsd/skills/milestone-summary/SKILL.md davepoon/buildwithclaude

Trigger Scenarios

需要生成项目里程碑总结时为新团队成员提供项目背景介绍时

Install

npx skills add davepoon/buildwithclaude --skill gsd:milestone-summary -g -y

More Options

Non-standard path

npx skills add https://github.com/davepoon/buildwithclaude/tree/main/plugins/gsd/skills/milestone-summary -g -y

Use without installing

npx skills use davepoon/buildwithclaude@gsd:milestone-summary

指定 Agent (Claude Code)

npx skills add davepoon/buildwithclaude --skill gsd:milestone-summary -a claude-code -g -y

安装 repo 全部 skill

npx skills add davepoon/buildwithclaude --all -g -y

预览 repo 内 skill

npx skills add davepoon/buildwithclaude --list

SKILL.md

Frontmatter

{
    "name": "gsd:milestone-summary",
    "type": "prompt",
    "description": "Generate a comprehensive project summary from milestone artifacts for team onboarding and review",
    "allowed-tools": [
        "Read",
        "Write",
        "Bash",
        "Grep",
        "Glob"
    ],
    "argument-hint": "[version]"
}

Generate a structured milestone summary for team onboarding and project review. Reads completed milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION files) and produces a human-friendly overview of what was built, how, and why.

Purpose: Enable new team members to understand a completed project by reading one document and asking follow-up questions. Output: MILESTONE_SUMMARY written to .planning/reports/, presented inline, optional interactive Q&A.

<execution_context> @${CLAUDE_PLUGIN_ROOT}/workflows/milestone-summary.md </execution_context>

**Project files:** - `.planning/ROADMAP.md` - `.planning/PROJECT.md` - `.planning/STATE.md` - `.planning/RETROSPECTIVE.md` - `.planning/milestones/v{version}-ROADMAP.md` (if archived) - `.planning/milestones/v{version}-REQUIREMENTS.md` (if archived) - `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)

User input:

Version: $ARGUMENTS (optional — defaults to current/latest milestone)

Read and execute the milestone-summary workflow from @${CLAUDE_PLUGIN_ROOT}/workflows/milestone-summary.md end-to-end.

<success_criteria>

Milestone version resolved (from args, STATE.md, or archive scan)
All available artifacts read (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
Summary document written to .planning/reports/MILESTONE_SUMMARY-v{version}.md
All 7 sections generated (Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, Getting Started)
Summary presented inline to user
Interactive Q&A offered
STATE.md updated </success_criteria>

Version History

502fc01 Current 2026-07-05 15:13

Metadata

Files: 0
Version: 13c9cb5
Hash: f01d5fc6
Indexed: 2026-07-05 15:13

gsd:milestone-summary