企业官网建设流程全解析

396个技能包怎么装？ai-engineering-from-scratch install_skills.py使用完全指南

【免费下载链接】ai-engineering-from-scratchLearn it. Build it. Ship it for others.项目地址: https://gitcode.com/GitHub_Trending/ai/ai-engineering-from-scratch

ai-engineering-from-scratch 仓库内置了396 个技能包（skills）和99 个提示词模板（prompts），全部以标准化格式存放在各课程的outputs/目录中。你不需要手动拷贝文件——仓库自带安装脚本 scripts/install_skills.py，一条命令就能把它们按类型、阶段、标签筛选后批量安装到你指定的目标目录，并自动生成清单文件。本指南带你从零完成全部安装。

仓库里到底有多少技能包？

打开 README.md 可以看到，仓库在phases/**/outputs/下共提供：

技能包有两种形态：

• 单文件技能：一个带 YAML 元信息的 Markdown 文件，如 skill-fipa-mapper.md
• 目录技能包（bundle）：包含SKILL.md、参考文档、脚本和素材的完整目录，如 skill-contract-reviewer/，安装时会整目录复制，并做完整性校验

安装前准备：克隆仓库 + 一条 Python 环境

脚本只依赖 Python 标准库，无需安装第三方包。

git clone https://gitcode.com/GitHub_Trending/ai/ai-engineering-from-scratch cd ai-engineering-from-scratch python3 --version # 3.8+ 即可

核心文件就两个：安装入口 install_skills.py 和它依赖的公共校验库 _lib.py。

最快方式：一条命令装全部 396 个技能包

python3 scripts/install_skills.py ~/my-skills

这条命令会：

1. 扫描phases/下所有outputs/目录
2. 安装全部 396 个技能包（默认--type skill）
3. 按默认skills布局写入~/my-skills/<技能名>/SKILL.md
4. 在目标目录生成manifest.json安装清单

完成后终端会提示installed 396 artifact(s) into ~/my-skills，即可把~/my-skills指向你的 Agent 工具使用的技能目录。

按需求筛选：只装你要的那部分

三个筛选参数可任意组合，帮你从 396 个技能包里精准取货：

# 技能 + 提示词 + 智能体全都要 python3 scripts/install_skills.py ~/my-skills --type all # 只要 RAG 标签的技能包 python3 scripts/install_skills.py ~/my-skills --tag rag # 组合筛选：Phase 13 里所有产物 python3 scripts/install_skills.py ~/my-skills --phase 13 --type all

三种目录布局：选对结构事半功倍

--layout控制安装后的目录组织方式：

python3 scripts/install_skills.py ~/my-skills --layout flat python3 scripts/install_skills.py ~/my-skills --layout by-phase

注意：同一次安装请固定使用一种布局，混用会导致同名冲突提示。

先预览再落盘：dry-run 与强制覆盖

第一次使用建议先"空跑"，只打印将安装什么、装到哪里，不写任何文件：

python3 scripts/install_skills.py ~/my-skills --dry-run

输出前 20 条安装计划加总数，确认无误后去掉--dry-run正式执行。

三个实用开关：

• --force：目标文件已存在时强制覆盖。脚本不会静默覆盖——不加--force时，遇到已有文件会报错并列出冲突路径，避免误伤你改过的内容
• --json：关闭人类可读输出，只写manifest.json，方便接自动化流程
• 脚本内置安全校验：拒绝符号链接逃逸、非法路径等风险操作，目录包安装采用"暂存—校验—原子替换"方式，中途失败不会留下半成品

装完怎么核对？看 manifest.json

每次安装都会在目标目录生成manifest.json，记录：

• 每个产物的类型、名称、版本、标签、来源路径（相对仓库根目录）
• 目录包还包含其源目录和文件列表
• 按类型、按阶段的数量统计

打开它就能回答"我到底装了哪些技能包、分别来自哪节课"。另外仓库根目录的 outputs/index.json 是产物总索引，可用于对照。

常见问题速查

• no artifacts matched the given filters：筛选条件太严，--phase和--tag同时使用时是"且"关系，放宽其中一个即可
• target file(s) already exist：目标目录已有同名文件，加--force覆盖，或换一个干净的目标目录
• 想只装 5 个目录技能包练手：这些 bundle 都来自 Phase 13 的技能系列课程，如 skill-safety-reviewer、skill-release-gate，用--phase 13即可

写在最后

从 396 个技能包里取货，你只需要记住三件事：一条命令装全部、三个参数做筛选、dry-run 先预览。装完看一眼manifest.json，你的 AI 工具箱就建好了。

【免费下载链接】ai-engineering-from-scratchLearn it. Build it. Ship it for others.项目地址: https://gitcode.com/GitHub_Trending/ai/ai-engineering-from-scratch