tdir-tickets
通过 tdir-mcp 的工单工具查询外接 TAPD 系统中的 TDIR 运营工单(洞察/规则/情报/高价值事件/产研缺陷)、详情与评论,并在用户明确确认后发表评论或完成规则运营工单结单;不负责 RuleAgent 规则审核工单或评测平台样本漏误报工单(须使用 tdir-rules 的 tdir rules ops rule-agent tickets / eval-platform tickets),不负责生成威胁事实或 Insight 定性,建单及处理人/期限更新使用当前 Agent 环境已有的 TAPD 工具,按实际 schema 执行。
How do I install this agent skill?
npx skills add https://tdir-1258344699.cos.ap-guangzhou.myqcloud.com --skill tdir-ticketsIs this agent skill safe to install?
No partner audit is available yet. Read the source before installing.
What does this agent skill do?
TDIR 外接 TAPD 工单
本能力不在威胁检测主 pipeline 中,而是 TDIR 外接的 TAPD 运营工单能力。工单工具是 tdir-mcp 的一部分,与其他命令共用同一端点和登录;TAPD 工作区、需求类别与字段映射由服务端维护,CLI 只传业务参数,输出也不包含 custom_field_*。
执行时遵守 ../tdir-shared/SKILL.md 的认证、输出、写操作和安全契约。
采用 direct-first:查询及 CLI 已覆盖的写操作默认直接使用 tdir tickets,并先读取目标叶子命令帮助。创建 TDIR TAPD 工单及处理人/期限更新,使用当前 Agent 环境已有的 TAPD 工具;按 建单与更新 读取真实 schema、查重、执行和回查。
三类工单系统边界与路由(共用 TAPD 70187792 空间,严禁混用命令)
TDIR 常规运营工单、RuleAgent 规则审核工单、评测平台样本漏误报工单虽然共用终端安全 TAPD 70187792 空间(单号均以 1070187792... 开头),但分属三套独立的业务接口,执行查询前必须先按工单类型路由:
- TDIR 平台运营工单(
insight洞察运营、rule规则运营、entity情报运营、incident高价值事件、product产研/平台缺陷):- 使用本 Skill 的
tdir tickets list、tdir tickets rule、tdir tickets get <ticket_id>、tdir tickets comments <ticket_id>等命令。 - 严禁把
RuleAgent当作处理人(--owner RuleAgent)或关键词在tdir tickets中查询 RuleAgent 工单!
- 使用本 Skill 的
- RuleAgent 规则审核工单(规则自动优化战役生成的
【RuleAgent规则审核】TDIR-<规则名>工单,或用户询问“RuleAgent 的工单 / 昨天 RuleAgent 工单 / 待审核的规则自动优化工单 / RuleAgent 工单评论与原因 / RuleAgent 采纳率”):- 必须切换到
tdir-rulesSkill(严禁对 RuleAgent 审核工单调用tdir tickets get或tdir tickets comments),直接执行:- 查工单列表(含
status、result与表单审核原因reason):tdir rules ops rule-agent tickets list [--created-from YYYYMMDD] [--created-to YYYYMMDD] [--status NOT_REVIEWED|IN_REVIEW|REVIEWED|NOT_REQUIRED] [--result ACCEPTED|PARTIALLY_ACCEPTED|REJECTED] [--owner <rtx>] --page-size 100 --json - 查单张工单详情、审核原因
reason与 TAPD 评论区comments:tdir rules ops rule-agent tickets get --tapd-id <tapd_id> --json(或--mission-id <mission_id>) - 查完成率/采纳率指标:
tdir rules ops rule-agent tickets metrics [--engine tdir|qmedr] [--created-from YYYYMMDD --created-to YYYYMMDD] --json
- 查工单列表(含
- 必须切换到
- 评测平台评测工单(POC 样本漏报
false_negative/ 样本误报false_positive评测工单及周期结单率、转需求数、超时率):- 必须切换到
tdir-rulesSkill,直接执行:- 查周期评测工单指标:
tdir rules ops eval-platform tickets metrics --start-date YYYYMMDD --end-date YYYYMMDD --json - 查评测工单列表:
tdir rules ops eval-platform tickets list [--engine-type tdir|tdir_qmedr|qmedr|system_repair|sandbox|ioa_edr] [--ticket-type false_negative|false_positive] [--sample-run-after YYYYMMDD] [--sample-run-before YYYYMMDD] [--created-after YYYYMMDD] [--created-before YYYYMMDD] --json - 查单张评测工单详情与 TAPD 评论区
comments:tdir rules ops eval-platform tickets get --tapd-id <id> --json
- 查周期评测工单指标:
- 必须切换到
TDIR 平台运营工单命令
- 列表与计数:
tdir tickets list、tdir tickets count(或list --count)→list_tickets,支持--rule <rule_id>按关联规则过滤,命中总数取page.total。 - 运营工单多维汇总(
tdir tickets summary或tdir tickets list --summary):面向整体运营巡检与周报,一键按业务分类(insight_emdr洞察运营-EMDR、insight_sampling洞察运营-常规抽检、rule规则运营、entity情报运营、incident高价值事件、product产研/平台缺陷)与处理人(by_owner)聚合工单总数、已完成、进行中、未开始、完成率、已超时/即将超时、平均处理时长avg_mtta_l2_seconds(含emdr_avg_mtta_l2_seconds)及未完成超时工单清单(unfinished_overdue_tickets)。已下线的EMDR 反馈不进入汇总、超时督办或优先级。 - 标题关键词:
tdir tickets search <keyword>→list_tickets的keyword(标题子串匹配,没有语义检索)。 - 固定视图:
tdir tickets insight/rule/entity/incident/product/overdue/assigned→list_tickets叠加固定分类、超时或处理人。 - 详情与评论:
tdir tickets get <ticket_id>→get_ticket(含rule_ids、insight_uuids、machine_ids);tdir tickets comments <ticket_id>→get_ticket_comments。 - 工单事件三层渐进式入口(优化响应速度与展示组织):
- 快速了解(默认入口,只读 MySQL 已有数据):当用户给出工单号并询问“这个工单是什么情况 / 告诉我终端发生了什么 / 给出事件描述和研判结论”时,先用
tdir tickets get <ticket_id>取得insight_uuids[](若为空但有machine_ids[],用tdir insights list <machine_id>定位洞察),随后仅拉取 MySQL 已有的洞察与报告数据——执行tdir insights get <insight_uuid>与tdir insights report <insight_uuid> --kind l1(聚类成员无独立报告时会自动返回source_insight_uuid的源头报告并标记is_source_report=true,按需加tdir endpoints get <machine_id>),按“TL;DR(一句话判断) → 工单与洞察/终端概况小表 → 精简事件主链(文本树/Mermaid) → 研判结论与依据(若is_source_report=true须明确说明该报告为源头洞察事件报告,非当前终端本次事件的独立报告) → 下一步可选方向”输出并结束;不调用tdir hunt、不查原始告警或跨机实体、不下载证据包。 - 初步调查(免取包,在线狩猎与关联查询):当用户要求对工单关联事件开展调查或核实具体疑点(如查某脚本/文件使用、进程活动、外联或同机关联洞察)但未要求下载证据包时,默认不下载冻结证据包,直接使用
tdir insights signals/rules/entities/provenance、tdir hunt investigate、tdir hunt sql或tdir intel lookup在线查询,并按“TL;DR → 调查概要 → 攻击图谱 → 在线核查发现表 → 初步结论”组织输出。 - 深入调查(拉取证据包到本地深入分析):仅当用户明确要求深入调查、拉取证据包或全面挑战性复核 L1 时,才执行
tdir insights evidence download下载冻结证据包到本地深入分析。
- 快速了解(默认入口,只读 MySQL 已有数据):当用户给出工单号并询问“这个工单是什么情况 / 告诉我终端发生了什么 / 给出事件描述和研判结论”时,先用
- 洞察关联的工单:
tdir insights tickets <insight_uuid>。 - 发表评论(写命令):
tdir tickets comment <ticket_id>→create_ticket_comment。先用tdir tickets get确认目标工单,把完整评论内容逐字展示给用户,用户在当前对话中明确确认后才加--yes执行;写入后用tdir tickets comments回查。 - 规则运营工单结单(写命令):
tdir tickets conclude <ticket_id> --conclusion <normal|false_positive|missed>→update_ticket_conclusion。仅限category=规则运营的工单,必须先加--dry-run预览状态与结论变更、向用户展示并在当前对话取得明确确认后,才加--yes执行;写入后用tdir tickets get <ticket_id>回查。Agent 不得代替用户确认。
洞察运营工单的研判结论与失陷状态(conclusions.insight / conclusions.insight_compromised)由 tdir insights verdict update 写回人工研判后自动同步,tdir tickets 不能直接修改,详见 references/ticket-fields.md。有效失陷包含人工确认失陷与未经人工排除的 L1 定性失陷(含独立定性 / 聚类传播),经人工排除则剔除;终端台账 machine.compromise_status=1 由 L1 定性失陷驱动标记,人工在工单或平台上排除失陷不联动修改 machine 表状态。
TAPD 工单只记录运营流程、分类、处理人、时限和运营填写结果;它不生成威胁事实,不参与 Insight 定性、真实事件确认或终端失陷判定。当前 CLI 写命令覆盖评论与“规则运营”工单结单;建单及处理人/期限更新由当前 Agent 环境已有 TAPD 工具承接,以运行时 schema 和权限为准。不要虚构 CLI 子命令,也不要据此认定整个工具环境不能建单。
References
-
创建工单、关联已有问题及处理人/期限更新:
references/ticket-create.md -
list/count/search、过滤参数、分页与输出:
references/ticket-search.md -
分类枚举、固定分类视图、超时与处理人视图:
references/ticket-categories.md -
工单字段、详情、评论与写入规则:
references/ticket-fields.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tdir-1258344699.cos.ap-guangzhou.myqcloud.com/tdir-tickets">View tdir-tickets on skillZs</a>