@hupan56/wlkj 2.6.0 → 2.7.1

package/templates/qoder/skills/wl-status/SKILL.md

@@ -1,61 +1,83 @@
----
-name: wl-status
-description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. 用户说'项目怎么样''进度''健康度''路线图''现在在做什么''整体情况'时触发。"
-trigger: "用户说'项目怎么样''进度''健康度''路线图''整体情况''/wl-status'"
----
-
-# wl-status — 项目状态总览
-
-三个维度，用户没指定就全展示：
-
-## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-
-- `.qoder/.developer` — 当前开发者
-- `data/index/.index-meta.json` — 图谱新鲜度（健康度计算用）
-- `.qoder/learning/eval-history.jsonl` — EVA 评估历史（健康度趋势用，可能不存在）
-- `workspace/tasks/*/task.json` — 全部任务（current 维度用）
-
-## 维度 1：current（当前迭代）
-
-```bash
-python .qoder/scripts/task.py list
-```
-展示：
-- 当前活动任务（标 `*` 的那条）
-- 进行中任务清单 + 各自进度
-- 最近 5 个动作（建任务/finish/PRD 发布等，从 task.json 的 status 历史推）
-
-## 维度 2：roadmap（路线图）
-
-从任务的优先级 + 依赖关系（parent/child）整理：
-- **Now**：当前迭代（in_progress 任务）
-- **Next**：P1/P2 且依赖已就绪的任务
-- **Later**：P3 或依赖未就绪的任务
-- 阻塞项单独标出
-
-## 维度 3：health（健康度）
-
-加权评分（满分 5）：
-
-| 指标 | 权重 | 数据源 |
-|------|------|--------|
-| EVA PRD 合格率 | 25% | eval-history.jsonl 最近 10 次 PASS 比例 |
-| 索引新鲜度 | 20% | .index-meta.json 的 last_sync 距今天数 |
-| 按时交付 | 20% | 近期 task finish 是否在计划期内 |
-| 团队同步 | 15% | `team_sync.py status` 的 ahead/behind |
-| 流水线流转 | 10% | task 在各阶段的停留时长 |
-| 学习成长 | 10% | learning 记录条数 |
-
-判定：≥4 健康 / 3–4 有风险 / <3 需关注。
-
-## 团队同步健康（必跑）
-
-```bash
-python .qoder/scripts/team_sync.py status
-```
-看 ahead/behind 是否对齐，未同步产出有几个。
-
-## 输出规则
-
-一段总览 + 三个分维度小节。健康度分数醒目显示。发现问题（如索引过期、
-未同步堆积、EVA 合格率低）在结尾列"建议动作"清单。
+---
+name: wl-status
+description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. 用户说'项目怎么样''进度''健康度''路线图''现在在做什么''整体情况'时触发。"
+trigger: "用户说'项目怎么样''进度''健康度''路线图''整体情况''/wl-status'"
+---
+
+
+## 🔧 仓库根定位（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+
+# wl-status — 项目状态总览
+
+三个维度，用户没指定就全展示：
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `data/index/.index-meta.json` — 图谱新鲜度（健康度计算用）
+- `.qoder/learning/eval-history.jsonl` — EVA 评估历史（健康度趋势用，可能不存在）
+- `workspace/tasks/*/task.json` — 全部任务（current 维度用）
+
+## 维度 1：current（当前迭代）
+
+```bash
+python "$R/.qoder/scripts/task.py" list
+```
+展示：
+- 当前活动任务（标 `*` 的那条）
+- 进行中任务清单 + 各自进度
+- 最近 5 个动作（建任务/finish/PRD 发布等，从 task.json 的 status 历史推）
+
+## 维度 2：roadmap（路线图）
+
+从任务的优先级 + 依赖关系（parent/child）整理：
+- **Now**：当前迭代（in_progress 任务）
+- **Next**：P1/P2 且依赖已就绪的任务
+- **Later**：P3 或依赖未就绪的任务
+- 阻塞项单独标出
+
+## 维度 3：health（健康度）
+
+加权评分（满分 5）：
+
+| 指标 | 权重 | 数据源 |
+|------|------|--------|
+| EVA PRD 合格率 | 25% | eval-history.jsonl 最近 10 次 PASS 比例 |
+| 索引新鲜度 | 20% | .index-meta.json 的 last_sync 距今天数 |
+| 按时交付 | 20% | 近期 task finish 是否在计划期内 |
+| 团队同步 | 15% | `team_sync.py status` 的 ahead/behind |
+| 流水线流转 | 10% | task 在各阶段的停留时长 |
+| 学习成长 | 10% | learning 记录条数 |
+
+判定：≥4 健康 / 3–4 有风险 / <3 需关注。
+
+## 团队同步健康（必跑）
+
+```bash
+python "$R/.qoder/scripts/team_sync.py" status
+```
+看 ahead/behind 是否对齐，未同步产出有几个。
+
+## 🧩 QoderWork 增强：日历校准健康度（可选 · 无连接器则自动回退）
+
+> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors，授权 Microsoft 365 / macOS 日历，邮件可选）。
+> **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，健康度照常按上表纯本地数据计算，不受影响。**
+> 探测方式：仅当运行环境提供了「日历」工具可直接读取时才用。
+
+若日历连接器可用，让「按时交付」「团队同步」两个维度打分更贴近现实：
+- **按时交付**：对照日历里真实的截止事件 / 里程碑会议节点，判断任务是否赶在节点前 finish，比纯靠 task.json 计划期更准
+- **团队同步**：若邮件连接器也可用，把"上级 / 相关方近期是否收到过进度"纳入（近 N 天有无发出进度邮件）
+
+> 仍是可选增强：连接器数据**只用于校准这两个维度的得分**，其余四个维度算法不变。
+> 无连接器时，这两个维度维持原算法（按 task.json 计划期 / team_sync status 计算）。
+
+## 输出规则
+
+一段总览 + 三个分维度小节。健康度分数醒目显示。发现问题（如索引过期、
+未同步堆积、EVA 合格率低）在结尾列"建议动作"清单。

package/templates/qoder/skills/wl-task/SKILL.md

@@ -1,58 +1,132 @@
----
-name: wl-task
-description: "任务管理 + RICE 优先级排序。Task management with RICE prioritization. 用户说'建任务''排优先级''开始做这个''任务做完了''列一下任务''归档'时触发。"
-trigger: "用户说'建任务''排优先级''开始做''做完了''看任务''归档''/wl-task'"
----
-
-# wl-task — 任务管理 + RICE 排序
-
-任务存在 `workspace/tasks/{MM-DD-slug}/`，含 `task.json` + `prd.md` + `implement.jsonl` + `check.jsonl`。
-
-## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-
-- `.qoder/.developer` — 当前开发者（assignee 默认值）
-- `.qoder/.current-task` — 当前活动任务（如有，"开始做"默认对它操作）
-- 列出已有任务：`python .qoder/scripts/task.py list`
-
-## 子命令对照
-
-| 用户说什么 | 跑什么 |
-|-----------|--------|
-| "建个任务 XXX" | `task.py create "XXX" [--slug ...] [--priority P0\|P1\|P2\|P3]` |
-| "列一下任务" / "我的任务" | `task.py list [--mine] [--status in_progress]` |
-| "看下 XXX 任务" | `task.py show <task-dir>` |
-| "开始做 XXX" | `task.py start <task-dir>` |
-| "这个任务做完了" | `task.py finish` |
-| "归档 XXX" | `task.py archive <task-dir>` |
-| "把 A 拆成子任务 B" | `task.py add-subtask <parent> <child>` |
-
-完整用法：
-```bash
-python .qoder/scripts/task.py create "登录优化" --slug login-fix --priority P1
-python .qoder/scripts/task.py start 06-13-login-fix
-python .qoder/scripts/task.py current --source      # 看当前活动任务
-python .qoder/scripts/task.py list --mine --status in_progress
-python .qoder/scripts/task.py finish
-python .qoder/scripts/task.py archive 06-13-login-fix
-python .qoder/scripts/task.py add-subtask 06-13-parent 06-13-child
-```
-
-## RICE 优先级（建/排时自动算）
-
-RICE = Reach × Impact × Confidence ÷ Effort
-- 建任务时若给了 `--priority`，写入 task.json
-- "排优先级"指令：扫所有任务，让用户给每个 R/I/C/E 打分（或从 task.json 读已有值），重算排序
-
-## 完成后同步
-
-`create` 和 `finish` 改了任务状态，要推给团队：
-```bash
-python .qoder/scripts/team_sync.py push
-```
-（脚本会自动 stage workspace/tasks/ 并提交）
-
-## 输出规则
-
-- `list` 结果用表格呈现（任务名 | 状态 | 优先级 | 负责人），当前任务标 `*`
-- `create` 后告诉用户任务目录路径 + 下一步建议（"接 /wl-prd 写需求" 或 "/wl-spec 写规格"）
-- `finish` 后提示是否归档 + 跑 `/wl-report` 出日报
+---
+name: wl-task
+description: "任务管理 + RICE 优先级 + 依赖排期。7 站流水线的'任务'站，产品在这里把 PRD 落成任务。Task management with RICE prioritization. 用户说'建任务''排优先级''开始做这个''任务做完了''列一下任务''归档''排期'时触发。"
+trigger: "用户说'建任务''建个任务''排优先级''开始做''做完了''看任务''列任务''归档''排期''甘特图''/wl-task'"
+---
+
+
+## 🔧 仓库根定位（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+
+# wl-task — 任务管理（7 站之「任务」站 · 产品工位）
+
+> 这是 `/wl-task` 命令的 skill 入口（让 QoderWork 的 `/` 列表也能用）。
+> 完整执行规则见命令 `.qoder/commands/wl-task.md`。
+> **模块契约**（输入/输出/校验）：`.qoder/contracts/task.md`
+> **第一性原理：又快又准。** 快 = 并行评估 RICE + 一次取全任务；准 = PRD 衔接不丢字段 + 三道检查。
+
+## 🚦 动作路由（看用户说啥）
+
+| 用户说什么 | 动作 | 跑什么 |
+|-----------|------|--------|
+| "建个任务 XXX" / "把刚才需求建成任务" / "create" | **create** | `task.py create`（带 PRD 衔接） |
+| "列一下任务" / "我的任务" / "有哪些任务" / "list" | **list** | `task.py list` |
+| "接下来做啥" / "能做的有哪些" | **list --ready** | 只看能立刻开始的 |
+| "卡住的有哪些" / "哪些被阻塞" | **list --blocked** | 只看有未完成依赖的 |
+| "看下 XXX 任务" / "XXX 怎么样了" / "show" | **show** | `task.py show <名>` |
+| "开始做 XXX" / "启动 XXX" / "start" | **start** | `task.py start <名>` |
+| "这个任务做完了" / "完成了" / "finish" | **finish** | `task.py finish` |
+| "归档 XXX" / "archive" | **archive** | `task.py archive <名>` |
+| "排优先级" / "排一下" / "rank" | **rank** | RICE 评估（AI 层） |
+| "排期" / "甘特图" / "排个日期" / "plan" | **plan** | `task.py gantt` + set-due |
+| 模糊 / 拿不准 | 先 list 给全貌 | 再问要操作哪个 |
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者（assignee 默认值）
+- `.qoder/.current-task` — 当前活动任务（"开始做""完成了"默认对它操作）
+- 列出已有任务：`python "$R/.qoder/scripts/task.py" list`
+- 衔接 PRD：扫 `workspace/members/{dev}/drafts/REQ-*.md` + `data/docs/prd/REQ-*.md`
+
+## 🔒 三道前置检查（任何动作前先做，保证健壮）
+
+1. **身份检查**：`.developer` 缺失 → 停下，提示先 `/wl-init`，不继续（否则 create 会把 assignee 写空）。
+2. **空数据兜底**：tasks 目录不存在/空 → 读操作友好提示"还没有任务"，不报错；create 直接建。
+3. **脚本退出码**：`task.py` 返回非 0 → 原样读 stderr 告诉用户。`4`=权限不足（零信任 ACL），`1`=任务不存在/JSON 缺失。**绝不绕过 ACL。**
+
+## 执行
+
+按选中动作，读 `.qoder/commands/wl-task.md` 对应段落执行。核心纪律：
+
+**create（最高频）—— PRD 衔接不丢字段：**
+- 有 PRD → 从 PRD 提取标题/模块/验收点，**别让用户重述**；把 REQ-ID 记进 task.json 的 `tags`。
+- 无 PRD → 用用户给的一句话当标题。
+- 建完 push：`python "$R/.qoder/scripts/team_sync.py" push`
+
+**rank（RICE）—— 一次取全，别逐个问：**
+1. `task.py list --status planning` 拿全待排任务
+2. AI 基于 PRD **先估**每个的 R/I/C/E（标注信心来源）
+3. 算 RICE 排序展示，问用户要调整哪个
+4. 写回每个 task.json 的 `rice` 字段（Edit 工具）
+
+**plan（排期/依赖）—— 脚本已支持增强能力：**
+- `task.py set-due <任务> <YYYY-MM-DD>` 截止日期
+- `task.py block <A> <B>` / `unblock <A> <B>` 依赖（循环依赖自动检测）
+- `task.py gantt [--weeks 4]` 甘特图（只排有日期的，自动标逾期）
+
+## RICE 公式与口径
+
+RICE = Reach × Impact × Confidence ÷ Effort
+
+| 维度 | 估法 | 分值参考 |
+|------|------|----------|
+| R 触达 | 影响多少用户/订单（看 PRD 用户画像） | 1=少 / 10=全员 |
+| I 影响 | 对核心目标贡献度（看 PRD 目标指标） | 0.5=弱 / 3=强 |
+| C 信心 | 有数据/竞品支撑？还是拍脑袋？ | 50%=猜 / 100%=有据 |
+| E 工作量 | 几个人周（看 PRD 功能点数量） | 1=小 / 5=大 |
+
+排不动时的兜底：任务缺 PRD → 诚实说估不准，建议补 PRD 或手动 P0-P3。
+
+## 🔒 create 的三道质量检查（建完顺手提醒，非阻塞）
+
+| 检查 | 查什么 | 不过怎么办 |
+|------|--------|-----------|
+| ① 衔接锁 | tags 有 REQ-ID？标题对上 PRD？ | 补 REQ-ID，提示从 PRD 复制验收点 |
+| ② 归属锁 | assignee 是谁？ | 为空 → 问"指派给谁？" |
+| ③ 阻塞锁 | 依赖标对了吗？ | 列可能依赖，问"要不要 block 上？" |
+
+## Storage
+
+```
+任务目录 → workspace/tasks/{MM-DD-slug}/
+  ├── task.json  (状态/优先级/RICE/依赖/assignee/tags[REQ-ID])
+  ├── prd.md     (PRD 模板或引用已有 PRD)
+  ├── implement.jsonl / check.jsonl
+归档 → .qoder/archive/{YYYY-MM}/{MM-DD-slug}/
+活跃指针 → .qoder/.current-task
+```
+
+## 完成后同步
+
+`create` / `finish` / `archive` 改了任务状态，都要推给团队（用户永不碰 git）：
+```bash
+python "$R/.qoder/scripts/team_sync.py" push
+```
+
+## 🧩 QoderWork 增强：待办双向同步（可选 · 无连接器则自动回退）
+
+> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors，授权 Microsoft 365 待办 / OneNote，或 macOS 提醒事项）。
+> **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，任务只在本地 task.json 管理，完全够用。**
+> 探测方式：仅当运行环境提供了「待办 / To-Do」工具可直接读写时才用。
+
+若待办连接器可用，让任务在本地之外也可见、可提醒（非必须，纯锦上添花）：
+- `create` 带截止时间的任务后 → 同步为一条待办，标题 `【WL】<任务名>`，截止日用 task.json 的 due
+- `finish` 任务后 → 把对应待办标记为已完成
+- `archive` 任务 → 归档对应待办（不删除，留痕）
+
+> 回退保证：同步失败 / 无连接器**绝不影响本地任务状态**，只补一句 `[待办未同步：非 QoderWork 或未授权连接器]` 提示。
+> 本地 task.json 永远是唯一事实源（single source of truth），连接器只是它的一个"投影"。
+
+## 输出规则
+
+- `list` 结果用表格呈现（优先级 | 状态 | 任务 | 负责人 | 标题 | 备注），当前任务标 `*`
+- `create` 后告诉用户任务目录路径 + 下一步建议（"接 /wl-prd-full 写需求" 或 "/wl-code 写代码"）
+- `finish` 后提示是否归档 + 看下个 `--ready` 的任务
+- 任何脚本非 0 退出 → 原样转述错误，不吞
+
+详细执行规则见 `.qoder/commands/wl-task.md`。