关于 cawplan-ticket-context
cawplan-ticket-context 是用于查询并展示 CawPlan 工单详情的 Agent skill。它呈现标题、正文和已有进展评论,之后停止,不继续执行实现工作。
主要功能
- 01通过 URL 或工单 ID 查询
- 02展示标题和详细正文
- 03显示当前进展评论
- 04报告附件引用
适用场景
- 01查看 CawPlan issue URL 对应的详情
- 02检查工单当前进展
- 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,请将其作为当前进展展示。如果该字段为空或不存在,请说明没有返回当前进展摘要。 - 展示工单上下文后结束本轮,除非用户明确要求其他工作。