mcpField
L
linear-usage

linear-usage

github.com/fcakyon生产力1.2k37 次安装今天更新
代码仓库

关于 linear-usage

一套关于 Linear 和问题跟踪的实践指南，涵盖问题编写、标签与优先级、周期规划及分流处理，适用于希望统一问题描述和项目流程的团队。

主要功能

  1. 01问题标题与描述指南
  2. 02缺陷和功能请求模板
  3. 03标签与优先级建议
  4. 04周期及项目规划实践
  5. 05分流和关闭问题步骤
  6. 06GitHub 关联与工作流示例

适用场景

  1. 01编写可复现的缺陷报告
  2. 02为功能请求定义验收标准
  3. 03规划并分流团队待办事项
  4. 04将拉取请求关联到 Linear 问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fcakyon/claude-codex-settings --skill linear-usage

安装后在 Claude Code 中输入/linear-usage确认已加载。

详细介绍

Linear 和问题跟踪最佳实践

问题撰写指南

清晰的标题

标题应描述问题或预期结果：

  • 良好：“用户无法在移动版 Safari 中重置密码”
  • 不佳：“密码错误”
  • 良好：“为用户报告添加 CSV 导出功能”
  • 不佳：“导出功能”
有效的描述

包括：

  1. **背景：**这为何重要
  2. **当前行为：**目前发生了什么（针对错误）
  3. **预期行为：**应该发生什么
  4. **复现步骤：**针对错误
  5. **验收标准：**完成的定义
模板

错误报告：

## Description
Brief description of the issue.

## Steps to Reproduce
1. Step one
2. Step two
3. Issue occurs

## Expected Behavior
What should happen.

## Actual Behavior
What happens instead.

## Environment
- Browser/OS
- User type

功能请求：

## Problem Statement
What problem does this solve?

## Proposed Solution
High-level approach.

## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2

标签分类

建议的标签

类型标签：

  • bug - 某项功能无法正常工作
  • feature - 新功能
  • improvement - 改进现有功能
  • chore - 维护、重构

领域标签：

  • frontend、backend、api、mobile
  • 或按功能领域划分：auth、payments、onboarding

状态标签（如果不使用工作流状态）：

  • needs-triage、blocked、needs-design
标签最佳实践
  • 控制标签数量（总计 15–25 个）
  • 使用一致的命名规范
  • 按类别使用不同颜色
  • 每季度检查并精简

优先级和估算

优先级级别
  • **紧急（P0）：**生产环境宕机、安全问题
  • **高（P1）：**主要功能损坏、关键截止日期
  • **中（P2）：**重要但不紧急
  • **低（P3）：**锦上添花、小幅改进
估算技巧
  • 使用相对规模（点数），而非小时数
  • 估算复杂度，而非时间
  • 将测试和审核时间计算在内
  • 如果范围发生重大变化，请重新估算

周期／冲刺规划

周期最佳实践
  • **时长：**通常为 1–2 周
  • **容量：**按 70–80% 规划，为临时事务留出余量
  • **结转：**复盘事项未完成的原因
  • **回顾：**在周期结束时进行简短回顾
规划流程
  1. 检查待办事项的优先级
  2. 将问题纳入周期
  3. 拆分较大的事项（>5 点）
  4. 指定负责人
  5. 确定依赖项和阻塞因素

项目组织

项目与倡议

**项目：**目标明确、有时限的工作（1–3 个月）

  • 通常由单个团队负责
  • 有明确的交付成果
  • 示例：“移动应用 v2 发布”

**倡议：**战略主题

  • 可能涵盖多个项目
  • 目标周期较长
  • 示例：“平台可靠性”
路线图技巧
  • 路线图事项应保持较高层级
  • 定期更新状态
  • 链接到详细的问题／项目
  • 与利益相关者分享

分诊工作流

分诊流程
  1. 每天检查新问题
  2. 补充缺失信息（标签、优先级）
  3. 分配给合适的团队／人员
  4. 关联相关问题
  5. 移至待办事项，或在问题无效时关闭
关闭问题

关闭时注明明确原因：

  • **已完成：**工作已完成
  • **重复：**链接到原问题
  • **不予修复：**说明原因
  • **无效：**信息缺失、无法复现

GitHub 集成

将 PR 关联到问题
  • 在 PR 标题或描述中引用 Linear 问题 ID
  • Linear 会自动建立关联并更新状态
  • 在分支名称中使用问题 ID，以便自动关联
工作流自动化
  • PR 已打开 → 问题移至“In Progress”
  • PR 已合并 → 问题移至“Done”
  • 在 Linear 设置中进行配置

评论

支持 Markdown