Linear Issue Implementation 是一个面向软件工程实践的技能,用于从 Linear 议题出发,完成从分析、规划、测试驱动开发、代码审查到创建 PR 的完整开发闭环。
用途 当用户提供 Linear 议题 ID(如 TRA-9、DEV-123)或要求实现某个 Linear 议题、希望获得结构化 TDD 流程与代码审查、或需要从议题到 PR 的自动化工作流时使用。
核心工作流(14 步)
- 通过 Linear MCP 获取议题完整详情(标题、描述、状态、优先级、建议分支名 branchName、团队与项目、附件、标签等)。
- 收集额外上下文:在 Obsidian 中按议题 ID 或关键词检索会议记录、架构决策等;若议题引用 Sentry 问题则获取错误堆栈、影响用户与环境;若引用 GitHub PR/issue 则用 gh 查看讨论与评审反馈,最后汇总上下文对实现的影响。
- 检索团队状态并将议题更新为 In Progress。
- 使用 Linear 建议的分支名创建功能分支(先同步 main,已存在则复用,操作幂等)。
- 分析需求并制定实现计划:目标、需求、架构、测试策略、实现步骤、验收标准。
- 通过 memory MCP 将计划写入记忆图以便追踪。
- 向用户展示计划并请求确认。
- 确认后调用 tdd-workflow 技能,执行红-绿-重构循环与测试金字塔策略。
- 调用 parallel-code-review 技能并行运行安全审查(OWASP Top 10、多租户隔离、XSS/CSRF/SQL 注入、认证授权、敏感数据处理)、Rails 最佳实践审查(POODR、Rails 7+ 约定、N+1、ActiveRecord、服务对象、Result 模式)以及前端审查(ViewComponent、Tailwind、StimulusJS、可访问性)。
- 调用 code-review-implementer 技能按影响与工作量分级修复反馈;架构类反馈为必须项(如抽取服务对象、应用 Result 模式),全部落实前不得创建 PR。
- 校验:运行 bundle exec rspec 与 bin/lint,处理实际违规;仅做 Rails 代码时 Yarn 失败可忽略,MigratedSchemaVersion 等警告无害。
- 创建有意义的提交:测试、实现、重构、安全修复、模式改进、文档等分类提交,提交信息含 Linear 议题链接。
- 用 gh pr create 生成结构化 PR,正文包含摘要、实现细节、测试策略、代码审查结论、破坏性变更,并以 Closes 链接 Linear 议题。
- 最终核验:CI 触发、议题关联更新、测试通过、评审人通知、分支保护满足等,并输出完成清单。
项目约定 遵循 CLAUDE.md:服务对象承载业务逻辑、可失败操作用 Result 模式、POODR 原则;ActsAsTenant 自动租户隔离;RSpec + shoulda-matchers 与系统测试,避免 stub 被测系统,请求测试用后门中间件认证;用户可见文本走 i18n,用时间戳列替代布尔值,静态值用 Postgres 枚举,必需环境变量用 ENV.fetch。
使用前提 Linear MCP 已配置;当前目录为 git 仓库且 main 已同步;具备 rspec 与 bin/lint;gh CLI 已认证;tdd-workflow、parallel-code-review、code-review-implementer 技能可用。
限制与错误处理 议题 ID 需正确格式并确认访问权限;分支已存在属预期,工作流会复用;测试或 lint 失败须修复后再提 PR,不要盲目执行 standardrb --fix;架构反馈未落实前不得创建 PR。该技能偏重 Rails 技术栈,非 Rails 项目的适用性资料未说明。