Skip to content

zerolong0/Development-Standards

Repository files navigation

AI协作开发规范体系

🎯 概述

这是一套基于行业专家最佳实践的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全栈支持

📚 文档结构

🏗️ 技术架构规范(新增)

🎯 产品设计原则(新增)

  • 产品设计原则指南.md - 基于张小龙《微信背后的产品观》的产品设计哲学
    • 理解人性是产品设计的基础
    • 简单就是美的设计理念
    • 产品进化论与环境设计
    • 产品人格化与品味追求
    • 实践指南与核心检查清单

🎨 设计系统规范(新增)

🎨 AI设计方法论

🎨 AI前端界面设计

🏗️ AI系统架构模块

🚀 1人公司AI创业指南(新增)

  • AI-Solo-Founder/ - AI时代的单人创业完整指南
    • 基于实战经验的AI创业方法论
    • 从想法到产品的完整路径
    • 适合独立开发者和小团队

📋 核心规范文档

📱 移动端跨平台开发指南

📝 实用模板

🛠️ 工具和脚本

🚀 如何使用

⚡ 快速开始(推荐)

一键集成到任何项目:

# 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

📖 启动本地Wiki服务

# 方法1: 使用启动脚本(推荐)
./start-wiki.sh

# 方法2: 直接运行Python脚本
cd scripts && python3 start-wiki.py

访问地址: http://localhost:1024

特色功能:

  • 🎨 美观的响应式界面
  • 📝 Markdown自动渲染
  • 🔗 智能链接导航
  • 📋 自动目录生成
  • 💻 代码语法高亮

新项目启动

  1. 复制本规范体系到项目根目录下的 docs/standards/
  2. 根据项目特点定制技术决策模板
  3. 设置开发环境和工具链
  4. 建立团队协作流程

AI Agent项目开发

  1. 阅读 AI Agent开发完整指南
  2. 使用 Agent PRD模板 撰写需求文档
  3. 参考 保险Agent案例 学习实践
  4. 遵循Agent产品开发方法论

日常开发

  1. 遵循Context Engineering原则与AI协作
  2. 应用三次尝试原则解决问题
  3. 执行增量开发和持续集成
  4. 维护功能性文档

质量保证

  1. 使用代码审查检查清单
  2. 执行TDD开发流程
  3. 监控性能和质量指标
  4. 定期回顾和改进流程

📈 版本历史

版本 日期 主要变更 基于项目
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项目开发
  • 小团队敏捷开发
  • 个人项目管理

🤝 贡献和改进

这套规范体系是活文档,会根据实际使用经验持续优化:

  1. 问题反馈: 记录使用中遇到的问题和改进建议
  2. 最佳实践分享: 补充新发现的有效方法
  3. 工具更新: 随技术发展更新工具和配置
  4. 流程优化: 根据团队反馈调整工作流程

📞 支持和联系

如有问题或建议,请通过以下方式联系:

  • 项目Issues: [GitHub链接]
  • 邮箱: [联系邮箱]
  • 文档维护者: 开发团队

最后更新: 2025-09-27 维护者: Zerolong 版权: MIT License

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages