文件分工
| 文件 |
作用 |
SKILL.md | AI Agent 的执行入口，说明触发方式、流程和必读文件。 |
AGENT.template.md | 项目骨架、Project Profile 与迁移契约。 |
skill.json | 机器可读元数据，用于索引、安装、版本检查和自动发现。 |
index.html | 浏览器可读页面。 |
适用场景
- 新仓库需要统一的 Agent 入口与 Project Profile。
- 旧版 agents-init 项目需要迁移到 v5 职责边界。
- 项目准备通过 project-runtime 管理 Skill、MCP、Task/Case 与 Git。
- 公开模板需要排除个人规则、凭据与私有路径。
输入信息
| 字段 |
必填 |
说明 |
| 项目名称 | 是 | 仓库或产品的名称。 |
| 项目类型 | 是 | 代码、文档、工作流或其他可组合类型。 |
| 技术栈 | 是 | 可从仓库文件确认的语言与框架。 |
| 运行环境 | 是 | 本地、容器、远程或混合。 |
| Agent 客户端 | 是 | Codex、Cursor、Claude Code 等入口。 |
| 项目命令 | 否 | 不能确认时保留 TODO，不由模板臆造。 |
标准流程
- 扫描仓库并确认可证实的 Project Profile 字段。
- 预览 v5 文件计划和所有路径冲突。
- 确认后运行无覆盖初始化器。
- 解析 JSON 并检查 Agent 路由一致性。
- 由同包 project-runtime 后续导入或同步 Skill/MCP。
- 由独立 Opinion provider 管理用户规则与场景检查。