Spike Manifest【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-doneIdea[One paragraph describing the overall idea being explored]Requirements[Design decisions that emerged from the users choices during spiking. Non-negotiable for the real build. Updated as spikes progress.][e.g., Must use streaming JSON output, not single-response][e.g., Must support reconnection on network failure]Spikes#NameTypeValidatesVerdictTags其特殊之处在于 **Requirements 是动态生长的**用户在 Spike 过程中表达的每个偏好都必须被当场追加到 Requirements 小节——这些决策一旦形成即对真实构建不可谈判non-negotiable。MANIFEST.md 也因此成为贯穿 Spike → plan-phase → build 的单一事实源。 ### 构建与验证循环build_spikes 每个 Spike 的构建遵循深度优先于速度原则完整步骤见 [get-shit-done/workflows/spike.md](https://link.gitcode.com/i/7aba777b3f5753c4801c7c1d5291259f) 1. 创建 .planning/spikes/NNN-descriptive-name/ 目录 2. **默认给用户可体验的东西**见下文体验优先仅当问题确实关乎事实而非感受时才退回 stdout/CLI 验证 3. 从最简版本写起再逐步加深 4. 发现新问题就迭代出现意外表面就补一个隔离它的后续测试答案太浅就探测边界大输入、并发请求、畸形数据、网络失败假设被推翻就调整并在 README 中记下 pivot。复杂问题允许多文件如 test-basic.js、test-edge-cases.js、benchmark.js 5. 撰写带 YAML frontmatter 的 README.md模板见下文 6. 静默自动关联相关 Spike 7. 运行验证——可自行验证则运行并迭代、更新判定需要人判断则弹出 CHECKPOINT: Verification Required 检查点框包含运行命令、预期产出等待用户反馈是否符合预期 8. 在 MANIFEST.md 中补上该 Spike 行 9. 若 COMMIT_DOCS 为 true按规范提交 bash gsd-sdk query commit docs(spike-NNN): [VERDICT] — [key finding] --files .planning/spikes/NNN-descriptive-name/ .planning/spikes/MANIFEST.md汇报判定与发现若核心假设被推翻弹CHECKPOINT: Decision Required让用户在继续剩余 Spike / 调整路线 / 放弃三者间决策。每个 Spike 的 README 采用统一的 YAML frontmatter 小节模板get-shit-done/workflows/spike.md--- spike: NNN name: descriptive-name type: standard validates: Given [precondition], when [action], then [expected outcome] verdict: PENDING related: [] tags: [tag1, tag2] --- # Spike NNN: Descriptive Name ## What This Validates [Given/When/Then] ## Research [Docs checked, approach comparison table, chosen approach, gotchas. Omit if no external deps.] ## How to Run [Command(s)] ## What to Expect [Concrete observable outcomes] ## Observability [If forensic log layer exists. Omit otherwise.] ## Investigation Trail [Updated as spike progresses. Document each iteration: what tried, what revealed, what tried next.] ## Results [Verdict, evidence, surprises, log analysis findings.]这套模板同时服务两个目的对机器frontmatter 里的spike/type/validates/verdict/tags可被后续 wrap-up 流程批量解析对人Investigation Trail与Results强制记录调查过程而不仅是结论。体验优先让用户感觉到 Spike 在工作这是本工作流最有辨识度的设计get-shit-done/workflows/spike.md构建的默认偏向是给出用户能亲身体验的东西而不是只有 Claude 能读的 stdout。可能的形态包括展示结果的可视化 HTML 页面、带触发按钮与响应展示的 Web UI、展示数据流过管线的页面、允许用户试不同输入并观察输出的最小界面。仅在 Spike 确实关于事实而非感受时才退回 stdout/CLI 验证纯粹的数据转换答案是是它解析正确这类二值是非问题这个 API 能否认证这个库是否存在基准数字X 多快Y 占多少内存。拿不准就构建 UI——多花几分钟却能让 Spike 变成用户可以现场演示并建立信心的产物。若 Spike 需要运行时可观测性工作流要求搭一层取证式日志层forensic log layer带 ISO 时间戳与类别标签的事件日志数组导出机制服务端 GET 端点 / CLI 写 JSON 文件 / 浏览器 Export 按钮日志摘要事件计数、时长、错误、元数据数据量大时补充分析辅助函数。判定语义与风险管控Spike 的判定分三档语义在 wrap-up 流程中被进一步明确get-shit-done/workflows/spike-wrap-up.mdVALIDATED—— 提供已被证明的可用模式PARTIAL—— 提供带约束的可用模式INVALIDATED—— 提供雷区与死路同样是宝贵资产。工作流反复强调不要急于下结论只说VALIDATED——它能跑而没有细节的 Spike几乎总是不完整的。最终逐 Spike 报告格式如下◆ Spike NNN: {name} Verdict: {VALIDATED ✓ / INVALIDATED ✗ / PARTIAL ⚠} Key findings: {not just verdict — investigation trail, surprises, edge cases explored} Impact: {effect on remaining spikes}收尾三件事Conventions、总报告与后续路由更新 CONVENTIONS.md当次会话所有 Spike 构建完毕后把浮现或固化下来的模式写入.planning/spikes/CONVENTIONS.mdget-shit-done/workflows/spike.md# Spike Conventions Patterns and stack choices established across spike sessions. New spikes follow these unless the question requires otherwise. ## Stack [What we use for frontend, backend, scripts, and why] ## Structure [Common file layouts, port assignments, naming patterns] ## Patterns [Recurring approaches: how we handle auth, how we style, how we serve] ## Tools Libraries [Preferred packages with versions that worked, and any to avoid]铁律只收录在 2 个 Spike 中重复出现、或由用户明确选择的模式。若文件已存在则就地更新相应小节若COMMIT_DOCS开启则提交docs(spikes): update conventions。会话总报告全部完成时输出 GSD 风格的总结块包含 Verdicts 表001 standard ✓ VALIDATED、002a comparison ✓ WINNER等、Key Discoveries、Feasibility Assessment 与 Signal for the Build该用什么、避开什么、注意什么。随后是标准化的下一步路由/gsd:spike --wrap-up—— 把 Spike 知识打包成实现蓝图主推项/gsd:spike—— 继续 Spike 更多想法无参数即进入 Frontier 模式/gsd:plan-phase—— 基于验证结果启动真实实现的规划/gsd:explore—— 继续探索该想法。--wrap-up把实验结论固化为项目级技能/gsd:spike --wrap-up是工作流的另一半get-shit-done/workflows/spike-wrap-up.md负责把.planning/spikes/的实验结论转译为一份项目本地、持久可加载的实现蓝图技能./.claude/skills/spike-findings-[project]/并生成.planning/spikes/WRAP-UP-SUMMARY.md存档。其流程要点收集清单gather读 MANIFEST.mdglob.planning/spikes/*/README.md并解析 frontmatter若技能已存在读其processed_spikes元数据过滤掉已处理的 Spike无未处理 Spike 时提示先运行/gsd:spike并退出同样受commit_docs配置控制。自动全量纳入auto_include所有未处理 Spike 一律打包展示处理清单。VALIDATED / PARTIAL / INVALIDATED 三种判定各有携带价值模式 / 约束模式 / 雷区。按功能域自动分组group依据标签、名字、related字段与内容把 Spike 归组每组对应生成技能内的一个 reference 文件。确定技能名skill_name取自项目根目录名输出到./.claude/skills/spike-findings-[project-dir-name]/已存在则原地追加更新。拷贝源码copy_sources把 README 与核心源码复制进技能目录sources/NNN-spike-name/排除node_modules/、锁文件、构建产物等。合成蓝图synthesize每个功能域写一份references/[feature-area-name].md——要像食谱而非论文未来构建会话应能照着做而无需重新 Spike。每份蓝图固定包含五个小节# [Feature Area Name] ## Requirements [来自 MANIFEST.md Requirements 且适用于本域的不可谈判设计决策] ## How to Build It [逐步做法装什么、怎么配、用什么代码模式附从 Spike 源码提取的关键片段] ## What to Avoid [看着对其实不对的东西、gotcha、被尝试过并失败的死路] ## Constraints [硬事实速率限制、库限制、版本要求、不兼容点] ## Origin Synthesized from spikes: NNN, NNN, NNN Source files available in: sources/NNN-spike-name/, sources/NNN-spike-name/【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考