relay-harvest
The exact gotchas.md entry format the compile.ts parser expects. Use during the Relay debug stage whenever writing a new entry to .bob/knowledge/gotchas.md - a heading or field off this format silently fails to compile.
- License 许可
- MIT
- 最近更新
- 2026-09-27
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- relay-harvest
- description
- The exact gotchas.md entry format the compile.ts parser expects. Use during the Relay debug stage whenever writing a new entry to .bob/knowledge/gotchas.md - a heading or field off this format silently fails to compile.
03 SKILL.md 正文
Gotcha entry format
cli/src/knowledge.ts's parseGotchas splits on ^## headings and reads
- **field:** value bullets below each one. Field labels are matched
case/space-insensitively, but use this exact casing for consistency with
existing entries.
Heading: ## gotcha-NNN - Title (next free number; em dash -,
not a hyphen).
Required fields, in order, each a - **field:** bullet (multi-line
values may wrap on indented continuation lines):
## gotcha-022 - Short, specific title of the bug class
- **discoveredIn:** T-NNN-slug
- **discoveredAt:** 2026-09-26T10:44:00Z
- **costMinutes:** 35
- **symptom:** What was observed before the cause was known.
- **rootCause:** What actually caused it.
- **fix:** How it was fixed.
- **watchOut:** One-line warning surfaced during future onboarding.
- **codeRefs:** `path/to/file.ts:NN`, `path/to/other.ts:NN`
- **stalenessCheck:** When this entry should be re-verified.
costMinutes must be a bare number (the parser regexes the first digits
out of the value). codeRefs is comma-separated, backticks optional (the
parser strips them). Append new entries at the end of the file - never
edit or delete an existing entry, even to fix a typo; add a follow-up note
in a new entry instead.
04 同仓库更多 Skills
relay-doctor
Run relay doctor to check .bob/ config and gotchas.md against the parser
relay-criteria
How to extract testable acceptance criteria from a ticket and write ambiguity rewrites. Use during the Relay brief stage, whenever turning ticket language into task.json's acceptanceCriteria.
relay-baton
Relay's file conventions and task.json update rules - where each stage writes, what fields it owns, and the CLI commands that log timing. Use whenever writing or updating anything under .bob/tasks/ or .bob/knowledge/.
doctor
Run relay doctor to check .bob/ config and gotchas.md against the parser