线性工作流管理

通过位于{baseDir}/scripts/linear-cli.js的捆绑CLI管理Linear任务和项目。

范围与运行时模型

• 此技能运行node {baseDir}/scripts/linear-cli.js ...命令。
• CLI使用官方的@linear/sdk开发工具包。
• 身份验证通过本地环境中的LINEAR_API_KEY实现。
• 预期API目的地是通过官方SDK访问Linear GraphQL(https://api.linear.app/graphql)。

先决条件

1. 需安装Node.js和npm。
2. 一次性安装脚本依赖：
   • cd {baseDir}/scripts && npm install
3. 设置您的API密钥：
   • export LINEAR_API_KEY="lin_api_..."

如果缺少依赖项或LINEAR_API_KEY，请停止操作，并在处理事务/项目操作前完成设置。

身份验证与凭据

• 所需凭据：LINEAR_API_KEY。
• 请从https://linear.app/settings/api获取。
• 建议使用最小权限访问，并为自动化流程使用专用令牌。

必要工作流程

1. 明确意图和范围：
   • 团队/项目、标签、周期、负责人、截止日期、优先级。
2. 首先读取当前状态：
   • 列出/获取事务、项目、状态、标签、用户、周期。
3. 其次执行变更操作：
   • 创建/更新事务、评论、项目、里程碑、标签。
4. 准确总结变更内容：
   • 提及ID、状态、负责人、阻碍因素及后续行动。

命令覆盖范围

• 团队与项目：teams、projects、createProject
• 问题：issues、issue、createIssue、updateIssue
• 评论：createComment
• 状态与标签：states、labels
• 用户：user

快速示例

node {baseDir}/scripts/linear-cli.js teams
node {baseDir}/scripts/linear-cli.js projects
node {baseDir}/scripts/linear-cli.js issues
node {baseDir}/scripts/linear-cli.js issue ENG-123
node {baseDir}/scripts/linear-cli.js createIssue "Title" "Description" "team-id" '{"priority":2}'
node {baseDir}/scripts/linear-cli.js updateIssue "issue-id" '{"stateId":"state-id"}'

实用工作流程

• 紧急问题分类： 列出高优先级未解决问题、分配负责人、将状态移至进行中，添加分类评论。
• 冲刺规划： 评审周期范围，创建缺失事项，设定优先级和估算，协调分配人员。
• 发布准备： 验证阻碍因素，更新项目状态，创建里程碑任务，添加部署评论。
• 文档清理： 查找过期文档/事项，开启后续任务，关联相关记录。

安全与操作规则

• 切勿编造ID；更新前先获取并确认。
• 优先选择针对性更新而非宽泛的批量编辑。
• 进行批量编辑时，在应用更改前说明分组逻辑。
• 不要在事项评论或描述中包含机密信息。
• 不要向此技能Linear API范围外的端点发送数据。

参考

• references/API.md以获取优先级值和工作流模式。