Back to Details

skill-system-review

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

skill-system-review

skill-system-review

Bridge between OMO Prometheus and the TKT ticket lifecycle.
Two directions:
  1. Review — After bundle closes, assemble structured review context for Prometheus to evaluate
  2. Plan→TKT — Convert Prometheus plans into TKT roadmap bundles and worker tickets
OMO Prometheus与TKT工单生命周期的桥接工具。
双向功能：
  1. 审查 — Bundle关闭后，组装结构化审查上下文供Prometheus评估
  2. 计划→TKT — 将Prometheus计划转换为TKT路线图Bundle和执行工单

Operations

操作

generate-review-prompt

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-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-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-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

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-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-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-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:
  1. tkt.sh close
    generates 
    review.yaml
    stub
  2. PM Agent calls 
    generate-review-prompt
    to assemble review context
  3. 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
  4. write-review-inbox
    converts Prometheus output into TKT-ingestible tickets
  5. refresh_review_inbox()
    picks up new tickets automatically
当TKT Bundle关闭时：
  1. tkt.sh close
    生成
    review.yaml
    存根文件
  2. PM Agent调用
    generate-review-prompt
    组装审查上下文
  3. Prometheus接收结构化上下文并生成： 
    • summary
      — 已完成的工作内容
    • discussion_points[]
      — 权衡方案、关注点、向用户提出的问题
    • next_actions[]
      — 后续工作项
    • quality_assessment
      — 结构化质量评估
  4. write-review-inbox
    将Prometheus输出转换为TKT可导入的工单
  5. refresh_review_inbox()
    自动获取新工单

Prometheus as Roadmap Planner

Prometheus作为路线图规划器

When a user makes a new request through Prometheus:
  1. Prometheus conducts structured interview (OMO default behavior)
  2. Prometheus writes plan to 
    .sisyphus/drafts/
  3. plan-to-bundle
    reads the plan and generates TKT commands
  4. PM Agent executes the commands to create roadmap goal + bundle + worker tickets
  5. OMO dispatches agents to claim and execute tickets
当用户通过Prometheus提出新请求时：
  1. Prometheus进行结构化访谈（OMO默认行为）
  2. Prometheus将计划写入
    .sisyphus/drafts/
  3. plan-to-bundle
    读取计划并生成TKT命令
  4. PM Agent执行命令以创建路线图目标 + Bundle + 执行工单
  5. 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}"]
      }
    }
  }
}