AgentSkillsCN

he-spike

在规划阶段之前，通过限时调查或快速原型验证可行性、降低模糊性，或对比不同方案。适用于在需求收集与方案规划之间，当前进方向尚不清晰时使用。

SKILL.md
--- frontmatter
name: he-spike
description: Runs a time-boxed investigation or throwaway prototype to validate feasibility, reduce ambiguity, or compare approaches before planning. Use between intake and plan when the path forward is unclear.
argument-hint: "[slug or docs/specs/<slug>.md]"

HE Spike

Run a focused, time-boxed investigation to reduce uncertainty before planning.

When to Use

  • •Feasibility is uncertain (new technology, unfamiliar API, unclear constraints)
  • •Multiple valid approaches exist and the tradeoffs aren't clear without hands-on exploration
  • •The intake spec recommends a spike (fuzzy-idea loop outcome)
  • •Risk is high enough that building a throwaway prototype is cheaper than guessing wrong

Inputs

  • •docs/specs/<slug>.md (the intake spec that triggered the spike)
  • •Specific questions to answer or hypotheses to validate

Spike Contract

  1. •Define a clear question or hypothesis to validate.
  2. •Set a time box (default: 2 hours of focused work).
  3. •Build the minimum throwaway prototype or investigation needed.
  4. •Document findings — not the prototype code.
  5. •Spike code is disposable and must not be merged into the main codebase.

When comparing multiple approaches, launch one subagent per approach to explore them concurrently. Each subagent prototypes or researches one option and returns findings. This maximizes coverage within the time box.

Output

  • •docs/specs/<slug>-spike.md with:
    • •Question: What we set out to learn
    • •Approach: What we built or investigated
    • •Findings: What we learned (with evidence)
    • •Recommendation: Which approach to take and why
    • •Remaining unknowns: What we still don't know
    • •Time spent: Actual vs. budgeted

Exit Gate

  • •Spike findings document exists at docs/specs/<slug>-spike.md
  • •Original question is answered or explicitly marked as still-unknown with next steps
  • •Recommendation is actionable (feeds directly into planning)
  • •Docs commit gate passes

Transition Options

Present 2-3 explicit next-step options with a recommended default. Use request_user_input (Codex) or AskUserQuestion (Claude Code) in Plan mode; otherwise ask in chat. Wait for user selection before proceeding.

At least one option must be Next step: he-plan.