SuperAPI AI 工具集

build-app-context

数据与分析

查看项目

更新于 10-15 21:43

技能介绍

用途:为 FOLIO 应用领域构建或刷新上下文文件(references/context/<area>.md),供 write-testrail-cases 技能作为领域知识来源使用。

凭据:按顺序尝试读取 .env(KEY=VALUE)、~/.folio-credentials、环境变量;涉及 TESTRAIL_URL/USER/API_KEY、JIRA_BASE_URL/USER_EMAIL/API_TOKEN、可选 GITHUB_TOKEN。全程静默尝试,不向用户索要凭据;全部失败则报告缺失键并停止。

主要流程:

  1. 阶段0 交互式设置:先静默抓取 FOLIO 责任矩阵,自动解析 JIRA 前缀、团队、ui-/mod- 仓库、测试仓库、ECS 范围、Eureka 应用,并预填;矩阵不可访问时回退为一次性询问五个问题(领域名、TestRail section ID、GitHub 仓库、Jira 组件或 epic、关注版本)。
  2. 阶段1 TestRail:按 section 分页拉取用例,提取 id、title、前置条件、步骤、release、ECS、refs 等;按版本分配权重(Umbrellaleaf 1.0、Trillium 0.9、Sunflower 0.8、Ramsons 0.6、Quesnelia 0.5、更早或空 0.3);抽取 Toast、弹窗标题、面板名、手风琴名、按钮标签、状态值、Capability Sets、验证模式、导航路径、ECS 信号,并从用例标题归纳业务规则。
  3. 阶段2 GitHub:遍历仓库文件树,优先抓取 README/doc/CHANGELOG、.feature、permissions.json/moduleDescriptor.json、OpenAPI、en_US.json 等(最多20个文件,跳过超200KB);提取功能、权限、UI 字符串,并与 TestRail 结果比对标记为 [confirmed]、[from source] 或 [from cases]。
  4. 阶段3 Jira:按组件或 epic 拉取已完成的 Story、New Feature 与 Bug(最多500条、Bug 保留最新100条),提取验收标准、能力映射、负面/边界规则与版本信息。
  5. 阶段4 生成结构化 Markdown 上下文文件,含应用说明、术语、记录层级、生命周期、UI 结构、精确 UI 文本、状态值、Capability Sets、验证模式、ECS 说明、业务规则与待确认项。
  6. 阶段5 保存到 write-testrail-cases/references/context/<area>.md,不能写到仓库根目录的 references/context/。

限制:若文件已存在等后续步骤,资料未完整提供。需凭据可访问 TestRail、Jira、GitHub 才能抓取对应数据,缺失来源应显式标注而非编造。