无尘阁日记

无尘阁日记

WorkBuddy技能评测 #247 | 架构设计与工程规范:一个中国 CI 项目的 40 篇内部手册被公开了
silcano

基本信息

  • 组内条数:45 条,热度 2,450 – 2,495
  • 主体来源:腾讯蓝盾(BK-CI)的模块架构指南,40 条共享热度 2,495,全部是中文
  • 代表技能:00-bkci-global-architecture、dispatch-module-architecture(构建调度)、agent-module-architecture(构建机 Agent)、artifactory-module-architecture(制品库)、pipeline-plugin-development(流水线插件开发)、project-module-architecture、design-patterns、microservice-infrastructure、unit-testing、api-interface-design
  • 另一部分:一套英文 TypeScript 工程规范(TypeScript Conventions、Backend Architecture、Backend Testing 等,热度 2,450)

它解决了什么痛点

这是整个系列里最特殊的一组:它是一份真实大型项目的内部文档,被做成了技能。一个 CI 系统有流水线、调度、构建机、制品库、代码库、权限、存储七八个子系统,每个子系统都有自己的领域模型和约束。新人进项目要花几个月才能搞清楚「改这里会影响哪里」。

把它做成 40 个技能,等于给 AI 装了一份「项目地图」:你说「我要加一种新的构建机调度策略」,它会先读 dispatch-module-architecture,知道资源分配、队列管理、Docker/K8s 调度这些约束,再动手。这套做法的可复制性很强 —— 任何有内部文档的团队都能照抄这个结构。

对我有没有用(技术 / 自媒体 / AI / 读书)

技术:参考价值大于实用价值。你不做 CI 系统,这 40 条的具体内容用不上;但它示范了一件事 —— 怎么把一个复杂系统的知识切成 40 个能用的单元。这对你自己项目写文档是直接可借的模板。自媒体:有一个好选题,中文技术号里「大型项目内部文档长什么样」是稀缺内容,这 40 条的命名和分层本身就能写成一篇。AI:中等,属于上下文工程里「给 AI 项目地图」的实践。读书:无。

典型场景

你有一个自己维护了两年、已经记不清细节的项目。做法:照这 40 条的结构,把自己的项目也切成「全局架构 + 各模块 + 横切关注点(测试/规范/接口设计)」三层,每个模块写 200 字。成果:不是让 AI 更懂你的项目,而是你自己重新理清了一次。这套结构最值钱的地方是它强迫你回答「这个模块的边界在哪」。

一句话结论

内容属于蓝盾,结构属于所有人。把它当「怎么写项目文档」的范本读,比当技能装有用得多。

📊 完整对比数据见在线总表:WorkBuddy 技能市场全量调研总表(腾讯文档)