用途
ticket-format 用于规定本仓库中 Linear 与 Superset 工单的标准三段式结构。当需要创建、起草或梳理一张工单时,依据该格式组织内容,可使工单结构统一、重点清晰。
主要结构
工单由三个部分组成:
- Context(背景):用 2 至 4 句话说明哪里出了问题或需要什么,以及原因。该部分强调以结果为导向,而不是以解决方案为导向。
- References(来源):记录工单来自哪里。没有来源时可省略此段。示例表格包含 Source(如 Slack #feedback)、Who(如 @alice)、Link(如 thread)、Date(如 2026-05-10)四列。
- Implementation notes(实现说明):由 agent 梳理填写。若没有代码库上下文,可留空,待后续梳理时补充。填写时使用以下子标题,并跳过不适用的部分:
-
Files:路径:行号 + 相关性原因
-
Approach:一段话
-
Related code:仓库中的类似模式
-
Gotchas:约束、既往事故
-
使用方式
在创建、起草或梳理工单时,按照上述三段结构组织内容;Context 保持简短且聚焦结果,References 按需保留,Implementation notes 在具备代码库上下文时按子标题填写。
适用场景
适用于本仓库中 Linear 和 Superset 工单的创建、起草与梳理工作。
限制
资料未提供该技能的安装方式、命令、平台支持范围、收费信息或其他使用步骤,暂未提供。