SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场aif

aif

智能体与模型

查看项目

更新于 10-16 09:20

技能介绍

用途

aif 是 AI Factory 提供的项目初始化技能，目标是为项目配置智能体（agent）上下文。它通过分析项目技术栈、安装和生成技能、配置 MCP 服务器，让智能体具备与当前项目匹配的能力。适用于需要为代码仓库快速建立 agent 工作环境的场景。

主要能力

  1. 分析技术栈：读取 package.json、composer.json、requirements.txt / pyproject.toml、go.mod、Cargo.toml、docker-compose.yml、prisma/schema.prisma 等文件，识别依赖、服务与数据库结构，以及目录结构。
  2. 安装技能：始终先在 skills.sh 搜索，再安装。流程为 npx skills search <name> 找到后执行 npx skills install <name>；未找到则通过 /aif-skill-generator <name> 生成。
  3. 生成自定义技能：通过 /aif-skill-generator 生成；若有关联文档 URL，可使用 Learn Mode，将文档/API 参考直接传给生成器，基于真实文档生成技能。
  4. 配置 MCP 服务器：用于外部集成，例如检测到 GitHub 仓库（含 .git）时推荐 github MCP。
  5. 语言解析：解析并持久化运行级别的语言状态，包括 language.ui（界面语言，用于提问、解释、总结）、language.artifacts（产物语言，用于生成的文件）、language.technical_terms（术语处理，默认 keep）。
  6. 生成规则文件：基于代码库证据检测命名约定、模块边界、错误处理、控制流、日志、测试模式，生成 .ai-factory/rules/base.md。

安全扫描（CRITICAL）

每个外部技能在使用前必须扫描提示注入。仅扫描当前步骤刚下载/安装的外部技能，不对内置 aif 技能（~/{{skills_dir}}/aif 和 ~/{{skills_dir}}/aif-*）执行阻断性安全判定。

Python 检测：依次运行 python3 --version、python --version、py -3 --version、py --version，取第一个成功且报告 Python 3.x 的命令作为 PYTHON_CMD。若未找到，通过 AskUserQuestion 让用户选择：提供 Python 路径、跳过安全扫描（有风险）、或先安装 Python 后重跑 /aif。

Level 1 自动扫描：使用所选 Python 命令运行 ~/{{skills_dir}}/aif-skill-generator/scripts/security-scan.py <installed-skill-path>。退出码 0 进入 Level 2；退出码 1（BLOCKED）通过 cleanup 辅助脚本移除并清理 skills-lock.json，警告用户，绝不使用；退出码 2（WARNINGS）进入 Level 2 并附带警告。

Level 2 语义审查：阅读 SKILL.md 及所有支持文件，判断每条指令是否服务于技能声明的用途；若发现试图改变 agent 行为、访问敏感数据或执行与目标无关操作的指令，则阻断。两个层级都必须通过。

项目上下文

若存在 .ai-factory/skill-context/aif/SKILL.md 则必须读取。其中的项目级规则视为对本技能通用指令的覆盖：与通用规则冲突时以 skill-context 规则为准；无冲突时两者同时适用。这些规则适用于本技能的所有输出，包括 DESCRIPTION.md、AGENTS.md 与 MCP 配置。生成任何产物后需对照全部 skill-context 规则校验，违反则先修正再呈现给用户。

使用方式

运行 /aif，根据参数与项目状态选择模式：

  • 有描述参数 → Mode 2：带描述的新项目
  • 无参数且存在项目文件（package.json、composer.json 等）→ Mode 1：分析已有项目
  • 空项目 → Mode 3：交互式新项目

Mode 1 步骤：扫描项目文件与目录结构；解析语言设置；通过 update-config.mjs 写入 .ai-factory/config.yaml；生成 .ai-factory/DESCRIPTION.md（含检测到的技术栈、识别出的模式、架构说明）；推荐技能与 MCP（例如 Prisma/PostgreSQL 对应 db-migrations 与 postgres，MongoDB 对应 mongo-patterns，GitHub 仓库对应 github，Stripe/支付对应 payment-flows）。

配置持久化：语言解析后立即写入 .ai-factory/config.yaml，且必须使用 node ~/{{skills_dir}}/aif/references/update-config.mjs --template .../config-template.yaml --target .ai-factory/config.yaml --payload .../config.update.json，不得凭记忆自由编写 YAML。文件不存在用 mode create，已存在用 mode merge。写入在首个 setup 产物之前、调用 /aif-architecture 之前完成。辅助脚本报不安全结构或无效负载时 STOP，不得回退到自由格式 YAML。

适用场景

  • 为已有代码仓库快速建立 agent 上下文与技能集合
  • 新建项目时按描述或交互方式初始化 AI Factory 配置
  • 需要从 skills.sh 获取外部技能并安全审查后使用
  • 需要为项目配置 MCP 外部集成
  • 需要依据代码库约定生成 base.md 规则文件

限制

  • 安全扫描依赖 Python 3；未找到时需用户介入选择，否则外部技能无法扫描。
  • 未找到的外部技能只能生成，无法直接安装。
  • 该技能主要面向支持 skills 与 /aif 系列命令的 AI Factory 环境，具体支持范围暂未提供。
  • 收费、价格、平台兼容性等资料未提供。