.codebuddy 目录结构说明

~/.codebuddy/
├── settings.json              # 用户级全局配置
├── settings.local.json        # 本地个人偏好（不共享）
├── CODEBUDDY.md               # 用户级记忆文件
├── mcp.json                   # 全局 MCP 服务器配置
├── statusline-command.sh      # 自定义状态行脚本（可选）
│
├── agents/                    # 用户级自定义子代理（所有项目可用）
├── rules/                     # 用户级规则文件（所有项目可用）
├── skills/                    # 用户级技能（所有项目可用）
│
├── projects/                  # 各项目的会话与子代理运行时数据
├── sessions/                  # 会话数据
├── plans/                     # 计划模式生成的计划文件
│
├── logs/                      # 运行日志
├── traces/                    # 执行追踪数据（OpenTelemetry）
├── file-history/              # 文件变更历史
├── history.jsonl              # 对话历史
├── blobs/                     # 二进制资源（图片、截图等）
├── tasks/                     # 任务追踪数据
├── teams/                     # Agent 团队运行时数据
├── shell-snapshots/           # Bash 沙箱快照
│
├── plugins/                   # 已安装的插件
├── local_storage/             # CLI 键值持久化存储
├── channels/                  # 频道配置（WeChat 等）
│
├── computer-use/              # Computer Use 功能记录
├── debug/                     # 调试信息
└── usage-data/                # 使用量统计

{
  "language": "简体中文",
  "model": "gpt-5",
  "reasoningEffort": "high",
  "permissions": {
    "defaultMode": "default",
    "allow": ["Bash(git:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "memory": {
    "autoMemoryEnabled": true,
    "typedMemory": true
  },
  "trustedDirectories": ["~/workspace/myproject"]
}

## 工具偏好
- 使用 pnpm 而非 npm
- 倾向函数式编程风格

## 代码风格
- 使用 2 空格缩进

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

~/.codebuddy/agents/
├── code-reviewer.md      # 代码审查代理
└── translator.md         # 翻译代理

---
name: code-reviewer
description: 代码审查专家，在编写代码后主动使用
tools: Read, Grep, Glob, Bash
model: inherit
---

您是一位高级代码审查员，专注于代码质量、安全性和实践教程...

~/.codebuddy/rules/
├── preferences.md        # 个人编码偏好
└── workflows.md          # 常用工作流规范

---
alwaysApply: false
paths: src/**/*.ts
---

# TypeScript 规范

- 优先使用 `interface` 而非 `type`
- 禁止使用 `any`

~/.codebuddy/skills/
└── pdf/
    └── SKILL.md

.codebuddy/
├── settings.json              # 项目共享配置
├── settings.local.json        # 本地个人配置（.gitignore 自动忽略）
├── CODEBUDDY.md               # 项目级记忆文件
│
├── agents/                    # 项目级自定义子代理
├── rules/                     # 项目级规则文件
├── skills/                    # 项目级技能
├── commands/                  # 自定义斜杠命令

{
  "permissions": {
    "allow": ["Read", "Edit", "Bash(git:*)", "Bash(npm:*)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  },
  "enabledPlugins": {
    "pr-review-toolkit@company-tools": true
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "myorg/codebuddy-plugins"
      }
    }
  }
}

# 项目说明

本项目是 TypeScript monorepo（Yarn workspaces）。

## 常用命令

- `yarn build` — 构建所有包
- `yarn test` — 运行所有测试

## 架构约定

- 使用 CellJS 依赖注入框架
- 协议定义放在 `*-protocol.ts` 文件

.codebuddy/agents/
├── blog-translator.md     # 博客翻译代理
└── docs-reviewer.md       # 文档审查代理

.codebuddy/rules/
├── code-style.md          # 代码风格规范
├── testing.md             # 测试规范
├── security.md            # 安全要求
└── frontend/
    ├── react.md           # React 组件规范
    └── styles.md          # 样式规范

.codebuddy/skills/
├── case-executor/
│   ├── SKILL.md           # 技能定义
│   ├── scripts/           # 辅助脚本
│   └── references/        # 参考资料
└── cnb-api/
    └── SKILL.md

---
name: case-executor
description: 执行 JSON 测试用例并生成报告
allowed-tools: Read, Write, Bash
---

您是测试执行专家，负责运行 JSON 格式的 UI 测试用例...

.codebuddy/commands/
├── deploy.md              # /deploy 命令
├── team/
│   ├── issue-start.md     # /team:issue-start 命令
│   └── create-issue.md    # /team:create-issue 命令
└── openspec/
    └── propose.md         # /openspec:propose 命令

---
description: 创建一个新的 Issue
argument-hint: "<描述> ; <类型> ; <产品>"
allowed-tools: Bash 
---

根据以下描述创建 Issue：$ARGUMENTS

命令行参数                         （最高优先级）
    ↓
.codebuddy/settings.local.json    （项目本地，不提交版本控制）
    ↓
.codebuddy/settings.json          （项目共享，团队统一）
    ↓
~/.codebuddy/settings.json        （用户全局，个人偏好）
    ↓
产品内置默认配置                   （最低优先级）

1. 用户级记忆：~/.codebuddy/CODEBUDDY.md
2. 用户级规则：~/.codebuddy/rules/*.md（递归）
3. 项目级记忆：CODEBUDDY.md（从 cwd 向上递归查找）
4. 项目级规则：.codebuddy/rules/*.md（仅 cwd，不向上）
5. 项目本地记忆：CODEBUDDY.local.md
6. 子目录记忆：工具操作文件时动态加载该子目录的 CODEBUDDY.md