pr-to-spec：把 GitHub PR 与本地代码变更转换为结构化、可供 AI 审查的提示规格

jeremylongshore/pr-to-prompt · Convert GitHub PRs into structured, reviewable prompt-spec artifacts for AI-assisted code review and regeneration

GitHub原文发布未知首次收录 2026-09-26上架 2026-09-26 07:02

☆ 收藏查看项目 ↗

ELI5：它是什么，解决什么问题

pr-to-spec（仓库名 pr-to-prompt）是一个 TypeScript 编写的 CLI 与 MCP 服务器工具，可将 GitHub PR、本地分支或暂存改动转换为结构化的 prompt-spec 规格，并支持意图声明与漂移检测（scope_creep、forbidden_touch、risk_escalation、type_mismatch 等信号）。规格生成以确定性启发式规则为主，不执行代码，输出 YAML/Markdown/JSON 及带退出码的 Agent 协议信封，便于管道化交给 AI Agent 做代码审查或重新生成；同时提供 GitHub Action 与 Claude Code、Cursor、Windsurf 等 IDE 的插件集成。

# 开源工具 # 拉取请求 # AI 辅助 # Agent 与自动化 # code-review

核心能力与快速开始

★ 0 · TypeScript

能做什么: 支持分析 GitHub PR（--repo/--pr）、本地分支 diff、暂存改动与最近 N 次提交；通过 intent set/check 声明目标、作用域、禁用路径、风险上限与变更类型，并检测 scope_creep、forbidden_touch、risk_escalation、size_overrun、type_mismatch 等漂移信号；内置基于规则的风险分类（认证、密钥、数据库、权限、支付、依赖、基础设施等）；提供 verification contract 管理、intent DAG 查询与影响分析、审查/CI 反馈摄入；输出 YAML、Markdown、JSON、双格式及 PR 评论，JSON 采用含版本、状态、退出码、信号、spec、intent 的 Agent 协议信封；以 MCP 服务器形式暴露 analyze_pr、scan_local、check_drift、set_intent、show_intent、analyze_assumptions 等工具；支持可选 AI 增强（Anthropic / OpenAI）。
适用场景: 在 CI 或 GitHub Action 中自动为 PR 生成提示规格并回帖评论；把代码改动转换为结构化输入交给 Claude 等 Agent 做审查或重新生成；在本地分支或暂存改动上做意图漂移与风险门禁检查（退出码 0/2/3/4）；在 Claude Code、Cursor、Windsurf 等 IDE 中通过 MCP 插件调用规格分析与漂移检测；用 contract 与 intent gate 约束变更范围、依赖引入与导出等。
项目形态: 可直接使用的工具
部署方式: CLI 本地运行；可作为 MCP 服务器通过 stdio 集成到 IDE（提供 .mcp.json 配置示例），并提供 GitHub Action 工作流示例；开发使用 pnpm（install/build/test/lint/typecheck）。
主要依赖: 需要 Node.js 与 pnpm 进行构建（pnpm install/build/test 等）；分析 GitHub PR 需要 GITHUB_TOKEN（PR 读取权限）；可选 AI 增强需要 ANTHROPIC_API_KEY 或 OPENAI_API_KEY；本地扫描/检查需在 git 仓库内运行；未说明具体版本号与硬件要求。
使用限制: 核心规格生成基于确定性启发式，非 LLM，AI 增强为可选项；不执行代码，仅处理元数据与 diff；GitHub API 单页最多返回 300 个文件，超大 PR 结果可能不完整；GitHub API 存在速率限制；Token 过期或无权限会报错；未说明支持的平台范围与性能上限。
许可证: MIT
最近推送: 2026-09-25 08:16

官方入门项目文档核对 README 依据 ↗

资料检查：2026-09-26 07:00 · 卡片整理：2026-09-26 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

将 GitHub PR、本地分支或暂存改动转换为结构化 prompt-spec，供 AI Agent 做代码审查或重新生成；通过意图声明与漂移检测（scope_creep、forbidden_touch、risk_escalation、type_mismatch 等）辅助代码审查与风险识别。

查看内容依据

Turn any code change — a GitHub PR, a local branch, staged edits — into a structured, agent-consumable spec with intent drift detection.

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

ai-code-review-bot：基于 AST 与 LLM 自动审查 GitHub 拉取请求

ai-code-review-bot 是一个 GitHub App，通过 tree-sitter 语法树分析与 LLM 代码审查自动审阅拉取请求，并在变更行上以内联评论形式给出严重程度、分类和修复建议。项目支持增量审查（仅审查上次审查提交之后的改动）、BullMQ 后台任务队列与重试、OAuth 保护的管理面板，以及按仓库配置启用的检查类别、最低严重程度、排除路径和自定义审查指令。

agent-skills：为编码 Agent 提供基于真实故障经验的可复用技能集

agent-skills 是一组面向编码智能体（主要为 Claude Code，格式为带 YAML frontmatter 的 Markdown，多数 Agent 框架可读取）的技能集合，每个技能都源于生产环境中反复出现的具体失败。技能覆盖无人值守运行与分诊、PR 评论线程审计、对抗式审查、审查分诊、Agent 编排、任务启动、代码质量、缺陷核查、语音记录与开源贡献等场景，强调用工具而非提示词强制执行约束、为质量循环设置成本刹车、区分主张与证据、明确标注未验证结论，并在权限问题上失败关闭。

public-skills：面向编码智能体（Claude Code 等）的可复用技能集合

这是一个以插件市场形式分发的、面向编码智能体的可复用技能（skill）集合。技能按主题分组为 hardware-lab（USB 抓包与协议逆向、台式仪器）、driver-porting（净室驱动规格与板卡专家，另见 driver-lab 仓库）、agent-workflow（与编码智能体长期协作：设计伙伴、项目规划、交接、会话学习等）、dev-tools（工程实用工具）等插件，并提供 everything 聚合插件。每个技能是 plugins/<theme>/skills/<name>/ 下的目录，含 SKILL.md 及脚本、参考或模板，遵循 Agent Skills 约定，可通过 Claude Code、Codex、Antigravity 或扫描 SKILL.md 目录的安装器（如 Vercel skills CLI）安装。

work-agent-skills：面向 AI 编程代理的可复用 SKILL.md 技能库

该项目收集了 71 个可复用的 AI 编程代理技能，以 SKILL.md 目录形式提供，可被 Claude Code、Codex 等读取。技能覆盖需求文档（PRD）撰写与执行、实现计划、代码审查、测试与调试、Git 与发布流程、发布验证、研究与分析、Web/SEO/性能、产品与文档输出等多个环节，并强调仓库经过 CI 检查不含凭证与个人信息，可通过符号链接接入代理的技能目录。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。