mcpField
C
cawplan-ticket-context

cawplan-ticket-context

github.com/cawcut生产力1143 次安装2 天前更新
代码仓库

关于 cawplan-ticket-context

cawplan-ticket-context 是用于查询并展示 CawPlan 工单详情的 Agent skill。它呈现标题、正文和已有进展评论,之后停止,不继续执行实现工作。

主要功能

  1. 01通过 URL 或工单 ID 查询
  2. 02展示标题和详细正文
  3. 03显示当前进展评论
  4. 04报告附件引用

适用场景

  1. 01查看 CawPlan issue URL 对应的详情
  2. 02检查工单当前进展
  3. 03在后续工作前了解工单背景

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/cawcut/skill-cawplan --skill cawplan-ticket-context

安装后在 Claude Code 中输入/cawplan-ticket-context确认已加载。

详细介绍

CawPlan 工单上下文

初始化

cawplan skill check

工作流

工单字段含义

对于 CawPlan 工单,description 是简短的标题,remarks 是详细页面的描述/正文(通常为 HTML)。始终按此含义标注和展示这些字段;不要把 description 当作正文,也不要在展示工单上下文时省略 remarks。

当用户调用 /cawplan-ticket-context、要求查询工单上下文,或在会话中提及 CawPlan 问题 URL 时,使用此技能。

当用户消息包含 CawPlan 问题 URL(例如 https://app.cawplan.com/issue/CWP-14471 或 https://proto-portal.example.com/issue/CAW-04560),且用户没有要求进行 SQA 需求分析、五字段结构化、模块树选择或归档到 QA Insights 时,自动触发此技能——这些需求应使用 cawplan-requirement-analyze 处理。如果用户只粘贴了问题 URL,不要等待其明确调用 /cawplan-ticket-context。

此技能仅用于展示。查询并展示工单详情后即停止。除非用户明确要求后续工作,否则不要检查代码库、搜索源文件、推断实施计划、运行测试、编辑文件、提交更改,也不要继续其他工作流。

接受以下任意组合:

  • CawPlan 问题 URL,例如 https://app.cawplan.com/issue/CAWP-13477
  • 产品问题 URL,例如 https://proto-portal.example.com/issue/CAW-04560
  • 工单显示 ID,例如 CAWP-13477、CAW-04560 或任何 PREFIX-123 格式的 ID
  • 工单唯一 ID

不要根据固定前缀列表推断工单 ID。显示 ID 前缀因产品而异(CAW、CAWP 等)。如果某个字符串符合结构模式 ^[A-Za-z][A-Za-z0-9]+-\d+$,或从类似 /issue/<display-id> 的 URL 路径段中提取,则将其视为显示 ID。通过运行 cawplan tickets search 验证候选项;如果搜索没有返回结果,应报告未找到匹配工单,而不是猜测其他前缀。

首先使用 cawplan tickets search 查询工单详情,并向用户展示返回的工单信息。对于显示 ID,使用确切的 --display_ids 形式:

cawplan tickets search --display_ids CAW-04560

对于多个显示 ID,将它们一起传入:

cawplan tickets search --display_ids CAWP-13477,CAW-04560

如果用户提供了 CawPlan 问题 URL,请在搜索前提取其显示 ID。如果用户只提供唯一 ID,没有提供显示 ID,请使用 cawplan tickets search --unique_ids ... 搜索,并展示返回的工单信息。如果输入中同时包含符合显示 ID 格式的引用和非显示 ID 引用,请使用 --display_ids 搜索显示 ID,并使用 --unique_ids 搜索唯一 ID。

展示工单详情后即停止。除非用户明确要求后续工作,否则不要写入本地工单上下文文件,也不要继续其他工作流。

附件

工单 HTML 字段(remarks、comment、progress_comment 等)可能包含嵌入文件:<img src=…> 截图,以及 <span|div data-type="…-attachment" data-src=… data-filename=…> 区块。其 CDN URL 为私有地址——不要直接获取。当搜索结果包含此类引用时,请在回复中说明工单包含多少个附件(如有 data-filename / alt 名称,也请列出),但不要下载这些附件。

如果用户要求查看、下载或分析附件,或向工单添加文件,请使用 cawplan-ticket-attachments 技能。

回复

搜索成功后,总结以下内容:

  • 查询的工单显示 ID 和唯一 ID。
  • 展示每个工单的标题(取自 cawplan tickets search 返回的 description)以及详细描述/正文(取自 remarks),以便当前会话中能看到工单需求。
  • 如果存在 progress_comment,请将其作为当前进展展示。如果该字段为空或不存在,请说明没有返回当前进展摘要。
  • 展示工单上下文后结束本轮,除非用户明确要求其他工作。

评论

支持 Markdown