介绍
# Linear Workflow Management
通过内置的 CLI（位于 `{baseDir}/scripts/linear-cli.js`）管理 Linear 的议题（issues）和项目。
## 范围和运行时模型
- 此技能运行 `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`
## 快速示例
```bash 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"}' ```
## 实用工作流
- 紧急缺陷分类： 列出高优先级的开放议题，分配负责人，将状态移至 `In Progress`（进行中），添加分类评论。 - 冲刺规划： 审查周期范围，创建缺失的议题，设置优先级和估分，协调经办人。 - 发布准备： 验证阻碍因素，更新项目状态，创建里程碑任务，添加上线评论。 - 文档清理： 查找过时的文档/议题，创建后续任务，关联相关记录。
## 安全与操作规则
- 绝不要编造 ID；在更新前先获取并确认。 - 相比大范围的批量编辑，优先使用小范围的更新。 - 对于批量编辑，请在应用更改前说明分组逻辑。 - 不要在议题评论或描述中包含机密信息。 - 不要将数据发送到此技能的 Linear API 范围之外的端点。
## 参考
- `references/API.md` 用于了解优先级值和工作流模式。