AGENT SKILL

repair-taskts

Fix task.ts definition issues — Seed syntax, missing .build(), empty checks, import errors, TypeScript errors

适用职业开发工程师
License 许可
MIT
最近更新
2026-06-13
Stars
★ 3
Forks
1

01 前言 Front Matter

name
repair-taskts
tags
[ "repair", "gap:output", "gap:check-failed", "gap:seed" ]
context
[ { "type": "gap", "fields": [ "gapKind", "unitPath", "taskTitle", "taskId" ] }, { "path": "{unitPath}", "type": "file", "label": "taskts-source" }, { "cmd": "npx tsc --noEmit {unitPath} 2>&1 | head -20", "type": "cmd", "label": "typescript-errors" }, { "type": "ai", "label": "issue-analysis", "tools": [ "Read" ], "prompt": "Read the task.ts file at `{unitPath}` and check for these issues: 1. `.seed({type: 'dynamic', items: [...]})` object syntax instead of `.seed(async (ctx) => { ctx.spawn(...) })` 2. Missing `.build()` call at the end of the taskDef chain 3. Empty checks array `.checks([])` 4. Missing `import { taskDef } from '@openplaybooks/converge-core'` 5. Seed function that never calls `ctx.spawn()` 6. TypeScript compilation errors\nFor each issue: state what's wrong, the line number, and the exact code fix.\n", "timeoutMs": 30000 } ]
description
Fix task.ts definition issues — Seed syntax, missing .build(), empty checks, import errors, TypeScript errors
allowed-tools
[ "Read", "Write", "Edit", "Bash", "Grep" ]

03 SKILL.md 正文

Repair task.ts

Fix structural issues in a task.ts definition file.

Step 1: Read Context

  1. Read repair-context/gap.md — what gap triggered this
  2. Read repair-context/issue-analysis.md — AI pre-analysis of issues
  3. Read repair-context/taskts-source.md — the actual task.ts content
  4. Read repair-context/typescript-errors.txt — tsc output
  5. Read repair-context/history.md (if exists)

Step 2: Fix Issues

Create a backup first:

cp "{unitPath}" "{unitPath}.backup"

Then apply fixes based on the analysis:

Seed object → function

If the file has .seed({type: 'dynamic', items: [...]}), convert to:

.seed(async (ctx) => {
  await ctx.spawn(taskDef().id('item-1').title('...').build());
  await ctx.spawn(taskDef().id('item-2').title('...').build());
})

Missing .build()

Append .build() at the end of the taskDef chain.

Empty checks

Replace .checks([]) with at least one meaningful check.

Missing import

Add import { taskDef } from '@openplaybooks/converge-core'; at the top.

TypeScript errors

Read repair-context/typescript-errors.txt and fix each error.

Step 3: Verify

npx tsc --noEmit "{unitPath}" 2>&1

Should produce no errors.

04 同仓库更多 Skills

openplaybooks-dev
openplaybooks-dev/converge

hello-checker

Use this skill when asked to "verify", "check", or "validate" a file's existence and content. It provides a reliable workflow for confirming files meet their spec.

Skill与智能体开发
★ 3
openplaybooks-dev
openplaybooks-dev/converge

ask-skill

暂无简介

Skill与智能体开发
★ 3
openplaybooks-dev
openplaybooks-dev/converge

html-review-artifact

Framework-wide guidance for crafting polished human-review artifacts as markdown or HTML

前端开发Skill与智能体开发
★ 3
openplaybooks-dev
openplaybooks-dev/converge

converge-planning

Design a Converge playbook end-to-end. Use when the user says "plan a project", "design a playbook", "decompose into tasks", "scaffold a Converge workflow", "onboard to Converge", or asks how to write TASK.md / playbook.yml. Two entry points: plan a new playbook or update an existing one. Hand off to `/converge-control` after producing the playbook structure.

Skill与智能体开发
★ 3
openplaybooks-dev
openplaybooks-dev/converge

converge-control

Operate a Converge playbook end-to-end — start runs, monitor progress, narrow failures with `--select`, inspect runtime state, validate definitions, surgically reset subtrees, and stop stuck or orphaned runs. Use this skill whenever the user says "run my playbook", "execute this", "monitor the run", "converge failed", "the run is stuck", "retry failures", "babysit this playbook", "what's the status?", "show me the gantt", or asks how to use `converge run` / `--select` / `inspect` / `doctor` / `clean` / `stop`. Also use it for `HTTP 401` / `Invalid API key` failures on the first task — those are environment-not-playbook problems — and for any post-run cleanup work. Hand off to `converge-planning` if the user wants to design or restructure the playbook itself.

开发工程师Skill与智能体开发
★ 3
openplaybooks-dev
openplaybooks-dev/converge

repair-spawn-intermediate

Generate a new intermediate task when no existing task produces a required output

Skill与智能体开发
★ 3