Workticket

技能简介

Workticket 是两款 Claude Code 技能的合集，涵盖开发全流程的两端：将想法变为可操作工单，将工单变为 Pull Request。它包含两个核心技能：/workticket（工单→PR 十二阶段编排器）和 /createTicket（想法→工单）。支持 Jira 和 GitHub Issues，零依赖安装程序，无需在项目目录内运行。

它的核心价值在于：让 AI 来承担项目管理流程的执行工作，人类只需做决策和评审。

核心能力

• 工单→PR 十二阶段编排器：/workticket 将一个工单推进到 Pull Request，全程 12 个阶段自动编排
• 想法→工单智能拆分：/createTicket 将产品需求拆分为正确分割的工单，每个工单携带产品所需信息
• 信心路由决策：每个阶段评估变更复杂度，自动决定是推进还是上报（HIGH 全自动 / MEDIUM 摘要确认 / LOW 停止上报）
• 零依赖安装程序：Node.js 仅在安装时需要，工作流本身永不调用；安装后全局可用，从任意目录运行
• Jira / GitHub Issues 双支持：默认 Jira，可切换为 GitHub Issues，无需单独凭证
• 权限隔离：机器级只读权限在 ~/.claude/settings.json，仓库级写权限在 .claude/settings.local.json，避免权限过度授予
• 票据约定自动配置：npx workticket conventions 交互式生成团队约定，支持 Jira createmeta API 自动填充
• 诊断工具：npx workticket doctor 检查所有依赖和配置，写入零改动

安装配置

前置要求：

• Claude Code（CLI、桌面或网页版）
• Git（已配置用户名和邮箱）
• GitHub CLI（gh 已认证）
• Node.js 18+（仅安装时需要）
• Jira 或 GitHub Issues（二选一，可选）

# 一键安装（从任意目录运行）
npx workticket install

# 初始化项目
cd your-repo
npx workticket init

# 验证安装
npx workticket doctor

npx workticket install 执行以下操作：

• 创建 ~/.claude/skills/workticket/ 并复制技能文件
• 注册 ~/.claude/CLAUDE.md 中的技能入口
• 添加机器级只读权限到 ~/.claude/settings.json
• 提示添加仓库级写权限（显示将写入的内容，等待确认）
• 写入 Jira API token 到 ~/.claude/.jira-env（Jira 模式）

使用步骤

1. 机器级安装 npx workticket install（一次性，从任意目录运行）
2. 仓库级初始化 npx workticket init（每个仓库跑一次）
3. 验证配置 /workticket setup（在 Claude Code 内检查 11 项依赖和环境）
4. 运行工单工作流 /workticket PROJ-123（开始 12 阶段工单→PR 编排）
5. 创建工单 /createTicket（输入产品想法，AI 自动拆分为多个可操作工单）
6. 生成约定 npx workticket conventions（为团队 Jira / GitHub Issues 配置工单约定）
7. 根据信心路由决策：HIGH 阶段自动推进，MEDIUM 等待确认，LOW 停止上报人类

适用场景

• AI First 开发团队：人类只做架构决策和代码评审，流程执行全交给 AI
• Jira / GitHub Issues 用户的日常工作流：工单→代码→PR 的闭环管理
• PRD 到可执行工单的转换：输入模糊的产品需求，输出结构化工单集合
• 多仓库项目的管理：同一工单涉及多个仓库时的分支创建和权限管理
• CI/CD 集成：工作流生成的 PR 可直接触发 CI，构建失败自动回退到人工评审
• 团队规范落地：通过约定配置将团队的开发规范（分支命名、PR 模板、Commit 格式）固化到流程中

适用人群

• 使用 Claude Code 的开发者：需要将工单快速转化为 PR 的工程师
• 产品经理：需要将模糊的产品想法转换为结构化、可执行工单的专业人士
• 工程经理：需要为团队建立标准化 AI 驱动开发流程的负责人
• DevOps 工程师：需要将工单系统与 CI/CD 流水线集成的自动化专家
• 初创公司技术负责人：需要用有限人力最大化工程产出的团队 leader

工作原理

Workticket 工作流分为 4 个阶段共 12 个步骤：

设置阶段（1-3步）：飞前检查（验证 git/项目配置）→ 读取工单 → 呈现与评审（询问不明确之处）

规划阶段（4-6步）：创建分支 → 分析（并行 Agent 探索代码库）→ 规划（生成实施计划并存档）

构建阶段（7-9步，循环）：实现（按计划写代码）→ 验证（Lint/Style/Review/测试）→ 开发评审（呈现差异给开发者）

发布阶段（10-12步）：更新知识库 → 创建 PR（Changelog/Commit/草稿 PR）→ 复盘（分析过程并记录教训）

信心路由：每个阶段结束时评估复杂度（HIGH/ MEDIUM/ LOW），决定下一步是自动推进还是上报人类决策。

官方链接

• NPM：https://www.npmjs.com/package/workticket
• GitHub：https://github.com/MagellanTV/workticket