diff --git a/README.md b/README.md index bb128cf..027afcb 100644 --- a/README.md +++ b/README.md @@ -1,119 +1,154 @@ -# 🚀 TechCamp - 1024 实训营 +
+

XEngineer

+

+ Be the Builder. Be an XEngineer.
+ AI 能写代码了，工程师的核心能力不再是「写」，而是「判断」。 +

+

+ Qiniu Cloud + Founder + Season 6 +

+
+ +--- + +## 🚀 关于 XEngineer + +XEngineer 新工科计划（原 1024 实训营）由七牛云发起，是一个以开源精神为基石的工程师成长平台。 -> 携手成长，成就优秀工程师 +在 AI 编程工具的冲击下，《人月神话》的传统工程逻辑正在失效，“写代码”不再是核心瓶颈。真正决定项目成败的，变成了更高维度的拷问： +- 你在解决一个**真正值得**的问题吗？ +- 你的系统架构能否**支撑未来的变化**？ +- 你用什么来**证明**你交付的东西是可靠的？ + +当 AI 代劳了基础开发，工程师的价值必须向高处迁移：从「代码实现」转向「产品决策与架构设计」。 + +这正是我们升级为 XEngineer 的初衷——**“X”代表倍增，代表跨界，代表正交，代表无限可能**，代表我们相信每一位工程师都有潜力创造十倍于过去的价值。 + +在这里，你将告别纸上谈兵，直面真实复杂的开源项目，体验严谨的工程规范，感受架构设计的艺术，在实战中锻造工程思维，在协作中传承技术精神。 + +从扎实技术到追求卓越，与我们一起成为 XEngineer。 + +--- -[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) -[![Status](https://img.shields.io/badge/status-active-brightgreen.svg)]() +## 🎯 我们要培养什么样的人？ -## 📖 项目简介 +我们想和你一起成为的，是能够**定义问题、设计系统、做出决策、创造商业价值**的人。 -1024 实训营，由七牛云发起，致力于打造一个开放、实践、创新的工程师成长平台。我们以开源精神为基石，以工程实践为路径，以架构思维为指引，在真实项目中锤炼工程师的工匠精神。 +这样的人，我们称之为：**产品架构师（Product Architect）**。 -在这里，你将直面真实复杂的开源项目，体验严谨的工程规范，感受架构设计的艺术，在实战中锻造工程思维，在协作中传承技术精神。 +支撑这种判断力的，是一套完整的能力框架： -我们相信，优秀的工程师不仅需要扎实的技术功底，更需要追求卓越的工程精神。 +| 维度 | 核心问题 | 本质 | +|------|----------|------| +| **工程** | 怎么把事做成？ | 拆解复杂问题为独立模块，通过版本迭代逼近目标，借助团队分工协同推进 | +| **设计** | 做什么事？做成什么样子？ | 一门关于「决策」的学问，回答边界与取舍 | +| **商业** | 什么值得做？ | 理解需求、衡量价值、判断投入产出 | -如果你也热爱技术、渴望成长，欢迎加入我们。 +--- ## 🎯 项目特色 -- **开源公开**：过程公开，结果开源，倒逼高质量产出，让优秀者容易被看见 -- **AI Native**：倡导 Build/Think/Code With AI，让 AI 成为你最强大的伙伴，共同创造 -- **技术纵深**：挑战编程语言、编译器等高技术门槛项目，技术纵深足够，切入点不设限 -- **资深带教**：资深专家全程陪跑，代码逐行审阅，架构反复推敲，坚持高工程标准 -- **全流程参与**：从定方位到架构设计再到开发实现，体验完整的产品思维和架构思维 -- **小团队共创**：3-5 人小组协作，激发潜能，培养团队协作和领导力 +- **开源公开**：过程公开，结果开源，倒逼高质量产出，让优秀者容易被看见。 +- **技术纵深**：挑战编程语言、编译器等高技术门槛项目，技术纵深足够，切入点不设限。 +- **资深带教**：资深专家全程陪跑，代码逐行审阅，架构反复推敲，坚持高工程标准。 +- **全流程参与**：从定方位到架构设计再到开发实现，体验完整的产品思维和架构思维。 +- **小团队共创**：5-6 人小组协作，激发潜能，培养团队协作和领导力。 + +--- + +## 📅 8 周硬核迭代旅程 (Milestone Journey) + +我们的实战项目采用 **8 周 / 4 个里程碑 (Milestone)** 的敏捷迭代模式，每一轮都交付可演示的闭环产物： + +| 阶段 | 核心目标 | 关键交付物 | +|------|----------|------------| +| **MS0** | 开营准备 | 环境配置、业务议题输入、规范对齐 | +| **MS1** | 战略决策与骨架 | 产品 Proposal、**架构主干代码**、首个可串联版本 | +| **MS2** | MVP 深化落实 | 核心路径跑通、Issue 任务拆解、架构细化 | +| **MS3** | 功能闭合达标 | MVP 完整可用、核心测试覆盖、导师 Code Review | +| **MS4** | 打磨交付发布 | 冻结功能、部署环境、v1.0 Tag、路演与复盘 | -## 📚 内容目录 +--- + +## 🛠 核心工程哲学 (The XEngineer Way) -### 🆕 2026 年技术课程 +在 XEngineer，我们遵循一套严苛但极具价值的工程规范： -| 序号 | 主题 | 链接 | -| ---- | ---------------------------------------------------- | ------------------------------------------------------------------------------------ | -| 01 | 从 0 构建一个 Mini Claude Code（TypeScript） | [📖 阅读](2026/01.%20从0构建一个Mini%20Claude%20Code%28TypeScript%29/README.md) | +- 🎯 **先设计，再开发 (Design Before Code)** + - 严禁将模糊需求直接丢给 AI 生成代码。任何功能进入编码前，必须先厘清产品边界与架构骨架。 +- 📄 **文档驱动开发 (Documentation-Driven)** + - 重要的决策不留存在聊天记录里。需求变更做增量，工程文档一旦进入开发即视为「只读基线」。 +- 🏗️ **代码即架构 (Code as Architecture)** + - 系统架构不是目录罗列，而是通过**空骨架代码**（真实的接口与数据模型，桩实现）以 PR 形式合入主干，确保团队能在稳定的主干上并发开发。 +- 🤖 **AI-Native 与 人工问责 (AI with Accountability)** + - 倡导 Build/Think/Code With AI，让 AI 成为强大伙伴。但坚守红线：**AI 不替代工程流程，最终交付责任在人**。合入主干的 AI 代码必须经得起拷问，核心逻辑必须有人能完全理解并讲清。 +- 🔄 **Milestone 敏捷迭代** + - 每个 Milestone 都是一轮完整的「产品 → 架构 → 开发」闭环。从 MS1 的战略决策与主干串联，到 MS3 的功能闭合，再到 MS4 的打磨发布，步步为营。 +- 🤝 **透明且严谨的 GitHub 协作** + - 全员采用 `Fork + PR` 模式，Issue 承载工程文档与任务拆解，PR 承载代码与 Review。不额外造轮子，用 GitHub 原生能力实现全流程可追溯。 -### 🆕 2025 年技术分享系列 +### 📋 实训营工程规范体系（Guidelines and Standards） -| 序号 | 主题 | 链接 | -| ---- | -------------------------------------------- | ------------------------------------------------------------------------------------------- | -| 01 | 工程实践分享 \| 把小事做好 | [📖 阅读](2025/01.%20工程实践分享%20%7C%20把小事做好/202504-builder-articles.md) | -| 02 | 工程实践分享 \| "写代码"不是第一步！ | [📖 阅读](2025/02.%20工程实践分享%EF%BD%9C"写代码"不是第一步！/llkgstore-summary.md) | -| 03 | 同学，为什么我建议你关注 1024 实训营？ | [📖 阅读](2025/03.%20同学，为什么我建议你关注%201024%20实训营？/whycamp.md) | -| 04 | 当 AI 能写代码，工程师的核心竞争力是什么？ | [📖 阅读](2025/04.%20当%20AI%20能写代码，工程师的核心竞争力是什么？/ai-related-engineer.md) | -| 05 | 我眼中的优秀工程师特质 | [📖 阅读](2025/05.%20我眼中的优秀工程师特质/to-be-better-engineer.md) | -| 06 | 一行之差：为什么你的文件末尾应该留一个空行？ | [📖 阅读](2025/06.%20一行之差：为什么你的文件末尾应该留一个空行？/newline-at-eof.md) | -| 07 | 从类型系统看 XGo 编译器的实现 | [📖 阅读](2025/07.从类型系统看XGo编译器的实现/typesystem_xgo.md) | -| 08 | AI 辅助开发新范式：1024 实训营带你探索未来 | [📖 阅读](2025/08.%20AI辅助开发新范式：1024实训营带你探索未来/AI-assisted-dev.md) | -| 09 | 许式伟聊 AI 时代下的工程师发展观 | [📖 阅读](2025/09.%20许式伟聊AI时代下的工程师发展观/content.md) | -| 10 | 许式伟发布 XGo 全景图：AI 时代的全民编程语言 | [📖 阅读](2025/10.%20xgo发布/content.md) | -| 11 | GitHub PR 合并三选一：主分支该怎么选？ | [📖 阅读](2025/11.%20GitHub%20PR%20合并三选一：主分支该怎么选？/github-pr-merge.md) | -| 12 | 如何才算"完成"一个AI应用? | [📖 阅读](2025/12.%20如何才算"完成"一个AI应用/content.md) | -| 13 | 从类型系统理解 LLGo 编译器的实现 | [📖 阅读](2025/13.从类型系统理解%20LLGo%20编译器的实现/typesystem_llgo.md) | -| 14 | Code Review 不是什么——盘点5个常见误区 | [📖 阅读](2025/14.%20Code%20Review%20不是什么/what-code-review-is-not.md) | -| 15 | 架构设计从何入手？ | [📖 阅读](2025/15.%20架构设计从何入手/content.md) | -| 16 | 关于架构设计的几点认知体会 | [📖 阅读](2025/16.%20关于架构设计的几点认知体会/content.md) | -| 17 | SPX-Algorithm：构建多模态搜索服务的一些心得 | [📖 阅读](2025/17.%20SPX-Algorithm：构建多模态搜索服务的一些心得/share.md) | -| 18 | 代码不是核心：从 XLink 项目看产品开发的决策层次 | [📖 阅读](2025/18.%20代码不是核心：从%20XLink%20项目看产品开发的决策层次/content.md) | -| 19 | llpyg: LLGo 快速集成 Python 生态的桥梁 | [📖 阅读](2025/19.%20llpyg:%20LLGo%20快速集成%20Python%20生态的桥梁/content.md) | -| 20 | X绘图：我们如何让 AI 更好地融入产品 | [📖 阅读](2025/20.%20X绘图-我们是如何让AI更好的融入我们的产品的/实训感悟.md) | -| 21 | LLGo 中 Python 编译与运行时集成：从依赖识别到一键交付 | [📖 阅读](2025/21.%20LLGo%20中%20Python%20编译与运行时集成/content.md) | +为了保证高质量的工程产出，XEngineer 制定了完善的规范矩阵。所有参训学员与开源贡献者均建议阅读： -### 🎓 第 4 期训练营 +| 规范领域 | 核心关注点 | 链接 | +| --- | --- | --- | +| **00 软件工程规范** | 总纲：Milestone 交付标准、协作强制规则、会议与汇报、AI 使用红线 | [Wiki](https://github.com/1024XEngineer/XEngineer/wiki/00-XEngineer-%E8%90%A5%E8%BD%AF%E4%BB%B6%E5%B7%A5%E7%A8%8B%E8%A7%84%E8%8C%83) | +| **01 产品设计规范** | 提案(Proposal)驱动、做减法、边界清晰、以例子定义行为 | [Wiki](https://github.com/1024XEngineer/XEngineer/wiki/01-%E4%BA%A7%E5%93%81%E8%AE%BE%E8%AE%A1%E8%A7%84%E8%8C%83) | +| **02 架构设计规范** | 总架构先行、空骨架代码、模块拆分、架构演进跟踪 | [Wiki](https://github.com/1024XEngineer/XEngineer/wiki/02-%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1%E8%A7%84%E8%8C%83) | +| **03 GitHub 过程管理** | Milestone/Issue/PR/Release 规范、标签体系、草案评审机制 | [Wiki](https://github.com/1024XEngineer/XEngineer/wiki/03-GitHub-%E8%BF%87%E7%A8%8B%E7%AE%A1%E7%90%86%E8%A7%84%E8%8C%83) | -#### 实训课题 -| 模块 | 主题 | 内容 | -| ------- | --------------------------------------- | --------------------------------------------- | -| 第 1 组 | XBuilder 项目分享与传播 | [📖 阅读](4th/1st_xbuilder_share/topic.md) | -| 第 2 组 | XBuilder 基于大模型的代码生成与素材生成 | [📖 阅读](4th/2nd_copilot_classfile/topic.md) | -| 第 3 组 | LLGo 对 Python 库开箱即用 | [📖 阅读](4th/3rd_llgo_python/topic.md) | -| 第 4 组 | AI Powered Ops | [📖 阅读](4th/4th_ai_powered_ops/topic.md) | +--- +## 🤝 协作与贡献指南 (Contributing) -#### 实训公开课 -| 期数 | 主题 | 内容 | -| ------- | --------------------------------------- | ---------------------------------- | -| 第 1 期 | 《人人都是产品经理》作者苏杰：AI 教我的产品哲学 | [📖 观看](https://mp.weixin.qq.com/s/qGQBKs3bjDZzk-SKdNumBw) | -| 第 2 期 | 汪源 × 许式伟：AI时代如何打造真正解决用户痛点的产品？ | [📖 观看](https://mp.weixin.qq.com/s/eppy6z7XNN-mVZIjk44yvg) | -| 第 3 期 | 《构建之法》作者邹欣：实战中的软件工程——从微软到 AI 时代的构建之道 | [📖 观看](https://mp.weixin.qq.com/s/CkKXGLzycyE7inMFp6jKlw) | -| 第 4 期 | 毕玄 x 许式伟：AI时代架构演进的底层逻辑与未来挑战 | [📖 观看](https://mp.weixin.qq.com/s/ON0dmxCtD0CjBo6ZEewK4Q) | +我们严格遵循 **Fork + PR** 的原生 GitHub 协作流，拒绝「黑盒式」提交： +1. **Issue 先行** — 所有功能与 Bug 必须先建立 Issue。较大需求需在 Issue 中完成 **Proposal（产品提案）** 的评审。 +2. **Fork 开发** — Fork 仓库到个人名下，在个人分支进行开发。 +3. **PR 门禁** — 提交 Pull Request 必须关联对应 Issue，通过测试，可 Review。 +4. **强制 Review** — 代码必须经过 AI 质量检查与导师 / 助教的人工 Review，确保无方向性偏差且逻辑清晰后方可 Merge。 -### 📋 实训营规范 +🏷️ **标签追踪体系**：我们使用 `proposal` → `Proposal-Accepted` → `FullSpec` / `MiniSpec` → `Documented` 等原生 Label 追踪每一个想法从提出到落地的全生命周期。 -- **任务发布规范**: [如何发布任务](communitee/01.how-to-release-tasks.md) -- **产品方向指导**: [定产品方向指导规范](communitee/02.product-direction-template.md) -- **日报写作规范**: [如何写高质量日报](communitee/03.how-to-write-quality-daily-report.md) -- **运营管理实践**: [1024 实训营运营管理实践](communitee/04.techcamp-operational-practice.md) +> ⚠️ **AI 使用红线**：AI 生成的代码，作者必须能完整讲清逻辑。核心架构必须由人设计。每一个 AI 重度参与的 PR 必须附上 Prompt 与人工审查笔记。 -### 💡 提案与建议 +--- -- **课程指导**: [定方向](proposal/课程指导-定方向.md) +## 👁️ 关注我们 (Follow Us) -### 📖 学习资料 +> *"不要去盲目追逐变化，相反，要找到不变的东西。你有信心创造出一个 10 年后还不会过时的产品吗？"* +> — 许式伟 -#### Git +**XEngineer 新工科计划常年火热招生中。** -- 可视化学习 Git Branch/Commit: https://learngitbranching.js.org/?locale=zh_CN +如果你想持续了解： +- AI 时代工程师的角色将走向何方？ +- 什么才是穿越周期的好产品？ +- 如何用架构思维做乘法而非加法？ -## 🤝 参与贡献 +欢迎关注我们的微信公众号【XEngineer新工科计划】，获取最新的项目动态、工程方法论与开源社区资讯。我们在寻找下一批愿意一起回答这些问题的人。 -我们欢迎所有形式的贡献！无论是： -- 📝 内容贡献：分享技术文章、实践经验 -- 🐛 问题反馈：报告错误或提出改进建议 -- 💡 功能建议：提出新功能或改进想法 -- 🌟 社区建设：参与讨论、回答问题 +--- -## 📄 许可证 +## 📜 许可证 (License) -本项目采用 Apache-2.0 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 +本组织下的开源项目默认采用 [Apache-2.0](https://opensource.org/licenses/Apache-2.0) 或 [MIT](https://opensource.org/licenses/MIT) 开源许可证，具体请参阅各仓库的 `LICENSE` 文件。 --- +

+ Initiated by 许式伟 · Powered by Qiniu Cloud ☁️
+ Rooted in open source, driven by real-world projects, guided by architectural thinking. +

+
**让技术成长，从这里开始** ✨ -_如果这个项目对你有帮助，请给我们一个 ⭐️_ +*如果这个项目对你有帮助，请给我们一个 ⭐️*