taskboard-workbench 0.0.0-stage → 0.3.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/CHANGELOG.md +403 -0
- package/LICENSE +21 -0
- package/README.md +210 -2
- package/cli/tb.mjs +314 -0
- package/cordis.patch.yml +5 -0
- package/index.js +633 -0
- package/lib/client.js +522 -0
- package/package.json +96 -4
- package/scripts/tb-flow.mjs +86 -0
- package/skills/taskboard-flow/SKILL.md +89 -0
- package/skills/taskboard-flow/references/errors.md +61 -0
- package/skills/taskboard-flow/references/injection.md +70 -0
- package/skills/taskboard-flow/references/steps/S0.md +31 -0
- package/skills/taskboard-flow/references/steps/S1.md +28 -0
- package/skills/taskboard-flow/references/steps/S2.md +31 -0
- package/skills/taskboard-flow/references/steps/S3.md +22 -0
- package/skills/taskboard-flow/references/steps/S4.md +25 -0
- package/skills/taskboard-flow/references/steps/S5.md +36 -0
- package/skills/taskboard-flow/references/steps/S6.md +30 -0
- package/skills/taskboard-flow/references/steps/S7.md +23 -0
- package/spec/norms/acceptance.md +36 -0
- package/spec/norms/card-update.md +39 -0
- package/spec/norms/doc-editing.md +30 -0
- package/spec/norms/flow.md +45 -0
- package/spec/norms/manifest.json +41 -0
- package/spec/norms/project-defaults.md +33 -0
- package/spec//345/233/242/351/230/237agent.md +171 -0
- package/src/core/acceptance.mjs +62 -0
- package/src/core/advance.mjs +192 -0
- package/src/core/agent-teams.mjs +48 -0
- package/src/core/binding.mjs +44 -0
- package/src/core/config.mjs +22 -0
- package/src/core/contract.mjs +287 -0
- package/src/core/debug-dispatch.mjs +94 -0
- package/src/core/delivery.mjs +93 -0
- package/src/core/deps.mjs +53 -0
- package/src/core/diagnostics.mjs +648 -0
- package/src/core/domain.mjs +235 -0
- package/src/core/empty-state.mjs +240 -0
- package/src/core/errors.mjs +142 -0
- package/src/core/evidence.mjs +86 -0
- package/src/core/executor.mjs +645 -0
- package/src/core/human-review.mjs +773 -0
- package/src/core/intake.mjs +179 -0
- package/src/core/kickoff.mjs +147 -0
- package/src/core/loop.mjs +498 -0
- package/src/core/memory.mjs +193 -0
- package/src/core/next-step.mjs +377 -0
- package/src/core/notify.mjs +183 -0
- package/src/core/owner.mjs +41 -0
- package/src/core/requirements.mjs +292 -0
- package/src/core/review.mjs +82 -0
- package/src/core/session-naming.mjs +64 -0
- package/src/core/split-ask.mjs +107 -0
- package/src/core/store.mjs +3442 -0
- package/src/core/team.mjs +170 -0
- package/src/core/ticket-stage.mjs +150 -0
- package/src/core/verify.mjs +170 -0
- package/src/core/watchdog.mjs +144 -0
- package/src/host/ai-elaborator.mjs +26 -0
- package/src/host/team-engine.mjs +125 -0
- package/src/host/tool-surface.mjs +205 -0
- package/src/mcp/flow-block.mjs +173 -0
- package/src/mcp/server.mjs +156 -0
- package/src/mcp/tools.mjs +764 -0
- package/src/server/api.mjs +2050 -0
- package/src/server/events.mjs +32 -0
- package/src/server/kickoff.mjs +46 -0
- package/src/server/server.mjs +214 -0
- package/src/server/verify.mjs +112 -0
- package/tools/env-check.mjs +35 -0
- package/tools/seed.mjs +67 -0
- package/web/app.js +5337 -0
- package/web/index.html +15 -0
- package/web/tokens.css +1151 -0
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「交项目主会话生成任务分拆」的指令构造(纯函数)—— 2026-10-28 真机批注。
|
|
3
|
+
*
|
|
4
|
+
* 现象:需求条目详情里的「生成看板任务(分拆)」此前**只有一个人工 textarea** ——
|
|
5
|
+
* 人按 `标题 | 负责人 | kind` 一行一条手打,没有建议、没有草稿、没有修订回路。
|
|
6
|
+
* 用户要求:「引入自动生成按钮,并可交互提交修改意见变更优化」。
|
|
7
|
+
*
|
|
8
|
+
* 口径(人拍 **方案 C:走项目主会话**):不新增第二条 LLM 通道,把「先出草稿」这一步交给
|
|
9
|
+
* **项目主会话**里的 agent —— 它本来就有仓库上下文与 `taskboard_*` 工具。
|
|
10
|
+
* 本模块只负责把**要求、格式、边界**写成一段可投递的文本(与 FR-97 的 `debug-dispatch` 同法):
|
|
11
|
+
* 收方 agent 跑在另一个会话,不读本仓 `AGENTS.md`,这段文本是唯一能把纪律带过去的通道。
|
|
12
|
+
*
|
|
13
|
+
* 本模块**不碰 DOM / 不发请求 / 不读库**,因此可被单测逐段断言。
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
/** 收方 agent 必须遵守的边界(与 `debug-dispatch.mjs` 同口径,不得随意删改)。 */
|
|
17
|
+
export const SPLIT_ASK_BOUNDARIES = Object.freeze([
|
|
18
|
+
"**先不要建卡**:本轮只出建议清单,等人在看板点「生成任务」再落库(避免一次对话把看板灌满)",
|
|
19
|
+
"不 commit、不 push(commit 归队长/人)",
|
|
20
|
+
"不改范围外文件;只读分析条目与本仓库",
|
|
21
|
+
"不删用户数据(看板项目 / 任务 / 需求条目)",
|
|
22
|
+
"不把任务置「完成(done)」:完成只能由人确认",
|
|
23
|
+
"动 ~/.dsh/profiles/**、LaunchAgent plist、dsh plugin add/remove、宿主进程重启 —— 必须先汇报并取得用户明确审批",
|
|
24
|
+
]);
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* 回帖里**唯一**被看板解析的格式(人把它粘回「生成看板任务」的输入框即可落库)。
|
|
28
|
+
* 冒号、竖线、箭头都是**半角**,为保证 `split` 端点能直接吃这份文本。
|
|
29
|
+
*/
|
|
30
|
+
export const SPLIT_ASK_LINE_FORMAT = Object.freeze([
|
|
31
|
+
"每行一个任务,字段用半角 `|` 分隔:",
|
|
32
|
+
"`序号 | 标题 | 负责人 | kind | 依赖`",
|
|
33
|
+
"- 负责人:`planner` / `engineer` / `tester` / `reviewer` / `archivist`,不确定就留空",
|
|
34
|
+
"- kind:`work` / `review`,不确定就留空",
|
|
35
|
+
"- 依赖:填**前置任务的序号**(多个用逗号,如 `1,2`),没有就留空",
|
|
36
|
+
"- 例:`3 | 补前端抽屉宽度 | engineer | work | 1,2`",
|
|
37
|
+
]);
|
|
38
|
+
|
|
39
|
+
function line(value, fallback = "(未填写)") {
|
|
40
|
+
const text = String(value ?? "").trim();
|
|
41
|
+
return text || fallback;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 拼「生成任务分拆」的指令。
|
|
46
|
+
*
|
|
47
|
+
* @param {object} input
|
|
48
|
+
* @param {object} input.item 需求条目(identifier / title / description / acceptance / priority / status)
|
|
49
|
+
* @param {object} [input.project] 项目(id / name / workspacePath)
|
|
50
|
+
* @param {string} [input.feedback] 人提交的**修改意见**(第二轮起才有)
|
|
51
|
+
* @param {string[]} [input.previous] 上一版草稿的**原始行**(用于"只改受影响的行")
|
|
52
|
+
* @param {number} [input.maxTasks] 期望条数上限(默认 7)
|
|
53
|
+
* @returns {string} 可直接投递的完整指令文本(纯字符串,无副作用)
|
|
54
|
+
*/
|
|
55
|
+
export function buildSplitAskPrompt({ item, project, feedback, previous, maxTasks } = {}) {
|
|
56
|
+
const it = item ?? {};
|
|
57
|
+
const p = project ?? {};
|
|
58
|
+
const cap = Number.isFinite(maxTasks) && maxTasks > 0 ? Math.min(Math.trunc(maxTasks), 12) : 7;
|
|
59
|
+
const prev = Array.isArray(previous) ? previous.map((x) => String(x ?? "").trim()).filter(Boolean) : [];
|
|
60
|
+
const note = String(feedback ?? "").trim();
|
|
61
|
+
|
|
62
|
+
const parts = [];
|
|
63
|
+
parts.push(`# 任务:为需求条目 ${line(it.identifier, "(无编号)")} 生成「看板任务分拆」建议(只出建议,不要建卡)`);
|
|
64
|
+
parts.push("");
|
|
65
|
+
parts.push("## 条目原文(请先读懂再拆)");
|
|
66
|
+
parts.push(`- 编号:${line(it.identifier)}`);
|
|
67
|
+
parts.push(`- 标题:${line(it.title)}`);
|
|
68
|
+
parts.push(`- 优先级:${line(it.priority, "none")} 状态:${line(it.status)}`);
|
|
69
|
+
parts.push(`- 所属项目:${line(p.name ?? p.id)} 工作区:${line(p.workspacePath)}`);
|
|
70
|
+
parts.push("");
|
|
71
|
+
parts.push("### 描述");
|
|
72
|
+
parts.push(line(it.description, "(条目无描述)"));
|
|
73
|
+
parts.push("");
|
|
74
|
+
parts.push("### 验收标准");
|
|
75
|
+
parts.push(line(it.acceptance, "(条目无验收标准 —— 请在建议里顺带指出这一点)"));
|
|
76
|
+
parts.push("");
|
|
77
|
+
|
|
78
|
+
if (note) {
|
|
79
|
+
parts.push("## 修改意见(本轮必须按它改)");
|
|
80
|
+
parts.push(note);
|
|
81
|
+
parts.push("");
|
|
82
|
+
}
|
|
83
|
+
if (prev.length) {
|
|
84
|
+
parts.push("## 上一版草稿(**只改受意见影响的行**,其余原样保留)");
|
|
85
|
+
parts.push("```");
|
|
86
|
+
for (const l of prev) parts.push(l);
|
|
87
|
+
parts.push("```");
|
|
88
|
+
parts.push("");
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
parts.push(`## 产出要求`);
|
|
92
|
+
parts.push(`- 拆出 **3–${cap}** 个技术任务,覆盖「实现 / 验证 / 评审」三条线,粒度做到"一个人半天到两天能干完"。`);
|
|
93
|
+
parts.push(`- 依赖要写清:先做后做靠「依赖」列表达,不要靠标题里的"然后/接着"。`);
|
|
94
|
+
parts.push("");
|
|
95
|
+
parts.push("### 回帖格式(**只有这个格式会被看板解析**)");
|
|
96
|
+
for (const l of SPLIT_ASK_LINE_FORMAT) parts.push(l);
|
|
97
|
+
parts.push("");
|
|
98
|
+
parts.push("先给一段 3 行以内的拆解思路,然后**只用一个 ``` 代码块**装任务行,代码块里除任务行外不要有别的文字。");
|
|
99
|
+
parts.push("");
|
|
100
|
+
|
|
101
|
+
parts.push("## 边界红线(逐条遵守,并在回帖末尾自查一行)");
|
|
102
|
+
for (const l of SPLIT_ASK_BOUNDARIES) parts.push(`- ${l}`);
|
|
103
|
+
parts.push("");
|
|
104
|
+
parts.push("## 回报");
|
|
105
|
+
parts.push("拆解思路(≤3 行)→ 任务行代码块 → 边界自查一行。**不要**调用任何建卡工具。");
|
|
106
|
+
return parts.join("\n");
|
|
107
|
+
}
|