用途:为项目提供一套实现 AgentOS 三层上下文模型的目录布局,适用于初始化项目、整理文档,以及说明规格(spec)与变更(change)文件应放置的位置。
主要能力:定义三层目录结构。第一层 docs/standards/ 表示“如何构建”,存放技术模式、编码原则与架构决策,如 coding.md(TDD 模式:Stub → Test → Implement → Refactor)和 architecture.md(分层架构:Router → Service → Repository → Entity → Database)。第二层 docs/product/ 表示“做什么与为什么”,存放产品愿景、路线图与业务背景,如 product.md(产品定义、目标用户、核心功能、成功指标)和 roadmap.md(按优先级排列的接下来 3 个功能、实现策略、当前状态)。第三层 docs/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/ 任务跟踪与 CLAUDE.md 项目概览。
Beads 任务跟踪:.beads/ 下 beads.jsonl 为 Git 跟踪的任务数据,beads.db 为本地缓存(gitignored),bd.sock 为套接字(gitignored)。.gitignore 需加入 .beads/beads.db 与 .beads/bd.sock。Beads 提供依赖感知的任务管理,/spec:create 与 /spec:propose 等命令会自动创建 epic,并按技术依赖顺序(Entity → Repository → Service → Router)排列任务。
限制:资料未提供该技能的安装方式、收费情况、支持平台及实际效果等信息。