AGENTS.md · diff

git:20260330.c32cc34 to git:20260430.b8d5fbd

15 added, 37 removed. Audit A to A.

- # Spec 驱动式开发 - Skills 体系

+ # R&K Flow Skills

- 构建完整的 Skills 体系，通过 Obsidian 实现 Spec 驱动式开发方法论。v2.0 引入 Agent Teams 多角色协作架构，将开发流程拆分为 5 个阶段，由 6 个专职角色分工协作。

+ R&K Flow 是一套 Spec 驱动式开发 Skills 体系，通过 Obsidian 管理文档，用 Agent Teams 多角色协作架构驱动开发流程。

- ## 技术栈

+ ## 项目身份

- - **AI Agent**: Claude Code (Anthropic)

- - **文档系统**: Obsidian

- - **版本控制**: Git

- - **文档格式**: Obsidian Flavored Markdown

- - **数据格式**: YAML (frontmatter), JSON (canvas)

- **类型**: 开发工作流框架 / Skills 工具库

- ## 项目规范

- ### 开发方法论

- 本项目采用 **Spec 驱动式开发**，所有功能开发遵循以下流程：

- 1. 先设计（plan.md），后实现

- 2. 严格遵循 Spec，不添加额外功能

- 3. 每个实现都可追溯到 Spec 文档

- 4. 完整的开发过程记录在 Obsidian 中

+ - **运行时**: Claude Code / Codex / compatible coding agents

+ - **文档系统**: Obsidian

+ - **版本控制**: Git / GitHub Flow

- ### 编码规范

+ ## 详细规则入口

@import .agents/rules/

- ### 文档规范

- - 所有 Spec 文档使用 Obsidian Flavored Markdown

- - 命名规范：`YYYYMMDD-HHMM-任务描述`（任务描述必须中文）

- - 使用 `[[wikilink]]` 建立文档关联

- - 每个文档包含完整的 YAML frontmatter

- ### 开发流程

- - 新功能开发：`/spec-start` → 5 阶段流程

- - 功能更新：`/spec-update`

- - 问题修复：`/spec-debug`

- - 经验检索：`/exp-search`

- - 经验沉淀：`/exp-reflect`

+ ## 目录路由

- ### 记忆系统

+ - `spec-*`：R&K Flow 核心 Spec 生命周期 Skills

+ - `exp-*`：经验与知识记忆 Skills

+ - `git-work/`：GitHub Flow 工作流

+ - `.agents/rules/`：本仓库长期规则、项目偏好和文档规范

+ - `spec/context/experience/`：显式经验记忆

+ - `spec/context/knowledge/`：显式知识记忆

- - 自动层：Auto Memory（Claude 自主管理）

- - 显式层：`spec/context/experience/` + `spec/context/knowledge/`

- - 索引文件始终加载，详情按需检索

+ > AGENTS.md 是入口清单，不承载长篇规范。详细规则和项目偏好维护在 `.agents/rules/`。