name: hive-workflow description: 使用Hive系统进行问题追踪和任务管理。当创建、更新或管理工作项时使用。当需要追踪bug、feature、task或epic时使用。不要用于简单的一次性查询或探索。 tags:
- hive
- issues
- tracking
- workflow tools:
- hive_create
- hive_query
- hive_update
- hive_close
- hive_create_epic
- hive_sync related_skills:
- swarm-coordination
Hive工作流技能
Hive是一个为AI代理设计的本地优先问题追踪系统。本技能提供了有效细胞管理的最佳实践。
注意: 对于群组工作流,请将此技能与global-skills/中的swarm-coordination结合使用。
细胞类型
| 类型 | 使用时机 |
|---|---|
bug |
某些东西坏了需要修复 |
feature |
添加新功能 |
task |
一般工作项 |
chore |
维护、重构、依赖管理 |
epic |
包含多个子任务的大型倡议 |
创建有效的细胞
好的细胞标题
- "修复UserService.getProfile()中的空指针异常"
- "在设置页面添加暗模式切换"
- "将身份验证令牌从localStorage迁移到httpOnly cookies"
不好的细胞标题
- "修复bug"(太模糊)
- "让它更好"(不可操作)
- "东西"(无意义)
细胞主体结构
## 问题
[对问题或需求的清晰描述]
## 预期行为
[应该发生什么]
## 当前行为
[当前发生的情况,针对bug]
## 建议解决方案
[如何修复/实现,如果已知]
## 接受标准
- [ ] 标准1
- [ ] 标准2
## 备注
[任何额外上下文、链接或约束]
工作流状态
open → in_progress → closed
↓
blocked(可选)
状态转换
Open → In Progress
hive_update(id: "hv-abc123", state: "in_progress")
当开始处理一个细胞时使用。
In Progress → Closed
hive_close(id: "hv-abc123", resolution: "在提交abc1234中修复")
当工作完成时使用。
In Progress → Blocked
hive_update(id: "hv-abc123", state: "blocked", body: "被#hv-xyz789阻塞")
当因依赖而无法进行时使用。
查询细胞
查找未完成的工作
hive_query(state: "open", type: "bug")
按关键词搜索
hive_query(search: "authentication")
列出最近活动
hive_query(limit: 10, sort: "updated")
Epic管理
Epic是相关工作项的容器:
---
type: epic
title: 用户身份验证大修
---
## 目标
现代化身份验证系统
## 子任务
- [ ] #hv-001: 实现OAuth2提供者
- [ ] #hv-002: 添加多因素认证支持
- [ ] #hv-003: 迁移会话存储
- [ ] #hv-004: 更新登录UI
创建带子任务的Epic
- 先创建epic:
hive_create(type: "epic", title: "用户身份验证大修", body: "...")
- 创建链接到epic的子任务:
hive_create(type: "task", title: "实现OAuth2", parent: "epic-id")
最佳实践
1. **每个逻辑工作单元一个细胞** - 不要合并无关的修复
2. **及时更新状态** - 保持细胞反映现实情况
3. **在主体中添加上下文** - 未来的你会感谢现在的你
4. **链接相关细胞** - 使用`#hv-id`引用
5. **关闭时提供解决方案** - 解释如何解决的
6. **使用标签** - 如`priority:high`、`area:frontend`等
同步与协作
细胞与git同步:
- 本地跟踪更改
- 使用
hive_sync()提交并推送到远程
与群组集成
在群组中工作时:
1. 使用`skills_use(name="swarm-coordination")`加载`swarm-coordination`技能
2. 使用`hive_create_epic()`创建epic(原子操作)
3. 协调器将细胞分配给工作代理
4. 工人根据子任务类型加载相关技能
5. 子任务完成时关闭细胞
6. 所有子任务完成后关闭epic
7. 使用`hive_sync()`同步(会话结束时必须执行)
常见细胞类型的技能推荐
- `type: "bug"` → 加载`testing-patterns`进行回归测试
- `type: "feature"` → 加载`system-design`进行架构设计
- `type: "chore"` → 加载`testing-patterns`如果重构
- `type: "epic"` → 加载`swarm-coordination`进行分解