# astah-diagram-automation

**Repository Path**: yr_binary/astah-diagram-automation

## Basic Information

- **Project Name**: astah-diagram-automation
- **Description**: Codex skill for automating Astah .asta diagram creation with Java API.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Astah Diagram Automation Skill

让 Codex 用 Java + Astah API 创建、更新、检查 `.asta` UML 图。

## 安装

```powershell
git clone https://github.com/zp-home/astah-diagram-automation.git "$env:USERPROFILE\.codex\skills\astah-diagram-automation"
cd "$env:USERPROFILE\.codex\skills\astah-diagram-automation"
```

## 准备

需要 JDK 和 Astah 的两个 jar：`astah-api.jar`、`astah-pro.jar`。

任选一种配置方式：

```powershell
$env:ASTAH_API_JAR="D:\Astah\astah-api.jar"
$env:ASTAH_PRO_JAR="D:\Astah\astah-pro.jar"
```

或放到：

```text
lib/astah-api.jar
lib/astah-pro.jar
```

检查环境：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\check-astah-env.ps1
```

## 使用

内置 `DumpAstah` 可先验证 `.asta` 能被读取：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\run-astah-tool.ps1 -Tool DumpAstah -Project ".\project.asta"
```

项目自己的绘图工具放到 `asta_tools/*.java` 后运行：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\run-astah-tool.ps1 -Tool YourTool -Project ".\project.asta" -ToolsDir ".\asta_tools"
```

## 内容

- `SKILL.md`：Codex 使用流程
- `assets/asta_tools/DumpAstah.java`：最小可用读取工具
- `scripts/check-astah-env.ps1`：环境检查
- `scripts/run-astah-tool.ps1`：编译并运行 Java 工具
- `references/`：本地方法、工具接口、踩坑点

不提交 Astah 授权 jar、私有 `.asta` 文件和业务专用绘图工具；这些按团队权限另行提供。