tackle-harness 0.0.2

package/plugins/core/skill-human-checkpoint/skill.md

@@ -0,0 +1,194 @@
+---
+name: human-checkpoint
+description: Use when reaching critical decision points in the workflow - forces pause for user review before proceeding. Triggers automatically after document creation, work package planning, or before batch execution.
+---
+
+<HARD-GATE>
+You MUST stop and wait for user confirmation at this checkpoint.
+Do NOT proceed to the next phase until user explicitly says "继续", "确认", "执行", or similar approval.
+This is not negotiable.
+</HARD-GATE>
+
+# Human Checkpoint
+
+工作流关键节点的人介入审核机制。
+
+## When to Use
+
+**自动触发场景**:
+- 完成需求/架构/设计文档编写后
+- 工作包创建完成，准备执行前
+- 批量执行计划制定后
+- 重大技术决策确定前
+
+**手动触发词**:
+- "等待审核" / "暂停确认"
+- "人介入" / "需要确认"
+- "checkpoint" / "暂停"
+
+## Red Flags - STOP
+
+| Thought | Reality |
+|---------|---------|
+| "用户应该想让我继续" | 必须等待明确指令 |
+| "文档看起来没问题" | 用户审核才算数 |
+| "这个很简单，不用等" | 任何决策点都要暂停 |
+| "我已经问了，没回复就继续" | 必须收到回复才能继续 |
+
+## Flow
+
+```dot
+digraph checkpoint {
+    rankdir=TB;
+
+    "到达关键节点" [shape=box];
+    "输出审核清单" [shape=box];
+    "🛑 暂停等待" [shape=box, style=filled, fillcolor=red];
+    "用户回复?" [shape=diamond];
+    "继续下一步" [shape=box];
+    "处理修改意见" [shape=box];
+
+    "到达关键节点" -> "输出审核清单";
+    "输出审核清单" -> "🛑 暂停等待";
+    "🛑 暂停等待" -> "用户回复?";
+    "用户回复?" -> "继续下一步" [label="确认/继续"];
+    "用户回复?" -> "处理修改意见" [label="修改"];
+    "处理修改意见" -> "输出审核清单";
+}
+```
+
+## Checkpoint Types
+
+### 1. 文档审核检查点
+
+触发时机: 完成文档编写后
+
+```markdown
+帅哥，文档已准备好，请审核：
+
+📋 文档清单:
+- [ ] docs/XX_需求分析.md - 需求概述
+- [ ] docs/XX_架构设计.md - 技术方案
+- [ ] docs/XX_开发计划.md - 实施步骤
+
+🔍 重点关注:
+- 需求范围是否正确？
+- 技术方案是否合理？
+- 预估工时是否准确？
+
+🔴 确认后回复"继续"，修改则指出需要调整的内容。
+```
+
+### 2. 工作包审核检查点
+
+触发时机: 工作包创建完成后
+
+```markdown
+帅哥，工作包已创建，请审核：
+
+📦 工作包概览:
+| 工作包ID | 名称 | 优先级 | 预估工时 | 子任务数 |
+|----------|------|--------|----------|----------|
+| WP-XXX | ... | P1 | Xh | X |
+
+🔗 依赖关系:
+- WP-XXX → WP-YYY (前置依赖)
+
+🔍 重点关注:
+- 任务拆分是否合理？
+- 优先级是否正确？
+- 依赖关系是否准确？
+
+🔴 确认后回复"执行"开始实现，或提出修改意见。
+```
+
+### 3. 批量执行检查点
+
+触发时机: 批量执行计划制定后
+
+```markdown
+帅哥，批量执行计划已制定，请确认：
+
+📊 执行计划:
+| 阶段 | 工作包 | 执行方式 | 预估时间 |
+|------|--------|----------|----------|
+| 1 | WP-XXX, WP-YYY | 并行 | Xh |
+| 2 | WP-ZZZ | 串行 | Xh |
+
+⚠️ 注意事项:
+- [注意事项1]
+- [注意事项2]
+
+🔍 确认要点:
+- 执行顺序是否正确？
+- 是否有遗漏的工作包？
+
+🔴 确认后回复"开始执行"，或调整执行计划。
+```
+
+### 4. 结果确认检查点
+
+触发时机: 批次工作包完成后
+
+```markdown
+帅哥，本批次工作包执行完成！
+
+## 执行结果
+| 工作包 | 状态 | 说明 |
+|--------|------|------|
+| WP-XXX | ✅ 完成 | ... |
+| WP-YYY | ✅ 完成 | ... |
+
+## 未完成项
+- (如有)
+
+## 下一步建议
+1. [建议1]
+2. [建议2]
+
+🔴 下一步安排是什么？
+```
+
+## User Response Handling
+
+### 确认类回复 → 继续执行
+- "继续" / "确认" / "OK" / "好的"
+- "执行" / "开始" / "做吧"
+- "没问题" / "可以"
+
+### 修改类回复 → 处理修改
+- "修改一下..." / "调整..."
+- "XXX 不对" / "YYY 需要改"
+- 处理完成后 → 重新输出审核清单 → 再次暂停
+
+### 等待类回复 → 保持暂停
+- "等等" / "我看看" / "稍等"
+- 保持暂停状态，不执行任何操作
+
+## Forbidden Actions at Checkpoint
+
+- ❌ 不要假设用户会同意而提前执行
+- ❌ 不要在用户未回复时自动继续
+- ❌ 不要跳过审核清单直接开始工作
+- ❌ 不要忽略用户的修改意见
+
+## Integration with Other Skills
+
+| Skill | 集成点 |
+|-------|--------|
+| `task-creator` | 工作包创建后触发检查点 |
+| `split-work-package` | 拆分完成后触发检查点 |
+| `completion-report` | 完成后触发结果确认检查点 |
+| `agent-dispatcher` | 批量执行前触发检查点 |
+
+## Report Format
+
+```
+帅哥，[检查点类型]已准备好，请审核：
+
+[审核内容]
+
+🔴 确认后回复"[确认词]"，修改则指出需要调整的内容。
+
+🛑 等待您的指令...
+```

package/plugins/core/skill-progress-tracker/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "skill-progress-tracker",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "项目进度追踪与记录 - 合并 progress-manager（读取进度）和 record-progress（记录进度），统一进度管理接口",
+  "triggers": ["记录进度", "保存进度", "读取进度", "查看进度", "增加授权", "record progress", "check progress", "view progress"],
+  "dependencies": [],
+  "provides": ["skill:progress-tracker"],
+  "config": {}
+}

package/plugins/core/skill-progress-tracker/skill.md

@@ -0,0 +1,204 @@
+---
+name: progress-tracker
+description: Use when user says "记录进度", "保存进度", "读取进度", "查看进度", "增加授权", or needs to manage project progress tracking and recording
+---
+
+# Progress Tracker
+
+项目进度追踪与记录的统一技能，合并了进度读取（原 progress-manager）和进度记录（原 record-progress）功能。
+
+## When to Use
+
+- 用户说 "记录进度" / "保存进度"
+- 用户说 "读取进度" / "查看进度"
+- 需要恢复上次工作上下文
+- 用户说 "增加授权"
+- 完成重要功能开发后
+- 会话结束前需要保存工作上下文
+
+## Quick Reference
+
+| 触发词 | 动作 |
+|--------|------|
+| 记录进度 / 保存进度 | 执行记录进度流程 |
+| 读取进度 / 查看进度 | 执行读取进度流程 |
+| 拆分工作包 / 创建工作包 | 调用 `split-work-package` skill |
+| 增加授权 | 执行授权流程 |
+
+---
+
+## Part 1: 读取进度 (Read Progress)
+
+### Read Progress Flow
+
+```dot
+digraph read_progress {
+    "用户请求读取进度" [shape=box];
+    "读取 PROGRESS.md" [shape=diamond];
+    "文档是否过大?" [shape=diamond];
+    "分段读取" [shape=box];
+    "完整读取" [shape=box];
+    "读取 task.md" [shape=diamond];
+    "文档是否过大?" [shape=diamond];
+    "分段读取" [shape=box];
+    "完整读取" [shape=box];
+    "汇报最近工作" [shape=box];
+    "询问是否继续" [shape=box];
+
+    "用户请求读取进度" -> "读取 PROGRESS.md";
+    "读取 PROGRESS.md" -> "文档是否过大?";
+    "文档是否过大?" -> "分段读取" [label="是(>2000行)"];
+    "文档是否过大?" -> "完整读取" [label="否"];
+    "分段读取" -> "读取 task.md";
+    "完整读取" -> "读取 task.md";
+    "读取 task.md" -> "文档是否过大?";
+    "文档是否过大?" -> "分段读取" [label="是(>2000行)"];
+    "文档是否过大?" -> "完整读取" [label="否"];
+    "分段读取" -> "汇报最近工作";
+    "完整读取" -> "汇报最近工作";
+    "汇报最近工作" -> "询问是否继续";
+}
+```
+
+### 分段读取规则
+
+当文档超过 **2000 行** 时，使用以下分段策略：
+
+| 文件 | 分段策略 | 优先读取 |
+|------|----------|----------|
+| `PROGRESS.md` | 读取最近 2000 行（从尾部开始） | 最新进度记录 |
+| `task.md` | 先读前 500 行概览，再按需读取 | 工作包概览表 |
+| `docs/wp/WP-XXX.md` | 按需读取具体工作包详情 | 单个工作包信息 |
+
+> ⚠️ `docs/core/12_工作包清单.md` 已废弃 (2026-03-17)，请使用 `task.md` 作为主索引
+
+### 分段读取实现
+
+使用 Read 工具的 `offset` 和 `limit` 参数：
+
+```
+# 读取大文件尾部（最近内容）
+Read(file_path="...", offset=总行数-2000, limit=2000)
+
+# 分批读取大文件
+Read(file_path="...", offset=1, limit=1000)    # 第1批
+Read(file_path="...", offset=1001, limit=1000) # 第2批
+```
+
+---
+
+## Part 2: 记录进度 (Record Progress)
+
+### Checklist
+
+1. **识别记录类型** - 工作包完成 vs 轻量级活动
+2. **更新 task.md 对应区域** - 根据类型更新不同区域
+3. **检查归档触发** - 是否需要归档
+4. **确认完成** - 向用户报告 "进度已记录"
+
+### 记录类型
+
+| 类型 | 更新区域 | 示例 |
+|------|----------|------|
+| **工作包完成** | `✅ 最近完成` + 工作包状态 | WP-109 架构问题分析文档完成 |
+| **轻量级活动** | `📝 最近活动` | 讨论文档记录机制优化方案 |
+
+### task.md 更新逻辑
+
+#### 工作包完成时
+
+1. **更新 `🔥 待办工作包`** - 移除已完成的工作包
+2. **更新 `✅ 最近完成`** - 在表格顶部添加新行
+3. **更新 `📊 快速概览`** - 进度统计 +1
+
+```markdown
+## ✅ 最近完成（最新10个）
+
+| 完成日期 | 工作包ID | 模块名称 | 说明 |
+|----------|----------|----------|------|
+| 2026-03-18 | WP-109 | 架构问题分析文档 | 17个单例分析、依赖关系图 |
+| ... | ... | ... | ... |
+```
+
+#### 轻量级活动时
+
+1. **更新 `📝 最近活动`** - 在表格顶部添加新行
+
+```markdown
+## 📝 最近活动（非工作包）
+
+| 日期 | 活动描述 |
+|------|----------|
+| 2026-03-18 | 讨论文档记录机制优化方案（Plan模式）|
+| ... | ... | ... |
+```
+
+### 归档触发检查
+
+| 条件 | 阈值 | 操作 |
+|------|------|------|
+| 最近完成 > 10 个 | > 10 | 将最旧的移入 `docs/archive/completed_*.md` |
+| 最近活动 > 20 条 | > 20 | 将最旧的移入 `docs/archive/activity_log_archive.md` |
+
+### 工作包完成记录模板
+
+完成工作包后，更新以下位置：
+
+#### 1. task.md `✅ 最近完成` 区域
+```markdown
+| 2026-03-18 | WP-XXX | 模块名称 | 简要说明 |
+```
+
+#### 2. task.md `📊 快速概览` 区域
+```markdown
+- **进度**: 74/117 (63.2%)  # +1 完成
+```
+
+#### 3. docs/wp/WP-XXX.md（如存在）
+```markdown
+## 完成记录
+
+- **完成日期**: 2026-03-18
+- **实际工时**: Xh
+- **经验教训**: ...
+```
+
+### 轻量级活动记录模板
+
+```markdown
+| 2026-03-18 | 活动描述 |
+```
+
+---
+
+## Part 3: 增加授权 (Add Permission)
+
+### Add Permission Flow
+
+1. **识别待授权命令** - 回顾本次会话中需要授权的命令
+2. **读取配置** - 读取 `.claude/settings.local.json`
+3. **添加授权** - 将命令添加到 `permissions.allow` 数组
+4. **保存配置** - 写入更新后的配置文件
+5. **确认完成** - 向用户报告已添加的授权命令列表
+
+---
+
+## Files
+
+| 文件 | 用途 | 状态 |
+|------|------|------|
+| `PROGRESS.md` | 详细进度记录（日志型） | ✅ 主要 |
+| `task.md` | 任务清单（主索引） | ✅ 主要 |
+| `docs/wp/WP-XXX.md` | 工作包详情（可选更新） | ✅ 活跃 |
+| `docs/archive/*.md` | 历史归档 | 📦 归档 |
+| `.claude/settings.local.json` | 权限配置 | ✅ 活跃 |
+
+## Related Skills
+
+- **split-work-package**: 拆分工作包（独立 skill）
+
+## Notes
+
+- 记录足够详细以便下次会话快速恢复上下文
+- 优先更新 task.md，不再使用 PROGRESS.md（已废弃）
+- 定期检查归档触发条件

package/plugins/core/skill-role-manager/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "skill-role-manager",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "角色赋能系统管理技能 - 查看角色、匹配角色、角色信息查询，对接 provider-role-registry",
+  "triggers": ["查看角色", "列出角色", "匹配角色", "角色管理", "角色信息", "角色统计", "view roles", "list roles", "role management"],
+  "dependencies": ["provider-role-registry"],
+  "provides": ["skill:role-manager"],
+  "config": {}
+}

package/plugins/core/skill-role-manager/skill.md

@@ -0,0 +1,252 @@
+---
+name: role-manager
+description: Use when user says "查看角色", "匹配角色", "角色管理", or needs to work with the role empowerment system for subagents
+---
+
+# Role Manager
+
+角色赋能系统管理技能，用于查看、匹配和管理专业角色。
+
+## When to Use
+
+**触发词**:
+- "查看角色" / "列出角色"
+- "匹配角色" / "哪个角色适合"
+- "角色管理" / "角色信息"
+- "使用 xxx 角色执行"
+
+## Quick Reference
+
+| 命令 | 功能 |
+|------|------|
+| `list` | 列出所有角色 |
+| `info <角色ID>` | 查看角色详情 |
+| `match <任务描述>` | 匹配最适合的角色 |
+| `stats` | 查看角色统计 |
+
+## 中文别名映射
+
+用户可以用友好的中文名称召唤角色，系统内部会自动转换为英文 ID。
+
+### 核心角色（通用框架）
+
+| 中文别名 | 英文 ID | 角色名称 |
+|----------|--------|------|
+| 协调者 | coordinator | 协调者 |
+| 调度者 | coordinator | 协调者 |
+| 执行者 | executor | 执行者 |
+| 审查者 | reviewer | 审查者 |
+| 架构师 | architect | 架构师 |
+| 设计师 | architect | 架构师 |
+| 实现者 | implementer | 实现者 |
+| 开发者 | implementer | 实现者 |
+| 编码者 | implementer | 实现者 |
+| 测试者 | tester | 测试者 |
+| 测试员 | tester | 测试者 |
+| 文档 | documenter | 文档编写者 |
+
+### 领域角色（由项目模板扩展）
+
+| 中文别名 | 英文 ID | 角色名称 |
+|----------|--------|------|
+| 前端 | frontend-dev | 前端开发专家 |
+| 后端 | backend-dev | 后端开发专家 |
+| 运维 | devops | 运维专家 |
+| UI专家 | godot-scene-expert | Godot 场景+UI专家 |
+| 场景专家 | godot-scene-expert | Godot 场景+UI专家 |
+
+## Flow
+
+```dot
+digraph role_manager {
+    rankdir=TB;
+
+    "解析命令" [shape=box];
+    "list?" [shape=diamond];
+    "info?" [shape=diamond];
+    "match?" [shape=diamond];
+    "stats?" [shape=diamond];
+    "列出所有角色" [shape=box];
+    "读取角色定义" [shape=box];
+    "分析任务关键词" [shape=box];
+    "计算匹配分数" [shape=box];
+    "返回最佳角色" [shape=box];
+    "读取角色专属库" [shape=box];
+    "显示统计信息" [shape=box];
+
+    "解析命令" -> "list?";
+    "list?" -> "列出所有角色" [label="是"];
+    "list?" -> "info?" [label="否"];
+    "info?" -> "读取角色定义" [label="是"];
+    "info?" -> "match?" [label="否"];
+    "match?" -> "分析任务关键词" [label="是"];
+    "分析任务关键词" -> "计算匹配分数";
+    "计算匹配分数" -> "返回最佳角色";
+    "match?" -> "stats?" [label="否"];
+    "stats?" -> "读取角色专属库" [label="是"];
+    "stats?" -> "显示统计信息" [label="否"];
+}
+```
+
+---
+
+## Commands
+
+### 1. 列出所有角色 (list)
+
+**触发**: "查看角色" / "列出角色"
+
+**输出示例**:
+```markdown
+帅哥，当前系统中有 8 个专业角色：
+
+### 核心角色（通用框架）
+
+| 中文别名 | 角色ID | 名称 | 专业领域 | 经验数 |
+|----------|--------|------|----------|--------|
+| 协调者 | coordinator | 协调者 | 任务分解、依赖分析、进度跟踪 | 0 |
+| 执行者 | executor | 执行者 | 通用编码、问题解决、文件操作 | 0 |
+| 审查者 | reviewer | 审查者 | 代码审查、测试验证、质量检查 | 0 |
+| 架构师 | architect | 架构师 | 系统设计、架构模式、技术选型 | 0 |
+| 实现者 | implementer | 实现者 | 代码实现、功能开发、Bug 修复 | 0 |
+| 测试者 | tester | 测试者 | 单元测试、集成测试、测试框架 | 0 |
+| 文档 | documenter | 文档编写者 | 技术文档、API 文档、用户指南 | 0 |
+
+### 领域角色（由项目模板扩展）
+
+| 中文别名 | 角色ID | 名称 | 专业领域 | 经验数 |
+|----------|--------|------|----------|--------|
+| 前端 | frontend-dev | 前端开发专家 | HTML/CSS/JavaScript、UI 组件 | 0 |
+| 后端 | backend-dev | 后端开发专家 | API 设计、数据库、服务端开发 | 0 |
+| 运维 | devops | 运维专家 | CI/CD、Docker、Kubernetes | 0 |
+
+使用 "查看角色 <角色ID或中文别名>" 了解详情。
+```
+
+### 2. 查看角色详情 (info)
+
+**触发**: "查看角色 godot-scene-expert" 或 "查看角色 UI专家"
+
+**执行步骤**:
+1. 读取 `.claude/agents/roles/{role_id}.yaml`
+2. 读取 `.claude/agents/memories/{role_id}.md`
+3. 格式化输出角色信息
+
+**输出示例**:
+```markdown
+## Godot 场景+UI专家
+
+### 基本信息
+- **角色ID**: godot-scene-expert
+- **版本**: 1.0.0
+- **子代理类型**: general-purpose
+- **中文别名**: UI专家、场景专家
+
+### 专业领域
+- 场景层级结构设计
+- 节点类型选择和配置
+- 信号连接模式
+- 场景继承和实例化
+- UI 布局和响应式设计
+
+### 匹配关键词
+场景、节点、tscn、预制体、信号连接、UI、界面、Control、布局
+
+### 任务类型
+feature, refactor, bug_fix
+
+### 专属经验库
+- 总经验数: 2
+- 最近更新: 2026-03-13
+
+#### 经验列表
+1. [场景设计] z_index 不影响事件传播
+2. [场景设计] 预加载文件不存在
+```
+
+### 3. 匹配角色 (match)
+
+**触发**: "匹配角色 修复场景点击事件问题"
+
+**执行步骤**:
+1. 分析任务描述中的关键词
+2. 读取 `role-registry.yaml`
+3. 计算每个角色的匹配分数
+4. 返回最佳匹配
+
+**匹配算法**:
+```
+分数 = 关键词匹配数 * 0.5 + 任务类型匹配 * 0.3 + 模块标签匹配 * 0.2
+```
+
+**输出示例**:
+```markdown
+帅哥，根据任务描述分析，最佳角色匹配：
+
+## 🎯 推荐角色: **godot-scene-expert** (UI专家)
+
+**匹配分数**: 0.85
+
+**匹配原因**:
+- 关键词匹配: "场景" (+0.5)
+- 任务类型: bug_fix (+0.3)
+- 模块标签: scenes (+0.05)
+
+**角色能力**:
+- 场景层级结构设计
+- 节点类型选择和配置
+- 信号连接模式
+- 场景继承和实例化
+- UI 布局和响应式设计
+
+**相关经验**:
+- [场景设计] z_index 不影响事件传播
+- [场景设计] 预加载文件不存在
+
+使用 "使用 UI专家 执行" 来指定此角色。
+```
+
+### 4. 查看统计 (stats)
+
+**触发**: "角色统计"
+
+**输出示例**:
+```markdown
+帅哥，角色系统统计：
+
+## 📊 角色系统概览
+
+| 中文别名 | 角色 | 经验数 | 执行次数 | 最后更新 |
+|----------|------|--------|----------|----------|
+| UI专家 | godot-scene-expert | 2 | 0 | 2026-03-13 |
+| 开发专家 | godot-script-expert | 6 | 0 | 2026-03-13 |
+| 战斗专家 | combat-ai-expert | 0 | 0 | - |
+| 效果专家 | effect-expert | 0 | 0 | - |
+| 测试专家 | test-reviewer | 1 | 0 | 2026-03-13 |
+
+**总计**:
+- 角色数: 5
+- 总经验数: 9
+- 累计执行: 0 次
+```
+
+---
+
+## Integration
+
+| Skill | 集成点 |
+|-------|--------|
+| `agent-dispatcher` | 自动角色匹配和记忆注入 |
+| `experience-logger` | 经验写入角色专属库 |
+| `human-checkpoint` | 确认角色选择 |
+
+---
+
+## Important
+
+1. **角色匹配是建议性的** - 用户可以手动指定角色
+2. **经验库持续增长** - 每次任务都可能添加新经验
+3. **定期维护** - 清理过时经验，合并相似经验
+4. **角色可扩展** - 可以添加新的专业角色
+5. **中文别名优先** - 用户可以用友好的中文名称召唤角色
+6. **系统内部使用英文 ID** - 子代理调度时使用英文 ID 确保唯一性

package/plugins/core/skill-split-work-package/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "skill-split-work-package",
+  "version": "1.0.0",
+  "type": "skill",
+  "description": "工作包拆分 Skill - 将任务拆分为结构化工作包（仅定义不实现），支持子任务分解和依赖关系管理",
+  "triggers": ["拆分工作包", "创建工作包", "split-work-package", "split work package", "create work package"],
+  "dependencies": ["provider:state-store", "provider:role-registry"],
+  "provides": ["skill:split-work-package"],
+  "metadata": {
+    "gatedByCode": true
+  },
+  "config": {}
+}