关于 issue
issue 是用于起草和管理 GitHub issue 的 skill,指导编写简洁且保留用户原意的标题,并正确处理 Markdown。内容还涉及附件、编辑后的核验,以及通过 issue-management skill 管理 issue 关系。
主要功能
- 01标题保留用户原意
- 02使用包名或领域前缀
- 03通过文件编写多行正文
- 04添加图片和视频附件
- 05编辑后核验 issue 内容
- 06将 issue 关系交由另一 skill 处理
适用场景
- 01为 GitHub issue 拟定清晰标题
- 02创建含多行 Markdown 的 issue
- 03为 issue 添加截图或视频
- 04编辑后检查 issue 内容
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ remotion-dev/ remotion --skill issue安装后在 Claude Code 中输入/issue确认已加载。
详细介绍
标题
编写简洁的标题,保留用户的表述方式。问题可以描述一个问题,也可以提出指令;除非用户提供或明确要求解决方案,否则不要把问题改写成指定解决方案。
针对特定软件包的问题,请在标题前加上软件包名称:
`@remotion/package`: Issue description
对于范围更广的问题,请使用相应的前缀:
Docs: Issue description
Studio: Issue description
Build: Issue description
CI: Issue description
Repo: Issue description
避免使用 Bug、Fix issue 或 Examples follow-up 等含义模糊的标题。
Markdown 正文和评论
切勿通过 shell 参数以内联方式传递多行 Markdown。请将问题正文和多行评论写入临时 Markdown 文件,优先使用 write 工具,并通过 --body-file 传入。
创建或编辑问题后,请验证其标题和正文:
gh issue view <number> --json title,body
确认内容正确,并且多行 Markdown 中包含真实换行,而不是字面上的 \n 序列。
附件
用户提供图片或视频时,请在 gh issue create、edit 或 comment 命令中使用 --attach 上传:
gh issue edit <number> --attach '/tmp/screenshot.png#Description of the screenshot'
多个文件请重复使用该标志。图片支持在 # 后添加替代文本;视频不支持。附件会追加到正文末尾,或将匹配的本地 Markdown 引用改写为上传后的 URL。仅使用 --attach 编辑会保留现有正文。
如果上传部分失败,请在重试前检查问题,避免重复添加。详情请参阅 gh issue <command> --help。
关联关系
对于父问题、子问题、阻塞方和被阻塞方的关联关系,请使用 issue-management 技能。