plan-management

Zate 的头像作者 Zate

devloop计划文件位置、格式和更新程序的中央参考。所有代理和命令必须遵循这些约定以保持计划同步。使用devloop计划时使用。

📖 中文导读:devloop计划文件位置、格式和更新程序的中央参考。所有代理和命令必须遵循这些约定以保持计划同步。使用devloop计划时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: plan-management description: This skill should be used when creating, reading, or updating devloop plans in .devloop/plan.md, task tracking, progress logs, phase management, PR feedback whenToUse: Creating or updating plans, reading plan state, understanding task status, marking tasks complete, adding progress entries, phase transitions, PR feedback tracking whenNotToUse: Quick tasks without formal plans, exploratory spikes, simple TODOs seeAlso:

  • skill: pr-feedback when: integrating PR review comments
  • skill: local-config when: project-specific settings

Plan Management

Conventions for .devloop/plan.md file format and updates.

Plan Location

Primary: .devloop/plan.md

Plan Format

# Devloop Plan: [Feature Name]

**Created**: YYYY-MM-DD
**Updated**: YYYY-MM-DD HH:MM
**Status**: Planning | In Progress | Complete
**Issue**: #123 (https://github.com/owner/repo/issues/123) (optional, if started from GH issue)
**Branch**: feat/feature-name (optional)
**PR**: https://github.com/.../pull/123 (after PR created)

## Overview

Brief description of the plan.

## Phase 1: [Phase Name]

- [ ] Task 1.1: Description
  - Acceptance: Criteria
  - Files: Expected files

## PR Feedback (after review)

PR #123 - @reviewer (CHANGES_REQUESTED)

### Blockers
- [ ] [PR-123-1] Fix issue (@reviewer)

### Suggestions
- [ ] [PR-123-2] Consider alternative (@reviewer)

## Progress Log
- [timestamp]: Event

Task Markers

Marker Meaning
- [ ] Pending
- [x] Completed
- [~] In progress
- [!] Blocked

PR Feedback Task IDs

Format: [PR-{number}-{item}]

Example: [PR-123-1] = First feedback item from PR #123

Parallelism Markers

  • [parallel:A] - Can run with other Group A tasks
  • [depends:N.M] - Must wait for Task N.M

Update Rules

  1. Mark tasks in progress: - [~]
  2. Mark tasks complete: - [x]
  3. Add Progress Log entry
  4. Update timestamps
  5. Add PR link after PR creation
  6. Add PR Feedback section after review
  7. Add Issue link if started from GitHub Issue

GitHub Issues Integration

When using issue-driven development (configured in local.md):

Starting from Issue

Use /devloop:from-issue 123 to fetch issue details and create a plan with:

  • **Issue**: #123 (URL) in the header
  • Issue title becomes plan title
  • Issue body provides context for planning

On Plan Completion

When all tasks are [x] and Issue is linked:

  1. Generate completion summary (tasks done, time elapsed)
  2. Post summary as comment on the issue
  3. Optionally close the issue (based on github.auto-close setting)

Issue Reference Format

**Issue**: #123 (https://github.com/owner/repo/issues/123)

The number after # is parsed by archive-plan.sh for GitHub integration.