workflow-status

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Workflow Status (the orchestrator's sensor)

工作流状态（编排器的传感器）

One read-only pass over the project that answers, in a single fixed JSON envelope: what exists, what is blocked on what, what is startable right now, and what the recommended next command is. Built for external orchestrators (see

docs/workflow/ORCHESTRATION.md

) but equally useful to a human asking "where do we stand?".

对项目执行一次只读扫描，通过一个固定的JSON信封回答以下问题：当前存在哪些内容、哪些任务被什么阻塞、哪些任务现在可以启动，以及推荐的下一步命令是什么。 专为外部编排器设计（参见

docs/workflow/ORCHESTRATION.md

），但对于询问“我们当前进展如何？”的人类用户同样有用。

Turn contract — verify before ending the turn

回合契约 — 结束回合前验证

✓ Every claim comes from a RUN command or a READ file (git/forge output, roadmap,
  fix index, feature folders) — nothing inferred from memory
✓ Nothing was edited, committed, pushed, or created — read-only, always
✓ `next.recommended` is non-bare (carries the unit's slug/NN, never a bare
  `/plan-feature`) AND staged by the target unit's resolved status:
  `idea`/undesigned → `/design-feature <slug>`; `defined` → `/plan-feature
  <slug>`; `planned` → `/execute-phase <NN>`
✓ A missing or non-frozen repository-state ledger emits a machine-readable
  substrate blocker and routes to discovery or resolution before any unit is
  listed as startable
✓ Every `detail.design_candidates[].next` begins with `/design-feature ` — design
  candidates always route to design, regardless of anything else
✓ When `--last-envelope` is supplied: the no-progress guard ran (crash-recovery
  checklist) — a hint that recommended `/plan-feature`/`/design-feature` for a
  unit still at its pre-advance status produces a `workflow_observations` note,
  never a silently repeated bland recommendation
✓ `recommendations.product_audit` was computed by the step-16 mechanical
  two-condition check (never guessed), and `next.tier` was derived from the
  resolved `next.recommended` command via the command→tier map in
  `## Machine envelope` (never guessed)
✓ Per-unit `review`/`closure`/`issues_born` (steps 10–12) were computed per
  their fixed rules — `adversarial.ran`/`n` stayed `null` unless real
  evidence exists, never guessed — and any fired `next.suggested[]` entries
  (step 13) quote their owning skill's condition verbatim, never a second
  copy of the trigger logic
✓ The envelope is emitted on **every** invocation of this skill, including a
  same-session natural-language follow-up about state — never replaced by prose
✓ The emitted envelope was checked against the shape reminders in
  `## Machine envelope` (mirroring
  `packages/agentic-workflow-schema/envelope.schema.json`) before printing
✓ The human-readable summary is printed, then the machine envelope (fenced
  ```json — see ## Machine envelope) is the ABSOLUTE last output

With

--json-only

, skip the human-readable summary: print the envelope alone.

✓ Every claim comes from a RUN command or a READ file (git/forge output, roadmap,
  fix index, feature folders) — nothing inferred from memory
✓ Nothing was edited, committed, pushed, or created — read-only, always
✓ `next.recommended` is non-bare (carries the unit's slug/NN, never a bare
  `/plan-feature`) AND staged by the target unit's resolved status:
  `idea`/undesigned → `/design-feature <slug>`; `defined` → `/plan-feature
  <slug>`; `planned` → `/execute-phase <NN>`
✓ A missing or non-frozen repository-state ledger emits a machine-readable
  substrate blocker and routes to discovery or resolution before any unit is
  listed as startable
✓ Every `detail.design_candidates[].next` begins with `/design-feature ` — design
  candidates always route to design, regardless of anything else
✓ When `--last-envelope` is supplied: the no-progress guard ran (crash-recovery
  checklist) — a hint that recommended `/plan-feature`/`/design-feature` for a
  unit still at its pre-advance status produces a `workflow_observations` note,
  never a silently repeated bland recommendation
✓ `recommendations.product_audit` was computed by the step-16 mechanical
  two-condition check (never guessed), and `next.tier` was derived from the
  resolved `next.recommended` command via the command→tier map in
  `## Machine envelope` (never guessed)
✓ Per-unit `review`/`closure`/`issues_born` (steps 10–12) were computed per
  their fixed rules — `adversarial.ran`/`n` stayed `null` unless real
  evidence exists, never guessed — and any fired `next.suggested[]` entries
  (step 13) quote their owning skill's condition verbatim, never a second
  copy of the trigger logic
✓ The envelope is emitted on **every** invocation of this skill, including a
  same-session natural-language follow-up about state — never replaced by prose
✓ The emitted envelope was checked against the shape reminders in
  `## Machine envelope` (mirroring
  `packages/agentic-workflow-schema/envelope.schema.json`) before printing
✓ The human-readable summary is printed, then the machine envelope (fenced
  ```json — see ## Machine envelope) is the ABSOLUTE last output

使用

--json-only

参数时，跳过人类可读摘要：仅打印信封内容。

When to use

何时使用

Between orchestration steps: an external driver runs it to decide the next command and model tier without parsing prose.
Before picking work manually: "what can I start right now?"
Not for judging quality (that's
```
review-change
```
/
```
audit-pr
```
) or product health (that's
```
product-audit
```
) — this skill reports state, it never judges.

编排步骤之间：外部驱动程序运行它，无需解析文本即可决定下一步命令和模型层级。
手动选择工作前：“我现在可以启动什么任务？”
不适合用于质量评判（那是
```
review-change
```
/
```
audit-pr
```
的用途）或产品健康度评估（那是
```
product-audit
```
的用途）——本技能仅报告状态，从不做评判。

Step 0 — Discover the project (always first)

步骤0 — 发现项目（始终第一步）

Per the agent guide's Workflow conventions + documentation map, then read what THIS skill needs:

docs/features/ROADMAP.md

, the fix index (

docs/fix/README.md

), every in-flight feature folder's

TASKS.md

progress.md

known-issues.md

, and

docs/features/SHIP_DECISIONS.md

if a ship-roadmap run exists.

遵循Agent指南中的工作流约定 + 文档地图，然后读取本技能所需的内容：

docs/features/ROADMAP.md

、修复索引（

docs/fix/README.md

）、每个进行中功能文件夹的

TASKS.md

progress.md

known-issues.md

，以及如果存在发布路线图运行记录，则读取

docs/features/SHIP_DECISIONS.md

。

Progressive loading — fixed sensor route

渐进式加载 — 固定传感器路径

The reference allowlist is exactly the seven linked paths below. Never invent or read another

references/

path. This skill is a read-only sensor. Every invocation loads this baseline in order:

sensor core
crash recovery
envelope core
envelope fields
guardrails

Add sensor signals only when a unit, issue, finding, or recommendation exists; an empty project skips that file but still emits the empty shapes defined by envelope fields. Add portability only when the platform actually lacks a named primitive.

--json-only

does not skip any baseline file.

All resources are one hop from this file. Missing required detail means

BLOCKED

; do not fabricate a partial envelope.

参考允许列表恰好是以下七个链接路径。切勿创建或读取其他

references/

路径。本技能是一个只读传感器。每次调用都会按顺序加载以下基线内容：

传感器核心
崩溃恢复
信封核心
信封字段
防护规则

仅当存在单元、问题、发现或建议时，才添加传感器信号；空项目会跳过该文件，但仍会输出信封字段定义的空结构。仅当平台确实缺少指定的原语时，才添加可移植性。

--json-only

不会跳过任何基线文件。

所有资源都与本文件直接关联。缺少必要细节意味着状态为

BLOCKED

；切勿编造部分信封。

Portability

可移植性

The sensor uses repository and forge commands only. When a named agent feature is unavailable, follow portability without changing the JSON contract.

传感器仅使用仓库和 forge 命令。当某个指定的Agent功能不可用时，请遵循可移植性要求，且不得修改JSON契约。

Relationship to other skills

与其他技能的关系

The sensor counterpart to
```
ship-roadmap
```
's conductor: an external orchestrator calls
```
workflow-status
```
→ routes on the envelope → invokes
```
plan-feature
```
/
```
execute-phase
```
/
```
review-change
```
/
```
audit-pr
```
/
```
triage-issue
```
directly, choosing the model per step — the same loop without the in-agent autopilot.
Read-only sibling of
```
audit-docs
```
(which judges coherence and can fix) and
```
product-audit
```
(which judges health): this one only reports state.
Schema owner:
```
orchestration-envelope
```
(internal).

是
```
ship-roadmap
```
编排器的传感器对应组件：外部编排器调用
```
workflow-status
```
→ 根据信封内容路由 → 直接调用
```
plan-feature
```
/
```
execute-phase
```
/
```
review-change
```
/
```
audit-pr
```
/
```
triage-issue
```
，为每个步骤选择模型——这是没有Agent内部自动驾驶的相同循环。
是
```
audit-docs
```
（评判一致性并可修复）和
```
product-audit
```
（评判健康度）的只读同类技能：本技能仅报告状态。
架构所有者：
```
orchestration-envelope
```
（内部）。

Done when

完成标志

Every roadmap/fix row, open PR, and in-flight folder was actually read, the dependency closures are computed transitively, and inconsistencies are reported (never repaired).
The
```
CRASH RECOVERY
```
sub-block was printed with a verdict from the decision table, and the envelope
```
state
```
matches it (CLEAN→OK, RESUMABLE→CONTINUE, AMBIGUOUS→NEEDS_INPUT).
With
```
--last-envelope
```
supplied: the no-progress guard ran — a stalled
```
/plan-feature
```
/
```
/design-feature
```
hint surfaces as a
```
workflow_observations
```
note, never a silent bland repeat, with no new write path introduced.
The human summary (unless
```
--json-only
```
) and the envelope — with
```
detail
```
carrying design_candidates, features, fixes, startable_now, blocked_units, open_prs, pending_triage,
```
untriaged_issues
```
(count + oldest_open) and
```
urgent
```
(labels-only issue list + interruptibility facts) — are printed, envelope last.
Each
```
detail.features[]
```
/
```
detail.fixes[]
```
entry additionally carries
```
review
```
,
```
closure
```
, and
```
issues_born
```
(steps 10–12) —
```
detail
```
-scoped, no schema change — and any fired triggers appear in a top-level
```
next.suggested[]
```
(step 13), single-sourced from the owning skill's own condition text.
Nothing was modified anywhere.

→ Next: the envelope's

next.recommended

command — it is computed from the actual state, so it IS the recommendation · a human overview → read the printed table · orchestrating programmatically → parse the last fenced json block

已实际读取每个路线图/修复条目、开放PR和进行中文件夹，已递归计算依赖关系闭包，并已报告不一致性（从不修复）。
已打印
```
CRASH RECOVERY
```
子块，并带有决策表得出的结论，且信封中的
```
state
```
与之匹配（CLEAN→OK，RESUMABLE→CONTINUE，AMBIGUOUS→NEEDS_INPUT）。
当提供
```
--last-envelope
```
时：已运行无进展防护——停滞的
```
/plan-feature
```
/
```
/design-feature
```
提示会作为
```
workflow_observations
```
注释显示，绝不会静默重复平淡的建议，且不会引入新的写入路径。
已打印人类可读摘要（除非使用
```
--json-only
```
）和信封——其中
```
detail
```
包含design_candidates、features、fixes、startable_now、blocked_units、open_prs、pending_triage、
```
untriaged_issues
```
（数量+最早开放时间）和
```
urgent
```
（仅标签问题列表+可中断性事实），信封最后输出。
每个
```
detail.features[]
```
/
```
detail.fixes[]
```
条目还包含
```
review
```
、
```
closure
```
和
```
issues_born
```
（步骤10–12）——属于
```
detail
```
范围，无架构变更——且任何触发的触发器都会出现在顶级
```
next.suggested[]
```
（步骤13）中，内容直接引用所属技能的条件文本。
未对任何内容进行修改。

→ 下一步：信封中的

next.recommended

命令——它由实际状态计算得出，因此本身就是建议 · 如需人类概览 → 阅读打印的表格 · 如需程序化编排 → 解析最后一个带围栏的json块