AgentSkillsCN

gsd-list-milestones

从 MILESTONES.md 注册表中展示已完成的里程碑。

SKILL.md
--- frontmatter
name: gsd-list-milestones
description: Display completed milestones from the MILESTONES.md registry
allowed-tools: Read, Bash
<objective> Display completed milestones from the MILESTONES.md registry.

Purpose: Show milestone history without scanning filesystem. Output: Formatted list of completed milestones with key accomplishments. </objective>

<execution_context> @.codex/get-shit-done/references/ui-brand.md </execution_context>

<context> Registry file: - `.planning/MILESTONES.md` — Milestone completion registry </context> <process> <step name="check_registry_exists"> Check if milestone registry exists using bash:
bash
if [ ! -f .planning/MILESTONES.md ]; then
    echo ""
    echo "No milestones completed yet."
    echo ""
    echo "Complete your first milestone with:"
    echo "  $gsd-complete-milestone"
    echo ""
    exit 0
fi

If registry doesn't exist: Show friendly message and exit. If registry exists: Continue to display step. </step>

<step name="display_milestones"> Display milestone history from registry:
bash
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo " GSD ► MILESTONE HISTORY"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""

# Display registry content
cat .planning/MILESTONES.md

echo ""
echo "───────────────────────────────────────────────────────────────"
echo ""
echo "Archived milestones are in: .planning/history/"
echo ""
echo "To view archived files:"
echo "  ls .planning/history/v1.0/"
echo "  cat .planning/history/v1.0/ROADMAP.md"
echo ""
echo "To start new milestone:"
echo "  $gsd-new-milestone"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
</step> </process>

<success_criteria>

  • Registry existence checked before display
  • Friendly message if no milestones completed yet
  • MILESTONES.md content displayed directly (no parsing)
  • Helpful bash commands shown for accessing archives
  • User knows next command (complete-milestone or new-milestone)
  • Template variables ($gsd-) used for cross-platform support </success_criteria>