SuperAPI AI 工具集

ticket-craft

智能体与模型

查看项目

更新于 10-15 19:54

技能介绍

ticket-craft 的用途是定义一种能让人工智能智能体自主执行的软件工单格式,把软件工程最佳实践与 Claude Code 所需的上下文要求结合起来,生成“Claude Code Ready”工单。它可用于 Jira、Asana、Linear、GitHub Issues 或任何工单系统。

主要能力:提供功能、Bug、技术债、Epic 拆解四类工单模板;用 INVEST+C 准则评估工单;提供 Claude Code Ready 检查清单,覆盖上下文、范围、验证与质量;支持识别反模式,如仅有标题、过度冗长、模糊需求、过度指定方案、缺少文件引用、缺少验证。它认为传统工单依赖人类在 Slack 追问、调用机构知识、从模糊描述推断意图,而 AI 智能体做不到这些,因此每张工单必须自包含,包含显式文件引用、模式引用、验证标准、约束和测试命令。

使用方式:按模板撰写工单,填写优先级、点数、标签、用户故事、背景、Given-When-Then 形式的验收标准、Out of Scope、相关文件、模式参考、数据库变更、API 契约、约束、验证命令、环境变量与依赖关系。检查清单要求文件路径完整、模式引用指向真实文件、API 契约已定义、数据库变更已指定、环境变量已列出、明确不做什么、不修改哪些文件、原子化、不超过 5 个故事点、提供测试、lint、类型检查命令等。

适用场景:需要把工单交给 AI 智能体执行、希望减少澄清往返、需要 Epic 拆解与智能体团队映射的团队。限制:资料未提供具体平台收费、价格或插件安装步骤,仅描述工单撰写方法;若信息不足则无法给出更具体的执行细节。