这是一套基于行业专家最佳实践的AI协作开发规范体系,整合了Chris Dzombak、Simon Willison、Anthropic等专家的经验,并通过Claude Code逆向工程分析提炼出企业级AI Agent架构设计,为所有软件项目提供标准化的开发流程和质量保证。
- 产品设计原则: 基于张小龙《微信背后的产品观》的产品设计哲学,作为所有产品的核心设计原则
- 技术架构规范: Web → APP → 小程序渐进式开发路径,React生态技术选型,70-80%代码复用策略
- 设计系统规范: 苹果风格极简设计,完整的色彩/字体/组件/动画系统,响应式设计指南
- AI设计方法论: 交互视觉设计和还原的完整解决方案,涵盖Figma Make、v0、tldraw等最新工具
- AI前端设计指南: 通过AI实现前端界面的完整方案,v0/Cursor/Bolt等工具深度对比
- AI系统架构模块: 基于Claude Code逆向工程,提供完整的Multi-Agent架构设计、92%压缩率的上下文管理、15个工具生态分析
- 1人公司创业指南: AI时代的独立开发者创业方法论,从想法到产品的完整路径
- 移动端跨平台方案: Flutter、React Native、uni-app、Taro全栈支持
- tech-architecture/ - 现代Web应用技术架构选型指南
- 产品设计原则指南.md - 基于张小龙《微信背后的产品观》的产品设计哲学
- 理解人性是产品设计的基础
- 简单就是美的设计理念
- 产品进化论与环境设计
- 产品人格化与品味追求
- 实践指南与核心检查清单
- design-system/ - 现代极简AI产品设计规范
- ai-design-methodology/ - 交互视觉设计和还原的完整解决方案
- ai-frontend-design/ - AI前端开发完整解决方案
- ai-system-architecture/ - 基于Claude Code逆向工程的企业级AI Agent架构参考
- AI-Solo-Founder/ - AI时代的单人创业完整指南
- 基于实战经验的AI创业方法论
- 从想法到产品的完整路径
- 适合独立开发者和小团队
- TECHNICAL_DECISIONS_TEMPLATE.md - 技术决策记录模板
- DEVELOPMENT_BEST_PRACTICES.md - 开发最佳实践指南
- PROJECT_WORKFLOW.md - 项目工作流程规范
- CONTEXT_ENGINEERING_GUIDE.md - AI协作上下文管理指南
- AI_AGENT_DEVELOPMENT_GUIDE.md - AI Agent产品开发完整指南
- MOBILE_CROSS_PLATFORM_GUIDE.md - 移动端跨平台开发完整指南
- MOBILE_FRAMEWORK_COMPARISON.md - 移动端框架详细对比分析
- MOBILE_IMPLEMENTATION_GUIDE.md - 移动端项目实施指南
- PROJECT_SETUP_CHECKLIST.md - 项目启动检查清单
- WEEKLY_PLANNING_TEMPLATE.md - 周计划模板
- CODE_REVIEW_CHECKLIST.md - 代码审查检查清单
- BUG_REPORT_TEMPLATE.md - 问题报告模板
- AGENT_PRD_TEMPLATE.md - AI Agent产品需求文档模板
一键集成到任何项目:
# Agent项目
./scripts/init-project.sh /path/to/your-project agent
# Web项目
./scripts/init-project.sh /path/to/your-project web
# 移动端项目
./scripts/init-project.sh /path/to/your-project mobile
# 通用项目
./scripts/init-project.sh /path/to/your-project立即获得:
- ✅ Claude AI协作配置
- ✅ 完整开发规范文档
- ✅ Git hooks自动检查
- ✅ VSCode优化配置
- ✅ Agent专用模板(agent项目)
- ✅ 移动端跨平台模板(mobile项目)
📚 详细使用指南: QUICK_START.md
# 方法1: 使用启动脚本(推荐)
./start-wiki.sh
# 方法2: 直接运行Python脚本
cd scripts && python3 start-wiki.py访问地址: http://localhost:1024
特色功能:
- 🎨 美观的响应式界面
- 📝 Markdown自动渲染
- 🔗 智能链接导航
- 📋 自动目录生成
- 💻 代码语法高亮
- 复制本规范体系到项目根目录下的
docs/standards/ - 根据项目特点定制技术决策模板
- 设置开发环境和工具链
- 建立团队协作流程
- 阅读 AI Agent开发完整指南
- 使用 Agent PRD模板 撰写需求文档
- 参考 保险Agent案例 学习实践
- 遵循Agent产品开发方法论
- 遵循Context Engineering原则与AI协作
- 应用三次尝试原则解决问题
- 执行增量开发和持续集成
- 维护功能性文档
- 使用代码审查检查清单
- 执行TDD开发流程
- 监控性能和质量指标
- 定期回顾和改进流程
| 版本 | 日期 | 主要变更 | 基于项目 |
|---|---|---|---|
| 2.5 | 2025-09-27 | 新增产品设计原则指南 | 张小龙《微信背后的产品观》 |
| 2.4 | 2025-09-14 | 新增设计系统规范模块 | 苹果设计语言研究 |
| 2.3 | 2025-09-14 | 新增技术架构规范模块 | VibeCodeing项目实践 |
| 2.2 | 2025-09-07 | 新增AI设计方法论模块 | 全网AI设计工具研究 |
| 2.1 | 2025-09-07 | 新增AI前端界面设计指南 | AI工具生态研究 |
| 2.0 | 2025-09-07 | 新增AI系统架构模块、1人公司创业指南 | Claude Code逆向工程 |
| 1.5 | 2025-09-06 | 新增移动端跨平台开发完整方案 | 跨平台框架分析 |
| 1.0 | 2025-08-29 | 初始版本,整合专家最佳实践 | MiniClothes |
- 张小龙: 《微信背后的产品观》(2012年腾讯内部演讲)
- Chris Dzombak: "Getting Good Results from Claude Code"
- Chris Dzombak: "Functional Documentation"
- Simon Willison: Context Engineering理念
- Anthropic: Claude Code Best Practices
- Claude Code Reverse Engineering Analysis (Yuyz0112)
- AI Pair Programming研究和实践
- AI-Solo-Founder创业方法论
- 渐进式全栈开发 - Web → APP → 小程序的渐进式技术路径
- 现代UI/UX设计 - 苹果风格极简设计系统实践
- AI驱动的设计开发 - 从设计到代码的全流程自动化
- 企业级AI Agent开发 - 基于Claude Code架构的Multi-Agent系统
- 1人公司/独立开发者 - AI驱动的单人创业完整方案
- AI Agent产品开发 - 完整的Agent开发方法论
- 智能应用开发 - AI驱动的应用产品
- 移动端跨平台开发 - Flutter、React Native、uni-app、Taro全栈支持
- iOS/Android移动应用开发
- Web前端/后端开发
- AI/ML项目开发
- 小团队敏捷开发
- 个人项目管理
这套规范体系是活文档,会根据实际使用经验持续优化:
- 问题反馈: 记录使用中遇到的问题和改进建议
- 最佳实践分享: 补充新发现的有效方法
- 工具更新: 随技术发展更新工具和配置
- 流程优化: 根据团队反馈调整工作流程
如有问题或建议,请通过以下方式联系:
- 项目Issues: [GitHub链接]
- 邮箱: [联系邮箱]
- 文档维护者: 开发团队
最后更新: 2025-09-27 维护者: Zerolong 版权: MIT License