用途:为 GitHub Issues 创建可追踪、可独立交付的用户故事待办列表。核心原则是“可验证”:每条验收标准都必须写明证明它的具体方法。该技能定义了 arc 技能家族的标准故事格式,故事正文模板、编号与验收标准规则见 STORY_FORMAT.md;gh 命令、标签、Projects 与认证细节见 GITHUB.md。
主要流程:先检查请求与仓库,确认用户要的是创建故事而非实现规划或泛泛头脑风暴,并阅读仓库文件、PRD/规格、已有 issue 与项目上下文,避免重复或臆想工作;随后在创建 issue 前先起草待办,按 epic/主题分组,使每个故事可独立交付且足够小,可由单个 agent 或开发者实现,并分配优先级(P0/P1/P2)与规模(S/M/L/XL),使用顺序编号 W-000001,先检查已有 issue 并从最大 W- 编号递增;每个故事需含 ID、标题、epic、优先级、规模、job-story 句子及带 Verify: 方法的清单式验收标准。
创建前需向用户展示拟定的 epic 与故事并请求批准,除非用户明确要求直接进行。批准后创建缺失的 epic、优先级与规模标签,用 gh issue create --body-file 创建 issue(不要用 --body 内联 markdown),创建或找到仓库 GitHub Project、关联仓库并加入每个 issue。最后用 gh issue list --limit 50 --state open 或等效查询确认,报告 issue URL/编号、项目状态与后续事项(如所需认证范围);后续实现时 PR 正文应包含 Closes #<number>。
边界:规划已有 issue 的实现用 arc-planning-work;尚未选定目标追踪器用 arc-defining-work;来源为 PRD 且需要纵向切片用 arc-prd-to-issues;目标为 Linear 用 arc-linear-issue-creator。