用途:面向自己提交代码的产品经理,把当前分支的 git 提交转成中文产品行为摘要与测试用例,再同步到 PM 的任务型 Jira issue。团队流程中 PR 标题带 PM 的 Jira 键,PR 合并后 Jira 自动生成下游测试型 issue 供 QA 阅读,因此写入的描述就是 QA 看到的上下文。
主要能力:读取提交差异(不只看提交信息)提取用户可见变化;按固定模板生成中文标题([模块] 一句话功能描述)、产品行为变更与测试用例;更新既有 issue 时保留原有标题、描述、Slack URL、关联 issue、截图、@提及等,默认静默保留、只追加;同步后返回 Jira URL 并一句话总结。
使用方式:入口为 /1k-jira-qa-handoff。默认提交范围为相对 origin/x 的独有提交,命令如 git fetch origin x、git log origin/x..HEAD 与 git diff origin/x...HEAD --stat;也可指定提交哈希或范围。先用 git show 逐条查看差异。相对日期须转成 YYYY-MM-DD。草稿先向用户预览一次,确认后再调用编辑端点;无 Jira URL 时先查提交或 PR 标题中已有的 OK-XXXXX 键,避免重复创建。Jira 内容一律简体中文,技能指令保持英文。
适用场景:有用户可见改动的功能交付、需要为 QA 补充产品行为说明与 2–4 条测试用例(覆盖主路径、平台分支、可见的负向路径)时使用。
限制:纯重构、杂项或依赖升级等无用户可见变化时跳过并提示;已有 QA 自有 Jira 测试 issue 的纯代码修复需先确认再决定是否重复;不写入代码片段、文件路径、函数名、行号或实现细节,不写只检查内部调用或状态机的用例;埋点验证需在备注中引导 PM 找数据团队。Atlassian MCP 未认证时先认证,之后需先加载 Jira 工具 schema 再按全限定名调用,部分工具需 cloudId。
相关技能:/1k-create-pr、/1k-commit、/1k-dev-commands、/1k-code-review-pr。