gdim-auto

Category: Content & Multimedia | Uploader: BeMxself | Downloads: 0 | Version: v1.0（Latest）

Use when starting automated GDIM execution from a design document. Analyzes the document, splits it into multiple GDIM flows, generates task directory with configs and entry script.

Changelog: Source: GitHub https://github.com/BeMxself/gdim-workflow-skill

Directory Structure

Current level: skills/gdim-auto/

📁 automation-ref/
- 📁 lib/
  - 📄 log.sh 1.2 KB
  - 📄 prompt-builder.sh 14.1 KB
  - 📄 runner.sh 4.4 KB
  - 📄 state.sh 6.9 KB
  - 📄 validate.sh 17.6 KB
- 📁 templates/
  - 📁 retry/
    
    📄 commit-missing.md 723 B
    
    📄 compile-failed.md 463 B
    
    📄 malformed-output.md 407 B
    
    📄 test-failed.md 432 B
  - 📁 stages/
    
    📄 design.md.tpl 1.9 KB
    
    📄 execute.md.tpl 1.9 KB
    
    📄 gap.md.tpl 3.1 KB
    
    📄 plan.md.tpl 1.9 KB
    
    📄 scope.md.tpl 1.9 KB
    
    📄 summary.md.tpl 2.0 KB
- 📁 tests/
  - 📄 test-auto-commit-captures-cross-round-flow-doc-updates.sh 4.2 KB
  - 📄 test-auto-commit-gdim-docs-default.sh 3.3 KB
  - 📄 test-enforce-round-code-commit-retry.sh 4.0 KB
  - 📄 test-executor-alias-support.sh 1.3 KB
  - 📄 test-final-report-auto-commit-keeps-workspace-clean.sh 3.6 KB
  - 📄 test-gap-blocked-keyword-does-not-force-block.sh 2.8 KB
  - 📄 test-gap-explicit-marker-priority-final.sh 2.6 KB
  - 📄 test-gap-final-decision-closes-no-commit-with-modules.sh 2.9 KB
  - 📄 test-gap-final-decision-closes-round.sh 2.6 KB
  - 📄 test-gap-final-decision-closes-with-prior-execute-no-new-commit.sh 3.4 KB
  - 📄 test-gap-final-decision-triggers-gdim-final-stage.sh 4.9 KB
  - 📄 test-gap-fracture-status-blocks-needs-decision-final.sh 3.4 KB
  - 📄 test-kiro-runner-precheck-ensures-dual-agents.sh 1.2 KB
  - 📄 test-path-violation-auto-expand-no-block.sh 4.0 KB
  - 📄 test-phase-resume-default.sh 2.0 KB
  - 📄 test-refactor-posture-flow-override.sh 3.8 KB
  - 📄 test-resume-skips-runner-when-phases-passed.sh 2.5 KB
  - 📄 test-retry-default-5-and-independent-counts.sh 4.7 KB
  - 📄 test-round-runs-stage-by-stage-sessions.sh 2.5 KB
  - 📄 test-round-state-granular-progress-events.sh 2.8 KB
  - 📄 test-round-uses-stage-specific-templates.sh 3.1 KB
  - 📄 test-runner-heartbeat-log.sh 1.6 KB
  - 📄 test-runner-supports-multiple-executors.sh 1.6 KB
  - 📄 test-setup-kiro-agent-copied-script-default-root.sh 1.6 KB
  - 📄 test-setup-kiro-agent-defaults.sh 1.7 KB
  - 📄 test-setup-kiro-agent-ensure-finds-home-skills.sh 1.1 KB
  - 📄 test-setup-kiro-agent-ensure-syncs-skills.sh 1.4 KB
  - 📄 test-skip-tests-flag.sh 3.1 KB
  - 📄 test-stage-input-precheck-blocks-missing-files.sh 2.7 KB
  - 📄 test-stage-prompts-inject-required-files.sh 5.7 KB
  - 📄 test-stall-limit-default-and-flag.sh 3.0 KB
  - 📄 test-sync-copies-missing-by-default.sh 1.6 KB
- 📄 run-gdim-flows.sh 11.4 KB
- 📄 run-gdim-round.sh 49.9 KB
- 📄 setup-kiro-agent.sh 8.3 KB
- 📄 sync-automation.sh 2.2 KB
📄 SKILL.md 12.4 KB

SKILL.md

---
name: gdim-auto
description: Use when starting automated GDIM execution from a design document. Analyzes the document, splits it into multiple GDIM flows, generates task directory with configs and entry script.
user_invocable: true
argument: "<design-doc-path>"
---

# GDIM Auto — 从设计文档生成自动执行环境

你是 GDIM 自动化任务生成器。用户提供一个设计文档路径，你需要：
1. 同步公共脚本
2. 分析设计文档并拆解为多个 GDIM 流程
3. 生成任务目录和所有配置文件
4. 输出启动/恢复指引

## 输入

按不同 agent 调用同名 skill：
- Claude Code（plugin）：`/gdim-auto <design-doc-path>`
- Codex（skills）：`$gdim-auto <design-doc-path>`
- kiro-cli（skills resources）：在对话中明确要求使用 `gdim-auto` skill，并提供 `<design-doc-path>`

`<design-doc-path>` 是相对于项目根目录的设计文档路径。

## 执行步骤

### Step 0: 定位路径

在执行任何操作前，先确定两个关键路径：

- **PROJECT_ROOT**: 当前工作目录（即用户运行当前 agent 会话的项目根目录）
- **SKILL_DIR**: 本 skill 所在目录。不要硬编码某个 agent 的插件目录，按以下顺序自动发现：
  ```bash
  # 0) 可选显式覆盖（便于 CI/调试）
  if [ -n "${GDIM_AUTO_SKILL_DIR:-}" ] && [ -f "${GDIM_AUTO_SKILL_DIR}/SKILL.md" ]; then
    SKILL_DIR="$(cd "${GDIM_AUTO_SKILL_DIR}" && pwd)"
  else
    # 1) 常见安装位置优先（项目级 / 用户级）
    CANDIDATES=(
      "${PROJECT_ROOT}/skills/gdim-auto/SKILL.md"
      "${PROJECT_ROOT}/.claude/skills/gdim-auto/SKILL.md"
      "${PROJECT_ROOT}/.agents/skills/gdim-auto/SKILL.md"
      "${PROJECT_ROOT}/.kiro/skills/gdim-auto/SKILL.md"
      "${PROJECT_ROOT}/.codex/skills/gdim-auto/SKILL.md"
      "${HOME}/.claude/skills/gdim-auto/SKILL.md"
      "${HOME}/.agents/skills/gdim-auto/SKILL.md"
      "${HOME}/.kiro/skills/gdim-auto/SKILL.md"
      "${HOME}/.codex/skills/gdim-auto/SKILL.md"
      "${CODEX_HOME:-${HOME}/.codex}/skills/gdim-auto/SKILL.md"
    )

    SKILL_FILE=""
    for p in "${CANDIDATES[@]}"; do
      if [ -f "$p" ]; then
        SKILL_FILE="$p"
        break
      fi
    done

    # 2) fallback 扫描常见根目录（包含 Claude 插件缓存/安装目录）
    if [ -z "$SKILL_FILE" ]; then
      SEARCH_ROOTS=(
        "${PROJECT_ROOT}"
        "${HOME}/.claude/plugins"
        "${HOME}/.claude"
        "${HOME}/.agents"
        "${HOME}/.kiro"
        "${HOME}/.codex"
        "${CODEX_HOME:-${HOME}/.codex}"
      )
      for root in "${SEARCH_ROOTS[@]}"; do
        [ -d "$root" ] || continue
        found=$(find "$root" -type f -path "*/gdim-auto/SKILL.md" 2>/dev/null | head -1)
        if [ -n "$found" ]; then
          SKILL_FILE="$found"
          break
        fi
      done
    fi

    [ -z "$SKILL_FILE" ] && echo "gdim-auto SKILL.md not found; check skill installation path for current agent." && exit 1
    SKILL_DIR="$(cd "$(dirname "$SKILL_FILE")" && pwd)"
  fi
  ```
  如果找不到，提示用户检查当前 agent 的 skill 安装目录（`.claude/skills`、`.agents/skills`、`.kiro/skills` 等）。

由此得出：
- **REFERENCE_DIR**: `${SKILL_DIR}/automation-ref` — 公共脚本的 source-of-truth
- **TARGET_DIR**: `${PROJECT_ROOT}/automation/ai-coding` — 项目中的公共脚本工作副本

### Step 1: 同步公共脚本

首先检查 `${TARGET_DIR}/sync-automation.sh` 是否存在：
- 不存在 → 用 Bash 工具从 REFERENCE_DIR 拷贝：
  ```bash
  mkdir -p automation/ai-coding
  cp "${REFERENCE_DIR}/sync-automation.sh" automation/ai-coding/sync-automation.sh
  chmod +x automation/ai-coding/sync-automation.sh
  ```

然后用 Bash 工具运行同步检查：

```bash
bash automation/ai-coding/sync-automation.sh "${REFERENCE_DIR}" automation/ai-coding
```

根据输出和退出码处理：

- **退出码 0**：所有脚本一致，或缺失文件已自动补齐，继续 Step 2
- **退出码 1**：有已存在文件与参考版本不一致（`[DIFF]`）。将 `[DIFF]` 行展示给用户并确认是否覆盖：
  - 若当前 agent 支持 **AskUserQuestion**，优先使用该工具
  - 若不支持 AskUserQuestion，则在会话中直接询问用户
  - 用户选择强制同步 → 用 Bash 工具重新运行：
    ```bash
    bash automation/ai-coding/sync-automation.sh "${REFERENCE_DIR}" automation/ai-coding --auto-copy
    ```
    这会将参考副本强制拷贝覆盖到项目中
  - 用户选择跳过 → 继续（使用现有脚本，可能存在版本差异）

### Step 2: 分析设计文档

读取 `<design-doc-path>` 的完整内容，提取以下信息：

1. **项目名称和 slug**：从文档标题或内容推断，slug 用于目录命名（小写、连字符分隔）
2. **涉及的模块列表**：Maven 模块路径（如 `security/ouroboros-web-security`）
3. **功能分组**：将设计文档拆解为独立的 GDIM 流程，每个流程应：
   - 有明确的功能边界
   - 可独立编译和测试
   - 复杂度适中（每个流程 1-4 轮可完成）
4. **流程间依赖关系**：哪些流程必须在其他流程之后执行
5. **每个流程的 scope**：涉及的模块、allowed_paths、success criteria

#### 拆解原则

- 基础设施/前置条件作为第一个流程
- 核心功能按独立性拆分
- 有共同依赖的流程可以并行（depends_on 相同）
- 集成/非功能性需求放在最后
- 每个流程的 max_rounds 默认 12，stage 默认 "B"
- 任务可设置默认 `refactor_posture`，取值为 `conservative` / `balanced` / `aggressive`，默认 `balanced`
- 单个流程可覆盖 `refactor_posture`；flow 级优先于任务级默认
- 最后一个流程（集成/收尾）stage 设为 "C"

### Step 3: 生成任务目录

任务目录路径：`.ai-workflows/<YYYYMMDD>-<task-slug>/`

其中 `<YYYYMMDD>` 是当天日期，`<task-slug>` 是从设计文档推断的 slug。

#### 3.1 生成 `config/flows.json`

```json
{
  "project": "<task-slug>",
  "workflow_dir": ".ai-workflows/<YYYYMMDD>-<task-slug>",
  "design_doc": "<design-doc-path>",
  "refactor_posture": "balanced",
  "execution": {
    "runner": "claude",
    "kiro_agent": "gdim-kiro-opus",
    "kiro_model": "opus"
  },
  "runners": {
    "claude": { "command": "" },
    "codex": { "command": "" },
    "kiro": { "command": "", "agent": "gdim-kiro-opus" }
  },
  "retry_limits": {
    "compile_failed": 5,
    "test_failed": 5,
    "malformed_output": 5,
    "commit_missing": 5
  },
  "flows": [
    {
      "id": 1,
      "slug": "<flow-slug>",
      "intent_file": "01-<flow-slug>.md",
      "depends_on": [],
      "max_rounds": 12,
      "stage": "B",
      "refactor_posture": "aggressive",
      "runner": "claude",
      "runner_cmd": "",
      "kiro_agent": "gdim-kiro-opus",
      "modules": ["<module-path>"],
      "allowed_paths": [
        "<module-path>/",
        ".ai-workflows/<YYYYMMDD>-<task-slug>/<flow-slug>/",
        ".ai-workflows/<YYYYMMDD>-<task-slug>/00-intent.md"
      ]
    }
  ]
}
```

其中 `refactor_posture` 的语义为：

- `conservative`：优先兼容性；默认不主动引入 breaking change
- `balanced`：默认档；在设计一致性与兼容性之间平衡
- `aggressive`：优先设计一致性；允许先落新设计，再围绕新设计修复破坏；若撕裂无法自动愈合，要求输出缺失决策并 BLOCKED

#### 3.2 生成 `00-intent.md`（共享 Intent）

从设计文档提取项目级 Intent，包含：
- 项目目标
- 整体架构决策
- 技术约束
- 质量要求

格式遵循 GDIM Intent 规范（Claude：`/gdim-intent`；Codex：`$gdim-intent`）。

#### 3.3 生成 `intents/<NN>-<flow-slug>.md`（每个流程的 Intent 片段）

每个流程一个 intent 文件，包含：
- 该流程的具体目标
- 涉及的模块和类
- Success criteria
- Hard constraints
- 与其他流程的接口约定

#### 3.4 生成 `run.sh`（入口脚本）

```bash
#!/usr/bin/env bash
# Auto-generated by gdim-auto skill
# Task: <task-slug>
# Design doc: <design-doc-path>
# Generated: <YYYY-MM-DD>
set -euo pipefail

TASK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$TASK_DIR/../.." && pwd)"
AUTOMATION_DIR="${PROJECT_ROOT}/automation/ai-coding"

if [ ! -f "${AUTOMATION_DIR}/run-gdim-flows.sh" ]; then
    echo "ERROR: automation/ai-coding/ public scripts not found. Run gdim-auto skill to sync (Claude: /gdim-auto, Codex: \$gdim-auto)." >&2
    exit 1
fi

exec "${AUTOMATION_DIR}/run-gdim-flows.sh" --task-dir "$TASK_DIR" "$@"

# Usage:
#   Start all flows:     ./run.sh
#   Only flow N:         ./run.sh --only N
#   Start from flow N:   ./run.sh --from N
#   Resume (auto):       ./run.sh                    (resumes from last checkpoint)
#   Unblock a flow:      ./run.sh --unblock <slug>
#   Dry-run preview:     ./run.sh --dry-run
#   Semi-auto mode:      ./run.sh --stage A
#   Skip mvn test gate:  ./run.sh --skip-tests
#   Stall threshold:      ./run.sh --stall-limit 5
#   Disable doc commits:  ./run.sh --no-auto-commit-gdim-docs
#   Use codex runner:    ./run.sh --runner codex
#   Use kiro runner:     ./run.sh --runner kiro --kiro-agent gdim-kiro-sonnet
#   Custom executor cmd: ./run.sh --runner custom --runner-cmd 'my-runner --stdio'
#   Heartbeat interval:  GDIM_HEARTBEAT_SECONDS=10 ./run.sh   (0=disable)
```

生成后执行 `chmod +x` 使其可执行。

#### 3.5 创建空目录

- `state/` — 运行时状态，创建 `.gitignore` 内容为 `*\n!.gitignore`
- `logs/` — 执行日志，创建 `.gitignore` 内容为 `*\n!.gitignore`
- 每个流程的子目录（如 `<flow-slug>/`）— 空目录，GDIM 产出运行时填充

### Step 4: 输出指引

生成完成后，向用户输出以下信息：

```
✅ GDIM 自动执行环境已生成

📁 任务目录: .ai-workflows/<YYYYMMDD>-<task-slug>/
📄 设计文档: <design-doc-path>
🔄 流程数量: N 个

流程列表:
  #1 <flow-slug> (depends: none)
  #2 <flow-slug> (depends: #1)
  ...

启动方式:
  cd <project-root>
  .ai-workflows/<YYYYMMDD>-<task-slug>/run.sh

常用命令:
  ./run.sh                    # 启动全部流程（自动断点恢复）
  ./run.sh --dry-run          # 预览模式
  ./run.sh --only 1           # 只跑第 1 个流程
  ./run.sh --from 3           # 从第 3 个流程开始
  ./run.sh --unblock <slug>   # 解除阻塞
  ./run.sh --stage A          # 半自动模式（每轮人工确认）
  ./run.sh --skip-tests       # 跳过 mvn test 门禁（也可用 GDIM_SKIP_TESTS=1）
  ./run.sh --stall-limit 5    # 连续 5 轮无 commit 判定 STALLED（可调整）
  ./run.sh --no-auto-commit-gdim-docs  # 关闭每轮 GDIM 文档自动提交（默认开启）
  ./run.sh --runner codex     # 使用 codex 执行器
  ./run.sh --runner kiro --kiro-agent gdim-kiro-opus   # 使用 kiro + 指定 agent
  ./run.sh --runner custom --runner-cmd '<your command>' # 自定义执行器命令
  GDIM_HEARTBEAT_SECONDS=10 ./run.sh   # 运行中心跳日志间隔（秒），设为 0 可关闭
```

## 注意事项

- 不要修改 `automation/ai-coding/` 下的公共脚本内容（除非 sync 检测到需要更新）
- `flows.json` 中的 `allowed_paths` 必须包含流程的工作流目录和涉及的模块目录
- 执行器配置建议使用 `execution.runner` 与 `flows[].runner`；旧字段 `executor` 与 `flows[].executor` 仍可兼容读取
- Intent 文件应该足够详细，让自动化 agent 能独立完成每个流程
- 当 runner=kiro 时，运行前会自动检查并确保存在 `gdim-kiro-opus` 与 `gdim-kiro-sonnet` 两个 agent（资源指向 `skill://~/.kiro/skills/...`），并同步 gdim skills 到 `~/.kiro/skills`
- `run-gdim-round.sh` 在同一轮内会按 `scope → design → plan → execute → summary → gap` 分阶段触发独立会话（每阶段一次 runner 调用）
- 默认会在每轮阶段完成后自动提交该轮 GDIM 文档（scope/design/plan/summary/gap 等）；可通过 `--no-auto-commit-gdim-docs` 或 `GDIM_AUTO_COMMIT_GDIM_DOCS=0` 关闭
- 每阶段执行前会进行必需输入文件硬校验（缺失即 BLOCKED），防止在缺依赖状态下继续推进流程
- 执行 runner 时会周期输出 `Runner still running... elapsed=<N>s`，默认间隔为 20 秒；可通过 `GDIM_HEARTBEAT_SECONDS` 覆盖（`0` 为关闭）
- 发生 `path_violation` 时会默认自动扩展 `allowed_paths`（按越界文件目录前缀）并继续执行，不再因该类失败直接 BLOCK
- 如果设计文档内容不足以拆解为多个流程，可以只生成一个流程
- 生成的所有文件使用 UTF-8 编码
- 不要自动执行工作流；只输出启动指引，后续由用户在终端手动运行

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

gdim-auto

Directory Structure

SKILL.md

Report

Notice