@donmai/plugin-线性
线性问题跟踪器集成 东迈。提供 Linear API 客户端、代理会话、状态过渡、活动流和工作类型路由.
安装
npm install @donmai/plugin-linear
快速启动
线性客户端
import { createLinearAgentClient } from '@donmai/plugin-linear'
const client = createLinearAgentClient({ apiKey: process.env.LINEAR_API_KEY! })
const issue = await client.getIssue('PROJ-123')
await client.updateIssueStatus('PROJ-123', 'Started')
await client.createComment(issue.id, 'Work in progress...')
代理会话
管理处理某一问题的代理人的生命周期:
import { createAgentSession } from '@donmai/plugin-linear'
const session = createAgentSession({
client: linearClient,
issueId: 'issue-uuid',
autoTransition: true,
workType: 'development',
})
await session.start() // Status -> Started
await session.emitThought('Analyzing requirements...')
await session.updatePlan([
{ title: 'Read code', state: 'completed' },
{ title: 'Implement feature', state: 'inProgress' },
{ title: 'Write tests', state: 'pending' },
])
await session.complete('Feature implemented') // Status -> Finished
工作类型
问题会根据其线性状态自动排序到工作类型:
| 状态 | 工作类型 | 代理角色 |
|---|---|---|
| 后台日志 | development | 执行特性/ 固定 |
| 开始 | inflight | 继续开展在建工程 |
| 完成 | qa | 验证执行情况 |
| 已交付 | acceptance | 最后验收测试 |
| 被拒绝 | refinement | 地址反馈 |
默认提示模板
新项目的明智缺省——根据需要超越每个工作类型:
import {
defaultGeneratePrompt,
defaultDetectWorkTypeFromPrompt,
defaultGetPriority,
} from '@donmai/plugin-linear'
密钥导出
LinearAgentClient编号 :createLinearAgentClient—— 有再试逻辑的线性 API 客户端AgentSession编号 :createAgentSession- 代理人生命周期管理defaultGeneratePrompt——默认快速生成defaultDetectWorkTypeFromPrompt——从免费文本中检测工作类型defaultGetPriority——工作类型重点测绘- 工作类型常数、 错误类型、 Webhook 事件类型
相关软件包
| 软件包 | 说明 |
|---|---|
| @ donmai/ core (韩语) | 核心指挥员 |
| @donmai/ nextjs (英语) | Next.js Webhook 服务器 |
许可证
麻省理工学院