# skills

**Repository Path**: auto-stack/skills

## Basic Information

- **Project Name**: skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code Skills — 渐进式工程翻译工具集

三个互补的 Claude Code skill，用于将复杂软件工程拆解并渐进式地翻译到其他语言。

## Skill 概览

### 1. `code-excerpter` — 代码摘取器

从大型代码库中提取独立可编译的小程序（每个 50-200 行）。每个小程序演示一种特定的编程能力，可以独立编译运行。

**适用场景：** 需要为语言翻译准备小粒度测试用例，或希望通过研究单个能力来理解代码库。

**实际产出：** 从 auto-code-rs 中提取了 33 个独立程序，涵盖 wrapping 算术、模式匹配、状态机、流处理、REPL 循环等。

### 2. `project-decomposer` — 渐进式工程拆解器

将复杂工程拆解为一系列渐进式 snapshot——每个都是一个可独立编译运行的完整工程，在前一步的基础上逐步增加功能。采用 git 历史分析 + AI 依赖推断的混合策略。

**适用场景：** 需要从零开始重构一个工程的构建路径，或需要用越来越复杂的程序验证转译器。

**实际产出：** auto-code-rs 的 6 个 snapshot，从最小骨架到完整 AI 编程助手。

### 3. `auto-lang-creator` — Auto 语言代码生成器

生成语法正确的 Auto 语言代码。提供 Rust 到 Auto 的映射表、常见陷阱检查清单和代码模板，基于 Auto 语言规范 v0.2。

**适用场景：** 编写、审查或将代码翻译到 Auto 编程语言。

## 推荐工作流

```
┌─────────────────────────────────────────────────┐
│  复杂工程（如 Rust 版 auto-code-rs）             │
└─────────────────┬───────────────────────────────┘
                  │
        第一步：/code-excerpter
        摘取 20-40 个独立小程序
        （每个验证一个语言特性）
                  │
                  ▼
        第二步：/auto-lang-creator
        逐个翻译小程序到 Auto 语言
        迭代修复问题，改进转译器
                  │
                  ▼
        第三步：/project-decomposer
        生成 5-8 个渐进式工程 snapshot
        逐个翻译每个 snapshot 到 Auto
        （验证工程级别的集成能力）
                  │
                  ▼
        结果：完整工程翻译完成并经过验证
```

**核心原则：** 小步快跑，尽早验证，快速迭代。

## Skill 关系对比

| 维度 | code-excerpter | project-decomposer | auto-lang-creator |
|------|---------------|--------------------|--------------------|
| 粒度 | 函数级（50-200 行） | 模块级（完整工程） | 文件级 |
| 独立性 | 完全独立 | 每步依赖上一步 | 按文件翻译 |
| 覆盖面 | 挑选关键逻辑点 | 覆盖整个代码库 | 单个翻译单元 |
| 适用场景 | 单个特性验证 | 集成能力验证 | 语言翻译 |

## 文件位置

```
~/.claude/skills/
  README.md                          ← 英文说明（本文件）
  README.cn.md                       ← 中文说明
  auto-lang-creator/
    skill.md                         ← Auto 代码生成规则
    references/auto-syntax.md        ← Auto 语言语法参考
  code-excerpter/
    skill.md                         ← 小程序摘取流程
    references/excerpt-patterns.md   ← 10 种摘取模式示例
  project-decomposer/
    skill.md                         ← 渐进式拆解流程
    references/decomposition-patterns.md ← 5 种拆解模式示例
```