让 AI Agent 来操作本项目

从"让 Agent 读懂项目"到"一套技能装进所有 Agent",三档由浅入深

本项目自带一份为 AI 编程助手写的 AGENTS.md:Agent 读完这一份文档,就能把项目装好、把片子做出来、把失败查清楚。想让 Agent 省掉"现学"这一步,可以再装上伴随技能库;如果你在多个 Agent 之间切换,还有第三档。

三档接入方式

1

第一档:把 Agent 指向本仓库

仓库自带 AGENTS.md,包含环境要求、四层部署验证清单与共享约定(日志前缀、重试模型、i18n 规范)。clone 之后,把下面这句话交给你的 Agent。

> 阅读这个项目的 AGENTS.md,安装依赖,配置 API Key,然后启动服务。
> 跑一下部署验证检查。

限制:AGENTS.md 住在仓库里,Agent 必须能读到仓库才能用;它同时讲"改项目"与"操作项目"。

2

第二档:装上伴随技能库

技能库把日常操作打包成三个现成技能,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 都要再来一次。

装好之后这样交代

  • · 我的任务失败了——查清原因,并告诉我值不值得修。
  • · 创意视频出来是无声的。我要旁白和字幕——配好并跑一遍。
  • · 拿我已完成的那个任务,优化分镜提示词,然后只重跑受影响的部分。
3

第三档:一套技能,所有 Agent

在多个 Agent 之间切换时,把技能库在 flint(本地优先的技能管理器)里登记一次:它会通过 symlink 或复制,把技能投放到你用到的每个 Agent 目录与项目目录。完全本地运行——无云端、无账号、无上报。

Flint ↗

Agent 最能帮上忙的地方:手动模式

手动模式会在检查点暂停流水线:Agent 读任务产物清单、就地改文件、预演哪些下游步骤会重跑,再确认继续。于是"润色旁白""修字幕"变成一次交代。

手动模式指南 →

三者边界

  • AGENTS.md —— 用于修改本项目的代码
  • 伴随技能库 —— 用于操作本项目
  • 本页 —— 两者之上的权威说明

现在就开始

不用 Agent 也一样能用:网页版 Studio 零安装,自托管版本功能最全。

相关页面

Agent 接入方式的文档依据

本文三档接入方式(读 AGENTS.md / 装伴随技能库 / 用 flint 分发)与其中的命令,均以本项目伴随技能库与 flint 的官方实现为准。

  1. agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)

    AGENTS.md、四层部署验证清单与 docs/public 的 Agent 操作文档,以本项目仓库为准。

  2. agnes-video-generator-skills — 项目伴随技能库(使用 / 排障 / 贡献)lcy362 · GitHub (2026)

    三个技能(使用 / 排障 / 贡献)、其覆盖范围与随附脚本,以技能库仓库为准。

  3. Flint — 本地优先的个人 AI 技能管理器(skills manager)与技能中枢lcy362 · GitHub (2026)

    第三方源登记、symlink / 复制分发到各 Agent 与项目目录的能力与本地优先特性,以 flint 仓库为准。

内容可信度说明

本文由一线实践者撰写,写的时候交叉核对了 arXiv 论文、厂商技术报告和 Stanford AI Index 等一手来源,不是凭主观印象下的结论。

S

SandGrid@lcy362

Agnes Video Generator 项目作者 · 全栈开发者

独立开发者,开源 AI 视频生成工具 Agnes Video Generator 的作者。项目基于 Agnes AI 完全免费的视频模型,MIT 协议开源,已经帮 1,000+ 创作者零成本产出过 AI 视频。长期关注视频生成模型的工程化和普及,文章内容都来自一线实践和一手研究。

访问 GitHub

最后更新:2026-08-21

准备好开始创作了吗?

「让世界级的 AI 属于每一个人。」—— Bruce Yang。完全免费,不用信用卡,也不要高性能显卡,零成本做出你的第一支 AI 视频。想用 Agnes AI 的免费视频模型?从这里开始就行。

克隆 GitHub 仓库,两分钟即可启动