skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
tdir-1258344699.cos.ap-guangzhou.myqcloud.com99 installs

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-tickets
view source ↗

Is 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... 开头),但分属三套独立的业务接口,执行查询前必须先按工单类型路由:

  1. 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 工单!
  2. RuleAgent 规则审核工单(规则自动优化战役生成的 【RuleAgent规则审核】TDIR-<规则名> 工单,或用户询问“RuleAgent 的工单 / 昨天 RuleAgent 工单 / 待审核的规则自动优化工单 / RuleAgent 工单评论与原因 / RuleAgent 采纳率”):
    • 必须切换到 tdir-rules Skill(严禁对 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
  3. 评测平台评测工单(POC 样本漏报 false_negative / 样本误报 false_positive 评测工单及周期结单率、转需求数、超时率):
    • 必须切换到 tdir-rules Skill,直接执行:
      • 查周期评测工单指标: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。
  • 工单事件三层渐进式入口(优化响应速度与展示组织):
    1. 快速了解(默认入口,只读 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、不查原始告警或跨机实体、不下载证据包。
    2. 初步调查(免取包,在线狩猎与关联查询):当用户要求对工单关联事件开展调查或核实具体疑点(如查某脚本/文件使用、进程活动、外联或同机关联洞察)但未要求下载证据包时,默认不下载冻结证据包,直接使用 tdir insights signals/rules/entities/provenance、tdir hunt investigate、tdir hunt sql 或 tdir intel lookup 在线查询,并按“TL;DR → 调查概要 → 攻击图谱 → 在线核查发现表 → 初步结论”组织输出。
    3. 深入调查(拉取证据包到本地深入分析):仅当用户明确要求深入调查、拉取证据包或全面挑战性复核 L1 时,才执行 tdir insights evidence download 下载冻结证据包到本地深入分析。
  • 洞察关联的工单: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

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>