Agentic Workspace Core：为编码智能体打造可移植的仓库原生基础架构

一个轻量级的仓库层解决方案，让AI编码助手从隐藏的记忆和过时的提示词中解放出来，通过文件化的知识系统实现可审计、可复现的协作

• 原作者/维护者： Daaaaave
• 来源平台： GitHub
• 原始标题： agentic-workspace-core
• 原始链接： https://github.com/Daaaaave/agentic-workspace-core
• 发布时间： 2026年5月25日

---

当开发者使用Claude、Cursor或其他AI编码工具时，一个常见的问题逐渐浮现：项目知识散落在聊天历史中，生成的上下文被当作真理，而未来的智能体不得不重复发现相同的决策或错误。每个工具都有自己的规则文件，项目知识无法持久化，协作变得混乱且不可复现。

Agentic Workspace Core正是为解决这一问题而生。它不是一个运行时框架、向量数据库或强制性的Obsidian仓库，而是一个可以安装到项目中并纳入版本控制的仓库原生基础层。

该项目的核心哲学是让智能体从仓库中的可检查文件工作，而非隐藏的聊天记忆或工具特定的规则蔓延。它建立了一套清晰的结构：

• AGENTS.md 作为权威的指令入口点
• docs/ 作为持久的项目知识库
• .agents/skills/ 作为可复用的智能体程序
• llms.txt 和 .agents/generated/ 作为生成的导航，而非策略
• .context/handoffs/ 作为临时的交接状态

一个关键的设计规则是：手写的Markdown是真相源，生成的文件仅用于导航。技能是程序化的，不拥有持久的项目事实。交接是临时的，被Git忽略。这种区分确保了知识管理的清晰边界。

安装过程极其简洁，只需在仓库根目录运行：

npx agentic-workspace-core@latest init --dry-run
npx agentic-workspace-core@latest init
npm run knowledge:check

对于0.1.x版本，初始化采用"替换优先"模式，适合需要干净Agentic Workspace Core层的受控项目。在替换前，init会将现有的智能体相关上下文移动到根目录的legacy/文件夹中，保留原始相对路径。

安装后，项目获得以下结构：

AGENTS.md
CLAUDE.md
llms.txt
.agents/
  knowledge.config.json
  generated/
  knowledge-core/
  skills/
  evals/skills/
docs/
  architecture/
  components/
  decisions/
  domain/
  glossary/
  plans/
  reference/
  research/
  runbooks/
  workflows/
.context/handoffs/   # 被Git忽略
legacy/              # 被Git忽略，仅在归档旧智能体上下文时创建

这种结构将知识按用途分类：架构决策、组件文档、领域知识、术语表、计划、参考资料、研究笔记、运行手册和工作流。

项目提供五个启动技能：

1. project-knowledge：回忆、路由、写入、纠正和验证持久的仓库知识
2. research-to-knowledge：有来源支持的研究和研究持久化
3. software-development-workflow：从任务契约到验证完成的非平凡编码工作
4. write-agent-skill：技能创建、修订、安全审查和评估
5. write-agent-handoff：针对另一个智能体、工作空间或未来会话的临时转移状态

项目还安装了三个npm命令：

• knowledge:build：重新生成llms.txt和.agents/generated/*
• knowledge:doctor：验证文档、技能、评估、配置和核心路径
• knowledge:check：验证生成的文件是否最新并运行doctor检查