AgentSkillsCN

project-planner

检测过时的项目计划，并提供会话指令建议。触发关键词：同步计划、更新计划、检查状态、计划已过时、追踪进度、项目规划。

SKILL.md
--- frontmatter
name: project-planner
description: "Detects stale project plans and suggests session commands. Triggers on: sync plan, update plan, check status, plan is stale, track progress, project planning."
allowed-tools: "Read Glob TaskList TaskCreate"

Project Planner Skill

Lightweight awareness layer for docs/PLAN.md. Detects when plans need attention and points to /save and /sync commands.

Purpose

This skill does NOT manage plans directly. It:

  • •Detects when docs/PLAN.md exists or is missing
  • •Identifies stale plans (no recent updates vs git activity)
  • •Suggests appropriate session commands

All plan operations go through /save (persist) and /sync (restore/status).

Detection Logic

Plan Missing

code
No docs/PLAN.md found
-> Suggest: /save to create initial plan from conversation

Plan Stale

code
docs/PLAN.md last modified: 5 days ago
git log shows: 12 commits since then
-> Suggest: /sync --git to update from commits

Uncommitted Work

code
git status shows: 5 modified files
docs/PLAN.md "In Progress" section outdated
-> Suggest: /sync --status to review

Session Start

code
Resuming work on project with docs/PLAN.md
-> Suggest: /sync to restore state

Quick Reference

SituationSuggestion
No plan exists/save after discussing goals
Plan is stale/sync --git
Need to see plan/sync --status
Update progress/save "notes"
Start fresh/save --archive

Staleness Heuristics

A plan is considered stale when:

  • •Last modified > 3 days ago AND
  • •Git shows commits since last modification AND
  • •Commits relate to plan topics (feat:, fix:, refactor:)

A plan needs review when:

  • •Session just started
  • •Significant uncommitted changes exist
  • •User mentions progress or completion

Notes

  • •This skill only suggests, never modifies
  • •/sync reads state, /save writes state
  • •Single source of truth: docs/PLAN.md