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

README.mdhuyanluanyuqaq/workspace-template

一套通用、可扩展、可复用、可维护的多项目 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.