AIRP Renderer

VS Code / Cursor extension that reads and exports AIRP documents (*.airp.json).

Make AI-written reports easier to read—and easier to change.

Ask AI for Markdown and you often get flat, meandering text. Ask for HTML and it can look fine, but it’s long, token-heavy, and painful to edit later. AIRP’s approach: have the AI write a *.airp.json source first, then open it with the AIRP Renderer extension as polished HTML. When you need to share, export HTML or Markdown.

The source is organized like Notion Blocks—46 of them so far (hero metrics, comparison, decision, timeline, Mermaid, architecture overview, and more). Each has its own layout, so plans, reviews, retros, and audits stay clear instead of turning into a wall of text.

How a report runs

Writing and reading stay separate. The *.airp.json in the middle is shaped by JSON Schema—generation and validation both treat it as the source of truth:

What you actually get:

• Missing fields or sections fail validation—fewer half-finished deliverables.
• The source fits Git and diffs; HTML / Markdown are just what humans read.
• Clear Block boundaries are steadier for the model, and usually cheaper in tokens than a hand-written full HTML page.

Quick start

1. Install the VS Code extension

Install AIRP Renderer from the Marketplace (extension ID: airp.airp-renderer-vscode).

Open any *.airp.json to read it, or export HTML / Markdown. Needs a VS Code–compatible editor (e.g. Cursor).

2. Install the /airp Skill

If you’re only opening sources someone else already wrote, the extension is enough. Install the Skill when you want AI to write new reports:

npx skills add maosong-ai/airp

In chat, type /airp <topic>. The Skill generates and validates a source file (default folder: .docs/airp/). Open it with the extension to read. Optional flags: --locale en-US, --out <dir>.

Languages

Supported document languages: English (en-US), 简体中文 (zh-CN), 日本語 (ja-JP), 한국어 (ko-KR), Deutsch (de-DE), Français (fr-FR), Русский (ru-RU), Español (es-ES), Português Brasil (pt-BR), Italiano (it-IT). Pass /airp --locale … when you write a report.

What’s next

Available today: Skill generates / validates sources; the extension reads and exports HTML / Markdown. Planned next:

让 AI 写出来的报告更好读，也好改。

AI 直接出 Markdown，往往又平又散；直接出 HTML，版式好看，但又长又费 token，后面也不好改。AIRP 的做法是：先让 AI 写出一份 *.airp.json 源文件，再用 AIRP Renderer 扩展打开成排版好的 HTML；需要对外发时，再导出 HTML 或 Markdown。

源文件按 Notion 那套 积木块（Block） 组织，目前有 46 种——指标首屏、对比、决策、时间线、Mermaid、架构总览等。每种有自己的版式，方案、评审、复盘、审计这类报告会清楚很多，不会糊成一坨字。

报告是怎么跑起来的

写和读是分开的。中间那份 *.airp.json 由 JSON Schema 约束，生成和校验都以它为准：

这样做的实际好处：

• 缺字段、缺章节时校验会失败，少交半成品。
• 源文件适合进 Git、做 diff；HTML / Markdown 只当给人看的成品。
• 积木块边界清楚，对模型更稳，通常也比整页手写 HTML 更省 token。

快速开始

1. 安装 VS Code 扩展

到 Marketplace 安装 AIRP Renderer（扩展 ID：airp.airp-renderer-vscode）。

打开任意 *.airp.json 就能读，也可以导出 HTML / Markdown。需要 VS Code 兼容编辑器（如：Cursor）。

2. 安装 /airp Skill

只读别人已经写好的源文件，装扩展就够了。要让 AI 帮你写新报告时，再装 Skill：

npx skills add maosong-ai/airp

对话里输入 /airp <主题>，Skill 会生成并校验源文件（默认目录：.docs/airp/），再用扩展打开即可阅读。可选参数：--locale zh-CN、--out <目录>。

多语言

支持这些文档语言：English（en-US）、简体中文（zh-CN）、日本語（ja-JP）、한국어（ko-KR）、Deutsch（de-DE）、Français（fr-FR）、Русский（ru-RU）、Español（es-ES）、Português Brasil（pt-BR）、Italiano（it-IT）。写报告时用 /airp --locale … 指定。

接下来打算做什么

现在已经能用：Skill 生成 / 校验源文件，扩展阅读并导出 HTML / Markdown。后面计划：

License

MIT

AIRP | Copyright (c) 2026 毛松 maosong-life@outlook.com