mcpField
F
find-unplanned-issues

find-unplanned-issues

github.com/remotion-dev开发68.6k383 次安装今天更新
代码仓库

关于 find-unplanned-issues

面向 Remotion 代码库的技能,用于审计未关联 masterplan 的 GitHub 未关闭 issue,并预览从 masterplan 清理已关闭 issue。它通过附带的 Bun 脚本生成只读报告,并支持 JSON 输出和自动化检查模式。

主要功能

  1. 01查找缺少 masterplan 祖先的 issue
  2. 02报告缺失的父级关系
  3. 03预览清理已关闭 issue
  4. 04支持 JSON 输出与检查模式

适用场景

  1. 01审计未关闭 issue 的规划关联
  2. 02检查 masterplan issue 层级
  3. 03在自动化中检查规划状态
  4. 04预览已关闭 issue 的清理

安装

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

$npx skills add https://github.com/remotion-dev/remotion --skill find-unplanned-issues

安装后在 Claude Code 中输入/find-unplanned-issues确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
scripts/
find-unplanned-issues.ts
prune-closed-masterplan-issues.ts

详细介绍

查找未规划的问题

在仓库根目录运行随附的只读审计脚本:

bun .agents/skills/find-unplanned-issues/scripts/find-unplanned-issues.ts

如果问题标题包含 masterplan,或其父级链中的任意问题标题包含 masterplan,脚本就会将其视为已规划。主计划问题本身不会出现在报告中。仓库特定的例外也会被排除;目前,问题 #8375 属于例外,因为这个长期运行的 CI 不稳定问题跟踪项有意独立存在。结果分为:

  • no parent:这个未关闭的问题完全没有父级。
  • no masterplan ancestor:这个问题有父级,但沿完整的父级链向上追溯时未找到主计划。

需要时,可指定其他仓库或使用机器可读输出:

bun .agents/skills/find-unplanned-issues/scripts/find-unplanned-issues.ts --repo owner/repo
bun .agents/skills/find-unplanned-issues/scripts/find-unplanned-issues.ts --json

自动化时传入 --check。发现未规划的问题时,脚本以状态码 1 退出;所有未关闭且非例外的问题都属于某个主计划时,则以状态码 0 退出。

该审计需要经过身份验证且支持 parent JSON 字段的 gh CLI。它只会读取问题数据。要修复审计结果,请使用 issue-management 技能,并在编辑后验证每项关系。

从主计划中移除已关闭的问题

递归预览根主计划下的所有已关闭后代问题:

bun .agents/skills/find-unplanned-issues/scripts/prune-closed-masterplan-issues.ts

默认根问题为 https://github.com/remotion-dev/remotion/issues/9081。仅当有意审计不同的层级结构时,才覆盖该值:

bun .agents/skills/find-unplanned-issues/scripts/prune-closed-masterplan-issues.ts \
  --root https://github.com/owner/repo/issues/123

除非传入 --apply,否则该命令只会试运行。应用更改时,请按从最深层到最浅层的顺序处理已关闭的问题,并在更改后验证每项关系。如果已关闭的问题有未关闭的子问题,请先将这些子问题移到它的父级,再移除该已关闭问题,以确保未完成的工作仍保留在主计划中。

bun .agents/skills/find-unplanned-issues/scripts/prune-closed-masterplan-issues.ts --apply

使用 --json 获取机器可读的试运行报告。切勿仅为测试脚本而传入 --apply;它会更改 GitHub 上实际的问题关系。

评论

支持 Markdown