Agent Skills › zai-org/ZCode › zcode-large-task-fixture

zcode-large-task-fixture

GitHub

用于生成、验证和删除大型合成 ZCode 任务数据，以进行 UI/会话性能测试。通过操作本地 SQLite 数据库模拟长运行任务场景，覆盖多种工具调用和消息类型，无需手动聊天即可高效评估渲染及恢复性能。

.agents/skills/zcode-large-task-fixture/SKILL.md zai-org/ZCode

触发场景

需要测试大对话或任务列表的渲染性能需要验证快照恢复或工具调用渲染能力需要生成大量合成数据进行性能基准测试

安装

npx skills add zai-org/ZCode --skill zcode-large-task-fixture -g -y

更多选项

非标准路径

npx skills add https://github.com/zai-org/ZCode/tree/main/.agents/skills/zcode-large-task-fixture -g -y

不安装直接使用

npx skills use zai-org/ZCode@zcode-large-task-fixture

指定 Agent (Claude Code)

npx skills add zai-org/ZCode --skill zcode-large-task-fixture -a claude-code -g -y

安装 repo 全部 skill

npx skills add zai-org/ZCode --all -g -y

预览 repo 内 skill

npx skills add zai-org/ZCode --list

SKILL.md

Frontmatter

{
    "name": "zcode-large-task-fixture",
    "description": "Generate, verify, or remove large synthetic ZCode task fixtures in local ~\/.zcode persistence for UI\/session performance testing. Use when testing big conversation\/task rendering, task list performance, snapshot recovery, tool-call rendering, reasoning, patches, todos, and model usage without spending time chatting manually.",
    "disable-model-invocation": true
}

ZCode Large Task Fixture

Use this skill to create a large local task that behaves like a long-running ZCode Agent task. It writes both persistence layers:

App task index: ~/.zcode/v2/tasks-index.sqlite
Agent session DB: ~/.zcode/cli/db/db.sqlite

The generated task is synthetic test data. Always back up before writing and record the manifest path.

Quick Commands

From the z-code repository root:

node .agents/skills/zcode-large-task-fixture/scripts/generate-large-task-fixture.mjs \
  --workspace "$PWD" \
  --turns 3000

Verify an existing generated task:

node .agents/skills/zcode-large-task-fixture/scripts/generate-large-task-fixture.mjs \
  --verify sess_perf_large_YYYYMMDDHHMMSS_xxxxxxxx

Remove a generated task:

node .agents/skills/zcode-large-task-fixture/scripts/generate-large-task-fixture.mjs \
  --delete sess_perf_large_YYYYMMDDHHMMSS_xxxxxxxx

Workflow

Confirm the target workspace path. Use the repository root unless the user names another workspace.
Generate with --turns 3000 for a large fixture. This creates roughly 6,000 messages and 20,000 parts.
Read the script output and report the sessionId, manifest path, counts, and backup directory.
Verify with --verify <sessionId>.
Tell the user to restart or refresh the app if it was already running, then open the pinned task titled Performance Fixture Large Mixed Task.

Safety

The script uses SQLite .backup before generation unless --no-backup is passed.
Backups are stored under ~/.zcode/perf-task-backups/<timestamp>/.
Manifests are stored under ~/.zcode/perf-task-manifests/<sessionId>.json.
Use --delete <sessionId> for generated fixtures. It deletes from tasks-index.sqlite and cascades the agent session rows.
Do not delete manually unless you have checked the manifest and confirmed the task id starts with sess_perf_large_.

Coverage

Generated sessions include:

User text and file parts
Assistant text and reasoning parts
Tool parts with completed, running, pending, and error states
Bash, Read, Grep, Glob, Edit, Write, TodoWrite, AskUserQuestion, Agent, WebSearch, and WebFetch tool shapes
Patch, compaction, subtask, agent, retry, step-start, and step-finish parts
Todo rows, session target rows, model usage rows, turn usage rows, and task index searchable text