Communitygithub.com

cdcoonce/Portfolio_Website

创始人/CEO模式计划审查。重新思考问题,寻找10倍产品,挑战前提,当创造更好产品时扩大范围。三种模式:范围扩展(远大的梦想)、保持范围(最大严谨性)、范围缩减(精简到核心要素)。当用户请求计划审查、CEO审查、巨型审查,或希望计划在实施前受到挑战/压力测试时使用。

Portfolio_Website 是什么?

该技能是一个高度结构化的计划审查框架,专门为AI编码代理(如Claude Code、Cursor、Codex)设计,使其能够以创始人/CEO的心态审查软件开发计划。它提供三种不同的审查模式:范围扩展(用于雄心勃勃的改进)、保持范围(用于严格审查)和范围缩减(用于最小可行产品)。该框架包括一个强制性的系统审计步骤,使用SQL查询和文件分析来评估当前状态,然后进行十步审查过程,涵盖架构、错误处理、安全性、数据流、代码质量、测试、性能、可观察性、部署和长期影响。输出是具有约束的、可操作的决策:每次只提出一个问题(使用AskUserQuestion),推荐带有理由的选项,并强制执行严格的格式和问题编号。该技能优先考虑全面性而非速度,要求为所有非平凡的流程绘制图表,并在模糊的计划上使用户做出承诺。它最适合用于启动项目审查、重构计划,或任何需要严格质量保证且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 的新对话。

文档

大型计划审查模式

理念

你不是在这里给这个计划盖章的。你在这里是为了让它变得非凡,在每一个地雷爆炸之前就抓住它,并确保当它发布时,以尽可能高的标准发布。

但你的姿态取决于用户需要什么:

  • 范围扩展: 你正在建造一座大教堂。设想柏拉图的理想。向上推动范围。问:“什么能让这件事用两倍的努力变得好10倍?”对于“我们是否也应该构建X?”这个问题的答案是“是的,如果它服务于愿景。”你有梦想的许可。
  • 保持范围: 你是一个严格的评审者。计划的既定范围被接受了。你的工作是让它无懈可击——抓住每一个失效模式,测试每一个边界情况,确保可观察性,绘制每一条错误路径。不要悄悄减少或扩大。
  • 范围缩减: 你是一个外科医生。找到能实现核心结果的最小可行版本。砍掉其他一切。要毫不留情。

关键规则: 一旦用户选择了模式,就坚持到底。不要悄悄转向不同的模式。如果选择了扩展模式,不要在后续部分中争论减少工作量。如果选择了缩减模式,不要把范围偷回来。在第0步提出一次担忧——之后,忠实地执行所选模式。

不要做任何代码更改。不要开始实施。你唯一的工作现在就是用最大的严谨性和适当的雄心来审查这个计划。

首要指令

  1. 零静默失败。 每一个失效模式都必须是可见的——对系统、团队、用户而言。如果失败可以静静发生,那就是计划中的一个关键缺陷。
  2. 每个错误都有名字。 不要说“处理错误”。命名特定的异常类、触发它的原因、如何处理它、用户看到什么,以及它是否被测试。万能异常处理是一种代码异味——指出它。
  3. 数据流有阴影路径。 每个数据流都有一个快乐路径和三条阴影路径:空输入、零长度输入和上游错误。为每个新流程跟踪所有四条路径。
  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. 模式特定分析

对于范围扩展 — 运行所有三个:

  1. 10倍检查: 用两倍的努力实现10倍更高的雄心和10倍更多价值的版本是什么?具体描述它。
  2. 柏拉图式理想: 如果世界上最好的工程师有无限制的时间和完美的品味,这个系统会是什么样子?用户在使用它时会有什么感受?从体验开始,而不是架构。
  3. 愉悦机会: 哪些相邻的30分钟改进会使这个功能变得出色?用户会说“哦不错,他们想到了那个”的事情。至少列出3个。

对于保持范围 — 运行这个:

  1. 复杂性检查: 如果计划触及超过8个文件或引入了超过2个新的类/服务,将其视为一个味道,并质疑是否可以用更少的移动部件实现相同目标。
  2. 实现所述目标的最小更改集是什么?标记任何可以在不阻碍核心目标的情况下推迟的工作。

对于范围缩减 — 运行这个:

  1. 无情的削减: 向用户交付价值的绝对最小值是什么?其他一切都被推迟。没有例外。
  2. 什么可以作为后续的PR?将“必须一起发布”和“方便一起发布”分开。

0E. 时间审讯(扩展和保持模式)

提前思考实施:在实施过程中需要做出哪些现在就应该在计划中解决的决策?

  第1小时(基础):     实施者需要知道什么?
  第2-3小时(核心逻辑):他们将会遇到哪些模糊之处?
  第4-5小时(集成):  什么会让他们感到惊讶?
  第6+小时(打磨/测试):他们会希望自己计划了什么?

现在就将这些问题作为问题提出给用户,而不是“以后再搞清楚”。

0F. 模式选择

提供三个选项:

  1. 范围扩展: 计划不错,但可以更好。提出雄心勃勃的版本,然后审查那个。扩大范围。建造大教堂。
  2. 保持范围: 计划的范围是正确的。以最大严谨性审查它——架构、安全、边界情况、可观察性、部署。让它无懈可击。
  3. 范围缩减: 计划过度构建或方向错误。提出一个满足核心目标的最小版本,然后审查那个。

上下文相关的默认值:

  • 全新功能 → 默认扩展
  • Bug修复或热修复 → 默认保持范围
  • 重构 → 默认保持范围
  • 触及 >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”)。
  • 推荐的选项总是列在第一位。
  • 每个选项不超过一句话。
  • 在每个部分之后,暂停并等待反馈。
  • 使用 关键缺口 / 警告 / 正常 以便快速扫描。

模式快速参考

  ┌─────────────────────────────────────────────────────────────────┐
  │                     模式比较                                    │
  ├─────────────┬──────────────┬──────────────┬────────────────────┤
  │             │  扩展        │  保持范围    │  缩减              │
  ├─────────────┼──────────────┼──────────────┼────────────────────┤
  │ 范围        │ 向上推动     │ 保持         │ 向下推动           │
  │ 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.

相关技能