AGENT SKILL

issue-tracker-workflow

创建和使用团队问题跟踪表,把问题描述、截图或录屏、处理状态、代码修复、 开发自测与人工验收串成闭环。用户说“记录这个 bug / 建问题表 / 问题汇总表 / 处理这条问题 / 解决这个问题单”,或当前上下文包含问题表、问题记录链接时使用。

License 许可
AGPL-3.0
所属仓库
tabtin-ai/TabTin
最近更新
2026-10-08
Stars
★ 454
Forks
115

01 前言 Front Matter

name
issue-tracker-workflow
description
创建和使用团队问题跟踪表,把问题描述、截图或录屏、处理状态、代码修复、 开发自测与人工验收串成闭环。用户说“记录这个 bug / 建问题表 / 问题汇总表 / 处理这条问题 / 解决这个问题单”,或当前上下文包含问题表、问题记录链接时使用。

02 资源文件 2

03 SKILL.md 正文

问题跟踪工作流

把表格当作团队可见的问题处理现场。Skill 只定义稳定流程;表 ID、仓库、分支、 发布规则等运行时信息从当前资源与 Workspace 规则读取,不写死在 Skill 中。

入口判断

按顺序判断:

  1. 当前上下文有表格或记录链接:读取表结构;结构兼容时直接处理对应记录。
  2. 用户明确要创建问题表:先展示下方表结构与用途,询问是否创建。
  3. 用户明确要记录、分派或持续跟踪问题,但没有兼容表:提醒一次并询问是否创建。
  4. 用户只是在咨询报错、排查一次性问题:直接帮助解决,不推销建表。

提醒使用这段产品语言,可按上下文压缩但不要省略“会创建什么”:

看起来你想把这个问题交给团队持续跟踪。小Tin 可以创建一张「问题跟踪」表, 用来保存问题描述、证据附件、负责人、处理状态、修复反馈和验收结果。 是否现在创建,并把这个问题记录进去?

创建前必须得到用户明确同意。用户拒绝时继续当前任务,不重复提醒。

标准表结构

初始化脚本创建以下字段:

字段 类型 用途
问题描述 text 主字段,一句话说明问题
证据附件 attachment 截图、录屏或日志文件
环境信息 long_text 系统、版本、复现环境
状态 select 唯一状态机
负责人 user 当前处理责任人
修复反馈 long_text 改了什么、在哪里、怎么验证、下一步
验收附件 attachment 实际效果或验收证据
验收日期 date 人工验收通过时间
提交人 created_by 自动记录创建者
提交时间 created_time 自动记录创建时间

状态值固定为:

新提交 → 待处理 → 处理中 → 开发自测 → 待部署 → 待验收 → 已完成

分支终态:重复、无法复现、已取消、暂不处理、待产品确定、后续排期。

经用户同意后运行:

bash scripts/ensure-issue-tracker-table.sh

脚本会复用同名兼容表;同名表结构不兼容时停止,不会擅自改表或再建重名表。 成功后读回 table_id,继续记录当前问题。只想向用户展示建表内容时运行 bash scripts/ensure-issue-tracker-table.sh --preview,它不会写数据。

兼容已有问题表

不要靠固定 UUID 识别问题表。按字段语义识别,并兼容以下旧字段名:

标准字段 兼容字段名
问题描述 Bug 描述
证据附件 操作录屏 / 截图
环境信息 系统
负责人 指派人 / 提交人
验收附件 验收截图

有当前 table_id 时可验证并复用:

bash scripts/ensure-issue-tracker-table.sh --table-id <table_id>

结构不兼容时说明缺哪些能力,并询问用户是创建标准表,还是只处理当前任务;不要 自动给业务表补字段。

处理一条问题

  1. 用记录链接原样读取详情;描述很短时先看证据附件,再判断需求。
  2. 开始处理后把状态改为 处理中,让团队看到有人接手。
  3. 完成代码修改与验证;代码交付按下一节读取当前 Workspace 规则。
  4. 只有在真实客户端或运行环境亲眼验证后,才转为 开发自测。
  5. 填写修复反馈:改了什么、在哪里、怎么验证、下一步等谁。
  6. 有部署环节则进入 待部署;部署完成且证据齐全后进入 待验收。
  7. 已完成、验收附件和验收日期属于人工验收动作,Agent 不代替用户确认。

记录链接优先直接使用,不手工拆 UUID:

tabtin table record detail "<record-url>" --format json
tabtin table record update --url "<record-url>" --set "状态=处理中"

状态必须名副其实:lint、类型检查和单元测试通过仍只是代码验证,不等于客户端 开发自测。拿不准时停在前一个状态,并在修复反馈里说明阻塞点。

代码交付边界

本 Skill 不规定分支名、GitFlow、远端仓库、PR 目标或发布节奏。进入代码处理阶段时:

  1. 读取当前 Workspace 的 AGENTS.md、仓库规则和相关开发 Skill。
  2. 检查当前分支、工作树与仓库状态。
  3. 按仓库自己的测试、提交和交付规则执行。
  4. 没有仓库规则且是否提交会改变结果时,先询问用户;不要创造发布制度。

问题表负责“谁在处理、证据是什么、走到哪一步”;仓库规则负责“代码怎么交付”。 两者不要互相硬编码。

04 同仓库更多 Skills

tabtin-ai
tabtin-ai/TabTin

tabtracker

管理自动化任务——创建、列出、暂停、恢复、立即触发(产品模块名「自动化」, 具体条目称「自动化任务」;CLI 命令仍为 tabtin tracker)。当用户表达"派活"意图时使用: 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令(直接执行)和长期任务(创建 自动化任务,由调度器在指定时间唤起 Agent)。

★ 454
tabtin-ai
tabtin-ai/TabTin

tabtin-project

在 Project Task 执行会话中工作:先读取当前任务工作面,再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task,或用户要求继续修改过程中的中间产物时使用。

★ 454
tabtin-ai
tabtin-ai/TabTin

skill-market

管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。

★ 454
tabtin-ai
tabtin-ai/TabTin

tabtin-widget

渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。

★ 454
tabtin-ai
tabtin-ai/TabTin

resource-link

插入资源链接——在 chat 文字流里给资源链接,markdown link 形态 [显示文本](tabtin://resource/<type>/<id>?hint=<carrierApp>), 用户点击直接在 Space 内打开。行业格式(http/https/ file/mailto)也兼容;不要写 file:// 让用户自己复制粘贴。

★ 454
tabtin-ai
tabtin-ai/TabTin

mcp-operations

操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools/resources/ prompts,并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到"使用 Playwright MCP""调用本机安装的 MCP 工具""读取某个 MCP resource""获取某个 MCP prompt"时激活。

★ 454