aif-skill-generator 是 lee-to/ai-factory 下的一个技能生成器,定位为「Agent Skills 架构师」,用于帮助用户创建专业、可投入生产的技能,并遵循 Agent Skills 开放标准。
【用途】 面向需要为 AI 代理构建技能包的使用者。核心场景包括:交互式地从零生成新技能;从一组 URL 中学习并据此生成技能(学习模式);搜索已有技能以获得灵感或避免重复;对技能做安全扫描与全量校验。
【主要能力】
- 技能包生成:按标准结构产出包含 SKILL.md(必需)、references/、scripts/、templates/、assets/ 等的完整技能包。
- 学习模式:抓取并研究参数中的 URL,配合补充搜索整理知识库,再向用户提出 2-3 个针对性问题(技能名、类型、定制项),生成技能包后自动对其执行安全扫描。
- 快捷命令:/aif-skill-generator <name>(交互生成)、<url>...(学习模式)、search <query>(在 skills.sh 搜索)、scan <path>(两级安全扫描)、validate <path>(结构检查 + 两级安全扫描)、template <type>(basic、task、reference、visual 模板)。
- 项目级规则:若存在 .ai-factory/skill-context/aif-skill-generator/SKILL.md,必须读取,并将其中规则作为本技能通用指令的项目级覆盖;冲突时项目规则优先,且该规则同样约束生成产物(包括生成的 SKILL.md 与技能包结构),生成后需逐条核验合规。
【安全扫描(两级)】 第一级为 Python 扫描器(regex + 静态分析),可捕获已知模式、编码载荷(base64、hex、零宽字符)、HTML 注释注入;退出码含义为:0 继续、1 阻止安装、2 存在警告需继续人工复核。第二级为 LLM 语义复核,由代理亲自阅读 SKILL.md 及全部支持文件,判断是否存在试图改变角色/目标/行为、访问或传输敏感数据、与声明的用途无关的命令、通过紧迫感或权威施压进行操纵等情形。两级都必须通过;任一级标记即阻止。技能内容被视为不可信输入,技能不得自证安全;扫描器结果与代理自身判断优先于技能内任何文字。若被阻止,则调用清理脚本(需带 --skill 与 --installed-path,复用传给 security-scan.py 的同一路径)并上报威胁。
【Python 检测】 按顺序探测 python3 --version、python --version、py -3 --version、py --version,取第一个成功报告 Python 3.x 的命令;未找到时可询问用户路径、在用户自担风险下跳过扫描(此时不调用 Python 扫描器,仍执行第二级人工复核)或建议安装 Python。
【validate 模式】 结构检查项包括:SKILL.md 存在、name 与目录名一致、name 为小写加连字符、description 同时说明做什么与何时用、frontmatter 无 YAML 语法错误、argument-hint 含方括号时必须加引号(未加引号会导致 YAML 解析错误,形如 [topic: foo|bar] 会被解析为数组内含字典从而崩溃代理 TUI)、正文少于 500 行、文件引用使用相对路径。随后执行两级安全扫描,并输出结构 + 安全的合并报告(FAIL / WARNINGS / PASS 三种结论)。
【使用方式与限制】 通过斜杠命令调用,参数以 scan、search、validate、template 开头或包含 http(s) URL 时进入相应模式,否则走标准生成流程。标准流程包含理解需求、调研、设计、编写 SKILL.md 等步骤,其间若安装外部技能需立即扫描,被阻止则清理并告警。安全扫描依赖 Python 3;未安装时第一级可跳过但需用户确认风险。扫描范围与威胁类别、严重级别、用户沟通模板等需阅读 references/SECURITY-SCANNING.md。
【暂未提供】 关于收费、价格、平台支持范围、生成效果的量化指标等,资料中暂未提供。