SuperAPI AI 工具集

openspec-linearized

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:在 Codex 操作 OpenSpec 变更生命周期(提案、实现、归档、同步规范等)时,叠加 Linear 生命周期管理,保持业务与技术的交接边界。Linear 卡片承载业务目标、用例、范围、验收标准与对外状态;仓库承载设计决策、任务、实现、迁移、测试与代码。规范源为 openspec/specs/,归档成功后镜像到 Linear 项目文档。

主要能力:提案阶段创建或继续变更并绑定 Linear 故事;实现阶段推进 tasks.md 并更新绑定故事;归档阶段先完成 OpenSpec 归档与增量规范同步,再把规范镜像为 Linear 项目文档(标题格式 OpenSpec: <capability-name>),并关闭故事。状态、校验、同步、继续与产物编辑类工作保留绑定感知,但不将故事置为 Done。

使用方式:先读 references/lifecycle.md,运行 openspec list --json 了解活跃变更,再据请求判断阶段。若 openspec/linear.yaml 存在,尽量执行对应阶段的 Linear 钩子;提案/初始化阶段缺失则先创建配置,其他阶段缺失则跳过 Linear 钩子继续本地工作。优先使用 Linear MCP 工具(list_teams、list_projects、list_issue_labels、list_issues、list_comments、list_documents、save_issue、save_comment、save_document)。初始化时只调用 list_teams、list_projects、list_issue_labels,逐项询问团队、项目、标签过滤(含“无标签过滤”选项),不得自动推断选择。

限制:Linear 不可用不阻塞本地 OpenSpec 工作;Linear 评论最多两句;不得把 Linear 作为规范源;归档成功前不得将故事置为 Done;技术设计不写入 Linear,业务上下文不写入仓库设计/任务;仅 Linear 项目文档用于规范镜像,不创建通用项目资源;归档后同步指引不写入 tasks.md。若当前 schema 已线性化,遵循 OpenSpec CLI 指示避免重复冲突;若为 local-only,则把本技能的 Linear 钩子叠加在常规流程上。