自然语言编译器

Prompt Compiler

<p align="center"> <img src="docs/images/cover.jpg" alt="Prompt Compiler Cover" width="100%"> </p>

Prompt Compiler turns vague requests into structured prompts, execution plans, and policy-checked workflows — so you can go from idea to safe, usable AI output in seconds.

Try it now at prcompiler.com | VS Code extension | GitHub artifacts

---

Core Prompt Compiler

The engine analyzes your intent and produces four output layers:

• System Prompt: persona, role, constraints, and output format rules for the target AI
• User Prompt: structured task definition derived from your input
• Execution Plan: decomposed steps based on your request
• Expanded Prompt: a combined prompt ready to paste into chat-based LLMs

Switch between the output tabs in the UI to inspect each layer, and copy any result with one click.

<p align="center"> <img src="docs/images/comp1.PNG" alt="Prompt Compiler - Main View" width="100%"> </p>

---

Installation

```bash git clone https://github.com/madara88645/Compiler.git cd Compiler

Environment Setup

cp .env.example .env

Core variables:

```env OPENAI_API_KEY=sk-your-actual-key OPENAI_BASE_URL=https://api.openai.com GROQ_API_KEY=gsk_your_groq_key

Prompt compiler mode: conservative (default) or default

PROMPT_COMPILER_MODE=conservative

Optional internal auth hardening (public app routes do not ask visitors for Prompt Compiler API keys)

ADMIN_API_KEY=replace-me PROMPTC_REQUIRE_API_KEY_FOR_ALL=false

How To Use

1. Type your idea, prompt, task, or workflow request into the input box.
2. Click Generate.
3. Review the output tabs: Intent, System, User, Plan, Expanded, JSON, Quality.
4. Use Conservative mode when you want grounded output.
5. If the task is sensitive, inspect the policy layer before using the result downstream.
6. Use Agent, Skill, Optimizer, Benchmark, and RAG surfaces as needed.

---

Optional RAG storage controls

PROMPTC_UPLOAD_DIR=.promptc_uploads PROMPTC_RAG_ALLOWED_ROOTS= ```

Notes:

• Public app routes are intended to work without custom Prompt Compiler API keys.
• OPENAI_API_KEY / GROQ_API_KEY are server-side provider credentials, not values that visitors should type into the app.
• If you set PROMPTC_RAG_ALLOWED_ROOTS, only files inside those roots can be ingested by path.

---

Policy-Aware Prompt Workflows

Prompt Compiler now also exposes a structured IR and policy layer for more sensitive or execution-heavy requests.

• Risk Level: low, medium, high
• Execution Mode: advice_only, human_approval_required, auto_ok
• Data Sensitivity: public, internal, confidential, restricted
• Allowed / Forbidden Tools
• Sanitization Rules

This is not a separate product. It is a new capability inside Prompt Compiler that helps you inspect risky requests before you run them downstream in coding, research, or automation flows.

---

GitHub Workflow Artifacts

Prompt Compiler can render deterministic markdown artifacts from natural language requests:

• Issue Brief
• Implementation Checklist
• PR Review Brief

Example:

python -m cli.main github render --type pr-review-brief --from-file prompt.txt

---

VS Code Extension

The VS Code package lives in integrations/vscode-extension. Once the Marketplace publisher is claimed and the first vscode-v* tag is pushed, it installs from:

• VS Code Marketplace — madara88645.promptc-vscode
• Open VSX (VSCodium / Cursor) — madara88645/promptc-vscode

Until then, install from source (see the extension README) or the .vsix artifact on the Publish VS Code Extension workflow run.

Features:

• Commands: PromptC: Compile Selection, PromptC: Compile File, PromptC: Recompile Last
• Activity Bar sidebar for backend status, latest compile summary, history, and favorites
• Panel tabs: Intent, Policy, Prompts, Raw JSON
• Artifact actions: copy, insert into editor, save favorite
• Settings: promptc.apiBaseUrl, promptc.conservativeMode, promptc.requestTimeoutMs, promptc.autoOpenPanel, promptc.historySize

API keys are stored in VS Code secret storage, not workspace settings.

---