EasyAgentTeam Template Builder
Start With A Workspace Copy
- Create a fresh workspace copy with
scripts/init_eat_workspace.py <target-dir>. - Work inside that copied workspace, not inside the skill folder.
- Keep the generated layout intact:
.agent-tools/agents/roles/skills/bundles/reports/workspace/
Plan-First Rule
Do not write the final bundle or run check/publish until planning is aligned with the user.
Clarify and lock:
- goal and scope
- reusable agent responsibilities
- skills to import
- IDs and naming rules
- project and workflow shape
- deliverables and evidence files
If a workflow is involved, present a Markdown Mermaid flowchart and get explicit user confirmation before generating the final workflow template, workflow run, or bundle.
Read references/planning-checklist.md when details are still fuzzy.
Working Contract
Follow the generated workspace contract in AGENTS.md and keep the six-step evidence flow closed:
goalrolesagentsproject/workflowbundlesubmit
Each step must leave evidence under reports/step-0X-* before moving forward.
Bundle Rules
- Keep agent prompts limited to function, usable external tools, and method.
- Do not describe EasyAgentTeam runtime internals inside agent prompts.
- Keep roles reusable rather than one-off.
- Keep workflow task contracts explicit: objective, input, output, constraints, boundary, exception handling, acceptance criteria.
- Keep
artifactsunderworkspace/and makewrite_setcover them without cross-task overlap. - Keep
workflow_run.auto_startfalse. - An empty local
skills/directory is allowed during planning; local skill import stays skipped until real skill packages are added.
Read references/workspace-contract.md if you need the detailed constraints.
Validation And Publish
Use only these entrypoints inside the copied workspace:
node .agent-tools/scripts/template_bundle_guard.mjs checknode .agent-tools/scripts/template_bundle_guard.mjs publish
publish must remain check-first and must not auto-start runs.
References
references/planning-checklist.mdreferences/workspace-contract.md