Hive工作流技能Skill hive-workflow

Hive工作流技能是一个用于AI代理的本地优先问题追踪系统,支持创建、更新和管理工作项,如bug、feature、task、chore和epic。关键词:问题追踪,任务管理,AI代理,工作流,细胞管理。

AI智能体 0 次安装 0 次浏览 更新于 3/19/2026

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

  1. 先创建epic:
hive_create(type: "epic", title: "用户身份验证大修", body: "...")
  1. 创建链接到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`进行分解