用途:面向 GitHub issue 的开始、规划、实现、跟踪与关闭全流程,核心约定是「1 issue = 1 branch = 1 worktree」,不在 main worktree 直接处理 issue,工作日志、判断、进度与 PR URL 均留在 issue comment 中。
主要能力:将 SKILL.md 作为入口,细节分散在 references 下的文件,按需读取。issue-selection.md 负责 issue 选定与依赖关系;issue-reference.md 负责从 GitHub Projects 引用 issue 与 GH_TOKEN;worktree.md 负责 worktree 的创建、命名与 .worktreeinclude;issue-progress.md 负责作业中的 issue 更新与设计资料切分;completion.md 负责 PR 后的收尾与设计资料反映;checklist.md 用于完工前检查。另有 HTML 与无 HTML 两种规划分发方式:有 HTML 分发时,issue description 只保留最小摘要与「## プランニング用資料」下的 [v{N}] 链接,计划全文放 HTML;无 HTML 分发时,将规划 Markdown 原样转记到 issue description,AI 侧规划文件只写 issue 链接。
使用方式:AI 代理写入 comment、description、status 时,须在 GitHub App bot preflight 成功后仅使用 bot helper script;preflight 失败则显示 setup 步骤并停止,禁止回退到人工 gh 或 GH_TOKEN。Plan mode 下若确认禁止写入前,须先向用户明示更新对象与内容概要并取得明确许可,获准后按 issue-progress.md 等正规步骤执行。只在 issue branch 产生差分,commit/push 前 gitleaks 失败则不得提交或推送,禁止用 --no-verify 等绕过 hook。
适用场景:需要在 GitHub 上以 issue 为单元、配合 worktree 隔离开发并留存可追溯进度的团队与代理协作流程。
限制:全流程依赖 GitHub App bot 与 helper script,preflight 不通过即停止;不提供人工 gh 回退路径;其他 GitHub 操作与 PR 评审需分别参考 kf-g-github-operations-bot-workflow 与 kf-g-github-pr-review-workflow。性能、收费、价格与平台等未在资料中提供。