roll-noteslisted

# roll-notes > 项目日记技能。记录开发过程中的成功、失败、感受和任何值得记住的事情。 > Append-only, timeline-driven, no fixed format. ## Trigger - User says "记一下"、"写进日记"、"append 到日记" - User asks to record a feeling, finding, or moment - A project milestone is reached and worth capturing ``` $roll-notes 终于搞定了那个 WebSocket 断线重连的 bug $roll-notes 今天的 code review 给了很好的反馈 ``` ## When Not to Use - Capturing a bug or feature idea into BACKLOG (use `$roll-idea`) - Generating the user-facing changelog (use `$roll-.changelog`) - Writing design documents or AC (use `$roll-design`) ## Behavior 1. **Determine file path**: `.roll/notes/YYYY-MM-DD.md` relative to project root (parallel to `.roll/dream/` and `.roll/briefs/` — notes is project metadata, not source) 2. **Get current time**: Use `Asia/Shanghai` timezone (`TZ=Asia/Shanghai date`) 3. **Read existing entries for style**: Before writing, read the last 2–3 entries in the same file. Analyze their style: heading format, voice/tone, paragraph structure, emoji usage, code block conventions, sign-off pattern. New entries must continue this style — do not invent new structural patterns. 4. **Append**: Add new entry at end of file — never overwrite existing content 5. **Create if missing**: If file doesn't exist, create with a `# YYYY-MM-DD — <one-line summary>` header 6. **Free format**: Paragraph, list, code block — whatever fits the moment ## File format ```markdown # YYYY-MM-DD — 一句话概括今天 > 时间：北京时间 HH:MM --- ## HH:MM — 事件标题 发生了什么、怎么解决的、什么感受。 --- ##