AgentSkillsCN

Directions Workflow

启动生产环境的 Docker 容器，用于手动测试；将发现的缺陷或问题记录为特性文件，测试完成后及时关闭容器。

SKILL.md

Directions Workflow Skill

A methodology for AI-assisted development that maintains context across sessions.

Core Concepts

Project Phases

Projects move through phases: discovery → planning → implementation → polish → shipping

Each phase has different focus areas and relevant documentation.

Session Management

  • •Every session should check PROJECT_STATE.md for current focus
  • •Sessions are logged in docs/sessions/ with date-based filenames
  • •Handoff documents capture state for future sessions

Decision Logging

Architectural and design decisions are logged to docs/decisions.md with:

  • •Date
  • •What was decided
  • •Why (reasoning/trade-offs)
  • •Alternatives considered

Blocker Tracking

Blockers are tracked in PROJECT_STATE.md with:

  • •What's blocked
  • •What was tried
  • •What would unblock

File Structure

code
docs/
├── 00_base.md              # System overview (read first)
├── PROJECT_STATE.md        # Current phase, focus, blockers
├── decisions.md            # Decision log
├── sessions/
│   ├── _index.md           # Session index
│   └── YYYY-MM-DD-*.md     # Individual session logs
└── [numbered docs]         # Reference documentation

Available Commands

CommandPurpose
/setupInitialize or detect Directions
/statusShow current project state
/logCreate/update session log
/decideRecord a decision
/interviewRun discovery interview
/learnedAdd glossary term
/reorgReorganize folder structure
/update-directionsPull latest updates
/executeWave-based parallel execution
/cookbookManage reusable code patterns

Workflow Principles

  1. •Context First - Always read PROJECT_STATE.md before starting work
  2. •Log As You Go - Don't wait until end of session to log
  3. •Decisions Are Permanent - Log decisions when made, not retroactively
  4. •Blockers Are Signals - Track blockers to identify patterns
  5. •Handoffs Enable Continuity - Write handoffs as if for another person

Context Management

Prevent quality degradation during long sessions:

  1. •File Size Limits - PROJECT_STATE.md <80 lines, session logs ~200 lines
  2. •Temporary Files - PLAN.md and RESUME.md delete after use
  3. •Orchestrator Pattern - Keep main context <40%, spawn subagents for heavy work
  4. •Wave Execution - Group tasks by dependency, run parallel waves with fresh contexts
  5. •Atomic Commits - One task = one commit for easy revert/bisect

See 52_context-management.md for full details.