task-ledger 1.2.1 → 1.2.2
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/SKILL.md +4 -3
- package/package.json +1 -1
- package/references/worklog.md +3 -1
package/SKILL.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: task-ledger
|
|
3
3
|
description: 本地任务台账，跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事（新建任务 / 建个坑 / 这活我领了）、记录已有任务的进展（接着做 / 记一条进展 / 这轮先记下）、查看任务状态或历史（现在该做什么 / 这活谁在做 / 上周做过什么）时加载；对某个具体任务要求结案或退回时，只认用户的明确指令；只是改代码、讨论方案时不要用。
|
|
4
|
-
version: 1.2.
|
|
4
|
+
version: 1.2.2
|
|
5
5
|
allowed-tools: Read,Write,Bash,Grep
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -66,6 +66,7 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <当
|
|
|
66
66
|
- **owner = 当前 `git config user.name`**，不能由外部传入；读不到就报错（先让用户配 git）。**只能动自己名下**的任务（`open` 的先 `claim`），不是你的直接拒绝 —— 不要绕过脚本改 JSON。
|
|
67
67
|
- **换人只能「释放 → 认领」**：skill 不提供交接，随便写的名字都是假的。
|
|
68
68
|
- **「执行记录」禁手改**：只由脚本按 `new / claim / set / release / log / close` 追加，只增不改；手写＝伪造时间线，且不刷新 `updated`。
|
|
69
|
+
- **改正文必配一条日志**：只要动了 worklog 的正文（改一句、补一节、改标题、修错字都算），**必须立刻跑一次 `log`**。没有对应日志的正文改动 = 这轮没做完 —— 时间线上会留下你改过、但没人知道为什么改的空洞。
|
|
69
70
|
- **升级前建的老 worklog 没有这一节**：不用你补，脚本第一次记时自动在文末补一节；文档丢失时 `log` 报错（`updated` 已刷新），用 `show` 查路径，**不要手写**。
|
|
70
71
|
- **旧数据里的 `blocked`**：读侧当进行中；`list --status blocked` 可捞出，用 `set --status doing` 归位。
|
|
71
72
|
|
|
@@ -74,7 +75,7 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <当
|
|
|
74
75
|
## 过程文档
|
|
75
76
|
|
|
76
77
|
1. **建档**：`new` 按模板建六节骨架并把路径写进状态表。
|
|
77
|
-
2.
|
|
78
|
+
2. **推进**：你直接编辑前五节，标题不许改名；**每改一轮正文就配一条日志**——同一次编辑动作里连改多处只记一条，改完立刻 `log --note "这轮做了什么"`。
|
|
78
79
|
3. **交付（待验收）**：任务仍留 `doing`，「待办」写「待用户验收」，「下一步」写清验收该看什么；这轮**照样要走收工三步**。结论只写可验证事实，评价等用户验收。
|
|
79
80
|
4. **封卷**：`close` 打封卷标记，此后不再改；文档靠 `history` 给的回链找回。
|
|
80
81
|
|
|
@@ -83,7 +84,7 @@ python3 <本 SKILL.md 所在目录>/scripts/progress.py <子命令> --repo <当
|
|
|
83
84
|
## 每次收工必做（「收工」= 这一轮对用户有可见产出）
|
|
84
85
|
|
|
85
86
|
1. 改正文：这轮变化的事实都落笔，「下一步」写具体动作，不写「继续推进」。
|
|
86
|
-
2. 跑 `log
|
|
87
|
+
2. 跑 `log`：**这一轮只要改过正文就必须记**（一轮至少一条）；正文没变也能记一条推进，但要同时重写「下一步」。
|
|
87
88
|
3. 回读末行（`tail -n 3 <路径>` 或 `show --id`）：时间 = 现在、说明 = 这轮的事。
|
|
88
89
|
|
|
89
90
|
交付前必须走完这三步；不走，这轮等于没发生，看板还会标停滞。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "task-ledger",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.2",
|
|
4
4
|
"description": "Task-ledger skill for coding agents: per-workspace progress tracking (ledger/progress.json, history, worklog) driven by a CLI script. Standalone install for CodeBuddy and other agents; also bundled inside the dsh-task-ledger DSH plugin.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"skill",
|
package/references/worklog.md
CHANGED
|
@@ -27,7 +27,9 @@
|
|
|
27
27
|
|
|
28
28
|
1. `show --id` 拿任务 JSON + worklog 全文与路径；
|
|
29
29
|
2. 直接改前五节；
|
|
30
|
-
3.
|
|
30
|
+
3. **立刻** `log --id <任务号> --note "补了…/改了…"`。
|
|
31
|
+
|
|
32
|
+
**改正文必配一条日志**：只要动过正文（哪怕一处错字、一个标题），就必须跟一条 `log`；没有日志的正文改动等于没发生过。同一次编辑动作里连改多处，只记一条。
|
|
31
33
|
|
|
32
34
|
已结案任务：worklog 已封卷、不在状态表，用 `history` 给出的回链找回，只读不改。
|
|
33
35
|
|