SuperAPI AI 工具集

arkweb-preflight

数据与分析

查看项目

更新于 10-16 03:11

技能介绍

用途:ArkWeb SDD Preflight 是可选的 Phase 0,在主流程(Phase 1-9)启动前主动检查工作环境是否满足要求,不阻塞任何阶段,检查结果不作为门禁。适用于首次使用 arkweb-sdd、切换机器或项目、数据源不可用、确认环境能力等级等场景。

主要能力:

  1. 确定项目根目录:确认当前工作目录并检查 skills/arkweb-architect/SKILL.md 是否存在,据此确定 SKILL_HOME。
  2. 必须项检查(不满足则无法启动主流程):P-1 检查 skills/ 下 11 个核心 SKILL.md 是否完整;P-2 检查产出物目录可写性,涉及命令 mkdir -p docs/features/test && rm -rf docs/features/test;P-3 检查 assets/templates/ 下 6 个模板;P-4 探测 sessions_spawn 是否可用,不可用则切换到模式 B(串行)。
  3. 增强项检查(可降级):E-1 GitCode API Token(优先 GITCODE_TOKEN,回退 GITLAB_TOKEN,或 .env 文件);E-2 oh-chromium-knowledge 知识库,检查 curl -s -H "PRIVATE-TOKEN: $TOKEN" "https://gitcode.com/api/v5/repos/{owner}/{knowledge_repo}/contents/index.json" 是否返回 HTTP 200;E-3 oh-ai-full-design 知识库;E-4 DeepWiki MCP;E-5 agent-browser skill;E-6 参考文档。
  4. 环境能力评级:🟢 完整(必须项+3 个以上增强项)、🟡 标准、🟠 基础、🔴 不可用。
  5. 自动修复:在用户确认后创建缺失目录(如 mkdir -p docs/features/ analysis/ references/ assets/templates/)、生成 .env 模板、生成 MCP 配置模板、检测运行模式。
  6. 输出环境报告,含项目根目录、检查时间、环境等级、必须项与增强项状态表、自动修复记录、数据源优先级与建议,报告可保存至项目根目录 preflight-report.md。

使用方式:用户说"检查环境"/"preflight"/"帮我检查配置"时触发;AI 也可在 Phase 1 前询问。用户直接说"开始需求分析"或"跳过检查"时跳过。

限制:检查仅为可选前置,不修改已有 skill 流程;自动修复需用户确认;部分增强项缺失时按降级方案处理,如 Phase 9 提交 PR 需手动、code-analysis 降级 DeepWiki 等。知识库权限缺失属正常情况。