# ASDM Workspace

AI-assisted Software Development Management (ASDM) Workspace，用于管理和配置 AI 辅助软件开发工具集与上下文。

## 项目结构

```
.
├── .asdm/                          # ASDM 核心配置目录
│   ├── workspace-install.json      # 工作区安装配置（工作区、工具集、规范关联）
│   ├── specs/                      # 规范定义
│   │   └── code-review/            # 代码审查规范
│   │       ├── manifest.json
│   │       └── README.md
│   ├── toolsets/                   # 工具集
│   │   ├── basic-tools/            # 基础工具集（Git 操作、项目启动）
│   │   └── context-builder/        # 上下文构建工具集（工作区上下文生成）
│   └── contexts/                   # 上下文文件存放目录
├── .codebuddy/                     # CodeBuddy 命令入口
│   └── commands/                   # 快捷命令
├── .workspace/                     # 工作区文件
└── README.md
```

## 工具集

### Basic Tools (`basic-tools`)

基础开发工具集，提供 AI 辅助软件开发的日常操作支持。

**可用命令：**

| 命令 | 说明 |
|------|------|
| `/asdm-start-project` | 检测工作区上下文，以开发模式启动项目 |
| `/asdm-git-commit-message` | 根据当前变更生成标准 Git 提交信息 |
| `/asdm-git-commit` | 使用生成的提交信息提交变更 |

**目录结构：**

```
.asdm/toolsets/basic-tools/
├── actions/                        # 操作指令
│   ├── asdm-start-project.md       # 项目启动指令
│   ├── asdm-git-commit.md          # Git 提交指令
│   └── asdm-git-commit-message.md  # 生成提交信息指令
├── spec/                           # 规范模板
│   ├── git-commit-message-spec.md  # 提交信息规范
│   └── git-commit-spec.md          # 提交操作规范
├── INSTALL.md                      # 安装说明
└── README.md
```

### Context Builder (`context-builder`)

上下文构建工具集，帮助为工作区自动生成和维护 AI 模型所需的上下文信息。

**可用命令：**

| 命令 | 说明 |
|------|------|
| `/asdm-context-build` | 为当前工作区构建初始上下文 |
| `/asdm-context-update` | 更新工作区已有上下文 |

**上下文文件：**

构建完成后，以下文件将生成在 `.asdm/contexts/` 目录下：

| 文件 | 说明 |
|------|------|
| `index.md` | 工作区上下文索引与导航 |
| `standard-project-structure.md` | 标准项目结构 |
| `standard-coding-style.md` | 编码风格规范 |
| `data-models.md` | 数据模型与关系 |
| `deployment.md` | 部署配置与流程 |
| `api.md` | API 定义与文档 |
| `architecture.md` | 系统架构与设计 |

## 规范

### Code Review (`code-review`)

代码审查规范，定义项目代码审查标准，包含以下检查项：
- 代码风格与格式
- 逻辑正确性
- 错误处理
- 性能考量

## 当前工作区配置

- **活跃工作区 ID:** 33
- **已安装工具集:** basic-tools, context-builder
- **已启用规范:** code-review
- **Agentic Engine:** Tencent CodeBuddy

## 快速开始

### 安装工具集

将以下提示粘贴到 AI 编码工具的聊天窗口中：

```shell
# 安装基础工具集
Follow instructions in .asdm/toolsets/basic-tools/INSTALL.md

# 安装上下文构建工具集
Follow instructions in .asdm/toolsets/context-builder/INSTALL.md
```

### 构建工作区上下文

```shell
Follow the instructions in .asdm/toolsets/context-builder/actions/asdm-context-build.md
```

### 日常开发操作

```shell
# 启动项目
/asdm-start-project

# 生成提交信息
/asdm-git-commit-message

# 提交变更
/asdm-git-commit
```

## 支持的 AI 编码工具

| 工具 | 命令目录 | 支持方式 |
|------|----------|----------|
| Claude Code | `.claude/commands/` | Frontmatter + 指令内容 |
| GitHub Copilot | `.github/prompts/` | YAML Frontmatter + 指令内容 |
| Tencent CodeBuddy | `.codebuddy/commands/` | 直接复制指令文件 |

## 许可证

Copyright (c) 2026 LeansoftX.com & iSoftStone. All rights reserved.

Licensed under the PROPRIETARY SOFTWARE LICENSE.