用途:该协议用于规范研究任务产出如何与工单系统对接。当任务存在工单上下文时,研究结果应附加到对应工单;否则仅以文件形式保存到 docs/research/,并告知用户。
主要能力:提供工单附件决策树(先判断是否有工单上下文,再判断是否有 mcp-ticketer 工具);按工作类型分流——可执行型工作创建子任务并关联发现,信息型工作附加文件并加摘要评论;提供执行强制用语、失败回退链、用户沟通模板(成功、部分失败、完全失败)以及优先级矩阵(创建子任务、附加文件加评论、仅评论、仅文件)和工作类型分类决策树,并附多个完整示例。
必要用法:检查任务中是否提供工单 ID/URL 或 PM 委派中的 TICKET CONTEXT;检测工具集中是否存在 mcp__mcp-ticketer__* 工具。有上下文且工具有效时执行附件;创建工作使用 mcp__mcp-ticketer__issue_create(parent_id="{TICKET_ID}"),附件与评论使用 mcp__mcp-ticketer__ticket_attach 与 ticket_comment。附件失败不应阻塞研究交付:记录错误、保存到 docs/research/、向用户报告具体错误。文件写入失败时可回退到备用路径,并按示例处理权限问题。
适用场景:用户显式提供工单、PM 委派携带工单上下文、有 mcp-ticketer 工具且存在工单上下文的研究任务;无工单上下文的临时研究则仅保存本地文件。
限制:资料未提供具体价格、平台范围、工具版本或性能指标;工具名称、路径与命令均需按原始形式使用,不能保证任何单一工单系统的兼容性;附件失败的回退行为以本地文件为准。