Skip to content
MyDSHMy DSH Field Notes
中文
Independently maintained; not affiliated with DeepSeek. No association with mydsh.dev or other MyDSH sites.

All categories/Code and debugging

Writing code and tests · Level Advanced · Coding Coding Feature

New feature: contract first

Add an export feature. The requirement is one sentence.

Prompt

Three defaults: define the input-output contract, then the error branches, then the happy path. An implementation without error handling is not finished.

Task: Add an export feature. The requirement is one sentence.

[Before you start, do three things]
1. Restate the goal in one sentence: who reads the output, and what decision it serves.
2. If I have not given you the following, ask me. Do not assume:
   - format, fields, ordering
   - volume and timeout limits
   - who may export
3. Say how you plan to do it (at most 5 steps) and wait for my go-ahead.

[Go through each of these]
- write the signature and return shape first and confirm
- list error branches: no permission, empty, timeout, disk full
- stream large files and explain the memory strategy
- provide a ten-line usage example

[Process]
1. State the contract: inputs, outputs, errors, side effects
2. List every error branch and boundary first
3. Then the happy path, one responsibility per function
4. Test key paths: one normal, two failure cases
5. State when this code would fail

[Output]
Contract, errors, happy path, tests, failure conditions.

[Do not]
- Never ignore an error return
- Never swallow exceptions
- No magic numbers; name them
- Do not log-and-continue instead of returning an error

What to state before it starts

Leave these unsaid and the model fills them with an assumption. Most 'wrong answers' start here.

  • format, fields, ordering
  • volume and timeout limits
  • who may export

Go through each of these

Where this kind of work most often goes wrong. Already in the prompt, so you do not have to remember it.

  • write the signature and return shape first and confirm
  • list error branches: no permission, empty, timeout, disk full
  • stream large files and explain the memory strategy
  • provide a ten-line usage example