Init Manager 技能

该技能使 AI 代理能够将 Init Manager 作为项目管理后端使用——领取任务、执行工作并完成任务。

配置

您的工作区需在 TOOLS.md 文件或环境变量中提供以下信息：

• Init Manager URL（例如：https://manager.init.hr）
• API Key（Bearer Token，以 initm_ 开头）
• 您的用户 ID（UUID）

AI 指南（指令优先级）

AI 指令分为三个层级。请始终遵循这些指令。 当发生冲突时，更具体的指令优先级更高：

1. 全局 AI 指南 — GET /api/settings?key=ai_global_guide
2. 用户专属 AI 指南 — GET /api/users/ → 返回结果中的 aiGuide 字段
3. 项目专属 AI 指南 — GET /api/projects/ → 返回结果中的 aiGuide 字段

首次启动及周期性执行时：需获取全部三类指南，并遵照合并后的指令执行。

任务工作流

1. 领取任务：领取状态为 ready 且已分配给您的任务
2. 切换至 in_progress：开始工作前，先将任务状态更新为 in_progress
3. 阅读完整上下文：编码前须通读任务完整描述、所有评论以及项目 AI 指南
4. 如有疑问：通过评论请求澄清，保持任务状态为 ready，并将其重新指派给人类处理
5. 完成任务时：将状态更新为 done，并在评论中附上提交（commit）/拉取请求（PR）链接及简要总结
6. 遇到阻塞时：在评论中详细说明问题，然后指派给人类处理

API 参考文档

认证方式

所有请求均需携带以下请求头：

Authorization: Bearer initm_

核心端点

创建任务

POST /api/tasks
{
  "projectId": "",
  "title": "任务标题",
  "type": "task",           // epic | task | bug
  "status": "backlog",      // backlog | ready | in_progress | done | verified
  "priority": "medium",     // low | medium | high | urgent
  "description": "...",     // 纯文本或 Tiptap JSON
  "parentId": "",     // 可选，用于创建子任务
  "dueDate": "2026-03-01T00:00:00.000Z"
}

更新任务

PATCH /api/tasks/
{
  "status": "in_progress",
  "title": "新标题",
  "priority": "high"
}

所有字段均为可选——仅需包含需要修改的字段。

添加评论

POST /api/tasks//comments
{
  "body": "您的评论内容"
}

⚠️ 请使用 body 字段，而非 content 字段。

指派用户

POST /api/tasks//assign
{ "userId": "" }

标签（Labels）

GET    /api/labels?projectId=
POST   /api/labels                        { "name": "Bug", "color": "#ef4444", "projectId": "" }
POST   /api/tasks//labels             { "labelId": "" }
DELETE /api/tasks//labels             { "labelId": "" }

行为说明

• 当任务状态变为 done 或 verified 时，相关指派将自动完成
• 若将任务移回 ready 或 backlog 状态，则会清除通知标记与指派完成状态
• 通过 API 创建的评论将被标记为 viaApi: true
• 任务编号（如 IMG-32）由项目前缀自动生成

错误响应

{ "error": "描述信息" }

常见工作流：检查待办任务

# 获取所有项目
curl -H "Authorization: Bearer $KEY" $URL/api/projects

# 遍历各项目看板，查找分配给您且状态为 ready 的任务
curl -H "Authorization: Bearer $KEY" $URL/api/projects/$PID/board

# 领取一个任务
curl -X PATCH -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" 
  -d '{"status":"in_progress"}' $URL/api/tasks/$TID

# ... 执行具体工作 ...

# 完成任务
curl -X PATCH -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" 
  -d '{"status":"done"}' $URL/api/tasks/$TID

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" 
  -d '{"body":"已完成。提交链接：https://..."}' $URL/api/tasks/$TID/comments