gh-ticket

此技能作为 GitHub Issue 生命周期中的技术文档助手。它专为工程师、团队负责人与项目经理设计，旨在通过强制记录系统状态、技术证据与具体需求，解决“模糊工单”的问题。在想法或错误被识别的当下，即时捕获新鲜的上下文，确保开发周期中不会丢失技术细节。

• 自动上下文提取：引导用户记录触发来源、相关文件路径、错误消息以及当前与期望状态。

• 技术证据收集：包含用于执行 git log 指令、通过 grep 搜索文件，以及使用 GitHub CLI (gh) 交叉比对现有 issue 或 PR 的预设流程。

• 结构化需求建模：强制使用包含功能需求、边缘案例与可验证验收标准的标准化模板，确保符合“完成定义”。

• 实现指引：为开发者架构笔记，包括受影响文件列表（修改/创建/删除）、关键代码位置与依赖性追踪。

• 标准化文档：通过对每个创建的工单使用强制性模板结构，提升项目间的工单追踪一致性。

• 适用场景：捕获复杂错误、规划新功能或记录需要采取行动的调查发现。

• 工作流程：遵循四个阶段：上下文捕获、需求提取、实现指引与标准工单结构生成。

• 输入/输出：接收开发者的调查笔记与技术上下文；产出格式完整、具备高度上下文的 GitHub Issue，供团队使用。

• 限制：需要访问 GitHub CLI (gh) 以获得最佳的交叉比对效果，并适用于将工单视为开发任务主要真理来源的协作环境。