SuperAPI AI 工具集

ticket-format

办公与效率

查看项目

更新于 10-30 16:30

技能介绍

用途

ticket-format 用于规定本仓库中 Linear 与 Superset 工单的标准三段式结构。当需要创建、起草或梳理一张工单时,依据该格式组织内容,可使工单结构统一、重点清晰。

主要结构

工单由三个部分组成:

  1. Context(背景):用 2 至 4 句话说明哪里出了问题或需要什么,以及原因。该部分强调以结果为导向,而不是以解决方案为导向。
  2. References(来源):记录工单来自哪里。没有来源时可省略此段。示例表格包含 Source(如 Slack #feedback)、Who(如 @alice)、Link(如 thread)、Date(如 2026-05-10)四列。
  3. Implementation notes(实现说明):由 agent 梳理填写。若没有代码库上下文,可留空,待后续梳理时补充。填写时使用以下子标题,并跳过不适用的部分:
    • Files:路径:行号 + 相关性原因

    • Approach:一段话

    • Related code:仓库中的类似模式

    • Gotchas:约束、既往事故

使用方式

在创建、起草或梳理工单时,按照上述三段结构组织内容;Context 保持简短且聚焦结果,References 按需保留,Implementation notes 在具备代码库上下文时按子标题填写。

适用场景

适用于本仓库中 Linear 和 Superset 工单的创建、起草与梳理工作。

限制

资料未提供该技能的安装方式、命令、平台支持范围、收费信息或其他使用步骤,暂未提供。