tackle-harness 0.0.2

package/plugins/core/skill-checklist/skill.md

@@ -0,0 +1,115 @@
+---
+name: checklist
+description: Use when user says "运行检查", "执行清单", "检查清单", or after completing a work package to verify quality
+---
+
+# Checklist
+
+开发完成质量检查技能。
+
+## When to Use
+- 用户说 "运行检查" / "执行清单" / "检查清单"
+- **每个工作包完成后自动执行**
+- 提交代码前的最终检查
+
+- 功能开发后验证质量
+- Bug 修复后验证修复效果
+
+## Flow
+```dot
+digraph checklist {
+    rankdir=LR;
+    node [shape=box]; label="读取 CHECKLIST.md";
+
+    "读取 CHECKLIST.md" -> "匹配 EXPERIENCE.md";
+    "匹配 EXPERIENCE.md" [shape=box];
+    "匹配 EXPERIENCE.md" -> "执行检查项";
+    "执行检查项" [shape=box];
+    "执行检查项" -> "有问题?";
+    "有问题?" [shape=diamond];
+    "有问题?" -> "查阅经验库" [label="是"];
+    "有问题?" -> "生成报告" [label="否"];
+    "查阅经验库" [shape=box];
+    "查阅经验库" -> "修复问题";
+    "修复问题" [shape=box];
+    "修复问题" -> "生成报告";
+    "生成报告" [shape=box];
+}
+```
+
+## Checklist Categories
+
+### 1. 代码质量检查
+- [ ] 代码符合 GDScript 规范
+- [ ] 无编译错误/警告
+- [ ] 公共函数有文档注释
+- [ ] 无 ERROR 输出
+
+- [ ] 无重复 WARNING
+
+- [ ] 临时调试代码已移除
+
+### 2. 测试检查
+- [ ] 测试用例已编写
+- [ ] 测试全部通过
+- [ ] 边界情况已覆盖
+- [ ] 测试文件语法正确
+
+### 3. 文档检查
+- [ ] PROGRESS.md 已更新
+- [ ] task.md 状态已更新
+- [ ] 工作包清单已更新
+- [ ] 新增函数有注释
+- [ ] 复杂逻辑有说明
+
+### 4. Git 检查
+- [ ] git status 确认变更范围
+- [ ] 无误提交文件
+- [ ] 提交信息格式正确
+- [ ] 包含 Co-Authored-By
+
+### 5. 经验记录
+- [ ] 遇到的问题已记录到 EXPERIENCE.md
+- [ ] 解决方案已记录
+- [ ] 可复用的模式已提取
+- [ ] 新发现的坑已添加到 CHECKLIST.md
+
+## Experience Matching Rules
+
+根据工作类型自动匹配相关经验：
+
+| 工作类型 | 匹配标签 |
+|----------|----------|
+| 修复脚本错误 | [脚本调试], [API兼容] |
+| 创建/修改场景 | [场景设计], [UI/UX] |
+| 系统重构 | [系统架构], [性能优化] |
+| 添加美术资源 | [美术资源] |
+| 调试运行问题 | [脚本调试], [工具使用] |
+
+## Report Template
+```markdown
+## 工作包完成检查报告
+
+**工作包**: WP-XXX
+**检查时间**: YYYY-MM-DD HH:mm
+
+### 检查结果
+| 类别 | 通过/总数 | 状态 |
+|------|----------|------|
+| 代码质量 | X/X | ✅/❌ |
+| 测试检查 | X/X | ✅/❌ |
+| 文档检查 | X/X | ✅/❌ |
+| Git 检查 | X/X | ✅/❌ |
+| 经验记录 | X/X | ✅/❌ |
+
+### 未通过项
+- [ ] 检查项 - 原因
+
+### 建议后续操作
+1. ...
+```
+
+## Important
+- **每个工作包完成后必须执行此检查清单**
+- 检查未通过时，应修复后再提交
+- 经验记录有助于避免重复踩坑

package/plugins/core/skill-completion-report/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "skill-completion-report",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "工作包完成报告 Skill - 标准化汇报与询问机制，生成单工作包/批量/简化完成报告，强制文档同步与门控验证",
+  "triggers": ["完成报告", "completion-report", "工作包完成", "completion report", "work package complete"],
+  "dependencies": ["provider:state-store"],
+  "provides": ["skill:completion-report"],
+  "config": {}
+}

package/plugins/core/skill-completion-report/skill.md

@@ -0,0 +1,331 @@
+---
+name: completion-report
+description: Use when completing a work package or batch of tasks - generates standardized completion report and asks for next steps. Triggers after work package execution or when user says "汇报结果".
+---
+
+<HARD-GATE>
+After generating the completion report, you MUST ask "下一步安排是什么？" and wait for user instruction.
+Do NOT assume what the user wants to do next.
+This is not negotiable.
+</HARD-GATE>
+
+# Completion Report
+
+工作包/批次完成后的标准化汇报与询问机制。
+
+## When to Use
+
+**自动触发场景**:
+- 工作包执行完成后
+- 批量工作包完成后
+- checklist 检查通过后
+
+**手动触发词**:
+- "汇报结果" / "完成报告"
+- "执行完毕" / "任务完成"
+- "总结一下" / "汇报"
+
+## Red Flags - STOP
+
+| Thought | Reality |
+|---------|---------|
+| "用户应该知道接下来做什么" | 必须明确询问 |
+| "直接开始下一个任务" | 需要用户确认 |
+| "汇报完就结束" | 必须询问下一步 |
+| "结果很好，不用问了" | 任何情况都要问 |
+
+## Flow
+
+```dot
+digraph completion {
+    rankdir=TB;
+
+    "任务完成" [shape=box];
+    "收集执行结果" [shape=box];
+    "生成标准化报告" [shape=box];
+    "同步所有文档状态" [shape=box, style=filled, fillcolor=orange];
+    "运行门控验证" [shape=box, style=filled, fillcolor=red];
+    "执行 checklist" [shape=box];
+    "记录经验" [shape=box];
+    "询问下一步" [shape=box, style=filled, fillcolor=yellow];
+    "🛑 等待指令" [shape=box, style=filled, fillcolor=red];
+
+    "任务完成" -> "收集执行结果";
+    "收集执行结果" -> "生成标准化报告";
+    "生成标准化报告" -> "同步所有文档状态";
+    "同步所有文档状态" -> "运行门控验证";
+    "运行门控验证" -> "执行 checklist" [label="通过"];
+    "运行门控验证" -> "同步所有文档状态" [label="失败，修复"];
+    "执行 checklist" -> "记录经验";
+    "记录经验" -> "询问下一步";
+    "询问下一步" -> "🛑 等待指令";
+}
+```
+
+## 强制文档同步
+
+**关键步骤** - 生成报告后必须同步更新以下文档状态：
+
+| 文档 | 用途 | 必须同步 |
+|------|------|----------|
+| `task.md` | 任务清单（主索引） | ✅ |
+| `docs/wp/WP-XXX.md` | 工作包详情 | ⚠️ 如存在 |
+
+**同步内容**：
+- 更新工作包状态：`📋 待开始` → `✅ 已完成`
+- 添加完成日期
+- 更新任务列表中的复选框
+
+**同步时机**：在生成报告后、执行 checklist 前必须完成
+
+### 状态同步验证 (不可跳过)
+
+同步完成后，必须执行以下验证：
+
+```bash
+# 验证 task.md 状态已更新
+grep "WP-XXX" task.md | grep "✅ 完成"
+```
+
+| 验证结果 | 处理 |
+|----------|------|
+| ✅ 找到 | 继续执行 checklist |
+| ❌ 未找到 | **停止！** 重新执行状态同步 |
+
+**这是硬性要求，不可跳过。**
+
+## 代码门控验证（必须）
+
+**同步完成后必须运行门控验证**：
+
+```bash
+node .claude/validators/skill-gate.js completion-report WP-XXX
+```
+
+| 结果 | 处理 |
+|------|------|
+| ✅ 通过 | 继续执行 checklist |
+| ❌ 失败 | 必须修复文档状态，重新验证 |
+
+**这是硬性要求，不可跳过。**
+
+## Report Types
+
+### 1. 单个工作包完成报告
+
+```markdown
+帅哥，工作包执行完成！
+
+## 📦 WP-XXX: 工作包名称
+
+### 执行结果
+| 任务ID | 任务名称 | 状态 | 说明 |
+|--------|----------|------|------|
+| XXX-001 | 任务1 | ✅ 完成 | - |
+| XXX-002 | 任务2 | ✅ 完成 | - |
+
+### 创建/修改的文件
+```
+scripts/xxx.gd          # 新增
+scenes/xxx.tscn         # 修改
+test/unit/test_xxx.gd   # 新增
+```
+
+### 验收标准完成情况
+- [x] XXX-001-A1: 验收项1
+- [x] XXX-001-A2: 验收项2
+- [x] XXX-002-A1: 验收项1
+
+### 测试结果
+- 单元测试: ✅ 5/5 通过
+- 集成测试: ✅ 3/3 通过
+
+### 检查结果
+| 类别 | 通过/总数 | 状态 |
+|------|----------|------|
+| 代码质量 | 5/5 | ✅ |
+| 测试检查 | 4/4 | ✅ |
+| 文档检查 | 3/3 | ✅ |
+| Git 检查 | 2/2 | ✅ |
+
+### 遇到的问题与解决
+- **问题**: [问题描述]
+- **解决**: [解决方案]
+
+---
+🔴 **下一步安排是什么？**
+```
+
+### 2. 批量工作包完成报告
+
+```markdown
+帅哥，本批次工作包执行完成！
+
+## 📊 执行总览
+
+| 工作包 | 状态 | 子任务 | 测试 | 说明 |
+|--------|------|--------|------|------|
+| WP-XXX | ✅ 完成 | 3/3 | 9/9 | - |
+| WP-YYY | ✅ 完成 | 2/2 | 6/6 | - |
+| WP-ZZZ | ❌ 阻塞 | 1/3 | 2/6 | 依赖未满足 |
+
+### 统计
+- **总工作包**: 3 个
+- **完成**: 2 个
+- **阻塞**: 1 个
+- **总耗时**: 约 Xh
+- **测试通过率**: 17/21 (81%)
+
+## ❌ 未完成项
+
+### WP-ZZZ: 工作包名称
+- **阻塞原因**: 依赖 WP-AAA 未完成
+- **需要**: [具体依赖内容]
+- **建议**: 先完成 WP-AAA
+
+## 📁 文件变更汇总
+```
+新增文件:
+  scripts/aaa.gd
+  scripts/bbb.gd
+  test/unit/test_aaa.gd
+
+修改文件:
+  scenes/main.tscn
+  scripts/manager.gd
+```
+
+## 💡 经验总结
+- [经验1]: 描述
+- [经验2]: 描述
+
+## 📋 下一步建议
+
+**优先级排序**:
+1. 完成 WP-AAA（解除 WP-ZZZ 阻塞）
+2. 继续执行 WP-ZZZ
+3. 开始新的工作包 WP-BBB
+
+---
+🔴 **下一步安排是什么？**
+```
+
+### 3. 简化完成报告（单任务快速汇报）
+
+```markdown
+帅哥，任务完成！
+
+## ✅ 完成内容
+- [具体完成的内容1]
+- [具体完成的内容2]
+
+## 📁 变更文件
+- `scripts/xxx.gd` - 修改
+- `test/unit/test_xxx.gd` - 新增
+
+## ✅ 测试状态
+- 全部通过 (X/X)
+
+---
+🔴 **下一步安排是什么？**
+```
+
+## Required Elements
+
+每个完成报告必须包含：
+
+| 元素 | 说明 | 必需 |
+|------|------|------|
+| 执行结果表 | 任务完成状态 | ✅ |
+| 文件变更 | 创建/修改的文件 | ✅ |
+| 测试状态 | 测试通过情况 | ✅ |
+| 检查结果 | checklist 结果 | ✅ |
+| 文档同步 | PROGRESS.md + task.md | ✅ **必须** |
+| 未完成项 | 阻塞/失败原因 | ⚠️ 如有 |
+| 下一步建议 | 建议的后续操作 | ⚠️ 可选 |
+| 询问下一步 | "下一步安排是什么？" | ✅ 必须 |
+
+## 清理状态验证（批量执行后必须）
+
+**如果本次执行使用了 agent-dispatcher（批量执行）**，报告必须包含清理状态：
+
+```markdown
+## 🧹 清理状态
+
+- TeamDelete: ✅ 已执行 / ❌ 未执行
+- 团队名称: {team_name}
+- 清理时间: {cleanup_time}
+```
+
+**如果 TeamDelete 未执行**，报告必须包含警告：
+
+```markdown
+⚠️ **警告**: TeamDelete 未执行，存在资源泄漏风险！
+建议手动执行清理命令："清理团队"
+```
+
+### 清理验证方法
+
+```bash
+# 验证团队目录已删除
+ls ~/.claude/teams/{team_name}/ 2>/dev/null
+# 应该返回 "No such file or directory"
+```
+
+| 验证结果 | 处理 |
+|----------|------|
+| ✅ 目录不存在 | 清理成功，继续报告 |
+| ❌ 目录存在 | 在报告中标注警告，建议手动清理 |
+
+## Question Templates
+
+必须使用以下询问模板之一：
+
+- 🔴 **下一步安排是什么？**
+- 🔴 **请问接下来要做什么？**
+- 🔴 **您希望我继续做什么？**
+
+## Response Handling
+
+### 继续执行类
+- "继续执行 WP-XXX" → 开始执行指定工作包
+- "按你的建议来" → 执行建议的下一步
+
+### 新任务类
+- "创建任务..." → 调用 task-creator
+- "先处理 XXX" → 切换到新任务
+
+### 暂停类
+- "先停一下" / "等等" → 保持等待状态
+- "今天到这里" → 记录进度，结束会话
+
+### 修改类
+- "XXX 需要改一下" → 处理修改意见
+
+## Integration with Other Skills
+
+```dot
+digraph integration {
+    rankdir=LR;
+
+    "工作包完成" [shape=box];
+    "completion-report" [shape=box, style=filled, fillcolor=lightblue];
+    "checklist" [shape=box];
+    "experience-logger" [shape=box];
+    "human-checkpoint" [shape=box];
+    "用户指令" [shape=box];
+
+    "工作包完成" -> "completion-report";
+    "completion-report" -> "checklist";
+    "completion-report" -> "experience-logger";
+    "completion-report" -> "human-checkpoint";
+    "human-checkpoint" -> "用户指令";
+}
+```
+
+## Forbidden Actions
+
+- ❌ 不要在报告后直接开始新任务
+- ❌ 不要假设用户想要什么
+- ❌ 不要省略询问下一步
+- ❌ 不要忽略未完成项

package/plugins/core/skill-experience-logger/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "skill-experience-logger",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "经验记录与提取 Skill - 分类记录开发经验教训，支持角色专属经验库和双重写入策略",
+  "triggers": ["总结经验", "记录经验", "这次学到了", "experience-logger", "log experience", "lessons learned"],
+  "dependencies": ["provider:memory-store"],
+  "provides": ["skill:experience-logger"],
+  "config": {}
+}

package/plugins/core/skill-experience-logger/skill.md

@@ -0,0 +1,235 @@
+---
+name: experience-logger
+description: Use when user says "总结经验", "记录经验", "这次学到了", or after solving a significant problem that should be documented for future reference
+---
+
+# Experience Logger (增强版)
+
+将开发过程中的经验教训分类记录，**支持角色专属经验库**，实现角色进化。
+
+## When to Use
+- 用户说 "总结经验" / "记录经验" / "这次学到了"
+- 解决了一个重要问题后
+- 发现了一个值得记录的坑
+- **每个工作包完成后应该执行**
+- **子代理执行完成后自动调用**
+
+## Flow (增强版)
+```dot
+digraph exp_logger {
+    rankdir=TB;
+
+    "回顾对话上下文" [shape=box];
+    "识别问题和解决方案" [shape=box];
+    "选择分类标签" [shape=box];
+    "匹配相关角色" [shape=box, style=filled, fillcolor=lightblue];
+    "格式化经验记录" [shape=box];
+    "写入角色专属库" [shape=box, style=filled, fillcolor=lightblue];
+    "同步到 EXPERIENCE.md" [shape=box];
+    "更新角色统计" [shape=box];
+    "确认完成" [shape=box];
+
+    "回顾对话上下文" -> "识别问题和解决方案";
+    "识别问题和解决方案" -> "选择分类标签";
+    "选择分类标签" -> "匹配相关角色";
+    "匹配相关角色" -> "格式化经验记录";
+    "格式化经验记录" -> "写入角色专属库";
+    "写入角色专属库" -> "同步到 EXPERIENCE.md";
+    "同步到 EXPERIENCE.md" -> "更新角色统计";
+    "更新角色统计" -> "确认完成";
+}
+```
+
+---
+
+## 角色进化机制
+
+### 标签到角色映射
+
+#### 核心角色映射（通用框架）
+
+| 标签 | 关联角色 |
+|------|----------|
+| `[架构设计]` | `architect` |
+| `[系统设计]` | `architect` |
+| `[模块划分]` | `architect` |
+| `[代码实现]` | `implementer` |
+| `[功能开发]` | `implementer` |
+| `[Bug修复]` | `implementer` |
+| `[重构]` | `implementer` |
+| `[调试]` | `implementer` |
+| `[测试验证]` | `tester` |
+| `[单元测试]` | `tester` |
+| `[集成测试]` | `tester` |
+| `[测试框架]` | `tester` |
+| `[文档编写]` | `documenter` |
+| `[API文档]` | `documenter` |
+| `[用户指南]` | `documenter` |
+| `[性能优化]` | `architect`, `implementer` |
+| `[项目管理]` | `coordinator` |
+
+#### 领域角色映射（由项目模板扩展）
+
+| 标签 | 关联角色 |
+|------|----------|
+| `[UI/UX]` | `frontend-dev` (web模板) |
+| `[前端开发]` | `frontend-dev` (web模板) |
+| `[API设计]` | `backend-dev` (web模板) |
+| `[数据库]` | `backend-dev` (web模板) |
+| `[部署]` | `devops` (devops模板) |
+| `[CI/CD]` | `devops` (devops模板) |
+| `[场景设计]` | `godot-scene-expert` (godot模板) |
+| `[脚本调试]` | `godot-script-expert` (godot模板) |
+
+### 双重写入策略
+
+1. **写入角色专属库** (`.claude/agents/memories/{role_id}.md`)
+   - 精准匹配角色
+   - 作为子代理记忆注入源
+
+2. **同步到 EXPERIENCE.md**
+   - 全局知识库
+   - 作为回退经验源
+
+---
+
+## Tags Reference
+
+### 分类标签
+
+| 标签 | 适用场景 | 关联角色 |
+|------|----------|----------|
+| `[脚本调试]` | GDScript 语法、逻辑错误、运行时问题 | godot-script-expert |
+| `[场景设计]` | 节点组织、场景结构、预制体设计 | godot-scene-expert |
+| `[系统架构]` | 模块划分、设计模式、代码组织 | combat-ai-expert |
+| `[UI/UX]` | 用户界面、交互设计、反馈系统 | godot-scene-expert |
+| `[美术资源]` | 精灵、动画、材质、音效 | effect-expert |
+| `[性能优化]` | 帧率、内存、加载时间 | godot-script-expert |
+| `[API兼容]` | Godot 版本差异、API 变更 | godot-script-expert |
+| `[工具使用]` | MCP 工具、编辑器技巧、命令行 | test-reviewer |
+| `[项目管理]` | Git、版本控制、工作流程 | test-reviewer |
+
+---
+
+## Execution Instructions
+
+### 1. 识别经验
+
+从对话上下文中提取：
+- 遇到的主要问题是什么？
+- 错误信息是什么？（如有）
+- 解决方案是什么？
+- 是否有可复用的价值？
+
+### 2. 选择标签
+
+根据问题类型选择合适的分类标签。
+
+### 3. 匹配角色
+
+根据标签查找关联的角色（参考上方映射表）。
+
+### 4. 格式化记录
+
+```markdown
+### [标签名称] 经验标题
+
+**错误信息**: (如有)
+```
+错误内容
+```
+
+**问题描述**: 简要描述问题
+
+**解决方案**: 具体的解决方案（含代码示例）
+
+**适用场景**: (可选) 在什么情况下适用
+
+**来源工作包**: WP-XXX
+**记录日期**: YYYY-MM-DD
+```
+
+### 5. 写入角色专属库
+
+路径：`.claude/agents/memories/{role_id}.md`
+
+追加到 `## 经验列表` 部分的末尾。
+
+### 6. 同步到 EXPERIENCE.md
+
+路径: `docs/EXPERIENCE.md`
+
+追加到对应标签分类下，并更新经验索引表。
+
+### 7. 更新角色统计
+
+更新角色专属库头部的统计信息：
+```markdown
+## 统计
+- 总经验数: X
+- 最后更新: YYYY-MM-DD
+- 累计执行任务: X 次
+```
+
+---
+
+## Experience Format Template
+
+```markdown
+### [标签名称] 经验标题
+
+**错误信息**:
+```
+原始错误信息
+```
+
+**问题描述**: 简要描述问题
+
+**原因分析**: (可选) 深入分析原因
+
+**解决方案**:
+```gdscript
+# 代码示例
+```
+
+**适用场景**:
+- 场景1
+- 场景2
+
+**来源工作包**: WP-XXX
+**记录日期**: YYYY-MM-DD
+```
+
+---
+
+## 自动经验提取规则
+
+| 触发条件 | 动作 | 标签 |
+|----------|------|------|
+| 报告包含 "错误信息/Error:" | 自动提取 | [脚本调试] |
+| 报告包含 "解决方案/修复方法" | 自动提取 | 对应标签 |
+| 任务部分完成/失败 | 强制记录失败原因 | 对应标签 |
+| 涉及场景/节点操作 | 自动关联 | [场景设计] |
+| 涉及 API 版本差异 | 自动关联 | [API兼容] |
+
+---
+
+## Important
+
+- **只记录有价值的经验**，避免泛泛而谈
+- **使用正确的标签分类**，便于后续检索
+- **必须写入角色专属库**，实现角色进化
+- **同步到 EXPERIENCE.md**，保持全局知识库
+- **每条经验控制在可快速阅读的长度**
+- **及时记录**，问题解决后立即记录
+- **定期整理**，相似经验合并，过时经验更新
+
+---
+
+## 角色进化收益
+
+| 角色使用次数 | 能力提升 |
+|--------------|----------|
+| 1-5 次 | 基础能力 |
+| 6-15 次 | 积累专属经验，减少踩坑 |
+| 16+ 次 | 领域专家，快速解决同类问题 |

package/plugins/core/skill-human-checkpoint/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "skill-human-checkpoint",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "工作流关键节点人介入审核机制 - 强制暂停等待用户确认，防止自动跳过重要决策点",
+  "triggers": ["等待审核", "暂停确认", "人介入", "需要确认", "checkpoint", "暂停", "wait for review", "pause for confirmation", "need confirmation"],
+  "dependencies": [],
+  "provides": ["skill:human-checkpoint"],
+  "config": {}
+}