把 Git 仓库或本地目录整理成一份适合喂给大模型的纯文本摘要。
promptdriven/pdd
一套以 prompt 文件为源码的开发系统,Python、TypeScript、Go 等代码由 prompt 生成。
- Star
- 913
- Fork
- 82
- 未关闭 Issue
- 493
- 最近提交
- 前天
这是什么?
PDD(Prompt-Driven Development)把 `.prompt` 文件当作项目的人工编写源码,传统语言代码由它生成。开发者在 prompt 中描述意图、约束、示例和测试,再生成可阅读、可审查的实现代码,但代码不再是唯一的事实来源。
命令行工具 `pdd-cli` 提供 `pdd sync` 流程,对每个模块依次执行依赖插入、代码生成、示例、崩溃处理、验证、测试和修复。`pdd change`、`pdd bug`、`pdd fix` 等 agentic 命令可以直接读取 GitHub issue 链接,调用 Claude Code、Gemini/Antigravity、Codex 或 OpenCode 等 CLI 执行多步骤工作流。`pdd connect` 会在本地 9876 端口启动网页界面。
本地模式通过 LiteLLM 调用模型,使用 CSV 模型清单,并提供 setup 向导自动检测 API Key 和 agentic CLI。默认的云端模式使用 GitHub 登录。
核心功能
- 01从 `.prompt` 源文件生成 Python、TypeScript、Go 等语言的代码。
- 02通过 `pdd sync` 串联依赖插入、代码生成、示例、崩溃处理、验证与测试。
- 03用 `pdd change`、`pdd bug`、`pdd fix` 直接处理 GitHub issue。
- 04通过 `pdd connect` 启动本地网页界面。
- 05本地模式借助 LiteLLM 支持多个 LLM 提供商和 agentic CLI。
适用场景
- 维护以 prompt 描述行为、意图变化后重新生成代码的项目。
- 借助 agentic 命令把 GitHub 功能需求或 bug 报告转为经过测试的代码变更。
- 从同一份 prompt 源生成多种目标语言的同一模块。
快速上手
- 1
安装 uv(运行 README 中的官方安装脚本)
- 2
使用 uv 安装 PDD
uv tool install pdd-cli - 3
运行设置向导,检测工具和 API 密钥
pdd setup - 4
启动网页界面
pdd connect
使用前须知
- 需要 Python 3.12 或更高版本。
- 大多数工作流需要 LLM API 密钥,或已登录的代理式 CLI(如 Claude Code、Codex 或 Gemini CLI)。
- 基于 Issue 的 CLI 工作流还需要 GitHub CLI(gh)。
收录于专题
标签
常见问题
- pdd 是什么?
- 一套以 prompt 文件为源码的开发系统,Python、TypeScript、Go 等代码由 prompt 生成。 PDD(Prompt-Driven Development)把 `.prompt` 文件当作项目的人工编写源码,传统语言代码由它生成。开发者在 prompt 中描述意图、约束、示例和测试,再生成可阅读、可审查的实现代码,但代码不再是唯一的事实来源。
- pdd 可以免费使用吗?用的什么许可证?
- pdd 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- pdd 还在维护吗?
- 活跃维护中。pdd 最近一次提交是在 2026年10月23日。
- pdd 适合用来做什么?
- 维护以 prompt 描述行为、意图变化后重新生成代码的项目。 借助 agentic 命令把 GitHub 功能需求或 bug 报告转为经过测试的代码变更。 从同一份 prompt 源生成多种目标语言的同一模块。
- pdd 怎么安装和运行?
- 安装 uv(运行 README 中的官方安装脚本) 使用 uv 安装 PDD: uv tool install pdd-cli 运行设置向导,检测工具和 API 密钥: pdd setup 启动网页界面: pdd connect
- 在哪里获取 pdd?
- 源代码和安装说明在 GitHub 上:https://github.com/promptdriven/pdd
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一套开源工具包,为 AI 编码代理提供结构化的规格驱动流程、模板和可记录的产出,用于功能开发、缺陷修复和想法评估。
一条命令完成 Claude Code 与 Codex 的安装和配置,附带中英双语提示词、工作流与 API 服务商预设。
将任意 GitHub 仓库生成可交互的架构图或一分钟讲解视频,并提供给 AI 智能体使用的 MCP 服务。
面向 OpenCode 的 AI 智能体框架,提供先规划、需审批的编码流程,并沿用团队自身的编码规范。
一款 AI 提示词优化工具,可优化、测试、对比提示词效果,并保存为可复用资产,支持网页、桌面、Chrome 扩展和 Docker 部署。