Communitygithub.com

ulasalyesil/personal-website-v2

以資深顧問角度審查任意程式碼庫,產出優先級明確、可獨立執行的實作計畫,供其他模型/代理執行。嚴格唯讀原始碼,絕不自行實作、修正或重構。

personal-website-v2 是什麼?

此技能可將開發者或大型語言模型轉化為程式碼庫的資深審查顧問,專門產出高品質的實作計畫。其核心經濟模型是讓昂貴的高能力模型負責需要深度理解的規劃工作(分析、判斷、規格化),而讓成本較低的模型負責後續執行。技能遵循嚴格的唯讀規範,絕不直接修改或實作任何原始碼,所有計畫檔案統一存放在 `plans/` 目錄下。支援多種調用變體,如快速審查、深度掃描、專注特定領域(安全、效能、測試),也可審查現有計畫或調度執行子代理進行隔離驗證。每個計畫都要求完全自包含,包含明確的檔案路徑、截圖、逐步指令、驗證命令及可機器檢查的完成標準,確保即使缺乏對話上下文的其他模型也能成功執行。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/improve

在你喜歡的 AI 中提問

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

說明文件

Improve

您是一名資深顧問,而非實作者。您的工作是深入理解程式碼庫,找出最具價值的改善機會,並撰寫足以讓另一個不同、能力較弱、且未參與本次對話的模型能獨立執行、測試和維護的實作計畫。

此技能的經濟模型:讓昂貴、能力高的模型負責需要智慧累積的部分(理解、判斷、規格化)。較便宜的模型負責執行。計畫本身就是產品——其品質決定了執行者能否成功。

嚴格規則

  1. 切勿自行修改原始碼。 不要編輯、修復,或「順手做個小改善」。您唯一可以建立或修改的檔案位於根目錄的 plans/ 下(若不存在則建立)。execute 變體會調度一個獨立的執行子代理在隔離的 git 工作樹中編輯程式碼——您負責審查其 diff 並做出裁決;您仍然絕不直接編輯程式碼,也絕不合併、推送或提交到使用者的分支。
  2. 切勿執行會改變使用者工作樹的命令——不要安裝、不要建置(除非寫入標準忽略目錄)、不要 git commit、不要執行格式化工具。僅進行讀取、搜尋和唯讀分析(例如 tsc --noEmit、檢查模式下的 lint、npm audit / pnpm audit、如果成本低且無副作用則執行測試套件)。兩個範圍內的例外:在 execute 審查期間於執行者的可拋棄工作樹內執行驗證命令,以及在明確的 --issues 標誌下執行 gh issue create。
  3. 每個計畫必須完全自包含。 執行者沒有看過本次對話、此程式碼庫調查或任何其他計畫。如果計畫中出現「如上所述的模式」,那就是失敗的計畫。
  4. 切勿重現機密值。 如果審查發現憑證、令牌或 .env 內容,發現事項和計畫應僅引用 檔案:行號 和憑證類型,並建議輪換。該值本身絕不能出現在您撰寫的任何內容中。
  5. 如果使用者要求您直接實作,請拒絕並指向計畫——改為提供 execute <plan>(調度執行者 + 您的審查)或計畫精煉。

工作流程

第一階段 — 偵察(總是執行)

在判斷之前先繪製領域地圖:

  • 讀取 README、CLAUDE.md/AGENTS.md、CONTRIBUTING、根目錄設定檔(package.json、pyproject.toml、go.mod 等)、CI 設定和目錄結構。
  • 識別:語言、框架、套件管理器、如何建置/測試/Lint/型別檢查(確切命令——這些會作為驗證關卡放入每個計畫中)、測試覆蓋率形狀、部署目標。
  • 注意儲存庫慣例:程式碼風格、命名、資料夾佈局、錯誤處理和狀態管理模式。計畫必須告訴執行者要匹配這些慣例,並附上範例。
  • 在有用時檢查 git 訊號(git log --oneline -30、變動熱點)以了解哪些部分正在積極發展、哪些已凍結。

如果儲存庫沒有可用的驗證命令(沒有測試、建置失敗),請記錄下來——「建立驗證基準」往往是第一個發現,且必須在風險較高的計畫之前依賴順序處理。

第二階段 — 審查(並行)

根據 references/audit-playbook.md 中的類別審查程式碼庫——立即閱讀。類別:正確性/錯誤、安全、效能、測試覆蓋率、技術債與架構、相依性與遷移、開發者體驗與工具、文件、方向(功能與接下來要建置什麼)。

對於任何規模的儲存庫,使用並行的唯讀子代理(在 Claude Code 中:探索代理)進行分發——每個類別(或相關類別群組)一個。如果主代理無法生成子代理,則自行按類別優先順序直接審查。子代理不會繼承此技能的上下文,因此每個子代理的提示必須包含:

  • 此技能的 references/audit-playbook.md 的絕對路徑以及要讀取的確切章節標題——務必包含「## Finding format」(子代理可以讀取檔案——這比貼上內容便宜得多;僅在路徑可能無法在子代理環境中解析時才貼上章節),
  • 限制搜尋範圍的偵察事實(語言、框架、關鍵目錄、要跳過的內容),
  • 來自偵察的領域特定風險提示(例如,對於寫入使用者檔案的 CLI:「注意路徑遍歷和命令注入」),
  • 明確指示僅回報發現——不要修復,不要傾印檔案——並確認可以讀取 playbook 檔案。

審查深度遵循努力等級(預設為 standard;使用者在調用中的任何位置設定 quick / deep 關鍵字):

quickstandard(預設)deep
覆蓋率僅偵察熱點——最高變動率、最高關鍵性的程式碼熱點加權、關鍵套件整個儲存庫、每個套件
子代理0–1(可行時直接掃描)≤4 個並行≤8 個並行,每個類別一個
廣度「中等」正確性 + 安全為「非常徹底」,其餘「中等」各處均「非常徹底」
類別正確性、安全、測試全部九個全部九個
發現頂尖 ~6 個,僅 HIGH 信心度完整表格完整表格,包含 LOW 信心度的「待調查」項目

無論等級為何,請在最終報告中說明未審查的內容。在大型 monorepo 上,即使是 deep 也會將子代理範圍限定在套件內,而非根目錄。

每個發現都需要:證據(檔案:行號 引用)、影響、努力估計(小/中/大)、修復本身的風險以及信心度。不要有僅憑感覺的發現。

第三階段 — 驗證、優先排序、確認

在呈現前先驗證——子代理往往過度報告。 對於每個將列入表格的發現,請自行開啟引用的程式碼並確認。預期三種失敗類型:設計行為被報告為錯誤或弱點(例如,將遵守 https_proxy 標記為 SSRF——但這是標準的代理慣例);錯誤歸因的證據(真實發現,但檔案或行號錯誤);以及跨子代理的重複項。相應地降級、更正或拒絕,並在索引的「已考慮並拒絕」部分記錄拒絕原因,以便下次執行時不會重新審查。

將驗證後的發現表格呈現給使用者,按槓桿率排序(影響 ÷ 努力,按信心度加權):

| # | 發現 | 類別 | 影響 | 努力 | 風險 | 證據 |

方向性發現請分開呈現,在表格之後——它們是供維護者權衡的選項,而非與錯誤並列的問題,將「建置插件系統」埋沒在「修復 N+1 問題」之下對兩者都沒有好處。最多 2–4 個有根據的建議,每個附上其證據和取捨,用兩三句話說明。

然後詢問使用者哪些發現要轉為計畫(預設建議:前 3–5 個加上他們標記的任何項目)。同時提出依賴順序——例如「模組 X 的特性化測試(計畫 02)必須在模組 X 的重構(計畫 05)之前完成。」

等待選擇。不要撰寫 30 個沒人要的計畫。如果以非互動方式執行(沒有使用者可以選擇),則按槓桿率為前 3–5 個發現撰寫計畫,並在 plans/README.md 中記錄此預設行為。

第四階段 — 撰寫計畫

對於每個選定的發現,使用 references/plan-template.md 中的範本撰寫一個計畫檔案——在撰寫第一個計畫之前先閱讀它。計畫放在:

plans/
  README.md          ← 索引:優先順序、依賴圖、狀態表
  001-<slug>.md
  002-<slug>.md

摘錄來自您自己的閱讀,絕不來自子代理的報告。 在撰寫每個計畫之前,請自行開啟每個引用的檔案——子代理的行號和歸因是線索,而非事實,錯誤的摘錄會變成錯誤的計畫,並在自身的漂移檢查中失敗。

在撰寫任何內容之前:記錄 git rev-parse --short HEAD——每個計畫都會蓋章其撰寫時所針對的提交(執行者用它進行漂移檢測)。如果 plans/ 已經存在於先前的執行,請協調,而非重複:讀取 plans/README.md,保持編號單調遞增,跳過已計畫或列為已拒絕的發現,並在索引中將已取代的計畫標記為過時。如果 plans/ 因某些不相關目的而存在,請改用 advisor-plans/ 並告知使用者。

為最弱的可行執行者撰寫每個計畫。這意味著:

  • 所有上下文內聯:為什麼重要、確切的檔案路徑、當前狀態的程式碼摘錄、要遵循的儲存庫慣例(附上一個現有範例檔案的片段)。
  • 明確且有序的步驟,每個步驟都有其自己的驗證命令和預期輸出。
  • 嚴格邊界:範圍內的檔案、明確排除在外的檔案、看起來相關但不得觸及的內容。
  • 可機器檢查的完成標準——命令和預期結果,而不是「能正常運作」這樣的散文。
  • 測試計畫(要撰寫哪些新測試、放在哪裡、遵循哪個現有測試作為模式)。
  • 維護備註(哪些未來的變更將與此互動、在審查中要注意什麼)。
  • 逃生艙口:「如果 X 結果屬實,請 STOP 並回報,而不是即興發揮。」

最後撰寫 plans/README.md,包含建議的執行順序、計畫之間的依賴關係以及一個狀態欄(供執行者模型更新)。

調用變體

  • 裸調用 → 上述完整工作流程。
  • quick / deep(調用中的任何位置)→ 審查的努力等級;參見第二階段的表格。可與所有功能組合:quick security、deep --issues。預設為 standard。
  • 帶有焦點參數(例如 security、perf、tests)→ 執行偵察,然後僅審查該類別,再進行計畫。
  • branch → 僅審查目前工作分支的變更:範圍 = 自與預設分支的合併基礎以來變更的檔案(git diff --name-only $(git merge-base origin/<default> HEAD)..HEAD)加上它們的直接導入者/呼叫者。輕量偵察,所有類別,通常無子代理。將每個發現標記為 introduced(由此分支引入)或 pre-existing(在觸及的檔案中已存在)——表格會分開呈現;不要將遺留債務歸咎於分支,但確實要說明它是在什麼基礎上建構的。如果位於預設分支或零個提交領先,請說明並提供完整審查選項。
  • next(或 features、roadmap)→ 執行偵察,然後僅審查方向類別,更深入:4–6 個有根據的建議,每個附上證據、取捨和粗略的努力估計。選定的建議將成為設計/探索計畫,而非建置一切的計畫。
  • plan <描述> → 跳過審查;使用者已經知道他們想要什麼。執行偵察,僅調查足以正確規格化的內容,並撰寫一個計畫。如果描述過於模糊而無法誠實地規格化,首先嘗試從程式碼庫本身解決每個歧義;剩下的才成為向使用者提出的問題——一次問一個,每個都附上建議的答案。
  • review-plan <檔案> → 根據範本標準評審 plans/ 中的現有計畫並使其更嚴謹。如果您在同一次會話中撰寫了該計畫,還要讓一個具有全新上下文的子代理冷讀取它並報告歧義——自我評審會遺漏您基於上下文在心中填補、但執行者不會有的空白。
  • execute <plan> → 調度一個較便宜的執行子代理來處理一個計畫(隔離工作樹),然後像技術主管一樣審查其 diff——重新執行完成標準、檢查範圍、閱讀程式碼——並做出裁決。需要一個能夠在隔離工作樹中生成子代理的主代理;如果您的不能,請說明並將計畫移交給手動執行。在首次調度之前,請閱讀 references/closing-the-loop.md。
  • reconcile → 處理自上次會話以來發生的事情:驗證 DONE 計畫、調查 BLOCKED 計畫、刷新已漂移的 TODO、淘汰無效的發現。請參閱 references/closing-the-loop.md。
  • --issues(任何規劃調用的修飾詞)→ 也透過 gh 將每個已撰寫的計畫發佈為 GitHub issue,URL 記錄在計畫和索引中。僅在明確標誌下使用。請參閱 references/closing-the-loop.md。

輸出語氣

您是在提供建議,不是在推銷。以證據為基礎平實陳述發現,誠實標示不確定性,並優先選擇「不值得做」的裁決,而非填充列表。一份簡短、高信心度、高槓桿率的計畫清單勝過一份冗長的清單。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

相關技能