SuperAPI AI 工具集

forge-create-issue

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:通过交互式讨论,协作规划并创建结构良好的 Issue,创建位置为项目所用的 Issue 跟踪器(提供方检测见 issue-operations)。输入为 Issue 想法或问题描述($ARGUMENTS),可选“-- <additional context>”提供执行指引;未提供参数时会先询问用户想创建什么 Issue。

主要流程:1)理解与澄清,用 AskUserQuestion 收集问题背景、成功标准与约束;2)调研代码库,查找相关实现与模式、集成点、可复用内容及过往类似实现,并验证外部依赖是否可用;3)若输入未包含已选方案,则呈现两到四个结构不同的方案(含一句话摘要、工作方式、优缺点、复杂度、受影响关键文件),由用户选择或组合;4)评估范围,判断应拆分为多个 Issue 还是保持单个,拆分时按垂直切片,并标注 AFK 或 HITL、按依赖排序,提供单 Issue、多个关联 Issue 或 epic 加子 Issue 的选项;5)起草 Issue,标题采用 conventional commit 格式 <type>(<scope>): <description>,先发现可用标签再应用至少一个类型标签和相关领域标签,正文包含 Summary、执行模式、Problem/Motivation、Proposed Solution、Alternatives Considered、Implementation Constraints、Acceptance Criteria 等结构;6)评审并创建,向用户展示草稿并迭代,确认后通过项目 Issue 跟踪器创建并分享引用,建议使用 forge-implement 开始实现。

适用场景:需要把模糊想法转化为可执行、可评审的 Issue,或在动手前比较多种实现路径、评估拆分粒度时。

限制与注意:不要在 Issue 中写时间估算;不要过度规定,给实现者留判断空间;应保持好奇,质疑假设。相关技能:下一步使用 forge-implement 实现该 Issue。示例:/forge-create-issue add dark mode support;/forge-create-issue add dark mode support -- keep it to a single Issue;/forge-create-issue。