Back to Details

speckit-orchestrator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Table of Contents

目录

Speckit Orchestrator

Speckit 编排器

Overview

概览

Coordinates the Spec Driven Development workflow, skill loading, and progress tracking throughout the command lifecycle.
在整个命令生命周期内协调Spec Driven Development工作流、技能加载和进度追踪。

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).
将SDD视为一个最小化、可测试的「自建模」循环：
  • 世界模型：代码仓库 + speckit产物（
    spec.md
    、
    plan.md
    、
    tasks.md
    ）
  • Agent模型：已加载的技能/插件 + 约束（尤其是
    .specify/memory/constitution.md
    ） + 进度状态
这与开放式具身Agent（例如Voyager/MineDojo）的模式一致，这类Agent通过课程（
tasks.md
）和技能库（可复用的插件技能+超能力方法论技能）来叠加能力。

When To Use

适用场景

  • Starting any 
    /speckit-*
    command.
  • Coordinating multi-phase development workflows.
  • Tracking progress across specification, planning, and implementation.
  • Ensuring skill dependencies are loaded.
  • 启动任意
    /speckit-*
    命令时
  • 协调多阶段开发工作流时
  • 跨需求规约、规划、落地阶段追踪进度时
  • 确保技能依赖已加载时

When NOT To Use

不适用场景

  • Single-phase work (just specify, or just plan)
  • Non-spec-driven projects
  • 单阶段工作（仅做规约，或仅做规划）
  • 非spec驱动的项目

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.
  1. 校验代码仓库上下文
    • 确认工作目录是支持speckit的项目
    • 检查
      .specify/
      目录结构是否存在
    • 验证所需脚本是否存在
  2. 加载持久化状态（「存在状态」）
    • 读取
      .specify/memory/constitution.md
      获取约束/原则
    • 若存在
      spec.md
      /
      plan.md
      /
      tasks.md
      则加载其上下文
  3. 加载命令依赖
    • 将当前命令与所需技能匹配
    • 加载配套的超能力技能
  4. 初始化进度追踪
    • 为工作流各阶段创建TodoWrite条目
    • 追踪完成状态

Command-Skill Matrix

命令-技能映射表

Quick reference for command-to-skill mappings:
CommandPrimary SkillComplementary Skills
/speckit-specify
spec-writingbrainstorming
/speckit-clarify
spec-writingbrainstorming
/speckit-plan
task-planningwriting-plans
/speckit-tasks
task-planningexecuting-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.
See 
modules/writing-plans-extensions.md
for plan authoring patterns.
命令到技能映射的快速参考：
命令核心技能配套技能
/speckit-specify
spec-writingbrainstorming
/speckit-clarify
spec-writingbrainstorming
/speckit-plan
task-planningwriting-plans
/speckit-tasks
task-planningexecuting-plans
/speckit-implement
-executing-plans, systematic-debugging
/speckit-analyze
-systematic-debugging, verification
/speckit-checklist
-verification-before-completion
详细模式：完整映射和加载规则请查看
modules/command-skill-matrix.md
。
规划编写模式请查看
modules/writing-plans-extensions.md
。

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.
每个工作流会话需要追踪：
  • 代码仓库上下文已校验
  • 前置依赖已验证
  • 命令对应的专属技能已加载
  • 产物已创建/更新
  • 验证已完成
详细模式：TodoWrite模式和指标请查看
modules/progress-tracking.md
。

Exit Criteria

退出标准

  • Active command completed successfully.
  • All required artifacts exist and are valid.
  • Progress tracking reflects current state.
  • No unresolved blockers.
  • 活跃命令已成功执行完成
  • 所有必填产物均存在且有效
  • 进度追踪已反映当前状态
  • 无未解决的阻塞问题

Related Skills

相关技能

  • 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.
  • spec-writing
    ：规约创建与优化
  • task-planning
    ：任务生成与规划
  • superpowers:brainstorming
    ：想法优化
  • superpowers:writing-plans
    ：落地规划
  • superpowers:executing-plans
    ：任务执行

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
命令未找到 请确保所有依赖已安装且位于PATH中
权限错误 请检查文件权限，使用合适的权限运行
非预期行为 使用
--verbose
参数开启详细日志