用途:在分支工作完成、准备提交拉取请求(PR)或合并请求(MR)时使用,创建能关联相关 issue 的 PR/MR,并通过关闭关键词在合并时自动关闭 issue。该技能会适配 GitHub、Forgejo 或本地 tk 工作流;本地 tk 场景下变为“准备合并”,无需远程 PR。
主要能力:强制要求每个 PR/MR 关联相关 issue 并使用关闭关键词,未关联 issue 视为不完整;支持 GitHub/Forgejo 的 Closes #X、Fixes #X、Resolves #X 自动关闭,本地 tk 用 tk dep / tk link 连接工单;可引用所有相关 issue(即使不关闭);支持在 PR/MR 正文中嵌入 Mermaid 图(GitHub/Forgejo 原生渲染),用于展示前后状态、数据流、组件交互与架构变更。
使用方式:先识别相关 issue(GitHub 用 gh issue list --search、gh issue view;Forgejo 用 tea issue list、tea issue view;本地 tk 用 tk ls、tk show),再用 git log main..HEAD --oneline、git diff main..HEAD --stat 收集上下文,然后创建 PR/MR。GitHub 用 gh pr create --title ... --body ...,Forgejo 用 tea pr create --title ... --description ...,正文格式一致;本地 tk 用 tk link、tk dep、tk add-note 连接工单并记录摘要。创建后验证关联:GitHub 用 gh pr view <number> --json closingIssuesReferences,Forgejo 用 tea pr view <number>,本地 tk 用 tk show <id>。
适用场景:分支开发完成、需要提交 PR/MR 或准备本地合并时;需要把变更与 issue 明确关联、需要图示复杂变更时。
限制:本地 tk 场景不创建远程 PR,也不使用 Mermaid 图(工单备注为纯文本);PR/MR 描述中不得包含 AI 工具署名页脚;Mermaid 图建议控制在 5-10 个节点并聚焦变更本身。平台检测规则参见 skills/obsidian-plan-wiki/references/platform-detection.md。