create-issues

创建 GitHub Issue

按照 TDD 原则和约定式提交规范，为 $ARGUMENTS 执行自动化 GitHub Issue 创建工作流。

上下文

• 当前 git 状态：!git status
• 当前分支：!git branch --show-current
• 未关闭的 Issue：!gh issue list --state open --limit 10
• GitHub 身份验证：!gh auth status

需求摘要

遵循 TDD 原则、约定式提交规范和受保护分支工作流。使用恰当的标签、自动关闭关键词和原子提交。完整规范请参见 references/requirements.md。

阶段 1：仓库分析

目标：评估仓库状态、检测模板，并确定 Issue 的范围和类型。

操作：

1. 根据上下文分析当前分支（main/develop 分支还是 PR 分支）
2. 查看未关闭的 Issue，找出重复或相关的工作
3. 检查贡献指南（CONTRIBUTING.md）并遵循其中的要求
4. 检测 .github/ISSUE_TEMPLATE/ 目录中的 Issue 模板
5. 如果存在模板：使用 gh issue create --list 选择合适的模板
6. 根据 $ARGUMENTS 的复杂程度确定 Issue 类型（史诗、PR 范围或审查）
7. 应用 references/decision-logic.md 中的分支决策逻辑

模板检测和合规详情请参见 references/repository-templates.md。

阶段 2：创建 Issue

目标：创建结构完善、带有恰当标签和链接的 GitHub Issue。

操作：

1. 创建或确认所需的优先级标签已存在（命令请参见 references/decision-logic.md）
2. 按照 references/issue-structure.md 中的结构要求起草 Issue
3. 使用 --label 添加适当的标签（优先级、类型）
   • 使用 --assignee 指定负责人
   • 如有要求，使用 --milestone 关联里程碑，或使用 --project 关联项目
4. 如果是 PR 范围的 Issue，添加自动关闭关键词（史诗除外）
   • 重要：只有 PR 合并到仓库的默认分支时，自动关闭关键词才会生效。 如果该 Issue 将由一个目标分支不是默认分支的 PR 解决，请告知用户该 Issue 不会自动关闭，必须手动关闭——完整规则和关键词表请参见 references/auto-closing-keywords.md。
5. 如适用，关联相关 Issue 或史诗

阶段 3：文档记录与交接

目标：记录决策并说明后续操作。

操作：

1. 记录分支策略决策及其理由
2. 向用户报告已创建 Issue 的编号和 URL
3. 如果当前位于 PR 分支且问题具有阻塞性：不要创建 Issue，而是在 PR 中添加详细评论
4. 说明后续步骤（创建 PR、分配给团队成员等）

参考资料

• 需求：references/requirements.md - 完整的 TDD 和提交规范
• 决策逻辑：references/decision-logic.md - 基于分支的决策和 Issue 类型
• Issue 结构：references/issue-structure.md - 标题、标签、正文、自动关闭
• 自动关闭关键词：references/auto-closing-keywords.md - 默认分支限制和关键词表
• 仓库模板：references/repository-templates.md - 贡献指南和 Issue 模板
• 示例：references/examples.md - 提交消息示例