Skip to content

docs: add Agentfile spec v1#99

Open
RussellLuo wants to merge 5 commits into
mainfrom
agentfile-spec-v1
Open

docs: add Agentfile spec v1#99
RussellLuo wants to merge 5 commits into
mainfrom
agentfile-spec-v1

Conversation

@RussellLuo
Copy link
Copy Markdown
Collaborator

@RussellLuo RussellLuo commented May 22, 2026

No description provided.

- 同步、升级、去重、收藏、权限控制、来源追踪和引用都需要稳定 ID。
- `updated_at` 不能替代模板 ID。

#### `version`
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: template versioning in repos and pinning old versions

The spec defines version semantics well, but not how multiple versions coexist in a repo/registry or how users select an older one.

Please clarify:

Storage model — overwrite templates//, versioned subdirs (//), or manifest-only with remote artifacts?
User refs — does registry/slug support a version (@0.1.0 / /0.1.0)? What is “latest” when omitted?
Agent lifecycle — are created agents pinned to the template revision, or do they follow future bumps?
A short subsection with one layout example + one CLI pinning example would close the gap with the existing id + version upgrade guidance.

@RussellLuo RussellLuo force-pushed the agentfile-spec-v1 branch from e9dc3e3 to 879ab24 Compare May 24, 2026 04:54
@RussellLuo RussellLuo force-pushed the main branch 2 times, most recently from 8a30e5b to 2f43ca0 Compare May 25, 2026 06:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants