Unleash AI Speed. Reduce Engineering Risk.
⭐ 如果 ODD 对你有帮助，请给我们一个 Star — 帮助更多人发现负责任的 AI 开发方式
⭐ If ODD helps you, please star us — help others discover responsible AI development
ODD (Output-Driven Development) 是 AI 原生软件工程的责任框架。
当代码以 1000 行/秒生成时，传统的人审代码已成为安全漏洞。ODD 通过契约前置 + 系统验证 + 责任封存，让你：
- ✅ 释放 AI 速度 — 不再等待人审代码
- ✅ 减少工程风险 — 完整可追溯的责任链
- ✅ 明确责任归属 — 谁定义契约，谁承担决策责任
# 1. 克隆仓库
git clone https://github.com/oddfounder/odd-starter
cd odd-starter
# 2. 安装依赖
pip install -r requirements.txt
# 3. 配置 API Key (复制 .env.example 为 .env)
# OPENAI_API_KEY=your_key_here
# OPENAI_BASE_URL=https://api.openai.com/v1 # 或使用 NVIDIA/其他兼容 API
# 4. 运行 Demo
python main.py generate "创建一个用户登录API"输出：
┌─────────────────────────────────────────────────────────────────┐
│ Step 1: 契约生成 │
├─────────────────────────────────────────────────────────────────┤
│ ✓ 匹配到产出物类型: auth_login │
│ ✓ 契约ID: 45335210... │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ Step 2: 代码生成 (AI) │
├─────────────────────────────────────────────────────────────────┤
│ ✓ 代码生成完成 (tokens: 1851) │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ Step 3: 契约验证 │
├─────────────────────────────────────────────────────────────────┤
│ ✓ 密码哈希函数 PASS (检测到 bcrypt) │
│ ✓ 会话令牌 PASS (检测到 jwt) │
│ ⚠ 明文密码存储 FAIL (需人工决策) │
│ ✓ 敏感日志 PASS (无 log(password)) │
└─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ Step 4: 封存 │
├─────────────────────────────────────────────────────────────────┤
│ ✓ 封存完成: output/seal_961afd7e.json │
│ ✓ 完整性哈希: 86c58aeb4088245e... │
└─────────────────────────────────────────────────────────────────┘
传统模式：
需求 → 人写代码 → 人审代码 → 部署
↑
瓶颈：人审速度
ODD 模式：
需求 → 契约 → AI生成 → 系统验证 → 封存 → 部署
↑ ↑ ↑
人定义 AI执行 自动检查
| 角色 | 传统开发 | ODD 开发 |
|---|---|---|
| 人类 | 写代码 + 审代码 + 背锅 | 定契约 + 做决策 |
| AI | (工具) | 生成代码 |
| 系统 | (无) | 验证 + 封存 |
- 📕 学术论文 v7.1 — Zenodo DOI: 10.5281/zenodo.18207648
- 📄 战略白皮书 — ODD: 释放 AI 速度，减少工程风险
- 🔬 5D Context Model — 理论基础
| 文档 | 适合人群 | 主题 |
|---|---|---|
| 开发者版 | 工程师 | 从"写代码"到"定契约"的角色升级 |
| 管理者版 | 技术管理者 | 如何在 AI 时代控制质量与风险 |
| 决策者版 | CTO/VP | 速度与安全的零和博弈已被打破 |
English Versions Available | 英文版可用
odd-starter/
├── odd/ # ODD 核心模块
│ ├── contract_generator.py # 契约生成器
│ ├── code_generator.py # 代码生成器
│ ├── contract_verifier.py # 契约验证器
│ └── seal_manager.py # 封存管理器
├── artifacts/standards/ # 产出物标准库
│ └── standard_library.yaml # 内置契约模板
├── docs/ # 文档
│ ├── demo-explained-for-developers_CN.md
│ ├── demo-explained-for-managers_CN.md
│ └── demo-explained-for-executives_CN.md
├── main.py # CLI 入口
├── requirements.txt
└── run_demo.bat # 一键运行脚本
| 文档 | 适合人群 | 主题 |
|---|---|---|
| 开发者版 | 工程师 | 从"写代码"到"定契约"的角色升级 |
| 管理者版 | 技术管理者 | 如何在 AI 时代控制质量与风险 |
| 决策者版 | CTO/VP | 速度与安全的零和博弈已被打破 |
English Versions available.
| 维度 | 传统假设 | AI 时代现实 |
|---|---|---|
| 代码作者 | 人类写代码 | AI 生成代码 |
| 质量保证 | 人审代码 | 代码量超越人审能力 |
| 责任归属 | 写代码的人负责 | 谁负责？ |
当代码生成不再稀缺，责任、可审计性、决策结构成为新的稀缺资源。
# 完整流程
python main.py generate "用户需求"
# 仅生成契约
python main.py contract "用户需求"欢迎贡献！请查看 CONTRIBUTING.md (待创建)
MIT License - 详见 LICENSE
Author: Yi Fu (ODDFounder) Email: fuyi.it@live.cn WeChat: Fuyi-ODDFounder
- 感谢所有给 ODD 项目 Star 的开发者
- 感谢 ODD 理论的早期反馈者
- 感谢所有为负责任 AI 开发而努力的人
ODD 释放 AI 速度，减少工程风险
Unleash AI Speed. Reduce Engineering Risk.