agentleFS
zengtianlizengtianli/cc-configs/skills/spike/SKILL.md

spike

Skill0 starsChanged 6 months agoMITView on GitHub

抛弃式 spike / poc / toy 实验协议。用户说"试一下 / 试试 X 行不行 / 看 Y 可不可行 / 快速验证 / 玩具版 / spike / poc / 抛弃式实验"时触发。**显式豁免**"每个项目必配 CLAUDE.md + .claude/ 脚手架"铁律 — 因为 spike 本质就是用完即弃。

54 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use competitor-news-monitor, blocked-page-recovery and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • aivrarSkill

    competitor-news-monitor

    Watch named companies for material news; cited digests.

    Also in 6 projects that use this

  • aivrarSkill

    blocked-page-recovery

    Recover blocked/paywalled/WAF'd pages via fallbacks.

    Also in 6 projects that use this

  • john-data-chenSkill

    teams-meeting-pipeline

    Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.

    Also in 8 projects that use this

  • john-data-chenSkill

    touchdesigner-mcp

    Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.

    Also in 5 projects that use this

  • Tommy-ywSkill

    songwriting-and-ai-music

    Songwriting craft, AI music generation prompts (Suno focus), parody/adaptation techniques, phonetic tricks, and lessons learned. These are tools and ideas, not rules. Break any of them when the art calls for it.

    Also in 8 projects that use this

  • mae616Skill

    p5js

    p5.js(クリエイティブコーディング)のProcessing由来「コードでスケッチ」思想を軸に、setup/drawループ・座標系・インタラクション・パフォーマンス最適化を整理する。p5.js、Processing、クリエイティブコーディング、ジェネラティブアート、インタラクティブ表現、ビジュアルプログラミング、Canvas描画、パーティクル、フラクタル、ノイズ表現に関する相談で必ず使うこと。ユーザーが「コードでアート」「動くビジュアル」「インタラクティブな描画」と言った場合にも適用する。

    Also in 8 projects that use this

  • +4 more from aivrar

The file

Files
SKILL.md

Spike — 抛弃式探索协议

核心理念:Karpathy K2/K4 — toy-first + 极简代码。code is cheap, judgment is scarce。先用 < 50 行验证 idea 能不能跑,再决定要不要"提级"为正式项目。

与铁律的关系:全局 ~/.claude/CLAUDE.md "每个项目必配 CLAUDE.md + .claude/ 脚手架"是为长寿项目立的。spike 是用完即弃,本 skill 是这条铁律的显式豁免出口。豁免范围明确写在下面"硬约束 - 豁免"节,不豁免的还是要守。


触发

用户说以下任一:

  • "试一下 / 试试 X 行不行 / 看 Y 可不可行"
  • "快速验证 / 玩具版 / 最小可跑"
  • "spike / poc / proof of concept"
  • "抛弃式实验 / 一次性脚本"
  • "先随便写个看看"

不触发:用户明确说"做正式版 / 新项目 / 长期用"。


硬约束

代码

  • 单文件 < 50 行(含注释、空行)
  • 一个文件解决一个问题;超出 → 已经不是 spike,停手并问用户

位置

  • 所有产物落 ~/Dev/_archive/spikes/YYYY-MM-DD-<slug>.{py,sh,ts,md}
  • 禁止在 ~/Dev/ 根下、~/Dev/stations/、~/Dev/apps/ 等正式区落 spike 产物
  • slug 用 kebab-case,无空格

豁免(这些铁律 spike 期不适用)

  • ✗ 不配 CLAUDE.md
  • ✗ 不建 .claude/ 脚手架
  • ✗ 不写 handoffs/<slug>.md
  • ✗ 不 commit(除非用户明确说"留下")
  • ✗ 不查 playbook META.md domain 索引
  • ✗ 不 AskUserQuestion 颗粒度对齐(spike 就是为了快速试错,不要把决策推回用户)
  • ✗ 不立 SSOT / 不写 README / 不建 reference wiki

仍守

  • ✓ 中文交流
  • ✓ 凭证从 ~/.personal_env 读
  • ✓ 破坏性操作(rm / drop / 写生产 DB)仍要确认 — spike 是探索,不是放飞
  • ✓ 用户提提级("留下 / 做正式版")→ 立即切换到 /start --bootstrap 流程,开始守所有铁律

执行流程

  1. 确认 idea + 范围(一句话):复述给用户"我打算用 < 50 行 <语言> 验证 <X>,落 ~/Dev/_archive/spikes/<YYYY-MM-DD>-<slug>.<ext>",不问颗粒度、不列方案、不起 plan mode
  2. 直接写:在指定路径写 < 50 行代码
  3. 跑通:本地执行一次,把输出贴给用户
  4. 询问后续:"spike 跑通,要提级为正式项目吗?(y/n)"
    • 用户说 要("留下 / 做正式版 / 提级")→ 引导走 /start --bootstrap 或手工迁移到 ~/Dev/<name>/,此时才开始配 CLAUDE.md / .claude/
    • 用户说 不要 / 默认 → spike 留在 _archive/spikes/,不 commit,不 写 handoff,会话结束

反模式

  • ❌ spike 跑超 50 行还在加功能 → 已经不算 spike,立即停手并问用户"这个 idea 看起来值得提级,要走 /start --bootstrap 吗?"
  • ❌ spike 产物落 ~/Dev/ 根 / stations/ / apps/(应该全在 _archive/spikes/)
  • ❌ 给 spike 配 SSOT / playbook / handoff / CLAUDE.md(违反 spike 的"用完即弃"本质)
  • ❌ 拿 spike 的产物当线上代码用(不审查、不测试、不部署 review)
  • ❌ spike 没跑通就开始"重构 / 抽象 / 加配置"(先证明能跑,再谈别的)
  • ❌ 用户说"试一下"被解读成"做个正式 MVP",触发全套脚手架协议(直接走 spike,别问)

何时提级为正式项目

只有用户明确说以下任一才提级:

  • "这个挺好 / 留下 / 做正式版 / 提级"
  • "迁到 ~/Dev/<name>/"
  • "加 CLAUDE.md / 配脚手架"

提级动作:

  1. mv ~/Dev/_archive/spikes/<YYYY-MM-DD>-<slug>.<ext> ~/Dev/<name>/<entry>.<ext>
  2. 走 /start --bootstrap 或手工补 CLAUDE.md + .claude/{settings.json,skills/,commands/}
  3. 从这一刻起,所有"每个项目必配脚手架"铁律全部生效,不再豁免

判别:用户没明说就不提级。spike 的默认归宿是留在 _archive/spikes/ 当历史档案,不是 "下一个项目种子"。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.