Communitygithub.com

samuelaure/engineering-protocols

完整的仓库注册表、技术栈一致性、使项目达到作品集水准的质量标准,以及将项目发布到个人站点。在启动新项目、选择技术栈、判断某事物是否已存在或公开呈现作品前,请先加载此技能。

engineering-protocols 是什么?

该技能为独立开发者Samuel Aure提供了一套统一的工程协议,旨在解决其跨领域工作时遇到的代码重复和技术栈不一致问题。它维护了一个包含活跃、休眠、弃用及未版本控制项目的完整仓库清单,并强制要求技术栈向TypeScript、React、Vite、Next、NestJS等核心工具集收敛,避免新框架导致的维护成本膨胀。技能还定义了作品集质量门槛:每个仓库必须拥有有效README、工作CI、无秘密痕迹、无AI代理残留文件,且文档与代码状态诚实匹配。此协议对Claude Code等AI开发工具尤其有用,能在开始新项目、选择技术栈或评估现有资产时自动触发,帮助开发者避免重复开发和维护混乱,确保输出达到可公开展示的工程质量。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samuelaure/engineering-protocols/tree/HEAD/skills/portfolio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Portfolio

GitHub 上有 40 个仓库,~/code 下克隆了 25 个,外加未版本控制的工作。Samuel 独自在截然不同的领域工作,因此两种失败模式是重复(构建 portfolio 中其他地方已有的东西)和分歧(为同一类产品使用新框架)。在此之前请阅读本文。

⚠️ 未决问题——展示方式尚未定义

Samuel 尚未决定项目如何展示在 samuelaure-web 的 portfolio 部分,也未决定它们应如何出现在 nau-web 上,也不确定代理商是否需要自己的变体。

在决定之前,该技能可以强制质量部分(仓库标准、文档),但不能强制发布部分。如果工作触及 samuelaure-web 的 portfolio 部分,或者项目达到值得展示的状态,请在那时提出这个问题——这才是设计它的时刻,并且应该一次性设计并一致应用,而不是针对每个项目临时拼凑。

活跃(最近 90 天)

仓库技术栈说明
naupnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · Remotionnaŭ 平台。2055 次提交。主系统
nau-mobileExpo SDK 50 · React Native · SQLiteInstagram 采集应用。独立仓库,本地优先
groovyGrails → NestJS · DockerAPI 迁移实验室——对旧版 Grails API 的绞杀者模式
websites/nau-webAstro · Expressnaŭ 营销网站
websites/karenexplora-webVite · Express客户网站
websites/violetacuesta-webVite · TS · Docker客户网站,部署在 VPS 上
websites/samuelaure-webVite · TS个人网站——托管 portfolio 部分
websites/andiuniverso-webVite · TS客户网站
karenexplora-freescoutDocker自托管帮助台部署
countdown-videoReact · Remotion程序化视频生成
nispirasKotlin · Android 原生呼吸覆盖应用。自带密钥库——请勿重新生成
engineering_protocolsMarkdown这些协议。~/.claude/ 的权威来源

休眠

advent-of-code (TS) · obsidian · carrousel-automation (React/Remotion/Tailwind) · apify-actors (TS) · web-chatbot-widget (TS, Docker) · math-app (Vite) · topic-roulette (Next 16, Tailwind — 无远程) · video-generator (NestJS) · whatsapp-number-checker (Express) · youtube-downloader (TS — 无远程) · websites/polar-web (最后修改于 2025-12)

已弃用

在 ~/code/deprecated/ 中:echonau, komunikadoj, nau-ig, r2-asset-manager。

nau-ig 是 nau-mobile 的前身——该应用被提取、吸收到 monorepo 中,然后又拉了出来。请勿混淆三者。

在 GitHub 上,未克隆

合并前的服务仓库,现在位于 nau monorepo 内部:9nau, flownau, nauthenticity, whatsnau, zazu。请勿克隆这些仓库来处理这些服务——它们位于 nau/apps/ 中。 (其中两个也作为嵌套 git 仓库留在 nau/tmp/ 中,这是垃圾。)

其他未克隆的:ai-mentor, astromatic, ecom, exercism, kinder-heldin, ludi9, project_1, samuel-aure, adventofcodeOLD, nau-storage。

未版本控制——有风险

~/code/no-git/ 中包含九个不在 git 中的目录:build-mobile, chrome-extensions, flownau, gmb, kkj_db_backups, omniroute, repurpose, scripts, video-bank-script。

一次磁盘故障就会丢失,而 kkj_db_backups 似乎是没有任何自身备份的数据库备份。已批准并正在等待按目录提出建议的审计。

技术栈一致性

Portfolio 已收敛为:TypeScript · React · Vite(用于网站) · Next(用于应用) · NestJS(用于 服务) · Postgres + Prisma · Docker · Remotion(用于视频) · Tailwind。

当项目没有特定技术要求时,请从该集合中选择。一致性可累积为精通,并使每个项目的维护成本更低;而每个项目使用新框架则会累积成无人有时间处理的维护负担。

已知待解决的分歧: 六个网站,四种方法——karenexplora-web、 samuelaure-web、violetacuesta-web 和 andiuniverso-web 使用 Vite,nau-web 使用 Astro, polar-web 未知。这些是同一类产品。在构建第七个之前,请选择一个并说明原因;将现有的六个合并是值得安排的。

质量门槛

一个仓库达到作品集水准的条件是:有人能在不询问 Samuel 的情况下找到它、理解它并运行它。

  • 值得其篇幅的 README。 它是什么、为什么存在、如何运行,以及那一两个真正有趣的决策。不是教程,不是空壳。如果读者仅凭 README 无法让它运行起来,那它就没有完成。
  • 在合理的地方有可工作的 CI。 绿色徽章是证据;损坏的徽章比没有更糟。
  • 永远没有秘密——历史上也没有。
  • 没有代理制品。 CLAUDE.md、.claude/、.agent/ 已在全局 gitignored,并在 engineering_protocols/projects/<repo>/ 中进行版本管理。一个宣传其 AI 工具的仓库在任何人评估时读起来都像是 AI 编写的。省略它可以让这个问题保持开放,而诚实的答案——是的,背后有工程协议——由 Samuel 直接说出,比由文件说出更好。
  • 诚实的状态。 一个 README 声称生产状态但实际已损坏的项目,比未完成的项目损失更多信誉。nau-mobile 花了数月时间宣称自己已弃用,同时却是活跃仓库;这就是需要避免的失败模式。
  • 文档既不要稀疏也不要过度。 描述代码已表明内容的文档是维护债务;而捕捉非显而易见决策、约束条件或陷阱的文档则物有所值。当文档和代码不一致时,文档就是 bug。

保持最新

当添加、删除、重命名仓库,更改技术栈,或在活跃与休眠之间移动时,请同时更新此文件和 global/CLAUDE.md 中的表格,作为该工作的一部分。然后同步到 ~/.claude/。一个偏离实际的注册表比没有注册表更糟,因为它会被信任。

相关技能