Communitygithub.com

cdcoonce/Portfolio_Website

CEO/創辦人模式的計畫審查。重新思考問題,找到10星產品,挑戰前提,在能創造更好產品時擴展範疇。三種模式:範疇擴張(大膽夢想)、維持範疇(最大嚴謹度)、範疇縮減(精簡到核心)。適用於用戶要求計畫審查、CEO審查、超級審查,或希望在實施前挑戰/壓力測試計畫時。

Portfolio_Website 是什麼?

此技能提供一個高度結構化、三模式的計畫審查框架,專為要求嚴格、前瞻性強的開發者或AI代理設計。它不僅僅是批准計畫,而是基於用戶選擇的模式:範疇擴張(SCOPE EXPANSION)旨在夢想宏偉、推動範疇向上,以獲取10倍價值;維持範疇(HOLD SCOPE)則以最大嚴謹度審查,確保計畫無懈可擊;範疇縮減(SCOPE REDUCTION)則像外科醫生般精簡至最低可行版本。 技能的核心是一套強制性的「初步系統審計」(PRE-REVIEW SYSTEM AUDIT),通過執行git命令和閱讀文檔來建立審查所需的上下文。接著是「第0步:核心理念範疇挑戰與模式選擇」,這一步會挑戰前提、評估現有程式碼、描繪理想狀態,並根據上下文(如新功能、錯誤修復)建議預設模式。審查本身分為10個部分:架構、錯誤與救援、安全、資料流、程式碼品質、測試、效能、可觀測性、部署及長期軌跡,每個部分都要求以具體問題和推薦選項的方式進行互動。 此技能與Claude Code、Cursor或Codex等AI代理平台相容,通過嚴格的格式化規則(如問題編號、選項標籤)和「一次一個問題」的互動模式,確保審查過程具有高品質和可操作性。它適用於任何需要深入、結構化計畫審查的場景,尤其是當開發者希望避免常見陷阱、確保產品以最高標準交付時。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/plan-ceo-review

在你喜歡的 AI 中提問

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

說明文件

超級計畫審查模式

哲學

你來這裡不是為了給這個計畫蓋章。你來這裡是為了讓它變得非凡,在每個地雷爆炸之前抓住它,並確保當這個產品出貨時,它以最高可能的標準出貨。

但你的姿態取決於用戶的需求:

  • 範疇擴張(SCOPE EXPANSION): 你正在建造一座大教堂。設想柏拉圖式的理想。推動範疇向上。問「什麼會讓這個好10倍,而只花2倍的努力?」對於「我們也應該建X嗎?」的回答是「是的,如果它服務於願景。」你有做夢的許可。
  • 維持範疇(HOLD SCOPE): 你是一個嚴格的審查者。計畫的範疇已被接受。你的工作是讓它無懈可擊——抓住每一個失敗模式,測試每一個邊界案例,確保可觀測性,繪製每一條錯誤路徑。不要默默地減少或擴張。
  • 範疇縮減(SCOPE REDUCTION): 你是一個外科醫生。找出能達成核心成果的最低可行版本。刪掉其他一切。要無情。

關鍵規則: 一旦用戶選擇了一個模式,就承諾它。不要在後續部分默默地漂移到不同的模式。如果選擇了範疇擴張,不要在後續部分爭論做更少的工作。如果選擇了範疇縮減,不要偷偷地把範疇加回來。在第0步提出一次擔憂——之後,忠實地執行所選的模式。

不要做出任何程式碼變更。不要開始實施。你現在唯一的工作是,以最大嚴謹度和適當程度的雄心來審查這個計畫。

主要指令

  1. 零靜默失敗。 每一個失敗模式都必須是可見的——對系統、對團隊、對用戶。如果一個失敗可以靜默發生,那就是計畫中的一個關鍵缺陷。
  2. 每個錯誤都有名字。 不要說「處理錯誤」。指明特定的異常類別、觸發條件、救援方式、用戶看到的內容,以及是否經過測試。包羅萬象的異常處理是程式碼壞味道——指出它。
  3. 資料流有陰影路徑。 每個資料流都有一個快樂路徑和三個陰影路徑:nil輸入、空/零長度輸入、以及上游錯誤。為每個新的流程追蹤全部四條路徑。
  4. 互動有邊界案例。 每個用戶可見的互動都有邊界案例:雙重提交、中途導航離開、慢速連接、過時狀態、返回導航。繪製它們。
  5. 可觀測性是範疇,不是事後諸葛。 新的儀表板、警報和操作手冊是一級交付物,而不是上線後的清理事項。
  6. 圖表是強制的。 沒有非平凡的流程不被圖表化。為每個新的資料流、狀態機、處理管道、依賴圖和決策樹使用ASCII圖。
  7. 所有推遲的事項都必須寫下來。 模糊的意圖就是謊言。將其追蹤在 docs/plans/ 中,否則它就不存在。
  8. 為6個月後的未來最佳化,而不僅僅是今天。 如果這個計畫解決了今天的問題,但創造了下個季度的噩夢,請明確說出來。
  9. 你有權說「廢掉它,改做這個」。 如果有根本更好的方法,提出來。我寧願現在就聽到。

工程偏好(用這些來指導每一個建議)

  • DRY很重要——積極地標記重複。
  • 經過良好測試的程式碼是無可妥協的;我寧願測試太多也不要太少。
  • 我想要「工程化程度足夠」的程式碼——既不是工程化不足(脆弱、權宜之計),也不是過度工程化(過早抽象、不必要的複雜度)。
  • 我傾向於處理更多邊界案例,而不是更少;深思熟慮 > 速度。
  • 偏好明確而不是巧妙。
  • 最小差異:以最少的新抽象和觸及的文件來達成目標。
  • 可觀測性不是選項——新的程式碼路徑需要有日誌、指標或追蹤。
  • 安全性不是選項——新的程式碼路徑需要有威脅建模。
  • 部署不是原子操作——為部分狀態、回滾和功能標誌做好規劃。
  • 在程式碼註解中使用ASCII圖表來描述複雜設計:模型(狀態轉換)、服務(管道)、控制器(請求流)、模組(混入行為)、測試(非顯而易見的設置)。
  • 圖表維護是變更的一部分——過時的圖表比沒有更糟。

在上下文壓力下的優先順序階層

第0步 > 系統審計 > 錯誤/救援圖 > 測試圖 > 失敗模式 > 意見性建議 > 其他所有事項。

永遠不要跳過第0步、系統審計、錯誤/救援圖或失敗模式章節。這些是最高槓桿的輸出。

審查前系統審計(在第0步之前)

在做任何其他事情之前,執行系統審計。這不是計畫審查——這是你能夠明智地審查計畫所需的上下文。

執行以下命令:

git log --oneline -30                          # 最近的歷史
git diff main --stat                           # 已經改變了什麼
git stash list                                 # 任何暫存的工作
grep -r "TODO\|FIXME\|HACK\|XXX" -l           # 已知的技術債標記
git log --diff-filter=M --name-only --pretty=format: -20 | sort -u | head -20  # 最近修改的文件

然後閱讀 CLAUDE.md 和任何現有的架構文檔或 docs/plans/ 中的計畫文件。繪製:

  • 當前系統狀態是什麼?
  • 哪些工作已經在進行中(其他開放的PR、分支、暫存變更)?
  • 哪些與此計畫最相關的現有已知痛點?
  • 在這個計畫觸及的文件中,有沒有 FIXME/TODO 註解?

回顧性檢查

檢查這個分支的git日誌。如果有先前的提交表明有之前的審查週期(審查驅動的重構、還原的變更),記錄改變了什麼,以及當前計畫是否重新觸及了那些區域。對之前有問題的區域要更加積極地審查。反覆出現的問題區域是架構壞味道——將它作為架構問題提出。

品味校準(僅限範疇擴張模式)

在現有程式碼庫中找出2-3個設計特別良好的文件或模式。將它們作為審查的風格參考。同時找出1-2個令人沮喪或設計不良的模式——這些是要避免重複的反模式。

在繼續第0步之前報告發現。

第0步:核心理念範疇挑戰 + 模式選擇

0A. 前提挑戰

  1. 這是要解決的正確問題嗎?不同的框架是否能產生一個顯著更簡單或更有影響力的解決方案?
  2. 實際的用戶/業務成果是什麼?這個計畫是通往那個成果最直接的路徑,還是它在解決一個代理問題?
  3. 如果我們什麼都不做會怎樣?是真實的痛點還是假設性的?

0B. 現有程式碼槓桿

  1. 哪些現有程式碼已經部分或完全解決了每個子問題?將每個子問題映射到現有程式碼。我們能否從現有流程中擷取輸出,而不是建立平行的流程?
  2. 這個計畫是否在重建任何已經存在的東西?如果是,解釋為什麼重建比重構更好。

0C. 理想狀態映射

描述這個系統12個月後的理想最終狀態。這個計畫是朝著那個狀態前進還是偏離它?

  當前狀態                  這個計畫                  12個月理想狀態
  [描述]          --->       [描述增量]    --->        [描述目標]

0D. 模式特定分析

對於範疇擴張(SCOPE EXPANSION) — 執行全部三個:

  1. 10倍檢查: 那個雄心壯膽10倍、並且為2倍努力傳遞10倍價值的版本是什麼?具體描述它。
  2. 柏拉圖式理想: 如果世界上最好的工程師有無限的時間和完美的品味,這個系統會是什麼樣子?用戶使用它時會感受到什麼?從體驗開始,而不是架構。
  3. 愉悅機會: 哪些相鄰的30分鐘改進會讓這個功能脫穎而出?那些用戶會想「哦,他們想到了那個」的事情。列出至少3個。

對於維持範疇(HOLD SCOPE) — 執行這個:

  1. 複雜度檢查: 如果計畫觸及超過8個文件或引入了超過2個新的類別/服務,將其視為壞味道,並挑戰是否可以用更少的移動部件達成相同的目標。
  2. 達成所述目標的最小變更集合是什麼?標記任何可以在不阻礙核心目標的情況下推遲的工作。

對於範疇縮減(SCOPE REDUCTION) — 執行這個:

  1. 無情刪減: 能夠向用戶傳遞價值的絕對最小值是什麼?其他一切推遲。沒有例外。
  2. 什麼可以作為後續的PR?將「必須一起出貨」與「一起出貨很棒」分開。

0E. 時間性審問(範疇擴張和維持範疇模式)

思考到實施階段:哪些決定需要在實施過程中做出,而這些決定現在就應該在計畫中解決?

  第1小時(基礎):     實施者需要知道什麼?
  第2-3小時(核心邏輯):他們會遇到什麼模糊之處?
  第4-5小時(整合):   什麼會讓他們驚訝?
  第6+小時(打磨/測試):他們會希望自己計畫了什麼?

現在就將這些作為問題向用戶提出,而不是「以後再弄清楚」。

0F. 模式選擇

呈現三個選項:

  1. 範疇擴張(SCOPE EXPANSION): 這個計畫不錯,但可以更棒。提出雄心壯膽的版本,然後審查它。推動範疇向上。建造大教堂。
  2. 維持範疇(HOLD SCOPE): 計畫的範疇是正確的。以最大嚴謹度審查它——架構、安全性、邊界案例、可觀測性、部署。讓它無懈可擊。
  3. 範疇縮減(SCOPE REDUCTION): 這個計畫過度建構或方向錯誤。提出一個能達成核心目標的最小版本,然後審查它。

上下文相關的預設值:

  • 全新功能 → 預設範疇擴張
  • 錯誤修復或熱修復 → 預設維持範疇
  • 重構 → 預設維持範疇
  • 計畫觸及 >15 個文件 → 建議範疇縮減,除非用戶反對
  • 用戶說「做大」/「雄心壯膽」/「大教堂」 → 範疇擴張,毫無疑問

一旦選擇,完全承諾。不要默默地漂移。

停止。 每個問題使用一次AskUserQuestion。不要批次處理。提出建議 + 原因。如果沒有問題或修復是顯而易見的,陳述你將要做什麼並繼續進行——不要在一個問題上浪費時間。在用戶回應之前不要繼續。

審查章節(共10個章節,在範疇和模式達成一致後)

請參見 references/review-sections.md 以獲得完整的10章節審查框架:

  1. 架構審查
  2. 錯誤與救援映射
  3. 安全性與威脅模型
  4. 資料流與互動邊界案例
  5. 程式碼品質審查
  6. 測試審查
  7. 效能審查
  8. 可觀測性與可除錯性審查
  9. 部署與推出審查
  10. 長期軌跡審查

每個章節都以一個 STOP 結束——每個問題使用一次AskUserQuestion,然後等待反饋。

必要輸出

請參見 references/required-outputs.md 以獲得強制交付物的完整列表。

關鍵規則 — 如何提問

每個AskUserQuestion必須:(1) 呈現2-3個具體的字母選項,(2) 首先陳述你推薦哪個選項,(3) 用1-2句話解釋為什麼該選項優於其他選項,並映射到工程偏好。不要將多個問題批次處理到一個問題中。不要問是/否問題。只有在你對開發者意圖、架構方向、12個月目標或用戶真正想要什麼有真正的模糊性時,才允許開放式問題——並且你必須解釋具體是什麼模糊不清。

對於你找到的每個問題

  • 一個問題 = 一次 AskUserQuestion 調用。 永遠不要將多個問題合併到一個問題中。
  • 具體描述問題,附上文件和行號引用。
  • 呈現2-3個選項,在合理的情況下包括「什麼都不做」。
  • 對於每個選項:用一行說明工作量、風險和維護負擔。
  • 以你的建議開頭。 將其陳述為一個指令:「做B。原因如下:」——不是「選項B或許值得考慮」。要有主見。我付費是為了你的判斷力,不是一個選單。
  • 將理由映射到上面我的工程偏好。 用一句話將你的建議連接到一個特定的偏好。
  • AskUserQuestion 格式: 以「我們推薦 [字母]:[一行原因]」開頭,然後列出所有選項為 A) ... B) ... C) ...。用問題編號 + 選項字母標記(例如,「3A」、「3B」)。
  • 逃生艙口: 如果一個章節沒有問題,就這麼說並繼續。如果一個問題有明顯的修復方法且沒有真正的替代方案,陳述你將要做什麼並繼續——不要在一個問題上浪費時間。只有在存在真正的決定且有實際的權衡取捨時才使用 AskUserQuestion。

格式化規則

  • 為問題編號(1, 2, 3...),選項使用字母(A, B, C...)。
  • 用數字 + 字母標記(例如,「3A」、「3B」)。
  • 推薦的選項總是首先列出。
  • 每個選項最多一句話。
  • 在每個章節之後,暫停並等待反饋。
  • 使用 關鍵差距 / 警告 / OK 以便掃描。

模式快速參考

  ┌─────────────────────────────────────────────────────────────────┐
  │                     模式比較                                    │
  ├─────────────┬──────────────┬──────────────┬────────────────────┤
  │             │  範疇擴張    │  維持範疇    │  範疇縮減          │
  ├─────────────┼──────────────┼──────────────┼────────────────────┤
  │ 範疇        │ 推動向上     │ 維持         │ 推動向下           │
  │ 10倍檢查    │ 強制         │ 可選         │ 跳過               │
  │ 柏拉圖式    │ 是           │ 否           │ 否                 │
  │ 理想        │              │              │                    │
  │ 愉悅        │ 5+個項目     │ 看到時記下   │ 跳過               │
  │ 機會        │              │              │                    │
  │ 複雜度      │ 「它夠大     │ 「它太複雜   │ 「它是最低         │
  │ 問題        │  嗎?」      │  嗎?」      │  限度嗎?」         │
  │ 品味        │ 是           │ 否           │ 否                 │
  │ 校準        │              │              │                    │
  │ 時間性      │ 完整 (第1-6小│ 僅關鍵決定   │ 跳過               │
  │ 審問        │ 時)          │              │                    │
  │ 可觀測性    │ 「操作的     │ 「我們能除   │ 「我們能看到      │
  │ 標準        │  樂趣」      │  錯它嗎?」  │  它壞了嗎?」      │
  │ 部署        │ 基礎設施作為 │ 安全部署     │ 最簡單可能的      │
  │ 標準        │ 功能範疇     │ + 回滾       │ 部署              │
  └─────────────┴──────────────┴──────────────┴────────────────────┘

Individual skills in this repo

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

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Production Python coding standards with automatic version detection (3.10-3.13). Use when writing, reviewing, or refactoring Python to ensure adherence to modern type syntax, LBYL exception handling, pathlib operations, ABC-based interfaces, and production-tested patterns. Not Dagster-specific - applies to any Python project.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

相關技能