issue-start 是一个围绕 GitHub Issue 的自动化工作流技能,输入 Issue 编号后依次完成收集、分析、实现与证据汇报。主要能力包括:用 gh 抓取 Issue 正文、评论、标签与附件图片并实际阅读;判定任务属于前端、后端还是两者,对照代码库做分析并把计划存到 .issue/{issue_number}/plan.md;创建 git worktree、在修改前采集 before 证据、实现并提交、再采集带标注框的 after 证据;把证据图镜像提交到默认分支,并在 Issue 上留下前后对比评论。
使用方式:以 Issue 编号或描述作为参数触发,例如 /issue-start 59;编号路径会校验 git 仓库与 gh 认证(Jira 场景另需 ~/.issue/settings.json 配置),描述路径会转入 plan 模式询问是否登记为 Issue。流程分为 13 个阶段:参数分支与前置检查、Issue 收集、任务性质判定、代码库对照分析、创建 worktree、before 采集、实现、工作树提交、after 采集、证据镜像提交推送、Issue 评论、主检出更新、选择下一步。脚本通过 node <skill>/scripts/issue-start.mjs 调用 fetch、worktree、guard、evidence-commit、evidence-mirror、evidence-urls、report-check、sync-base 等子命令;也可用 phase --request 走机器编排接口。
提交时用 git add -A -- ':!.issue' 排除证据目录,避免证据混入实现 diff。证据图地址按仓库公开范围选择:公开仓库用镜像 raw URL,私有仓库用 user-attachments URL。
限制与注意:依赖 gh 认证与 git 仓库环境;私有仓库的图片自动上传可能失败,需要用户手动上传;worktree 布局(sibling/children)需一次性确定;主检出同步受阻时不会自动处理,需向用户确认。其余收费、平台支持等信息本文档暂未提供。