Browse / General-purpose / workspace-template
workspace-template
huyanluanyuqaq
NDLDSN workspace agent 协作框架模板仓(templates/ + .agents/ 快照的唯一权威来源,供 F10 门禁参照)
Open huyanluanyuqaq/workspace-template → Checked against the four rules.
Works with any agent
ships AGENTS.md, the cross-tool instruction file.
In its own words
一套通用、可扩展、可复用、可维护的多项目 Multi-Agent 协作框架。 与具体技术栈无关;所有协作状态落盘为文件;任何 AI Agent(Claude / Codex / OpenCode / Hermes / 未来 Agent)均可接入。
1. 这是什么?
本仓库不是一个软件项目,而是一个 Agent Workspace Operating Framework。
多个 AI Agent 要在多个项目上长期协作,但 Agent 会退出、重启、换模型、换工具, 而协作状态不能丢。
答案是:把所有协作状态放进文件系统,用 Git 管理,让文件成为唯一事实来源。
2. 架构
- 约束轴:Security / Safety / System 规则为受保护规则,永远生效,任何层不得削弱。
- 特化轴:非受保护规则按具体性覆盖 —— Workspace → Project → Task → 目录 → 任务上下文。
4. Agent 如何工作
- Agent 不依赖聊天上下文,一切以文件为准。
- Agent 开始前必须声明 Role。
- Agent 结束时必须写 Handoff(不能只靠聊天交接)。
5. 如何创建新项目
方式 A — 使用脚本(推荐)
脚本会:复制 templates/project/ → projects/my-project/,替换占位符,并可选初始化 Git。
方式 C — 接入既有项目
已有一个在开发的项目,想纳入本 Workspace?
不要复制模板覆盖它。 按 .agents/protocols/project-adoption.md 执行, 核心原则是 只加不改:只追加协调层(AGENTS.md + docs/ + tasks/), 不动源码、测试、构建配置。
创建后
- 编辑
projects/my-project/AGENTS.md,填完所有{{PLACEHOLDER}}。 - 在
projects/README.md登记该项目。 - 在
docs/requirements/写需求,在docs/architecture/写架构。 - 把第一个 Task 放进
tasks/backlog/,开始协作。
6. 如何开始一个 Task
- 从
templates/task/TASK.md复制,创建:
projects/ /tasks/backlog/TASK-001- /TASK.md
- 填完 TASK.md 的静态部分(Objective / Scope / Acceptance Criteria / …)。
- 状态设为
READY,分配给某个 Role。 - 把 Task 目录从
backlog/移到active/,状态设为ACTIVE。 - 按 Workflow 推进,每次交接写 Handoff。
- Reviewer 给 PASS 后,移入
done/。
7. Agent 如何协作
架构变更回流: Developer 若发现设计不可行 → 回到 Architect。
Quoting 50% of the README. Read the rest on GitHub ↗
Read from the repository's git tree on 2026-08-17.