Init Manager Skill
This skill enables AI agents to work with Init Manager as a project management backend — picking up tasks, doing work, and closing them out.
Setup
Your workspace needs these in TOOLS.md or environment:
- - Init Manager URL (e.g.
https://manager.init.hr) - API Key (Bearer token, starts with
initm_) - Your User ID (UUID)
AI Guides (Instruction Hierarchy)
There are three levels of AI instructions. Always follow them. More specific wins on conflict:
- 1. Global AI Guide — INLINECODE3
- Per-User AI Guide —
GET /api/users/<your-user-id> → aiGuide field - Project AI Guide —
GET /api/projects/<project-id> → aiGuide field
On first boot and periodically: fetch all three and follow the combined instructions.
Task Workflow
- 1. Pick up tasks in
ready status assigned to you - Move to
in_progress before starting work - Read full description + all comments + project AI guide before writing code
- If unsure — comment asking for clarification, keep in
ready, assign to a human - When done — move to
done, add comment with commit/PR link + summary - If blocked — comment with details, assign to a human
API Reference
Authentication
All requests need:
CODEBLOCK0
Key Endpoints
| Action | Method | Endpoint |
|---|
| List projects | GET | INLINECODE12 |
| Project board |
GET |
/api/projects/<id>/board |
| Project details | GET |
/api/projects/<id> |
| List tasks | GET |
/api/tasks?assignee=me&status=ready |
| Get task | GET |
/api/tasks/<id> |
| Update task | PATCH |
/api/tasks/<id> |
| Move task | POST |
/api/tasks/<id>/move |
| Create task | POST |
/api/tasks |
| Add comment | POST |
/api/tasks/<id>/comments |
| Assign user | POST |
/api/tasks/<id>/assign |
| Complete assignment | POST |
/api/tasks/<id>/complete |
| Activity log | GET |
/api/activity |
| Global AI guide | GET |
/api/settings?key=ai_global_guide |
Create a Task
CODEBLOCK1
Update a Task
CODEBLOCK2
All fields optional — only include what changes.
Add a Comment
CODEBLOCK3
⚠️ Use body field, not content.
Assign a User
CODEBLOCK4
Labels
CODEBLOCK5
Behavior Notes
- - Assignments auto-complete when task moves to
done or INLINECODE28 - Moving task back to
ready/backlog clears notification flags and assignment completion - Comments created via API are flagged INLINECODE31
- Task keys (e.g.
IMG-32) are auto-generated from project prefix
Error Responses
CODEBLOCK6
| Status | Meaning |
|---|
| 400 | Bad request / validation |
| 401 |
Invalid or missing API key |
| 403 | Not allowed for your role |
| 404 | Resource not found |
| 409 | Conflict |
| 500 | Server error |
Common Workflow: Check for Tasks
CODEBLOCK7
Init Manager 技能
该技能使AI代理能够以Init Manager作为项目管理后端——领取任务、执行工作并完成关闭。
设置
你的工作区需要在TOOLS.md或环境中包含以下内容：
- - Init Manager URL（例如 https://manager.init.hr）
- API密钥（Bearer令牌，以initm_开头）
- 你的用户ID（UUID）
AI指南（指令层级）
共有三级AI指令。始终遵循它们。 冲突时更具体的指令优先：
- 1. 全局AI指南 — GET /api/settings?key=aiglobalguide
- 按用户AI指南 — GET /api/users/<你的用户ID> → aiGuide字段
- 项目AI指南 — GET /api/projects/<项目ID> → aiGuide字段
首次启动及定期： 获取全部三级指令并遵循合并后的指令。
任务工作流
- 1. 领取分配给您的ready状态任务
- 开始工作前移至in_progress
- 编写代码前阅读完整描述 + 所有评论 + 项目AI指南
- 如果不确定 — 发表评论请求澄清，保持ready状态，分配给人类
- 完成后 — 移至done，添加包含提交/PR链接及摘要的评论
- 如果受阻 — 发表评论说明详情，分配给人类
API参考
认证
所有请求需要：
Authorization: Bearer initm_<你的密钥>
关键端点
| 操作 | 方法 | 端点 |
|---|
| 列出项目 | GET | /api/projects |
| 项目看板 |
GET | /api/projects/
/board |
| 项目详情 | GET | /api/projects/ |
| 列出任务 | GET | /api/tasks?assignee=me&status=ready |
| 获取任务 | GET | /api/tasks/ |
| 更新任务 | PATCH | /api/tasks/ |
| 移动任务 | POST | /api/tasks//move |
| 创建任务 | POST | /api/tasks |
| 添加评论 | POST | /api/tasks//comments |
| 分配用户 | POST | /api/tasks//assign |
| 完成分配 | POST | /api/tasks//complete |
| 活动日志 | GET | /api/activity |
| 全局AI指南 | GET | /api/settings?key=aiglobalguide |
创建任务
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: }
标签
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）从项目前缀自动生成
错误响应
json
{ error: 描述 }
无效或缺失API密钥 |
| 403 | 您的角色不允许 |
| 404 | 资源未找到 |
| 409 | 冲突 |
| 500 | 服务器错误 |
常用工作流：检查任务
bash
获取所有项目
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
