agent-template/README.md

Wayflow Agent Template

This repository contains a Wayflow Agent Package.

• Package metadata: agent-package.json
• Agent instructions: instructions/AGENTS.md
• Agent Skills: skills/
• Package scripts: scripts/
• Evaluations: evaluations/
• Evolution policies: policies/

Keep generated runtime state and secrets out of version control.

初始化 Git 子模块

如果本仓库通过 Git submodule 引入 Skill 或其他资源，首次克隆、切换版本或更新代码后， 请在仓库根目录执行：

git submodule update --init --recursive

该命令会初始化子模块及其嵌套子模块，并检出当前仓库锁定的提交。 校验和打包前请确保初始化成功；打包读取锁定的提交，不包含子模块内未提交的修改。

用作 Gitea 模板

本仓库是 Agent Workforce 的通用草稿模板，默认使用 general 角色和 wayflow.agent-package/v4 Schema。

在 Agent Workforce 插件实例配置中设置：

{
  "giteaTemplateRepository": "pub-template/agent-template"
}

新建 Agent 时，插件会从本仓库生成独立开发仓库，更新包 ID、版本号、角色和标题。 模板内的 instructions、skills、assets 和其他包内容会保留。 开发辅助技能维护在 .agents/skills/，由插件安装到 Agent 开发工作区。

添加资源、技能或运行脚本后，请同步更新 agent-package.json 中的声明。 如使用子模块，建议使用明确的 HTTPS URL；生成的仓库位于 wagent 组织， 相对 URL 会按新仓库地址解析。

技能与角色维护

.agents/skills/agent-package-authoring 是 Package 编写的统一入口，按需读取 references 中的 instructions、capabilities、result contract、Skill 集成和资产交付规则。

.agents/skills/skill-creator 提供通用 Skill 创建、更新和校验流程；其 upstream/agentskills 子模块保留完整的 Agent Skills 规范与参考工具。

.agents/skills/agent-runtime-guide 用于指导 Agent 开发与维护，仅作为开发辅助技能安装， 不在 agent-package.json 中声明，也不进入运行时技能包。 role/ceo、role/pm 和 role/shared/skills/wayflow-hire-agent 是可选角色素材， 由 Workforce 在初始化对应角色时安装；通用 Agent 不安装 Hire 技能。 包编写辅助技能由本仓库 .agents/skills/ 维护；版本编排和演进分析技能仍由插件仓库维护。

本仓库由插件以 Git submodule 引用。修改模板后先提交、推送本仓库， 再更新插件仓库中的 submodule 指针并构建，插件包携带锁定的模板文件。 使用 Gitea Template API 的自定义模板仍使用其默认分支；它不受本地 submodule 指针锁定。