AgentSkillsCN

openspec-beads-implement

在实施过程中集成 OpenSpec 与 Beads。自动处理 Beads 问题，并自动更新 OpenSpec 任务。当用户希望以 Beads 作为跟踪器来实施变更时启用此技能。

SKILL.md
--- frontmatter
name: openspec-beads-implement
description: Integrates OpenSpec and Beads during implementation. Works on Beads issues and updates OpenSpec tasks automatically. Activates when user wants to implement a change using beads as tracker.

OpenSpec + Beads Implementation Skill

This skill integrates both systems during implementation: uses Beads for work tracking and updates OpenSpec automatically.

When to Activate

  • •User runs openspec apply <change> AND beads is initialized
  • •User says "implement this with beads", "work on <change>"
  • •User asks how to work with both systems

Main Flow

1. Select Change

bash
openspec status --change "<name>" --json

Same as openspec-apply-change.

2. Link with Beads

bash
bd list --labels "spec:<change>" --json

If no issues exist:

  • •Run openspec-to-beads first: Skill: openspec-to-beads
  • •Or warn user that there are no beads for this change

3. Implementation Loop

For each OpenSpec task:

  1. •

    Find equivalent bead

    • •Search by title containing the task text
    • •Use label spec:<change> to filter
  2. •

    Update status in Beads

    bash
    bd update <bead-id> --status in_progress
  3. •

    Implement the change

  4. •

    Close bead

    bash
    bd close <bead-id> --reason "Completed: <task-text>"
  5. •

    Update OpenSpec

    • •In tasks.md: - [ ] → - [x]

4. Show Progress

code
## Implementing: <change>

Beads: <in_progress>/<total> | OpenSpec: <complete>/<total>

Key Commands

Search Issues by Spec

bash
bd list --labels "spec:<change>" --json

View Issue Details

bash
bd show <id> --json

Update Status

bash
bd update <id> --status in_progress
bd update <id> --status open

Close Issue

bash
bd close <id> --reason "Completed: <desc>"

Common Errors

No beads for this change:

code
⚠️  No beads found with label spec:<change>
Run first: Skill openspec-to-beads

Beads not initialized:

code
⚠️  Beads is not initialized
Run: bd init --prefix <project>

Issue blocked:

code
⚠️  Issue <id> is blocked by: <blocking-id>
Use: bd show <id> for details

Synchronization

When all tasks are complete:

  • •Beads issues should be "closed"
  • •OpenSpec tasks.md should have - [x] in all

Recommend to user:

bash
bd sync  # Sync beads with git

Integration with Other Skills

  • •openspec-to-beads: Creates beads from specs (pre-implementation)
  • •openspec-apply-change: Flow without beads (fallback)
  • •openspec-archive-change: Archive completed change

Output Example

code
## Implementing: add-auth

Beads: 2/5 | OpenSpec: 2/5

▶ Working on: bead-123 "add-auth: Implement login API"
✓ Completed

▶ Working on: bead-124 "add-auth: Create Login component"
✓ Completed

3 tasks remaining...