SuperAPI AI 工具集

specrail-workflow

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:作为 SpecRail 治理仓库工作的入口技能,先完成启动流程,再根据路由加载对应的细分技能。

主要能力:启动时先搜索是否已有 issue、spec、模板、策略、schema 或工作流;读取适用的 AGENTS.md,以及存在时的 AGENT_USAGE.md 和 PLAN.md;读取 workflow.yaml、states.yaml、labels.yaml 和相关模板。识别路由:triage_issue、write_spec、implement、review_pr、fix_ci、draft_release_note。仓库包含时运行 checks/route_gate.py,allowed 表示可继续,warn 表示谨慎继续,needs_human 表示维护者门禁,blocked 表示停止。需要 GitHub issue 证据且仓库含适配器时,只读收集:python3 checks/github_issue_evidence.py --github-repo <owner/repo> --issue <issue-number> --json > issue-evidence.json。

路由到细分技能:triage 用 skills/specrail-triage-issue/SKILL.md;产品规格用 skills/specrail-write-product-spec/SKILL.md 写 specs/GH<issue-number>/product.md;技术规格用 skills/specrail-write-tech-spec/SKILL.md 写 tech.md;任务计划用 skills/specrail-plan-tasks/SKILL.md 写 tasks.md;实现用 skills/specrail-implement/SKILL.md;对照规格检查实现用 skills/specrail-check-impl-against-spec/SKILL.md;PR 评审用 skills/specrail-review-pr/SKILL.md;CI 诊断用 skills/specrail-diagnose-ci/SKILL.md;合并前门禁用 skills/specrail-pr-gate/SKILL.md;合并后发布说明用 skills/specrail-release-note/SKILL.md。

默认策略:面向产品、架构、跨模块、公共 API、工作流策略或行为不明确的变更,先 write_spec 再 implement;仅当已有批准 spec 覆盖、小型机械修复、仅测试或文档修正、聚焦 CI 修复,或用户明确要求跳过 spec 时才直接 implement。若选 write_spec 且无 GitHub issue 编号,先搜索已有 issue;若不存在且 GitHub 工作流在范围内,先创建或请求关联 issue,再写 product.md 和 tech.md,不得以缺少 issue 编号为由跳过 spec。

语言:人类可读文本按用户明确要求、用户当前语言、workflow.yaml 的 presentation.default_locale、presentation.fallback_locale 顺序选择。用户用中文或 locale 为 zh-CN 时,issue 正文、product.md、tech.md、PR 正文、评审摘要、交接、错误说明用中文;不翻译机器标识,如 write_spec、ready_to_spec、needs_human、product_spec、specs/GH1/product.md、命令名与 CLI 标志、JSON 键与 schema 字段名。

可选 Threads 集成:若任务涉及 GitHub issue 或 PR 队列、需要互不重叠的并行通道,或需要评审线程、CI、合并门禁、关闭审计,启动后读 integrations/threads.md 并使用可用的 threads 技能。边界:SpecRail 负责策略、语言、必需产物、人工门禁和确定性验证;Threads 负责通道图、队列门禁、远端真相刷新、评审线程处理和关闭审计。无 threads 技能或原生子代理能力时,继续单代理 SpecRail 流程并报告未启动原生 threads。

代理边界:可起草、评审、诊断和提议标签;不得提供最终批准、未经用户明确授权合并或强制推送、发布机密或私有安全细节、更改仓库权限、绕过人工门禁。除非人类明确要求,不要把仓库分发的 SpecRail 技能安装到 $HOME;存在 skills-lock.json 时视为声明的仓库技能集。若明确要求本地 Codex 技能安装,先运行 python3 tools/install_codex_skills.py --repo .,仅在请求写入时使用 --apply。

输出:报告完成时包含创建的 issue 或 PR 链接、spec 路径、所选 locale、保持英文的稳定 ID、验证命令与结果,以及评估合并就绪时的 PR 门禁决定。