用途:project-structure 提供一套目录布局,用于实现 AgentOS 三层上下文模型,帮助在搭建项目、组织文档以及说明规格与变更应放置位置时保持结构一致。
主要能力:项目根目录包含 docs/、.beads/ 和 CLAUDE.md。docs/ 下分三层:standards/ 为第一层,描述“如何构建”,含 coding.md(TDD 模式:Stub → Test → Implement → Refactor 及编码原则)与 architecture.md(分层架构:Router → Service → Repository → Entity → Database);product/ 为第二层,描述“做什么与为什么”,含 product.md(产品定义、目标用户、核心功能、成功指标)与 roadmap.md(按优先级排列的接下来三个功能、实现策略、当前状态);spec/ 为第三层,描述“接下来构建什么”。
使用方式:新功能(全新代码)放在 docs/spec/<feature>/spec.md,统一包含需求(用户故事、验收标准、业务规则)与技术设计(数据模型、API 设计、组件结构)。已有代码的变更放在 docs/changes/<feature>/<change>/,含 proposal.md(变更提案)、delta.md(ADDED/MODIFIED/REMOVED 变更)和 tasks.md(实现任务)。工作流命令为 /spec:propose 创建 proposal.md 与 delta.md,/spec:work 执行实现,/spec:complete 将 delta 合并进 spec.md 并删除变更文件夹。
任务跟踪:.beads/ 目录含 beads.jsonl(Git 跟踪的任务数据)、beads.db(本地缓存,需 gitignore)和 bd.sock(套接字,需 gitignore)。.gitignore 应加入 .beads/beads.db 与 .beads/bd.sock。Beads 提供依赖感知的任务管理,/spec:create 与 /spec:propose 等命令会自动创建按技术依赖排序(Entity → Repository → Service → Router)的 epic 与任务。
适用场景:需要统一项目文档分层、区分标准/产品/规格、并管理规格变更与任务依赖的团队或项目。
限制:资料未提供安装方式、平台支持、收费信息或具体命令参数细节,暂未提供。