关于 outside-to-issue
Outside to Issue 是一项技能,可将 diff 范围外的审查 Markdown 文件转换为统一格式的 issue 文件,用于跟踪 PR 审查。它保留审查元数据,并根据已有 issue 自动编号。
主要功能
- 01将审查文件转换为 issue 格式
- 02保留文件路径、日期和状态
- 03依据现有文件分配编号
- 04按文件名顺序处理
- 05按需创建 issues 目录
适用场景
- 01将 diff 外审查发现转为待跟踪 issue
- 02整理 PR 审查记录
- 03为现有 PR 延续 issue 编号
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pedronauck/ skills --skill outside-to-issue安装后在 Claude Code 中输入/outside-to-issue确认已加载。
详细介绍
从 diff 外部转为 Issue
将 diff 外部的审查文件转换为格式规范的 Issue 文件,用于跟踪 PR 审查。
概述
此技能会将 outside/ 目录中的审查文件转换为 issues/ 目录中的标准 Issue 文件,并遵循项目的 Issue 模板格式。转换过程会保留所有元数据,并自动处理 Issue 编号。
用法
针对特定 PR 运行转换脚本:
scripts/transform-outside-to-issues.sh --pr <PR_NUMBER>
示例:
scripts/transform-outside-to-issues.sh --pr 90
功能
- 查找所有外部文件:读取
ai-docs/reviews-pr-<PR>/outside/目录中的所有.md文件 - 确定起始 Issue 编号:自动查找现有 Issue 中的最大编号,并从下一个可用编号开始编号
- 转换每个文件:将 diff 外部的审查文件转换为 Issue 格式,包含:
- Issue 编号和标题
- 审查中的文件路径
- 日期和状态
- 包含审查详情的正文部分
- 标明该文件来自 diff 外部审查的页脚
文件结构
脚本所需的目录结构如下:
ai-docs/reviews-pr-<PR>/
├── outside/
│ ├── 002-outside_01_<file-path>.md
│ ├── 002-outside_02_<file-path>.md
│ └── ...
└── issues/
├── 001-issue.md
├── 002-issue.md
└── ...
输出格式
每个转换后的 Issue 文件都采用以下格式:
# Issue <NUMBER> - Outside-of-diff
**File:** `<file-path>`
**Date:** <date>
**Status:** <status>
## Body
<review-details-content>
---
_Generated from outside-of-diff review_
示例
对于包含 18 个 diff 外部文件的 PR 90:
scripts/transform-outside-to-issues.sh --pr 90
输出:
Created: issues/026-issue.md
Created: issues/027-issue.md
...
Created: issues/043-issue.md
Transformation complete! Created issues starting from 26
备注
- 脚本会根据现有 Issue 自动确定起始 Issue 编号
- 文件按排序后的顺序处理(按文件名的字母顺序)
- 原始 diff 外部文件中的所有元数据(文件路径、日期、状态)都会保留
- Details 部分的内容会成为 Issue 文件中的 Body 部分
- 如果
issues/目录不存在,脚本会创建该目录
相关命令
read_pr_issues.sh- 读取并显示 PR 审查 Issueresolve_pr_issues.py- 将 Issue 标记为已解决并更新 GitHub 讨论串pr-fix命令 - 修复指定 PR 的问题
评论
支持 Markdown