xiaokeer-project-template
AI-First 项目模板基座,定义 AI-Human 协作开发范式与 PRD 分层需求管理体系。
TemplateAI-FirstPRDWorkflowMarkdown
项目简介
xiaokeer-project-template 是 xiaokeer 项目生态中的初始模板项目,核心定位是提供一套标准化的项目结构和开发规范。项目采用 AI-First(AI优先) 开发方法论,将 AI 编程助手作为核心开发伙伴纳入开发流程,定义了完整的 AI-Human 协作开发范式。
主要特性
- 🤖 AI-First 方法论:将 AI 从辅助工具提升为开发伙伴
- 📋 PRD 分层体系:父子级 PRD 分层,实现需求精细化管理
- 🔄 标准开发流程:需求澄清 → PRD生成 → 拆分 → 增量开发 → 双重验收
- 📝 文档驱动开发:强制文档-代码同步,杜绝"文档过时"
- 🇨🇳 中文注释规范:面向中文开发者的代码可读性保障
- 🚀 快速启动指南:8步流程快速创建新项目
技术栈
| 类别 | 技术 |
|---|---|
| 开发模式 | AI-Human 协作开发 |
| 需求管理 | PRD 分层体系 |
| 文档规范 | Markdown + 中文注释 |
| 版本控制 | Git |
| 许可证 | MIT License |
技术亮点
亮点一:AI-First 开发方法论
将 AI 从"辅助工具"提升为"开发伙伴":
| 传统模式 | xiaokeer模式 |
|---|---|
| AI 是代码生成器 | AI 是需求分析者、架构设计者、开发者 |
| 人工主导全流程 | AI-Human 协作,各司其职 |
| 需求文档人工编写 | AI 主动追问、澄清、生成 PRD |
| 一次性开发 | 增量迭代开发,逐个子需求验收 |
亮点二:PRD 分层体系
父子级 PRD 分层,实现需求的精细化管控:
父级PRD (parent)
├── 原始需求描述
├── 用户回答
├── AI分析
└── 总体规划
↓ 拆分
子级PRD (child-1) 子级PRD (child-2) 子级PRD (child-n)
├── 技术层维度 ├── 工作量维度 ├── 外部依赖维度
└── 可独立开发验收 └── 可独立开发验收 └── 可独立开发验收
拆分维度示例:
- 技术层:前端/后端/数据库
- 工作量:开发工时估算
- 验证性:可测试性评估
- 外部依赖:环境配置/权限申请
亮点三:双重验收机制
AI 自测 + 人工验收的双重保障:
开发完成 → AI自我测试 → 请求人工验收 → 人工确认 → 完成
↓ ↓
发现问题 二次把关
↓ ↓
自动修复 质量保障
亮点四:文档驱动开发
强制文档-代码同步,杜绝"文档过时":
- 代码变更 → 必须更新 README.md
- README.md = 代码库的"活文档"
- 确保后续 AI 迭代时信息准确
亮点五:标准化工作流闭环
从需求到交付的完整闭环:
需求描述 → 需求澄清 → PRD生成 → 深度分析 → PRD拆分 →
增量开发 → 自测验收 → 人工验收 → 交付完成
亮点六:.xiaokeer 工作流目录
类似 .git 或 .idea,作为系统级辅助目录:
.xiaokeer/
├── prd/ # PRD 分层体系
│ ├── prd-x.x.0-parent.md # 父级PRD
│ └── prd-x.x.n-child.md # 子级PRD
├── prompt/ # AI提示词管理
└── SDLC.md # 软件开发生命周期模板
相关链接
- 代码仓库:GitHub