linear-cli initiative 指南:命令行查看与评论 Linear 战略举措
linear-cli initiative 指南:命令行查看与评论 Linear 战略举措
linear-cli 是一款让你在终端里直接管理 Linear 的开源命令行工具(agent friendly),其中的 linear initiative 子命令专门用于管理 Linear 的战略举措(initiatives)。本指南面向新手,带你快速掌握如何用命令行查看举措详情、列出所有举措,以及添加和查看评论——全程不离开终端,比切回浏览器更快、更适合写进脚本和 AI 工作流。
🎯 什么是 Linear 的战略举措(Initiative)
在 Linear 中,Initiative(战略举措)是比 Project 更高一层的规划单元:一个举措下可以挂多个 Project,用来表达季度目标、年度方向这类大规划。举措带有状态(planned / active / completed)、负责人、目标日期和描述。
linear-cli 把这一层完整地搬进了命令行,提供这些子命令(见 cli/initiative.rs 中的命令定义):
| 子命令 | 作用 |
|---|---|
list |
列出举措(别名 ls) |
view |
查看举措详情(别名 v) |
create / update |
创建 / 更新举措 |
archive / unarchive / delete |
归档 / 恢复 / 永久删除 |
add-project / remove-project |
关联 / 移除 Project |
comment add / comment list |
评论 / 查看评论 |
🔑 开始之前:完成登录
所有命令都需要有效的 Linear API key。只需登录一次(key 会安全存放在系统钥匙串中,详见 docs/authentication.md):
linear auth login # 按提示粘贴 API key
linear auth whoami # 确认当前用户与工作区
💡 多工作区用户可以用全局参数
--workspace <SLUG>指定操作哪个工作区。
📋 命令行查看 Linear 战略举措
一键列出所有举措:linear initiative list
linear initiative list # 默认只列出 active 状态的举措
linear initiative list --all-statuses # 查看所有状态
linear initiative list --status planned
linear initiative list -o @me # 只看自己负责的(支持用户名/邮箱/@me)
linear initiative list --archived # 包含已归档的
linear initiative list -j # 输出 JSON,方便管道处理
输出是带颜色状态标识的表格,按状态和名称排序;实现逻辑在 commands/initiative/list.rs。想直接在浏览器里看,加 -w 即可打开 Linear 的 initiatives 页面。
查看单个举措详情:linear initiative view
举措可以用 URL、UUID、slug 或名称 来指定(解析规则见 refs/initiative.rs):
linear initiative view "Q1 Goals"
linear initiative view init-12345 --json # 输出 JSON
linear initiative view "Q1 Goals" -w # 直接在浏览器中打开
终端下的输出是一份排版好的 Markdown 详情,包含:
- Status / Health / Owner / Target Date:关键元信息,状态还会着色显示
- Description:完整描述
- Projects:该举措下所有 Project 的列表及各自状态
这个"详情自动拼成 Markdown"的逻辑位于 commands/initiative/view.rs,非常适合直接粘贴给 AI Agent 做上下文。
💬 命令行评论 Linear 战略举措
添加评论或回复:linear initiative comment add
# 直接用参数写评论(支持 Markdown)
linear initiative comment add "Q1 Goals" -b "进度 80%,风险可控"
# 从文件读长评论(支持管道,用 - 表示 stdin)
linear initiative comment add "Q1 Goals" --body-file notes.md
# 回复某条顶层评论(传评论 ID)
linear initiative comment add "Q1 Goals" -p 8a2b... -b "收到,下周同步"
# 不带参数时会打开编辑器,像写邮件一样撰写
linear initiative comment add "Q1 Goals"
不带 -b / --body-file 时,CLI 会调用你配置好的编辑器交互式撰写(见 commands/initiative/comment/add.rs)。评论支持 Linear Markdown,比如用 Linear 链接自动 @ 成员。
查看评论:linear initiative comment list
linear initiative comment list "Q1 Goals" # 按线程展示全部评论
linear initiative comment list "Q1 Goals" --limit 10 # 只看最新 10 条
linear initiative comment list "Q1 Goals" -j # 输出 JSON
🚀 顺带掌握:创建与日常管理
# 创建一个举措
linear initiative create -n "Q2 Goals" -s active --target-date 2026-06-30
linear initiative create -i # 交互式填写所有字段
# 更新状态 / 描述
linear initiative update "Q2 Goals" --status completed
# 把 Project 挂到举措下
linear initiative add-project "Q2 Goals" "Platform"
# 归档(支持批量),不再需要时再恢复
linear initiative archive "Q1 Goals" -y
linear initiative unarchive "Q1 Goals"
参数速查表已整理在官方 skill 文档中:initiative.md,组织级功能示例可参考 organization-features.md。
❓ 常见问题
Q:找不到举措,报 not found?
确认工作区是否正确(linear auth list 查看已登录的工作区),并检查名称拼写;归档状态的举措需要先用 list --archived 确认存在。
Q:如何把举措信息交给脚本处理?
统一加 --json 参数即可,view 的 JSON 包含 id、url、owner、projects 等完整字段。
Q:和 initiative-update 有什么区别?
initiative-update 是另一种实体(举措状态更新/汇报),用于向管理层同步进展,命令见 initiative-update.md。
📚 延伸阅读
- 使用文档:docs/usage.md
- 认证机制:docs/authentication.md
- 命令实现:commands/initiative/
- CLI 参数定义:cli/initiative.rs
掌握 linear initiative 后,你就能在终端里完成"看目标 → 查详情 → 留评论"的完整闭环,配合 AI Agent 时更是事半功倍。