Skip to content
cccskills
FreePublished on GitHub

implement-spec

Turn a specification and its linked tickets into code. Multiple agents work on available tasks in separate worktrees, combine changes on one integration branch, and complete a code review before preparing the result for review or closing tickets.

OriginalShow the original description

在代码中实现 /to-spec 和 /to-tickets 的产出。

See how to install

Good for

  • Implementing a specification and its linked tickets
  • Working through tasks with blocking dependencies
  • Coordinating parallel implementation in separate worktrees
  • Integrating changes and preparing a pull request for review

Files included (2)

  • SKILL.md2.7 KB
  • agents/openai.yaml164 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

你已经获得一份 spec。这份 spec 应该有与之关联的 tickets,说明如何实现它。

Issue tracker 应当已经提供给你。如果没有,就告诉用户运行 /setup-matt-pocock-skills。

目标是在单个 integration branch 上实现整个 spec,并按 issue tracker 关闭工作的方式解决每一个 ticket。

tickets 不是步骤清单,而是一个 task graph,其中包含 blocking relationships。这意味着始终存在一个由可领取 tickets 组成的 frontier。

与 subagents 的通信应当简洁。主要通过 context pointers 通信:指向 spec、tickets、research notes 和之前的 commits。不要重复 pointers 已经提供的信息。

在可能的情况下,implementer subagents 应当在 background 中运行,以获得最大并发度。

步骤

  1. 阅读 spec 和 tickets,理解 task graph。

  2. (可选)使用一个 exploration subagent 完成 tickets 所需的探索,即相关的 codebase files 或 external documentation。确保 exploration subagent 能够保存文件:它应当把 Markdown notes 保存到 repo 外、所有后续 subagents 都能访问的目录。这样 implementer subagents 就能专注于实现,而不必重复探索。

  3. 创建 integration branch。如果 issue tracker 通过 PRs 关闭工作,或用户要求开 PR,就在第 5 步的首次合并之后打开一个 draft PR(不领先于 main 的 branch 无法开 PR),并标记它会关闭 spec 和 tickets。

  4. 使用 implementer subagents 实现每个 ticket,每个 subagent 都在自己的 worktree 和 branch 上工作。每个 implementer subagent:

    • 开始前确认其 worktree 基于 integration branch,若不是则 reset 到它上面;
    • 调用 Skill 工具并指定 tdd 来构建 ticket;
    • 在报告完成前,把 integration branch 的 tip 合并进自己的 branch
  5. 每个 implementer subagent 完成后,使用一个 merger subagent 把它的工作合并到 integration branch。

  6. 如果这改变了可用 tickets 的 frontier,就启动更多 implementer subagents 处理新的 tickets。这样可以获得最大并发度。

  7. 所有 tickets 完成后,在 integration branch 上调用 Skill 工具并指定 code-review。在单个 implementer subagent 中修复 code review 提出的所有问题。

  8. 如果存在 draft PR,把它标记为 ready for review。否则,按 issue tracker 关闭工作的方式解决每个 ticket,并报告 integration branch。

  9. 清理所有 implementer subagent 的 worktrees。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ask-matt

FreeSummary

Find the right skill and sequence for your current development task, from shaping an idea to implementation, debugging, and review. The guide also explains when to prototype, prepare specifications, or move work into a fresh session.

  • Choose a workflow for turning an idea into working software
  • Find the starting point for a difficult bug investigation
  • Plan specifications and tickets for work across multiple sessions
vinvcn/mattpocock-skills-zh-CN5.2KUpdated Oct 20, 2026

claude-handoff

FreeSummary

Summarize the current conversation and launch a fresh background agent to continue the work. The handoff includes references to existing artifacts and suggested skills, removes sensitive information, and can emphasize the next session’s intended focus.

  • Continue ongoing work with a fresh agent
  • Focus the next session on a specific task
  • Hand off work using references to existing documents
vinvcn/mattpocock-skills-zh-CN5.2KUpdated Oct 20, 2026

code-review

FreeSummary

Review changes from a chosen Git reference against both project coding standards and issue or specification requirements. Separate parallel reviews report rule violations, possible design problems, missing requirements, and changes beyond the intended scope.

  • Review a branch or pull request
  • Check changes since a specific commit
  • Find missing requirements or unintended scope
vinvcn/mattpocock-skills-zh-CN5.2KUpdated Oct 20, 2026

codebase-design

FreeSummary

Design modules that expose simple interfaces while hiding substantial behavior. Use shared terms and principles to assess interface complexity, decide where behavior can be swapped, and organize code so callers and tests use the same interface.

  • Simplify a module interface
  • Review module structure during refactoring
  • Decide where behavior should be swappable
vinvcn/mattpocock-skills-zh-CN5.2KUpdated Oct 20, 2026

diagnosing-bugs

FreeSummary

Diagnose difficult bugs and performance regressions by first building a repeatable check for the exact symptom. Minimize the reproduction, test ranked hypotheses, apply a fix, and verify the original scenario with regression tests where suitable.

  • Investigating persistent errors or incorrect output
  • Increasing reproduction rates for intermittent bugs
  • Measuring and diagnosing performance regressions
vinvcn/mattpocock-skills-zh-CN5.2KUpdated Oct 20, 2026

domain-modeling

FreeSummary

Clarify project terminology and the relationships between business concepts. Check definitions against concrete scenarios and code, update GLOSSARY.md as terms are agreed, and record significant design decisions with their trade-offs when the stated criteria are met.

  • Clarifying ambiguous project terminology
  • Creating or updating GLOSSARY.md
  • Checking concept boundaries against code and edge cases
vinvcn/mattpocock-skills-zh-CN5.2KUpdated Oct 20, 2026

See all skills by vinvcn

Report a problem with this skill