如何用claude-skills执行Ticket工作流:execute与complete命令完全解析
【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills
在 claude-skills 插件中,执行阶段(Execution Phase)的 Ticket 工作流由execute-ticket和complete-ticket两个命令组成:前者负责按实施计划写代码、补测试、验收,后者负责流转 Jira 状态并更新实施计划文档。本指南带你 5 分钟看懂这条工作流的完整玩法,新手也能直接上手。
为什么 Ticket 工作流要拆成两个命令?
claude-skills 把项目交付拆成四个阶段:Discovery(发现)→ Planning(规划)→ Execution(执行)→ Retrospectives(回顾)。执行阶段是每个 Ticket 都要循环一遍的"写码 → 收尾"小闭环:
| 顺序 | 命令 | 说明 |
|---|---|---|
| 1 | /project:execution:execute-ticket <ticket-key> | 实现 Ticket:写代码、建测试、核对验收标准 |
| 2 | /project:execution:complete-ticket [ticket-key] | 流转 Jira 到 "In Review",更新实施计划 |
💡 拆分原因很实际:实现过程可能很长,对话上下文会被压缩;如果"收尾记账"和"执行"捆在一起,完成状态的记录很容易被丢掉。详见 docs/workflow/execution-phase.md。
execute-ticket 四步执行法:从取票到交付
完整定义见 commands/project/execution/execute-ticket.md,整个流程分为四个阶段:
第一步:取票与自检(Phase 0)
命令会先拉取 Jira Ticket,并校验它是否自包含——即包含实施步骤、待改文件、测试代码、验收标准四要素。缺任何一项都会STOP并向你汇报"找到了什么、缺了什么",然后给出两个选项:由 AI 分析代码库补全细节,或你先更新 Ticket。
第二步:准备与并行检查(Phase 1)
- 阅读 Ticket 的实施步骤(第一信源)和实施计划(了解 wave/依赖上下文)
- 探索代码库中的既有模式,避免踩坑
- 检查实施计划中的Parallel Execution Strategy:同一 wave 内的多个 Ticket 可以并行,AI 会建议把前端/后端/数据库/测试分别委派给
frontend-developer、backend-developer、database-optimizer、test-automator等专家 Agent 同时开工
第三步:实现(Phase 2)
确认方案后,Jira 状态更新为 "In Progress",然后严格按计划执行:改文件、写单测/集成/E2E 测试、逐条核对验收标准。
第四步:交付摘要(Phase 3)
执行完成后 AI 不会替你提交代码,而是输出一份Ticket Completion Summary,包括:改动清单、涉及文件、新增测试、偏离计划之处、后续 Ticket,以及一条建议的 commit message。Git commit 和 PR 由你本人完成。
⚠️偏离处理机制:实现中如果必须偏离计划,AI 会先停下、说明偏离内容、原因和影响,等你批准后才继续,并在摘要中留痕。
complete-ticket:一键收尾的 5 个动作
完整定义见 commands/project/execution/complete-ticket.md。它的作用是"记账 + 流转":
- 识别 Ticket:可显式传参(如
/complete-ticket CC-123);不传参时自动从对话上下文中找最近执行过的 Ticket - 收集完成详情:从执行摘要中提取改动、文件、测试、偏离、后续工单
- 确认后才执行:向你展示"将把 Jira 流转到 In Review + 更新实施计划",等 Yes/No 确认
- 执行收尾:Jira 流转到 "In Review";同时更新 Confluence 实施计划的完成状态表、执行顺序表、并行 wave 表,并追加一个 Completion Details 小节
- 回执确认:输出清单式完成报告,提示你下一步去 commit 和建 PR
即使没有先跑execute-ticket,也可以单独使用——手动提供实施计划 URL 和改动摘要即可。
质量门与检查点:人在环上的安全网
claude-skills 的核心设计理念是强制检查点(Checkpoint):在执行前确认方案、偏离时暂停求批准、阻塞时等待指示、完成时提交摘要供审查。命令永远不会在没有你明确批准的情况下修改 Jira 或 Confluence。执行前的检查清单还要求:确认前置 Ticket 已完成、预提交钩子通过、新增测试全过且存量测试不回归。完整命令参考可查 docs/WORKFLOW_COMMANDS.md。
相关文件资料
- 执行阶段总览:docs/workflow/execution-phase.md
- execute-ticket 工作流文档:docs/workflow/execution-execute-ticket.md
- complete-ticket 工作流文档:docs/workflow/execution-complete-ticket.md
- 命令实现定义:commands/project/execution/
- 工作流清单(阶段依赖关系):commands/workflow-manifest.yaml
- Jira/Confluence 接入配置:docs/ATLASSIAN_MCP_SETUP.md
常见问题:Ticket 工作流跑不通怎么办?
Q:执行时提示 Ticket 缺少实施细节?A:说明 Planning 阶段没跑完整。先执行planning:impl-plan生成自包含的 Ticket 详情,或让 AI 现场分析代码库补全。
Q:complete-ticket 找不到上下文?A:先跑/execute-ticket <ticket-key>生成完成摘要,再执行 complete;或手动传入计划 URL 和改动摘要。
Q:所有 Ticket 完成后下一步是什么?A:运行/project:retrospectives:complete-epic <epic-key>生成 12 节完成报告、归档文档并关闭 Epic。
按 "execute → complete" 循环推进每个 Ticket,就是 claude-skills 交付工作流的完整节奏——代码由 AI 写,决定权始终在你手上。
【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考