@seanyao/roll 2026.421.4 → 2026.421.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/bin/roll +1 -1
- package/package.json +1 -1
- package/skills/roll-notes/SKILL.md +62 -0
package/README.md
CHANGED
|
@@ -141,6 +141,7 @@ Research → Design → Build → Check → Fix → (loop)
|
|
|
141
141
|
| Deep research (product / company / tech) | `$roll-research "subject"` |
|
|
142
142
|
| Patrol production for regressions | `$roll-sentinel patrol` |
|
|
143
143
|
| Debug a broken page | `$roll-debug <URL>` |
|
|
144
|
+
| Record a dev moment / diary entry | `$roll-notes "just fixed that nasty bug"` |
|
|
144
145
|
|
|
145
146
|
### Full Skill List
|
|
146
147
|
|
|
@@ -160,6 +161,7 @@ Research → Design → Build → Check → Fix → (loop)
|
|
|
160
161
|
| `$roll-.changelog` | Support | Auto-generate CHANGELOG from BACKLOG |
|
|
161
162
|
| `$roll-.echo` | Support | Passive intent clarification |
|
|
162
163
|
| `$roll-.clarify` | Support | Passive scope clarification for vague build requests |
|
|
164
|
+
| `$roll-notes` | Support | Project diary — append dev moments to `notes/YYYY-MM-DD.md` |
|
|
163
165
|
|
|
164
166
|
---
|
|
165
167
|
|
package/bin/roll
CHANGED
|
@@ -4,7 +4,7 @@ set -euo pipefail
|
|
|
4
4
|
# Roll — AI Agent Convention Manager
|
|
5
5
|
# Single source of truth for how all AI coding agents behave.
|
|
6
6
|
|
|
7
|
-
VERSION="2026.421.
|
|
7
|
+
VERSION="2026.421.5"
|
|
8
8
|
ROLL_HOME="${ROLL_HOME:-${HOME}/.roll}"
|
|
9
9
|
ROLL_CONFIG="${ROLL_HOME}/config.yaml"
|
|
10
10
|
ROLL_GLOBAL="${ROLL_HOME}/conventions/global"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@seanyao/roll",
|
|
3
|
-
"version": "2026.421.
|
|
3
|
+
"version": "2026.421.5",
|
|
4
4
|
"description": "Roll — Roll out features with AI agents",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"test": "find tests/unit tests/integration -name '*.bats' | sort | xargs ./tests/helpers/bats-core/bin/bats"
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: roll-notes
|
|
3
|
+
description: "Project diary skill. Records development moments — successes, failures, discoveries — appended chronologically to a daily notes file."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# roll-notes
|
|
7
|
+
|
|
8
|
+
> 项目日记技能。记录开发过程中的成功、失败、感受和任何值得记住的事情。
|
|
9
|
+
> Append-only, timeline-driven, no fixed format.
|
|
10
|
+
|
|
11
|
+
## Trigger
|
|
12
|
+
|
|
13
|
+
- User says "记一下"、"写进日记"、"append 到日记"
|
|
14
|
+
- User asks to record a feeling, finding, or moment
|
|
15
|
+
- A project milestone is reached and worth capturing
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
$roll-notes 终于搞定了那个 WebSocket 断线重连的 bug
|
|
19
|
+
$roll-notes 今天的 code review 给了很好的反馈
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Behavior
|
|
23
|
+
|
|
24
|
+
1. **Determine file path**: `notes/YYYY-MM-DD.md` relative to project root
|
|
25
|
+
2. **Get current time**: Use `Asia/Shanghai` timezone (`TZ=Asia/Shanghai date`)
|
|
26
|
+
3. **Append**: Add new entry at end of file — never overwrite existing content
|
|
27
|
+
4. **Create if missing**: If file doesn't exist, create with a `# YYYY-MM-DD — <one-line summary>` header
|
|
28
|
+
5. **Free format**: Paragraph, list, code block — whatever fits the moment
|
|
29
|
+
|
|
30
|
+
## File format
|
|
31
|
+
|
|
32
|
+
```markdown
|
|
33
|
+
# YYYY-MM-DD — 一句话概括今天
|
|
34
|
+
|
|
35
|
+
> 时间：北京时间 HH:MM
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## HH:MM — 事件标题
|
|
40
|
+
|
|
41
|
+
发生了什么、怎么解决的、什么感受。
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## HH:MM — 另一个事件
|
|
46
|
+
|
|
47
|
+
...
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Rules
|
|
51
|
+
|
|
52
|
+
- **No planning**: Never write "明日待办" or "下一步"
|
|
53
|
+
- **No summaries**: Never write "今日收获" or "经验教训"
|
|
54
|
+
- **Pure record**: What happened, as-is — honest, immediate, rough is fine
|
|
55
|
+
- **Append freely**: Multiple entries per day is normal
|
|
56
|
+
|
|
57
|
+
## File location
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
notes/
|
|
61
|
+
└── YYYY-MM-DD.md
|
|
62
|
+
```
|