让 AI Agent 来操作本项目
从"让 Agent 读懂项目"到"一套技能装进所有 Agent",三档由浅入深
本项目自带一份为 AI 编程助手写的 AGENTS.md:Agent 读完这一份文档,就能把项目装好、把片子做出来、把失败查清楚。想让 Agent 省掉"现学"这一步,可以再装上伴随技能库;如果你在多个 Agent 之间切换,还有第三档。
三档接入方式
第一档:把 Agent 指向本仓库
仓库自带 AGENTS.md,包含环境要求、四层部署验证清单与共享约定(日志前缀、重试模型、i18n 规范)。clone 之后,把下面这句话交给你的 Agent。
> 阅读这个项目的 AGENTS.md,安装依赖,配置 API Key,然后启动服务。
> 跑一下部署验证检查。限制:AGENTS.md 住在仓库里,Agent 必须能读到仓库才能用;它同时讲"改项目"与"操作项目"。
第二档:装上伴随技能库
技能库把日常操作打包成三个现成技能,Agent 不必先把这个项目摸一遍。它们只有文档与小脚本——不含服务代码,也不经手任何密钥。
三个技能
- ✓使用:部署、选模式、提交并观察任务、在手动模式检查点改产物
- ✓排障:查清一次失败的真正原因,并判断它值不值得修
- ✓贡献:改本项目的代码,并让 PR 通过 CI
推荐:用 flint 安装
flint 是本地优先的开源技能管理器:把技能集中在一处,一次登记即可投放到任意 Agent 与项目目录。它只认本地源、不会替你 clone,所以要登记的就是上面 clone 下来的那个目录。开源免费,欢迎 Star。
git clone https://github.com/lcy362/agnes-video-generator-skills.git
npx flint-skills-hub # Sources → add the cloned directory (flint reads its skills/ subdirectory)或者:手动拷贝(不用 flint)
cp -R agnes-video-generator-skills/skills/* <project>/.agents/skills/同一套技能就是普通目录,拷进项目的 .agents/skills/ 即可(任何读该目录的 Agent 都能用)。代价是每个项目、每上一个新 Agent 都要再来一次。
装好之后这样交代
- · 我的任务失败了——查清原因,并告诉我值不值得修。
- · 创意视频出来是无声的。我要旁白和字幕——配好并跑一遍。
- · 拿我已完成的那个任务,优化分镜提示词,然后只重跑受影响的部分。
第三档:一套技能,所有 Agent
在多个 Agent 之间切换时,把技能库在 flint(本地优先的技能管理器)里登记一次:它会通过 symlink 或复制,把技能投放到你用到的每个 Agent 目录与项目目录。完全本地运行——无云端、无账号、无上报。
Flint ↗Agent 最能帮上忙的地方:手动模式
手动模式会在检查点暂停流水线:Agent 读任务产物清单、就地改文件、预演哪些下游步骤会重跑,再确认继续。于是"润色旁白""修字幕"变成一次交代。
手动模式指南 →三者边界
- AGENTS.md —— 用于修改本项目的代码
- 伴随技能库 —— 用于操作本项目
- 本页 —— 两者之上的权威说明
现在就开始
不用 Agent 也一样能用:网页版 Studio 零安装,自托管版本功能最全。
相关页面
Agnes Video Generator 自托管部署教程 — 手动/Docker/npm/AI Agent | 免费 AI 视频
把免费开源的 AI 视频生成器跑在自己的电脑或服务器上:start.sh 手动部署、Docker 一条命令、npm CLI、AI Agent 辅助共四种方式,含完整命令、系统要求与环境变量说明,轻松自托管。
手动模式使用说明 — 自动随性生成 vs 手动精准出片 | Agnes Video
Agnes Video Generator 手动模式使用说明:在分镜、参考图、视频、配音、字幕、成片等检查点暂停,逐环节确认或修改产物后再继续,可配合更强的外部 AI 或工具实现有明确预期的输出。自动模式适合提供思路随性生成(vibe video generating),手动模式适合有明确输出预期、微调各阶段产物,并与自动模式做对比。
版本更新日志 — Agnes Video Generator
查看 Agnes Video Generator 全部版本的更新记录:新功能、改进、Bug 修复与部署方式,包含自 v1.0 起的完整版本历史。
Agent 接入方式的文档依据
本文三档接入方式(读 AGENTS.md / 装伴随技能库 / 用 flint 分发)与其中的命令,均以本项目伴随技能库与 flint 的官方实现为准。
- agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)
AGENTS.md、四层部署验证清单与 docs/public 的 Agent 操作文档,以本项目仓库为准。
- agnes-video-generator-skills — 项目伴随技能库(使用 / 排障 / 贡献)lcy362 · GitHub (2026)
三个技能(使用 / 排障 / 贡献)、其覆盖范围与随附脚本,以技能库仓库为准。
- Flint — 本地优先的个人 AI 技能管理器(skills manager)与技能中枢lcy362 · GitHub (2026)
第三方源登记、symlink / 复制分发到各 Agent 与项目目录的能力与本地优先特性,以 flint 仓库为准。
内容可信度说明
本文由一线实践者撰写,写的时候交叉核对了 arXiv 论文、厂商技术报告和 Stanford AI Index 等一手来源,不是凭主观印象下的结论。
SandGrid@lcy362
Agnes Video Generator 项目作者 · 全栈开发者
独立开发者,开源 AI 视频生成工具 Agnes Video Generator 的作者。项目基于 Agnes AI 完全免费的视频模型,MIT 协议开源,已经帮 1,000+ 创作者零成本产出过 AI 视频。长期关注视频生成模型的工程化和普及,文章内容都来自一线实践和一手研究。
访问 GitHub最后更新:2026-08-21