mcpField
F
forge-create-issue

forge-create-issue

github.com/mgratzer开发8352 次安装3 天前更新
代码仓库

关于 forge-create-issue

通过互动讨论协助团队规划并创建结构清晰的 Issue。该 skill 会先检查相关代码，再澄清目标、比较实现方案、评估拆分方式，并在用户确认后提交到项目 Issue 跟踪器。

主要功能

  1. 01先调查相关代码与复用点
  2. 02澄清问题背景和验收标准
  3. 03比较不同实现方案
  4. 04评估单个或多个 Issue
  5. 05确认草稿后创建 Issue

适用场景

  1. 01将功能想法整理成 Issue
  2. 02为缺陷描述补充成功标准
  3. 03讨论实现方式并确定范围
  4. 04将大型工作拆分为关联 Issue

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mgratzer/forge --skill forge-create-issue

安装后在 Claude Code 中输入/forge-create-issue确认已加载。

附带文件references/afk-vs-hitl.md

详细介绍

创建 Issue

通过交互式讨论协作规划并创建结构完善的 Issue。Issue 将创建在项目的 Issue 跟踪器中——有关服务提供方检测，请参阅 issue-operations。

输入

Issue 的想法或问题描述：$ARGUMENTS

可选：使用 -- <additional context> 提供执行指导。

如果未提供参数，请询问用户想针对什么内容创建 Issue。

流程

步骤 1：研究代码库

解析用户的输入，然后在提问前探索相关代码：

  • 查找相关的现有实现和模式
  • 确认集成点和可复用内容

如有相关外部依赖，请确认其可访问；如果依赖不可用，先指出问题再继续。

步骤 2：澄清需求

使用 AskUserQuestion 收集代码无法回答的信息：

  • 问题背景——是什么引发了这个问题、影响了哪些人、当前行为与期望行为
  • 成功标准——如何判断任务已完成
  • 约束条件——技术限制、依赖项
步骤 3：呈现备选方案

如果输入中已包含经过分析并说明理由的选定方案，跳过此步骤——决策已通过审慎分析作出。直接进入步骤 4。

否则，呈现你找到的结构不同的方案——通常为两到四个，而不是只给出一个建议；选择权属于用户。

对每个方案：

  • 一句话概述
  • 工作方式（简述）
  • 优缺点
  • 相对复杂度（低 / 中 / 高）
  • 受影响的关键文件

让用户通过 AskUserQuestion 选择或组合方案。

步骤 4：评估范围

评估应创建一个 Issue 还是多个 Issue。

**适合拆分的情况：**交付内容各不相同、涉及代码库的不同区域、工作可并行开展，或工作量超过 1-2 天。

**适合合并的情况：**变更紧密耦合，或拆分会增加协调开销。

拆分时，应采用纵向切分——每个 Issue 都是一条精简的端到端路径（参见 vertical-slicing）。将每项分类为 AFK 或 HITL（参见 afk-vs-hitl.md）。按依赖关系排序。

如果适合拆分，提供以下选择：单个 Issue、多个关联的 Issue，或包含子 Issue 的 epic。

步骤 5：起草 Issue

**标题：**使用常规提交格式——<type>(<scope>): <description>

**标签：**应用前先确认现有标签——参见 issue-operations。至少添加一个类型标签和相关的领域标签。

正文结构：

## Summary
[1-2 sentences]

**Execution mode:** [AFK | HITL] 

## Problem / Motivation
[Why this needs to exist]

## Proposed Solution
[Chosen approach with implementation details]

### Alternatives Considered
[Other approaches and why they weren't chosen]

### Implementation Constraints
[When applicable: preferred libraries, config locations, patterns to follow, external dependencies]

## Acceptance Criteria
- [ ] [Specific, testable criteria]
- [ ] Tests added/updated
- [ ] Documentation updated (if applicable)
步骤 6：审核并创建

向用户展示草稿，并持续修改直至用户满意（使用 AskUserQuestion 确认批准或修改）。然后使用项目的 Issue 跟踪器创建 Issue——有关特定服务提供方的操作方式，包括包含子 Issue 的 epic，请参阅 issue-operations。

分享 Issue 引用信息。建议使用 forge-implement 开始实现。

指南

  • 保持好奇——质疑假设，询问“为什么”和“如果……会怎样”
  • 不要规定过细——为实现者的判断留出空间
  • Issue 中不写时间估算——步骤 4 的工作量启发式仅用于决定是否拆分，不应写入 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

评论

支持 Markdown