harveyz-skill 0.1.0

package/skills/task/pm-task-dispatch/references/task-template.md

@@ -0,0 +1,145 @@
+# Task 工单标准
+
+> 参考：`methodology/multiagent-task/SPEC.md`
+
+## 目录结构
+
+每个任务创建独立文件夹，文件夹以任务号命名：
+
+```
+tasks/
+└── <id>/
+    └── task.md
+```
+
+示例：`tasks/T001/task.md`
+
+id 全局唯一，全局递增。
+
+---
+
+## Frontmatter 字段
+
+| 字段 | 格式 | 必填 | 说明 |
+|------|------|------|------|
+| `id` | `T001` | ✅ | 全局唯一编号 |
+| `project` | 项目名 | ✅ | 对应 projects 下的项目 |
+| `assignee` | `openclaw/<agent>` 或 `<外部AI>` | ✅ | 派发目标 |
+| `assigner` | `openclaw/<agent>` | ✅ | 派发者 |
+| `priority` | low / medium / high / xhigh | ✅ | |
+| `status` | open / done | ✅ | |
+
+### assignee 格式规范
+
+- **OpenClaw 内部 Agent**：`openclaw/<agent>`，如 `openclaw/coding-master`、`openclaw/writing-assistant`
+- **外部 AI 工具**：直接写工具名，如 `claude`、`cursor`
+
+### assigner 格式规范
+
+- 仅限 OpenClaw 内部 Agent：`openclaw/<agent>`
+
+### status 流转
+
+```
+open → done
+```
+
+---
+
+## 正文章节
+
+### 主要目标（必填）
+
+agent 要完成的核心目标。
+
+### 关键约束（必填）
+
+agent 必须遵守的约束条件。
+
+### 工作流（可选）
+
+agent 可参考的工作流步骤。
+
+### 使用工具（可选）
+
+agent 可以使用的工具列表。
+
+### 评估标准（可选）
+
+评估任务完成质量的标准，格式为 `[ ] 子项`。
+
+### 资料管理（可选）
+
+相关的文档或资料路径。
+
+---
+
+## 完整示例
+
+```yaml
+---
+id: T003
+project: openclaw-voice-commands
+assignee: openclaw/research-scientist
+assigner: openclaw/product-manager
+priority: high
+status: open
+---
+
+## 主要目标
+
+研究将 Discord 语音频道音频实时转换为 OpenClaw 可执行命令的完整方案，**仅评估本地 STT 方案**。
+
+## 关键约束
+
+1. 不考虑云原生 STT（Deepgram、OpenAI Whisper API 等）
+2. 仅评估本地转录模型
+3. 延迟目标 < 3s（端到端）
+
+## 工作流
+
+1. 语音采集方案调研（Discord Bot / API / Webhook）
+2. 本地 STT 模型选型对比（faster-whisper / whisper.cpp）
+3. 实时流式处理可行性分析
+4. 量化版本性能评估（INT8 / INT4）
+5. 技术架构设计
+6. 风险与可行性评估
+
+## 使用工具
+
+- web_search / web_fetch
+- 本地 faster-whisper 测试
+- OpenClaw sessions_send
+
+## 评估标准
+
+- [ ] 提供至少 2 种可对比的技术方案
+- [ ] 每种方案包含完整链路（采集→识别→理解→执行）
+- [ ] 给出明确推荐结论
+- [ ] 量化延迟和资源消耗
+
+## 资料管理
+
+- 任务目录：`~/Projects/project-management/tasks/T003/`
+- 项目目录：`~/Projects/project-management/projects/openclaw-voice-commands/`
+- 灵感记录：`memory/2026-04-04.md`
+```
+
+---
+
+## 与 Issue 的区别
+
+| 维度 | Task 工单 | Issue |
+|------|-----------|-------|
+| 位置 | `tasks/` | `projects/{project}/issues/` |
+| 用途 | 任务派发与执行追踪 | 项目问题追踪 |
+| 派发 | PM → Agent | 任意创建 |
+| 状态 | open → in_progress → done | open → closed |
+
+---
+
+## Task vs Issue vs Learn
+
+- **Task**：PM 派发给其他 Agent 的任务工单
+- **Issue**：项目中需要追踪的问题（bug/需求/里程碑）
+- **Learn**：需要深入学习的独立主题

package/skills/task/task-close/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: task-close
+description: 任务收尾技能。当 Agent 完成接受的任务后自触发，执行任务验收、总结、文档归档和问题记录。触发条件：Agent 已实际完成任务，需要进行收尾工作时使用。
+---
+
+# Task Acceptance - 任务收尾技能
+
+当 Agent 完成接受的任务后，自执行收尾流程。
+
+## 路径约定
+
+```
+任务文件夹：    ~/Projects/project-management/tasks/<id>/
+任务文件：      ~/Projects/project-management/tasks/<id>/task.md         （PM 写，Agent 只更新 frontmatter）
+完成报告：      ~/Projects/project-management/tasks/<id>/completion-report.md  （Agent 写）
+问题记录：      ~/Projects/project-management/tasks/<id>/lessons-learned.md    （Agent 写，可选）
+```
+
+## 触发条件
+
+Agent 已实际完成任务，满足以下任一条件：
+- 任务所有子项已完成
+- 主要目标已实现
+- 接收到 Harvey 或 PM 的收尾指令
+
+## 工作流
+
+```
+1. 任务验收 → 2. 任务总结 → 3. 文档归档 → 4. 问题记录 → 5. 发送完成通知
+```
+
+---
+
+## Step 1：任务验收
+
+**核心原则：必须实际执行并验证，不能仅凭印象判断。**
+
+### 读取任务文件
+
+读取任务文件（`~/Projects/project-management/tasks/<id>/task.md`）。
+
+**文件不存在时：** 停止收尾流程，向 Harvey 或 PM 报告：
+```
+任务文件 tasks/<id>/task.md 不存在，无法执行收尾。
+请确认任务编号是否正确，或由 PM 补充任务文件后重试。
+```
+
+### 生成评估标准（如任务文件无评估标准章节）
+
+Agent 根据任务主要目标，设计合理的评估标准：
+
+```markdown
+## 评估标准
+
+- [ ] <评估项1> - 对应主要目标的第1个子目标
+- [ ] <评估项2> - 对应主要目标的第2个子目标
+- [ ] <评估项3> - 关键约束的满足情况
+```
+
+设计原则：
+- 每个主要目标对应至少 1 个评估项
+- 每个关键约束对应至少 1 个评估项
+- 评估项可验证、可判定通过/不通过
+
+### 逐一验证
+
+- `[ ]` 子项 → 标记为 `[x]` 并说明验证方法和结果
+- 无法验证的子项 → 评估：1. 是否合理（验证方法本身是否正确）2. 是否代表任务失败（未验证 ≠ 未完成，如因外部依赖缺失则不算失败）
+
+### 输出验收报告
+
+创建 `completion-report.md`，写入验收报告（详见 [output-templates.md](references/output-templates.md)）。
+
+---
+
+## Step 2：任务总结
+
+在 `completion-report.md` 中追加任务总结章节（详见 [output-templates.md](references/output-templates.md)）。
+
+更新 `task.md` frontmatter（仅此两个字段，其他内容不动）：
+
+```yaml
+---
+status: done
+completed: YYYY-MM-DD
+---
+```
+
+---
+
+## Step 3：文档归档
+
+### 评估标准
+
+文档满足以下任一条件时，必须归档：
+- 是任务产出的核心交付物
+- 对后续工作有参考价值
+- 包含关键决策或配置
+
+### 归档流程
+
+1. 扫描任务过程中产生的文档
+2. 评估每份文档的价值
+3. 必要文档保存到任务文件夹（`tasks/<id>/`）
+4. 在 `completion-report.md` 中更新 Reference 章节（总索引表，包含所有任务相关文档）
+
+---
+
+## Step 4：问题记录
+
+判断是否有内容可记录（遇到问题、做了关键决策、有经验教训）：
+
+- **有内容** → 创建 `~/Projects/project-management/tasks/<id>/lessons-learned.md`，记录实际有价值的内容，跳过空表格（详见 [output-templates.md](references/output-templates.md)）。路径同步更新到 `completion-report.md` Reference 章节。
+- **没有内容** → 跳过，不创建文件。
+
+---
+
+## Step 5：发送完成通知
+
+收尾全部完成后，在 Agent 自己绑定的 Discord channel 发送任务完成消息：
+
+```
+任务 <id> 已完成。
+任务文件：tasks/<id>/task.md
+```
+
+---
+
+## 输出清单
+
+完成收尾后，任务文件夹应包含：
+
+| 文件 | 内容 | 必须 |
+|------|------|------|
+| `task.md` | frontmatter 更新为 `status: done`、`completed: YYYY-MM-DD` | ✅ |
+| `completion-report.md` | 验收报告 + 任务总结 + Reference 章节 | ✅ |
+| `lessons-learned.md` | 问题记录（有内容才创建） | 可选 |
+
+---
+
+## 注意事项
+
+1. **验收必须实际执行**——禁止仅凭印象打勾，必须说明验证方法
+2. **无评估标准时自行设计**——基于主要目标和关键约束设计可验证的评估项
+3. **任务文件不存在时自创建**——根据接受的任务信息补全主要结构
+4. **无法验证≠任务失败**——因外部依赖缺失导致无法验证的子项，如验证方法本身合理，则不算任务失败
+5. **如实记录**——问题就是问题，不要美化，经验就是经验，不要夸张
+6. **文档路径要准确**——方便后续快速定位

package/skills/task/task-close/references/output-templates.md

@@ -0,0 +1,76 @@
+# Output Templates
+
+> 任务收尾技能 output 模板参考
+
+---
+
+## completion-report.md 模板
+
+```markdown
+---
+task_id: <id>
+completed: YYYY-MM-DD
+---
+
+## 验收报告
+
+- [x] <验收项1> - 验证方法：<具体执行了什么>
+- [x] <验收项2> - 验证方法：<具体执行了什么>
+- [ ] <验收项3> - 未通过原因：<如实记录>
+
+## 任务总结
+
+### 实现方案
+
+<简要描述采用了什么方案、技术路径、关键实现点>
+
+### 执行结果
+
+<描述实际完成情况，与目标的对比>
+
+### 产出清单
+
+- <产出物1>：<路径或说明>
+- <产出物2>：<路径或说明>
+
+## Reference
+
+| 文档 | 功能 | 路径 |
+|------|------|------|
+| <文档名> | <描述文档用途> | <相对路径或绝对路径> |
+```
+
+---
+
+## lessons-learned.md 模板
+
+只记录实际存在的内容，没有的章节直接省略。
+
+```markdown
+# <任务ID> 复盘
+
+## 问题与对策
+
+| 问题 | 对策 | 结果 |
+|------|------|------|
+| <问题描述> | <采用的解决方案> | <效果如何> |
+
+## 关键决策
+
+| 决策 | 背景 | 选择 | 理由 |
+|------|------|------|------|
+| <决策内容> | <当时情况> | <选择了什么方案> | <为什么这样选> |
+
+## 经验教训
+
+<自由文本，记录下次可以改进的点>
+```
+
+---
+
+## task.md frontmatter 更新（收尾时只改这两个字段）
+
+```yaml
+status: done
+completed: YYYY-MM-DD
+```