Portfolio
GitHub 上有 40 个仓库,~/code 下克隆了 25 个,外加未版本控制的工作。Samuel 独自在截然不同的领域工作,因此两种失败模式是重复(构建 portfolio 中其他地方已有的东西)和分歧(为同一类产品使用新框架)。在此之前请阅读本文。
⚠️ 未决问题——展示方式尚未定义
Samuel 尚未决定项目如何展示在 samuelaure-web 的 portfolio 部分,也未决定它们应如何出现在 nau-web 上,也不确定代理商是否需要自己的变体。
在决定之前,该技能可以强制质量部分(仓库标准、文档),但不能强制发布部分。如果工作触及 samuelaure-web 的 portfolio 部分,或者项目达到值得展示的状态,请在那时提出这个问题——这才是设计它的时刻,并且应该一次性设计并一致应用,而不是针对每个项目临时拼凑。
活跃(最近 90 天)
| 仓库 | 技术栈 | 说明 |
|---|---|---|
nau | pnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · Remotion | naŭ 平台。2055 次提交。主系统 |
nau-mobile | Expo SDK 50 · React Native · SQLite | Instagram 采集应用。独立仓库,本地优先 |
groovy | Grails → NestJS · Docker | API 迁移实验室——对旧版 Grails API 的绞杀者模式 |
websites/nau-web | Astro · Express | naŭ 营销网站 |
websites/karenexplora-web | Vite · Express | 客户网站 |
websites/violetacuesta-web | Vite · TS · Docker | 客户网站,部署在 VPS 上 |
websites/samuelaure-web | Vite · TS | 个人网站——托管 portfolio 部分 |
websites/andiuniverso-web | Vite · TS | 客户网站 |
karenexplora-freescout | Docker | 自托管帮助台部署 |
countdown-video | React · Remotion | 程序化视频生成 |
nispiras | Kotlin · Android 原生 | 呼吸覆盖应用。自带密钥库——请勿重新生成 |
engineering_protocols | Markdown | 这些协议。~/.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/。一个偏离实际的注册表比没有注册表更糟,因为它会被信任。