作品集
GitHub 上有 40 個儲存庫,25 個已複製到 ~/code 下,加上未進行版本控制的作品。Samuel 獨自在非常不同的領域工作,因此兩個失敗模式是重複(建置作品集其他地方已存在的東西)和分歧(同類產品使用新框架)。在執行前請先閱讀此文件。
⚠️ 開放性問題 — 展示方式尚未定義
Samuel 尚未決定專案在 samuelaure-web 的作品集區塊中如何呈現,也不確定它們應如何出現在 nau-web 上,更不確定代理商是否需要自己的變體。
在決定之前,此技能可以強制執行品質部分(儲存庫標準、文件),但不能強制執行發佈部分。如果工作涉及 samuelaure-web 的作品集區塊,或專案達到值得展示的狀態,屆時再提出這個問題——那才是設計它的時機,並且應該一次性設計並一致應用,而不是為每個專案臨場發揮。
活躍中(最近 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 | 個人網站 — 託管作品集區塊 |
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 似乎是資料庫備份,卻沒有自己的備份。已核准進行包含每個目錄建議的審計,但目前尚未執行。
技術棧一致性
作品集已經收斂為: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/已全域加入.gitignore,並在engineering_protocols/projects/<repo>/中進行版本控制。一個宣傳其 AI 工具的儲存庫,對任何評估它的人來說,讀起來就像 AI 創作的。省略這些工具可以保持這個問題的開放性,而誠實的回答 — 是的,背後有工程協定 — 由 Samuel 親自說明,比從檔案中讀到更有說服力。 - 誠實的狀態。 一個聲稱處於生產狀態但實際上已損壞的 README,比一個未完成的專案更損害可信度。
nau-mobile花了數月時間宣告自己已棄用,同時卻是活躍的儲存庫;這就是要避免的失敗模式。 - 文件既不能太簡略也不能太冗長。 描述程式碼已經說明的文件是維護上的負債;記錄非顯而易見的決策、約束或陷阱的文件則能自我回本。當文件與程式碼不一致時,文件就是 bug。
保持此文件更新
當新增、刪除、重新命名儲存庫,或技術棧變更,或在活躍與休眠之間移動時,請更新此文件以及 global/CLAUDE.md 中的表格,作為該工作的一部分。然後同步到 ~/.claude/。一個偏離事實的註冊表比沒有註冊表更糟,因為它會被信任。