AgentSkillsCN

loom-workspace

借助 Loom 工作空间,为工单的隔离执行创建并管理独立的工作树。

SKILL.md
--- frontmatter
name: loom-workspace
description: Use loom workspace to create/manage worktrees for isolated execution of tickets.
license: MIT
compatibility: opencode,claude
metadata:
  created_at: "2026-01-27T17:03:09.731823+00:00"
  updated_at: "2026-01-27T17:03:09.731823+00:00"
  version: "1"
  tags: "git,workflow"
<!-- BEGIN:compound:skill-managed -->

Worktree basics (repo model)

Ensure a worktree exists for a branch:

  • loom workspace worktree ensure <branch> --base-ref main

List worktrees:

  • loom workspace worktree ls

Remove a worktree:

  • loom workspace worktree rm <branch> --yes

Repo status:

  • loom workspace status

Branch naming

Recommended:

  • ticket-<ticket-id>-<short-slug>

Example:

  • ticket-42-streaming-chunking

Practical note

OpenCode runs inside one working directory. Typically, this is the main branch worktree. loom workspace creates the worktree path (usually under .loom-repo/worktrees/<branch>). Do the code changes in that worktree.

<!-- END:compound:skill-managed -->

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.