메뉴
Karpathy 风格的 AI 编码行为约束。用于写代码、review、重构、修 bug、提交前审查，防止错误假设、过度设计、无关改动和不可验证目标。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | ssf-karpathy |
| description | Karpathy 风格的 AI 编码行为约束。用于写代码、review、重构、修 bug、提交前审查，防止错误假设、过度设计、无关改动和不可验证目标。 |
本 Skill 吸收 multica-ai/andrej-karpathy-skills 的核心思想，并融合到 SuperSpecFlow：
它不是替代 OpenSpec 合同层、Superpowers 执行纪律层或 SuperSpecFlow 路由与适配层，而是作为所有工程动作的底层行为约束。
/ssf-karpathy [目标]ssf-build 开始前、ssf-review 审查 diff 时、ssf-git 提交前宿主项目 Karpathy 产物默认写入 .superspecflow/karpathy/<change-id>/，例如 karpathy-preflight.md 和 karpathy-diff-audit.md。读取历史审计时先读 .superspecflow/karpathy/<change-id>/，缺失时 fallback 到兼容期旧路径；新写入不得推荐根目录 karpathy/<change-id>/。
编码前必须明确：
# 编码前判断
## 我理解的目标
## 明确假设
## 可能的歧义
## 更简单的方案
## 需要暂停确认的问题
规则：
实现前问：
# 简化检查
- 这是不是满足 spec 的最小实现？
- 有没有为未来需求写抽象？
- 有没有增加未要求的配置、扩展点、框架？
- 有没有把 50 行问题写成 200 行？
- 高级工程师会不会认为这过度设计？
禁止：
修改已有代码时：
每个改动都应该能回答：
这行为什么必须改？它对应哪个 Spec ID、测试或 bug 复现？
把命令式任务改写成可验证目标：
| 原始说法 | 转换后目标 |
|---|---|
| 加校验 | 先写无效输入测试，再实现并通过 |
| 修 bug | 先写复现 bug 的失败测试，再修到通过 |
| 重构模块 | 先证明现有测试通过，重构后再次通过 |
| 增加页面 | 定义用户路径、状态和验收结果后再实现 |
多步任务使用：
# 目标驱动计划
1. [步骤] → 验证：[检查方式]
2. [步骤] → 验证：[检查方式]
3. [步骤] → 验证：[检查方式]
在 review 或 commit 前输出：
# Karpathy Diff Audit
## 假设是否已显式说明
- Pass / Fail
## 是否为最小实现
- Pass / Fail
## 是否存在无关改动
- Pass / Fail
## 每类改动的来源
| 改动 | 对应 Spec / Task / Bug | 是否必要 |
|---|---|---|
## 验证证据
## 需要回滚或拆分的改动
ssf-think：用于暴露假设、提出更小 MVP。ssf-spec：用于把成功标准写成可验证 requirement。ssf-build：用于限制实现范围和 diff 面积。ssf-review：用于查出无关改动、过度设计和隐藏假设。ssf-git：用于保证 commit 只包含一个清晰目标。ssf-ship：用于避免“看似完成但未验证”的发布。简单拼写、明显一行修复、纯文案改动可以使用轻量模式：
目标：
最小改动：
验证：
但仍不得引入无关改动。
阶段六（档）。用户输入 /ssf-archive 或由 ssf-ship 续接时触发。归档 OpenSpec change、同步文档、更新 decision ledger，并用 Diataxis 检查文档缺口。
阶段三（建）。用户输入 /ssf-build 或由 ssf-spec 续接时触发。按 OpenSpec tasks 执行，使用 Superpowers 风格：理解、计划、TDD、小步实现、验证、更新 spec-to-code-map。
复盘。用户输入 /ssf-retro 时触发。复盘本轮 SuperSpecFlow，检查产品、规格、开发、测试、发布各阶段的流程质量，输出可执行改进。
阶段二（规）。用户输入 /ssf-spec 或由 ssf-think 续接时触发。生成 OpenSpec 风格 change contract：proposal.md、design.md、specs/*.md、tasks.md、Spec Readiness Review。
阶段一（想）。用户输入 /ssf-think 或描述新想法/新功能时触发。用 Superpowers brainstorming 纪律做价值、体验、范围反问，产出 Product Change Brief、Decision Record 和 design.md，然后进入 ssf-spec。
Git 工作流与中文 commit 正文门禁。用户输入 /ssf-git、/ssf-branch、/ssf-commit、/ssf-pr，或要求建分支、提交、生成 PR、合并、rebase 时触发。强制分支、暂存、提交、PR 与 OpenSpec change-id/Spec ID 对齐；commit 标题的类型与范围使用英文标识符（conventional commits），摘要、正文、字段名必须使用中文。