SuperAPI AI 工具集

swe-lifecycle

编程与开发

查看项目

更新于 11-11 17:19

技能介绍

概述

swe-lifecycle 是一个用于编排 AI 辅助软件交付全过程的技能,覆盖从发现和需求、设计、GitHub 规划、实现、验证、当前知识维护到持久化记录的各阶段。其核心目标是连接用户意图、已批准的预期、交付工作、实现证据和当前知识。

主要能力

  • 阶段编排:提供 orchestrate 操作,可组合相关生命周期阶段,不要求每个阶段或固定团队,遵循运行时委托权限,在无法委托时按顺序执行。
  • 启动引导:bootstrap 操作结合生命周期与 GitHub 工作流,可生成项目、架构、开发指南等文档,必要时生成里程碑或事务性 issue。
  • 规格与变更:specify 生成需求文档;propose-change 生成变更提案(合并提案与设计);design 为初始功能生成技术设计,为变更使用既有 CHG 记录,必要时生成 ADR。
  • 规划与实现:plan 生成里程碑、史诗(如适用)和相关 issue;implement/fix 使用相关 issue 及现有或新的变更记录。
  • 知识同步与记录:sync-knowledge 更新知识库、架构和开发指南;record-change 维护现有 CHG 或生成回顾性变更提案;finalize 生成拉取请求。
  • 上下文澄清:当缺少上下文且需要用户决策时,读取并使用已安装的 grilling 技能(调用别名 grill-me),按决策树和推荐一次问一个问题,在等待期间继续独立授权工作,用户决策后再恢复。若技能不可用,直接进行澄清,不阻塞工作。
  • 文档验证:提供脚本 python3 /path/to/swe-lifecycle/scripts/validate_docs.py /path/to/project,从任意安装路径运行。

使用方式

首先检查仓库说明、现有文档、源代码/测试及相关远程工作,明确请求范围与授权,不得覆盖未读内容。在编写文档或 GitHub 草稿前,阅读生命周期以了解阶段边界和约定。仅加载所需的参考和模板;保留必需章节,删除无关可选章节,保留重要规则、风险和证据,而非追求固定长度。复用明确授权;对于超出授权范围的重要新需求或架构变更,需寻求批准,同时继续独立的授权工作。按照规范布局或既有检查运行文档验证,报告实际验证结果、未知项和未完成工作。

模板为 assets/ 目录下的 Markdown 文件,使用前先阅读所选模板。实现时应用相关编码/测试技能。

适用场景

适合需要结构化、可追溯的 AI 辅助软件工程交付,尤其是涉及需求、设计、变更记录、知识管理和 GitHub 协作的项目。

限制与规则

  • 需求描述预期;设计描述预期实现;ADR 保留重大决策;知识描述经验证的当前行为;变更记录保留意图和实际交付;指南说明流程。
  • 每个有意义的工程变更使用一个 CHG 文件,按其主要需求分组(无需求时按领域分组),组内排序,链接所有受影响需求,不重复跨需求变更。交付证据追加到提案中,不单独创建变更日志。初始功能和有意义修复可使用回顾性记录,无需虚构提案。在明确授权迁移前,保留现有历史记录。
  • GitHub 负责里程碑、任务、依赖、PR 和交付状态;不维护并行本地 issue 数据库。读取现有工作以避免重复;远程写入需要覆盖该操作的授权。
  • 未经用户对该 PR 的明确批准,绝不合并不 PR;实现或 PR 创建授权不包含合并权限。
  • 保留稳定 ID、已批准意图和已完成历史。记录偏差和批准;后续工作使用新的变更记录。
  • 没有证据不得声称测试、完成、原因或历史行为。有效文档或拟定设计不是实现证明。
  • 若 grilling 技能或别名无法加载,直接选择能解锁最多工作的未解决决策,提出一个带建议和理由的简洁问题,等待回答后再问下一个;缺少访谈技能不阻塞澄清或要求安装。

暂未提供

关于收费、价格、平台兼容性等信息暂未提供。