speckit-orchestrator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

会话初始化

Verify Repository Context
- Confirm working directory is a speckit-enabled project.
- Check for
```
.specify/
```
  directory structure.
- Validate required scripts exist.
Load Persistent State ("presence")
- Read
```
.specify/memory/constitution.md
```
  for constraints/principles.
- Load current
```
spec.md
```
  /
```
plan.md
```
  /
```
tasks.md
```
  context if present.
Load Command Dependencies
- Match current command to required skills.
- Load complementary superpowers skills.
Initialize Progress Tracking
- Create TodoWrite items for workflow phases.
- Track completion status.

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

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.

See

modules/writing-plans-extensions.md

for plan authoring patterns.

命令到技能映射的快速参考：

命令	核心技能	配套技能
`/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

详细模式：完整映射和加载规则请查看

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

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

参数开启详细日志