# VASMC

用于 Prompt、Skill 与 AI 项目文档的 Markdown 编译器，把 .vasm.md 源文件构建为 .md，并记录后续处理事项。

## Metadata

- HTML: https://glenzli.com/projects/vasmc/
- Markdown: https://glenzli.com/projects/vasmc.md
- Collection: Projects
- Language: zh-CN
- Published: 2026-07-03
- Updated: 2026-08-27
- Status: active
- Tags: cli, markdown, compiler, prompt, skills

## Content

VASMC 是用于 Prompt、Skill 和 AI 项目文档的 Markdown 编译器。它把 `.vasm.md` 源文件展开为 `.md` 产物，并把需要继续处理的事项写入 `.vasmc/build-report.yaml`。

编译路径负责 import 展开、依赖锁定、语言过滤、输出路由和策略诊断等确定性工作。翻译、语义审查和项目上下文检查由执行构建的 AI 编辑器或开发者根据报告完成。

  ![VASMC 从源 Markdown 构建输出并生成处理报告](/images/projects/vasmc-banner.webp)

## 构建方式

```bash
npm install -g @vasm/cli
vasmc init
vasmc build
```

`.vasm.md` 是维护入口，生成的 `.md` 是构建产物。源文件可以声明 import、目标语言、输出路径与编译格式；构建完成后，普通 Markdown 供编辑器、Agent 或文档系统使用。

    **确定性编译**
    CLI 解析源文件、展开 import、锁定依赖、过滤语言块并写入目标文件。

    **构建报告**
    需要验证、翻译或策略审查的事项写入 YAML 报告；报告中的 action 不表示任务已经完成。

    **源文件边界**
    内容修改通常回到 `.vasm.md`，再重新构建，而不是直接维护生成文件。

    **可选语义检查**
    `vasm-console` 可以调用外部模型做 lint 与 diff，但与确定性编译链分开。

## 边界

VASMC 处理 Markdown 源码、构建与后续工作交接。策略检查覆盖 manifest、依赖、格式边界和内容信号；语义判断由执行构建的开发者或 AI 编辑器完成。

项目由 `@vasm/core`、提供 `vasmc` 命令的 `@vasm/cli`，以及可选的 `@vasm/console` 组成。