mcpField
O
outside-to-issue

outside-to-issue

github.com/pedronauck测试与质量644189 次安装1 周前更新
代码仓库

关于 outside-to-issue

Outside to Issue 是一项技能,可将 diff 范围外的审查 Markdown 文件转换为统一格式的 issue 文件,用于跟踪 PR 审查。它保留审查元数据,并根据已有 issue 自动编号。

主要功能

  1. 01将审查文件转换为 issue 格式
  2. 02保留文件路径、日期和状态
  3. 03依据现有文件分配编号
  4. 04按文件名顺序处理
  5. 05按需创建 issues 目录

适用场景

  1. 01将 diff 外审查发现转为待跟踪 issue
  2. 02整理 PR 审查记录
  3. 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

功能

  1. 查找所有外部文件:读取 ai-docs/reviews-pr-<PR>/outside/ 目录中的所有 .md 文件
  2. 确定起始 Issue 编号:自动查找现有 Issue 中的最大编号,并从下一个可用编号开始编号
  3. 转换每个文件:将 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 审查 Issue
  • resolve_pr_issues.py - 将 Issue 标记为已解决并更新 GitHub 讨论串
  • pr-fix 命令 - 修复指定 PR 的问题

评论

支持 Markdown