dsh-task-ledger 0.0.112 → 0.0.113

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-task-ledger",
3
- "version": "0.0.112",
3
+ "version": "0.0.113",
4
4
  "description": "Task ledger board for dsh (DeepSeek Harness): read-only board over task-ledger skill workspaces. The task-ledger skill is bundled — install the plugin, get the skill globally.",
5
5
  "keywords": [
6
6
  "deepseek",
package/skill/SKILL.md CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: task-ledger
3
3
  description: 本地任务台账,跨会话记录在办任务的归属、进度与起止。当用户要登记一件新的事(新建任务 / 建个坑 / 这活我领了)、记录已有任务的进展(接着做 / 记一条进展 / 这轮先记下)、查看任务状态或历史(现在该做什么 / 这活谁在做 / 上周做过什么)、给任务结案或退回(做完了 / 验收通过 / 不做了 / 退回待认领)、整理标签或检查台账一致性时加载;只是改代码、讨论方案时不要用。
4
- version: 1.3.39
4
+ version: 1.3.40
5
5
  allowed-tools: Read,Edit,Bash,Grep
6
6
  ---
7
7
 
@@ -39,7 +39,7 @@ allowed-tools: Read,Edit,Bash,Grep
39
39
 
40
40
  | 参数 | 含义 |
41
41
  |---|---|
42
- | `--title "…"` | 任务标题(必填)—— 写任务核心、一句话说清干啥,不要拿分类名当标题;它用来生成任务号和过程文件名,建议 4~20 字 |
42
+ | `--title "…"` | 任务标题(必填)—— 就是「做了什么事」,一句话说清干啥,**前面不要加分类 / 类型 / 项目名之类前缀**(分类归 `--category`,别塞进标题);它用来生成任务号和过程文件名,建议 4~20 字 |
43
43
  | `--id` | 自定义任务号(一般不传;只能用小写字母、数字、汉字和连字符) |
44
44
  | `--created` | 给过去漏记的任务补建时,补录实际创建日期(`YYYY-MM-DD`) |
45
45
  | `--self` | 建并认领:直接归自己名下、状态「进行中」。仅当用户明确说「并开始做 / 并执行」时才用(判定见生命周期第 2 条) |
@@ -47,7 +47,7 @@ allowed-tools: Read,Edit,Bash,Grep
47
47
 
48
48
  干什么:建任务、按模板建好过程文档。不加 `--self` = 只建,落公共池等认领;加 `--self` = 建并认领。
49
49
 
50
- 分类 / 标签口径(`--category` 只有 `new` 有;`--tags` 三个命令都有):`--category` 答「是什么类型」,单值,中文 ≤4 字 / 纯英文 ≤3 词,吃不准写「其他」,**建任务时给一次,之后谁都改不了**(`set` / `close` 没有这个参数,历史行里就是建任务时那个值;标题与创建时间同理,建完即不可变)。`--tags` 答「涉及什么」,0~5 个、逗号分隔,写不出就不传(传空串等于没传),随时可改。**分类只进台账与历史**(`list` / `history` 看得到),**不写进过程文档**;过程文档头部只有标签行,标签可以涵盖分类(「建设」「修改」这类词直接当标签写)。查询用 tags(包含匹配,见 `list --tag`)。名词性短语、中文优先。正例:`--category 缺陷修复 --tags "镜像拉取,超时重试"`;反例:`--category 已完成登录修复`、`--tags 修 bug`。
50
+ 分类 / 标签口径(`--category` 只有 `new` 有;`--tags` 三个命令都有):`--category` 答「是什么类型」,单值,中文 ≤4 字 / 纯英文 ≤3 词,吃不准写「其他」,**建任务时给一次,之后谁都改不了**(`set` / `close` 没有这个参数,历史行里就是建任务时那个值;标题与创建时间同理,建完即不可变)。`--tags` 答「涉及什么」,0~5 个、逗号分隔,建任务时能想到就给(传空串等于没传);在办期间用 `set --tags` 补;**结案是最该给终值的一段** —— 任务做完了、全貌最清楚,用 `close --tags` 定下来,不传就沿用原标签。**分类只进台账与历史**(`list` / `history` 看得到),**不写进过程文档**;过程文档头部只有标签行,标签可以涵盖分类(「建设」「修改」这类词直接当标签写)。查询用 tags(包含匹配,见 `list --tag`)。名词性短语、中文优先。正例:`--category 缺陷修复 --tags "镜像拉取,超时重试"`;反例:`--category 已完成登录修复`、`--tags 修 bug`。
51
51
 
52
52
  举例:用户说「新建个任务:把发布流程走通」→ `new --title "把发布流程走通"`(只建,不认领);用户明确说「新建个任务并开始做」→ `new --title "把发布流程走通" --self`。
53
53
 
@@ -99,7 +99,7 @@ allowed-tools: Read,Edit,Bash,Grep
99
99
  | `--id <任务号>` | 结哪条(必填) |
100
100
  | `--summary "…"` | 结案摘要(必填;放弃写「放弃:原因」) |
101
101
  | `--finished` | 给漏记的旧任务补用时,补录实际结案时间(`YYYY-MM-DD[ HH:MM[:SS]]`) |
102
- | `--tags` | 覆盖标签终值(写进历史行;文档头部只写标签)。分类不可改,历史行用它建任务时的值 |
102
+ | `--tags` | 覆盖标签终值(写进历史行;文档头部只写标签)。**结案时最该给**:任务做完了,最清楚涉及什么;不传则沿用原标签。分类不可改,历史行用它建任务时的值 |
103
103
 
104
104
  干什么:结案并封卷过程文档、移出自己名下。**封卷后只读**(见生命周期第 8 条)。
105
105
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "task-ledger",
3
- "version": "1.3.39",
3
+ "version": "1.3.40",
4
4
  "description": "Task-ledger skill for coding agents: per-workspace progress tracking (ledger/pool.json + owners/<hash>.json shards + owners.json index, 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",