skill-system-review

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

skill-system-review

Bridge between OMO Prometheus and the TKT ticket lifecycle.

Two directions:

Review — After bundle closes, assemble structured review context for Prometheus to evaluate
Plan→TKT — Convert Prometheus plans into TKT roadmap bundles and worker tickets

OMO Prometheus与TKT工单生命周期的桥接工具。

双向功能：

审查 — Bundle关闭后，组装结构化审查上下文供Prometheus评估
计划→TKT — 将Prometheus计划转换为TKT路线图Bundle和执行工单

Operations

操作

generate-review-prompt

Generate a structured review context from a completed/active ticket for Prometheus review.

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-review-prompt --ticket-id <TKT-XXX>

Input:

--ticket-id

(required) — the ticket to build review context for Output: JSON with

review_context

prometheus_prompt

expected_output_format

Reads:

Bundle
```
review.yaml
```
(stub generated by
```
tkt.sh close
```
)
All completed ticket results in the bundle
Audit ticket (TKT-A00) findings
Current
```
roadmap.yaml
```
state

从已完成/活跃的工单中生成结构化审查上下文，供Prometheus进行审查。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-review-prompt --ticket-id <TKT-XXX>

输入：

--ticket-id

（必填）— 用于构建审查上下文的工单ID 输出：包含

review_context

、

prometheus_prompt

、

expected_output_format

的JSON

读取内容：

Bundle的
```
review.yaml
```
（由
```
tkt.sh close
```
生成的存根文件）
Bundle中所有已完成的工单结果
审计工单（TKT-A00）的发现
当前
```
roadmap.yaml
```
的状态

generate-startup-review-prompt

Generate a review overview prompt for Prometheus at session startup (no active ticket context).

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-startup-review-prompt

Output: JSON with

roadmap_summary

bundles

prometheus_prompt

在会话启动时为Prometheus生成审查概览提示词（无活跃工单上下文）。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-startup-review-prompt

输出：包含

roadmap_summary

、

bundles

、

prometheus_prompt

的JSON

generate-startup-review

Generate a compact startup context summary for the next session.

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-startup-review

Output: JSON with

context_summary

roadmap_summary

bundles

includes
```
carryover_bundles[]
```
when reviewed bundles still have carryover work

为下一会话生成简洁的启动上下文摘要。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-startup-review

输出：包含

context_summary

、

roadmap_summary

、

bundles

的JSON

当已审查的Bundle仍有未完成工作时，会包含
```
carryover_bundles[]
```

suggest-roadmap-update

Suggest roadmap changes from findings/issues without mutating

roadmap.yaml

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" suggest-roadmap-update --input findings.json

Output: JSON

suggestions[]

with

{phase, section, change_type, description, rationale}

根据发现的问题/议题提出路线图变更建议，不会修改

roadmap.yaml

。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" suggest-roadmap-update --input findings.json

输出：包含

suggestions[]

的JSON，其中每个建议对象包含

{phase, section, change_type, description, rationale}

plan-to-bundle

Convert a Prometheus plan file (

.sisyphus/drafts/*.md

) into TKT bundle creation commands.

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" plan-to-bundle --plan-file <path>

Input:

--plan-file

(required) — path to Prometheus plan markdown Output: JSON with

route

goal

tickets[]

tkt_commands[]

(ready-to-execute shell commands)

Parsing rules:

```
## 
```
or
```
### 
```
headings with TODO/task keywords → ticket titles
```
- [ ]
```
checkboxes → individual worker tickets
Dependency markers (
```
depends on
```
,
```
after
```
,
```
blocks
```
) →
```
depends_on
```
fields
Effort estimates → ticket description metadata
Categories (
```
visual-engineering
```
,
```
deep
```
,
```
quick
```
, etc.) → ticket
```
category
```
```
### WAVE N
```
headings → ticket
```
wave
```
metadata for following tasks
Structured ticket metadata lines (category, effort, acceptance, source metadata, skills, QA scenarios) → preserved into ticket objects and generated TKT commands
Tiny plans can route to express without filename mentions when they stay within the no-dependency, no-effort fast path

将Prometheus计划文件（

.sisyphus/drafts/*.md

）转换为TKT Bundle创建命令。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" plan-to-bundle --plan-file <path>

输入：

--plan-file

（必填）— Prometheus计划markdown文件的路径输出：包含

route

、

goal

、

tickets[]

、

tkt_commands[]

（可直接执行的shell命令）的JSON

解析规则：

包含TODO/任务关键词的
```
## 
```
或
```
### 
```
标题 → 工单标题
```
- [ ]
```
复选框 → 单个执行工单
依赖标记（
```
depends on
```
、
```
after
```
、
```
blocks
```
）→
```
depends_on
```
字段
工作量估算 → 工单描述元数据
分类（
```
visual-engineering
```
、
```
deep
```
、
```
quick
```
等）→ 工单
```
category
```
```
### WAVE N
```
标题 → 后续任务的工单
```
wave
```
元数据
结构化工单元数据行（分类、工作量、验收标准、源元数据、Skill、QA场景）→ 保留到工单对象并生成TKT命令
小型计划若符合无依赖、无工作量的快速路径，可无需提及文件名直接路由到快速处理通道

write-review-inbox

Write Prometheus review feedback into the Review Agent Inbox format for

refresh_review_inbox()

ingestion.

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" write-review-inbox --input <json-file>

Input: JSON file with

discussion_points[]

next_actions[]

batch_id

Output: Appends

## Review Agent Inbox

# TICKET_BATCH

section to

note/note_tasks.md

将Prometheus审查反馈转换为Review Agent收件箱格式，供

refresh_review_inbox()

导入。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" write-review-inbox --input <json-file>

输入：包含

discussion_points[]

、

next_actions[]

、

batch_id

的JSON文件输出：在

note/note_tasks.md

中追加

## Review Agent Inbox

# TICKET_BATCH

章节

generate-dispatch

Generate a worker dispatch view from bundle ticket state.

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-dispatch --bundle B-001 [--tickets TKT-001,TKT-002]
python3 "<this-skill-dir>/scripts/review_prompt.py" generate-dispatch --auto

Input:

--bundle

(required), optional

--tickets

comma list Output: human-readable wave summary plus last-line JSON containing grouped dispatch waves

Rules:

without
```
--tickets
```
, emit currently open worker tickets only
preserve bundle dependency order into
```
dispatch_wave
```
include one-line summary and effort estimate for each ticket
```
--auto
```
creates the suggested next bundle from
```
suggest-next-bundle
```
and immediately emits dispatch for it

根据Bundle工单状态生成执行任务分配视图。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" generate-dispatch --bundle B-001 [--tickets TKT-001,TKT-002]
python3 "<this-skill-dir>/scripts/review_prompt.py" generate-dispatch --auto

输入：

--bundle

（必填），可选

--tickets

逗号分隔列表输出：人类可读的Wave摘要，最后一行是包含分组分配Wave的JSON

规则：

若未指定
```
--tickets
```
，仅输出当前未关闭的执行工单
保留Bundle依赖顺序到
```
dispatch_wave
```
包含每个工单的单行摘要和工作量估算
```
--auto
```
从
```
suggest-next-bundle
```
创建建议的下一个Bundle，并立即为其生成分配视图

suggest-next-bundle

Suggest the next bundle goal and seed tickets from roadmap/open work/carryover.

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" suggest-next-bundle

Output: JSON with

goal

suggested_tickets[]

open_issues[]

根据路线图/未完成工作/未完成任务，建议下一个Bundle的目标和初始工单。

bash

python3 "<this-skill-dir>/scripts/review_prompt.py" suggest-next-bundle

输出：包含

goal

、

suggested_tickets[]

、

open_issues[]

的JSON

Integration with OMO Prometheus

与OMO Prometheus的集成

Prometheus as Review Agent

Prometheus作为审查代理

When a TKT bundle closes:

```
tkt.sh close
```
generates
```
review.yaml
```
stub
PM Agent calls
```
generate-review-prompt
```
to assemble review context
Prometheus receives the structured context and produces:
- ```
summary
```
  — what was accomplished
- ```
discussion_points[]
```
  — trade-offs, concerns, questions for user
- ```
next_actions[]
```
  — follow-up work items
- ```
quality_assessment
```
  — structured quality evaluation
```
write-review-inbox
```
converts Prometheus output into TKT-ingestible tickets
```
refresh_review_inbox()
```
picks up new tickets automatically

当TKT Bundle关闭时：

```
tkt.sh close
```
生成
```
review.yaml
```
存根文件
PM Agent调用
```
generate-review-prompt
```
组装审查上下文
Prometheus接收结构化上下文并生成：
- ```
summary
```
  — 已完成的工作内容
- ```
discussion_points[]
```
  — 权衡方案、关注点、向用户提出的问题
- ```
next_actions[]
```
  — 后续工作项
- ```
quality_assessment
```
  — 结构化质量评估
```
write-review-inbox
```
将Prometheus输出转换为TKT可导入的工单
```
refresh_review_inbox()
```
自动获取新工单

Prometheus as Roadmap Planner

Prometheus作为路线图规划器

When a user makes a new request through Prometheus:

Prometheus conducts structured interview (OMO default behavior)
Prometheus writes plan to
```
.sisyphus/drafts/
```
```
plan-to-bundle
```
reads the plan and generates TKT commands
PM Agent executes the commands to create roadmap goal + bundle + worker tickets
OMO dispatches agents to claim and execute tickets

当用户通过Prometheus提出新请求时：

Prometheus进行结构化访谈（OMO默认行为）
Prometheus将计划写入
```
.sisyphus/drafts/
```
```
plan-to-bundle
```
读取计划并生成TKT命令
PM Agent执行命令以创建路线图目标 + Bundle + 执行工单
OMO分配代理认领并执行工单

Prompt Reference

提示词参考

```
prompts/prometheus-tkt-integration.md
```
— Instructions for Prometheus on how to use TKT roadmap/bundle system
```
prompts/question-protocol.md
```
— Structured questioning guide for all scenarios (requirements, branch decisions, review discussion, roadmap planning). Implements the
```
question_tool_first
```
policy from
```
config/tkt.yaml
```
.

```
prompts/prometheus-tkt-integration.md
```
— 供Prometheus使用TKT路线图/Bundle系统的说明文档
```
prompts/question-protocol.md
```
— 适用于所有场景（需求、分支决策、审查讨论、路线图规划）的结构化提问指南。实现了
```
config/tkt.yaml
```
中的
```
question_tool_first
```
策略。

Compatibility

兼容性

tickets.py alignment:
```
review_prompt.py
```
path matches the hardcoded reference at
```
tickets.py:2468-2470
```

Review Inbox format: Output matches

parse_review_agent_inbox()

expected format (

## Review Agent Inbox

# TICKET_BATCH

)

Scope rules: Referenced in 14+ ticket scope
```
allowed_prefixes
```
entries in
```
tickets.py
```

skill

{
  "schema_version": "2.0",
  "id": "skill-system-review",
  "version": "1.0.0",
  "capabilities": [
    "review-generate",
    "review-startup",
    "review-startup-summary",
    "review-roadmap-suggestion",
    "review-plan-to-bundle",
    "review-generate-dispatch",
    "review-suggest-next-bundle",
    "review-write-inbox"
  ],
  "effects": ["fs.read", "fs.write"],
  "operations": {
    "generate-review-prompt": {
      "description": "Assemble structured review context from completed ticket/bundle for Prometheus",
      "input": { "ticket_id": { "type": "string", "required": true } },
      "output": { "description": "Review context JSON", "fields": { "review_context": "object", "prometheus_prompt": "string" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-review-prompt", "--ticket-id", "{ticket_id}"]
      }
    },
    "generate-startup-review-prompt": {
      "description": "Generate Prometheus review overview at session startup",
      "input": {},
      "output": { "description": "Startup review context JSON", "fields": { "roadmap_summary": "object", "bundles": "array", "prometheus_prompt": "string" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-startup-review-prompt"]
      }
    },
    "generate-startup-review": {
      "description": "Generate compact startup context summary from roadmap and recent bundle reviews",
      "input": {},
      "output": { "description": "Startup summary JSON", "fields": { "context_summary": "string", "roadmap_summary": "object", "bundles": "array" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-startup-review"]
      }
    },
    "suggest-roadmap-update": {
      "description": "Suggest roadmap updates from findings/issues without mutating roadmap.yaml",
      "input": {
        "input": { "type": "string", "required": false }
      },
      "output": {
        "description": "Roadmap suggestion payload",
        "fields": { "suggestions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "suggest-roadmap-update"]
      }
    },
    "plan-to-bundle": {
      "description": "Convert Prometheus plan markdown into TKT bundle or express creation commands with metadata preservation",
      "input": { "plan_file": { "type": "string", "required": true } },
      "output": { "description": "Bundle or express creation commands", "fields": { "route": "string", "goal": "string", "tickets": "array", "tkt_commands": "array" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "plan-to-bundle", "--plan-file", "{plan_file}"]
      }
    },
    "generate-dispatch": {
      "description": "Generate a human-readable + JSON dispatch prompt from bundle ticket state",
      "input": {
        "bundle": { "type": "string", "required": false },
        "tickets": { "type": "string", "required": false },
        "auto": { "type": "boolean", "required": false }
      },
      "output": {
        "description": "Dispatch payload grouped by waves",
        "fields": { "bundle": "string", "tickets": "array", "waves": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-dispatch", "--bundle", "{bundle}"]
      }
    },
    "suggest-next-bundle": {
      "description": "Suggest the next bundle goal and seed tickets from roadmap/open work/carryover",
      "input": {},
      "output": {
        "description": "Suggested next bundle payload",
        "fields": { "goal": "string", "suggested_tickets": "array", "open_issues": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "suggest-next-bundle"]
      }
    },
    "write-review-inbox": {
      "description": "Write Prometheus review feedback into Review Agent Inbox for ticket ingestion",
      "input": { "input_file": { "type": "string", "required": true } },
      "output": { "description": "Inbox write confirmation", "fields": { "inbox_path": "string", "tickets_written": "integer" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "write-review-inbox", "--input", "{input_file}"]
      }
    }
  }
}

与tickets.py对齐：
```
review_prompt.py
```
的路径与
```
tickets.py:2468-2470
```
中的硬编码引用匹配
审查收件箱格式：输出格式符合
```
parse_review_agent_inbox()
```
的预期格式（
```
## Review Agent Inbox
```
+
```
# TICKET_BATCH
```
）
范围规则：在
```
tickets.py
```
的14+个工单范围
```
allowed_prefixes
```
条目中被引用

skill

{
  "schema_version": "2.0",
  "id": "skill-system-review",
  "version": "1.0.0",
  "capabilities": [
    "review-generate",
    "review-startup",
    "review-startup-summary",
    "review-roadmap-suggestion",
    "review-plan-to-bundle",
    "review-generate-dispatch",
    "review-suggest-next-bundle",
    "review-write-inbox"
  ],
  "effects": ["fs.read", "fs.write"],
  "operations": {
    "generate-review-prompt": {
      "description": "Assemble structured review context from completed ticket/bundle for Prometheus",
      "input": { "ticket_id": { "type": "string", "required": true } },
      "output": { "description": "Review context JSON", "fields": { "review_context": "object", "prometheus_prompt": "string" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-review-prompt", "--ticket-id", "{ticket_id}"]
      }
    },
    "generate-startup-review-prompt": {
      "description": "Generate Prometheus review overview at session startup",
      "input": {},
      "output": { "description": "Startup review context JSON", "fields": { "roadmap_summary": "object", "bundles": "array", "prometheus_prompt": "string" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-startup-review-prompt"]
      }
    },
    "generate-startup-review": {
      "description": "Generate compact startup context summary from roadmap and recent bundle reviews",
      "input": {},
      "output": { "description": "Startup summary JSON", "fields": { "context_summary": "string", "roadmap_summary": "object", "bundles": "array" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-startup-review"]
      }
    },
    "suggest-roadmap-update": {
      "description": "Suggest roadmap updates from findings/issues without mutating roadmap.yaml",
      "input": {
        "input": { "type": "string", "required": false }
      },
      "output": {
        "description": "Roadmap suggestion payload",
        "fields": { "suggestions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "suggest-roadmap-update"]
      }
    },
    "plan-to-bundle": {
      "description": "Convert Prometheus plan markdown into TKT bundle or express creation commands with metadata preservation",
      "input": { "plan_file": { "type": "string", "required": true } },
      "output": { "description": "Bundle or express creation commands", "fields": { "route": "string", "goal": "string", "tickets": "array", "tkt_commands": "array" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "plan-to-bundle", "--plan-file", "{plan_file}"]
      }
    },
    "generate-dispatch": {
      "description": "Generate a human-readable + JSON dispatch prompt from bundle ticket state",
      "input": {
        "bundle": { "type": "string", "required": false },
        "tickets": { "type": "string", "required": false },
        "auto": { "type": "boolean", "required": false }
      },
      "output": {
        "description": "Dispatch payload grouped by waves",
        "fields": { "bundle": "string", "tickets": "array", "waves": "array" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "generate-dispatch", "--bundle", "{bundle}"]
      }
    },
    "suggest-next-bundle": {
      "description": "Suggest the next bundle goal and seed tickets from roadmap/open work/carryover",
      "input": {},
      "output": {
        "description": "Suggested next bundle payload",
        "fields": { "goal": "string", "suggested_tickets": "array", "open_issues": "array" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "suggest-next-bundle"]
      }
    },
    "write-review-inbox": {
      "description": "Write Prometheus review feedback into Review Agent Inbox for ticket ingestion",
      "input": { "input_file": { "type": "string", "required": true } },
      "output": { "description": "Inbox write confirmation", "fields": { "inbox_path": "string", "tickets_written": "integer" } },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/review_prompt.py", "write-review-inbox", "--input", "{input_file}"]
      }
    }
  }
}