speckit-orchestrator

athola 的头像作者 athola

规范驱动开发的工作流协调器。协调技能加载、跟踪进度并确保speckit工作流程的一致性。触发器:speckit工作流程、规范驱动开发、speckit命令、工作流协调、进度跟踪、技能加载、speckit会话。适用场景:启动任何/speckit.*命令、协调多阶段开发、跟踪规范/规划/实施之间的进度。不适用场景:编写规范-直接使用spec-writing技能。不适用场景:生成任务-直接使用task-planning技能。所有规范驱动开发工作流程的入口点。

📖 中文导读:规范驱动开发的工作流协调器。协调技能加载、跟踪进度并确保speckit工作流程的一致性。触发器:speckit工作流程、规范驱动开发、speckit命令、工作流协调、进度跟踪、技能加载、speckit会话。适用场景:启动任何/speckit.*命令、协调多阶段开发、跟踪规范/规划/实施之间的进度。不适用场景:编写规范-直接使用spec-writing技能。不适用场景:生成任务-直接使用task-planning技能。所有规范驱动开发工作流程的入口点。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: speckit-orchestrator description: |

Triggers: specification, speckit, planning, orchestrator, orchestration Workflow orchestrator for Spec Driven Development. Coordinates skills and tracks progress.

Triggers: speckit workflow, spec driven development, speckit commands Use when: starting any /speckit-* command or coordinating multi-phase development category: workflow-orchestration tags: [speckit, workflow, orchestration, planning, specification] dependencies: - spec-kit:shared - sanctum:git-workspace-review - imbue:evidence-logging - superpowers:brainstorming - superpowers:writing-plans - superpowers:executing-plans tools: [] modules: - command-skill-matrix - progress-tracking progressive_loading: true usage_patterns: - workflow-coordination - progress-tracking - skill-loading complexity: intermediate estimated_tokens: 1500

Table of Contents

Speckit Orchestrator

Overview

Coordinates the Spec Driven Development workflow, skill loading, and progress tracking throughout the command lifecycle.

Persistent Presence Lens

Treat SDD as a minimal, testable “self-modeling” loop:

  • World model: repo + speckit artifacts (spec.md, plan.md, tasks.md)
  • Agent model: loaded skills/plugins + constraints (especially .specify/memory/constitution.md) + progress state

This mirrors patterns from open-ended embodied agents (e.g., Voyager/MineDojo) that compound capability via a curriculum (tasks.md) and a skill library (reusable plugin skills + superpowers methodology skills).

When to Use

  • Starting any /speckit-* command.
  • Coordinating multi-phase development workflows.
  • Tracking progress across specification, planning, and implementation.
  • Ensuring skill dependencies are loaded.

Core Workflow

Session Initialization

  1. Verify Repository Context

    • Confirm working directory is a speckit-enabled project.
    • Check for .specify/ directory structure.
    • Validate required scripts exist.
  2. Load Persistent State ("presence")

    • Read .specify/memory/constitution.md for constraints/principles.
    • Load current spec.md / plan.md / tasks.md context if present.
  3. Load Command Dependencies

    • Match current command to required skills.
    • Load complementary superpowers skills.
  4. Initialize Progress Tracking

    • Create TodoWrite items for workflow phases.
    • Track completion status.

Command-Skill Matrix

Quick reference for command-to-skill mappings:

Command Primary Skill Complementary Skills
/speckit-specify spec-writing brainstorming
/speckit-clarify spec-writing brainstorming
/speckit-plan task-planning writing-plans
/speckit-tasks task-planning executing-plans
/speckit-implement - executing-plans, systematic-debugging
/speckit-analyze - systematic-debugging, verification
/speckit-checklist - verification-before-completion

For detailed patterns: See modules/command-skill-matrix.md for complete mappings and loading rules.

Progress Tracking Items

For each workflow session, track:

  • Repository context verified.
  • Prerequisites validated.
  • Command-specific skills loaded.
  • Artifacts created/updated.
  • Verification completed.

For detailed patterns: See modules/progress-tracking.md for TodoWrite patterns and metrics.

Exit Criteria

  • Active command completed successfully.
  • All required artifacts exist and are valid.
  • Progress tracking reflects current state.
  • No unresolved blockers.
  • spec-writing: Specification creation and refinement.
  • task-planning: Task generation and planning.
  • superpowers:brainstorming: Idea refinement.
  • superpowers:writing-plans: Implementation planning.
  • superpowers:executing-plans: Task execution.

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag