关于 find-unplanned-issues
面向 Remotion 代码库的技能,用于审计未关联 masterplan 的 GitHub 未关闭 issue,并预览从 masterplan 清理已关闭 issue。它通过附带的 Bun 脚本生成只读报告,并支持 JSON 输出和自动化检查模式。
主要功能
- 01查找缺少 masterplan 祖先的 issue
- 02报告缺失的父级关系
- 03预览清理已关闭 issue
- 04支持 JSON 输出与检查模式
适用场景
- 01审计未关闭 issue 的规划关联
- 02检查 masterplan issue 层级
- 03在自动化中检查规划状态
- 04预览已关闭 issue 的清理
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ remotion-dev/ remotion --skill find-unplanned-issues安装后在 Claude Code 中输入/find-unplanned-issues确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlscripts/find-unplanned-issues.tsprune-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 上实际的问题关系。