Communitygithub.com

samuelaure/engineering-protocols

完整的儲存庫註冊表、技術棧一致性、讓專案值得放入作品集的品質標準,以及將專案發佈到個人網站。在開始新專案、選擇技術棧、判斷某個東西是否已存在,或公開展示作品前,請先載入此技能。

engineering-protocols 是什麼?

這個技能(engineering-protocols)是 Samuel Laure 個人作品集的規範與治理層。它管理約 40 個 GitHub 儲存庫(其中 25 個已複製到 ~/code)、它們的技術棧一致性、品質標準,以及最終將專案發佈到 samuelaure-web 個人網站的方式。對於在 TypeScript、React、Vite、Next、NestJS、Postgres、Docker 和 Remotion 等不同領域獨自工作的開發者來說,此技能能預防兩個關鍵的失敗模式:重複建置(建置已存在的東西)和技術分歧(對同類產品使用新框架)。它強制要求 README 必須讓人無需詢問作者就能理解並執行專案、強制實施 CI、禁止提交任何形式的機密資訊,並且明確禁止將 Claude 的專案設定檔(如 CLAUDE.md)提交到專案本身的版本控制中——這些檔案應僅存在於 engineering_protocols 儲存庫中,以保持作品集的專業性。該技能也明確指出作品集的「展示/發佈」部分尚未定案,是一項待解決的開放性議題。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

作品集

GitHub 上有 40 個儲存庫,25 個已複製到 ~/code 下,加上未進行版本控制的作品。Samuel 獨自在非常不同的領域工作,因此兩個失敗模式是重複(建置作品集其他地方已存在的東西)和分歧(同類產品使用新框架)。在執行前請先閱讀此文件。

⚠️ 開放性問題 — 展示方式尚未定義

Samuel 尚未決定專案在 samuelaure-web 的作品集區塊中如何呈現,也不確定它們應如何出現在 nau-web 上,更不確定代理商是否需要自己的變體。

在決定之前,此技能可以強制執行品質部分(儲存庫標準、文件),但不能強制執行發佈部分。如果工作涉及 samuelaure-web 的作品集區塊,或專案達到值得展示的狀態,屆時再提出這個問題——那才是設計它的時機,並且應該一次性設計並一致應用,而不是為每個專案臨場發揮。

活躍中(最近 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個人網站 — 託管作品集區塊
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 似乎是資料庫備份,卻沒有自己的備份。已核准進行包含每個目錄建議的審計,但目前尚未執行。

技術棧一致性

作品集已經收斂為: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/。一個偏離事實的註冊表比沒有註冊表更糟,因為它會被信任。

相關技能