@ilikexiaoni/pi-task-list 0.4.0
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/LICENSE +21 -0
- package/README.md +105 -0
- package/extensions/task-context-bridge.ts +121 -0
- package/extensions/task-list.ts +527 -0
- package/lib/task-list-core.ts +780 -0
- package/package.json +45 -0
- package/skills/task-list-guidance/SKILL.md +29 -0
package/package.json
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@ilikexiaoni/pi-task-list",
|
|
3
|
+
"version": "0.4.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "A generic structured task list extension for Pi with dependencies, evidence, and visible progress.",
|
|
6
|
+
"keywords": [
|
|
7
|
+
"pi-package",
|
|
8
|
+
"pi",
|
|
9
|
+
"pi-extension",
|
|
10
|
+
"pi-task-list",
|
|
11
|
+
"tasks",
|
|
12
|
+
"todo",
|
|
13
|
+
"planning"
|
|
14
|
+
],
|
|
15
|
+
"license": "MIT",
|
|
16
|
+
"author": "ilikexiaoni",
|
|
17
|
+
"publishConfig": {
|
|
18
|
+
"access": "public"
|
|
19
|
+
},
|
|
20
|
+
"files": [
|
|
21
|
+
"extensions/",
|
|
22
|
+
"lib/",
|
|
23
|
+
"skills/",
|
|
24
|
+
"README.md",
|
|
25
|
+
"LICENSE"
|
|
26
|
+
],
|
|
27
|
+
"scripts": {
|
|
28
|
+
"test": "node --test tests/*.test.ts"
|
|
29
|
+
},
|
|
30
|
+
"peerDependencies": {
|
|
31
|
+
"@earendil-works/pi-ai": "*",
|
|
32
|
+
"@earendil-works/pi-coding-agent": "*",
|
|
33
|
+
"@earendil-works/pi-tui": "*",
|
|
34
|
+
"typebox": "*"
|
|
35
|
+
},
|
|
36
|
+
"pi": {
|
|
37
|
+
"skills": [
|
|
38
|
+
"./skills"
|
|
39
|
+
],
|
|
40
|
+
"extensions": [
|
|
41
|
+
"./extensions/task-list.ts",
|
|
42
|
+
"./extensions/task-context-bridge.ts"
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: task-list-guidance
|
|
3
|
+
description: 通用多步骤任务清单和进度管理。需要把复杂工作拆成可验收节点、跟踪依赖和阻塞、记录证据或向用户汇报阶段进度时使用；适用于任何项目，不包含领域业务规则。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 通用任务清单
|
|
7
|
+
|
|
8
|
+
## 适用时机
|
|
9
|
+
|
|
10
|
+
- 任务包含三个或以上实质步骤，或需要跨文件、跨模块、跨环境验证。
|
|
11
|
+
- 用户需要看到当前进度、完成条件、阻塞原因或后续动作。
|
|
12
|
+
- 工作需要区分调查、判断、修改、测试和交付，而不是一次性给出建议。
|
|
13
|
+
|
|
14
|
+
## 使用规则
|
|
15
|
+
|
|
16
|
+
1. 优先使用 `task_list` 工具建立和维护任务状态；它是当前会话唯一可写的任务状态来源，不要同时维护另一套平行清单。Package 默认会通过 `task-context-bridge` 把短摘要提供给上下文处理，但摘要不是第二份任务状态。
|
|
17
|
+
2. 每项任务写成“动作 + 对象 + 完成条件”，例如“定位真实接口入口，并列出文件路径和调用方向”。
|
|
18
|
+
3. 把发现、判断、修改、验证和交付拆开；任务标题不要使用“继续处理”“完善方案”等无法验收的词。
|
|
19
|
+
4. 开始任务前更新为 `in_progress`；每条完成条件至少记录一条 `evidence`，证据数量满足完成条件后才能更新为 `completed`。
|
|
20
|
+
5. 有先后关系时使用 `blockedBy`；未完成依赖会自动阻塞任务，依赖完成后由系统自动解除该类阻塞。外部审批等人工阻塞使用 `blocked` 和 `blockReason`，只能显式解除；不要把未完成的工作标记为完成。
|
|
21
|
+
6. 每完成一个可验收节点，向用户说明：已完成什么、当前做什么、下一步是什么；任务面板的汇总数字不能替代这条说明。
|
|
22
|
+
7. 任务失败或环境不可用时保留事实和证据边界，新增阻塞记录，不删除失败痕迹或伪造完成状态。
|
|
23
|
+
8. 任务很简单时直接处理，不为了使用清单而制造额外步骤；工具不可用时使用简短的文本计划作为降级方案。
|
|
24
|
+
|
|
25
|
+
## 交付前检查
|
|
26
|
+
|
|
27
|
+
- 所有已完成任务都有完成说明或证据。
|
|
28
|
+
- 未完成任务仍保持 `pending`、`in_progress` 或 `blocked`，并写清下一步或阻塞原因。
|
|
29
|
+
- 用户能从进度消息看出当前结论、剩余风险和下一步，而不必猜测清单数字的含义。
|