生成可单独售卖、也可被方案复用的 package.zip

{
  "api_version": "relicex.pack.v0",
  "kind": "capability_pack",
  "id": "github_issue_summarizer",
  "version": "0.1.0",
  "title": "GitHub Issue Summarizer",
  "description": "Summarizes GitHub issue JSON into a prioritized action report.",
  "author": { "name": "creator_or_team", "id": "creator_id" },
  "tags": ["github", "summary", "automation"],
  "mode": "code",
  "runtime": {
    "kind": "interpreted",
    "profile": "python311-base@1",
    "entry": { "kind": "python", "value": "code/main.py:run" }
  },
  "inputs_schema": {
    "type": "object",
    "properties": {
      "issues": { "type": "array", "items": { "type": "object" } }
    },
    "required": ["issues"]
  },
  "outputs_schema": {
    "type": "object",
    "properties": {
      "summary": { "type": "string" },
      "report_md": { "type": "string" },
      "artifacts": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": { "type": "string" },
            "path": { "type": "string" },
            "mime_type": { "type": "string" }
          },
          "required": ["name", "path"]
        }
      }
    },
    "required": ["summary", "report_md"]
  },
  "workflow": [
    {
      "id": "summarize",
      "executor": { "type": "code", "entry": "code/main.py:run" },
      "in": { "issues": "${inputs.issues}" },
      "out": ["summary", "report_md", "artifacts"]
    }
  ],
  "evaluation": {
    "required_outputs": ["summary", "report_md"]
  },
  "files": {
    "readme": "README.md",
    "docs": ["docs/usage.md"],
    "code": ["code/main.py"],
    "prompts": [],
    "templates": [],
    "examples": ["examples/example_input.json", "examples/example_output.md"],
    "assets": []
  },
  "secret_requirements": [],
  "secret_groups": [],
  "runtime_permissions": {
    "network": { "required": false, "allow_domains": [] },
    "filesystem": {
      "reads": ["./inputs"],
      "writes": ["./outputs", "./artifacts", "./logs", "./tmp"]
    }
  }
}

# code/main.py
from __future__ import annotations

import os
from pathlib import Path


def run(inputs: dict | None = None) -> dict:
    inputs = inputs or {}
    issues = inputs.get("issues") or []
    lines = ["# Issue summary", ""]
    for index, issue in enumerate(issues, start=1):
        title = issue.get("title", "Untitled") if isinstance(issue, dict) else str(issue)
        lines.append(f"{index}. {title}")
    report_md = "\n".join(lines)
    artifact_dir = Path(os.environ.get("RELICEX_ARTIFACT_DIR", "artifacts"))
    artifact_dir.mkdir(parents=True, exist_ok=True)
    (artifact_dir / "issue_summary.md").write_text(report_md, encoding="utf-8")
    return {
        "summary": f"Summarized {len(issues)} issues.",
        "report_md": report_md,
        "artifacts": [
            {
                "name": "issue_summary",
                "path": "artifacts/issue_summary.md",
                "mime_type": "text/markdown",
            }
        ],
    }

<run_dir>/
├── inputs/
│   ├── input.json       # primary JSON object matching inputs_schema
│   └── files/           # CSV, PDF, images, uploaded data files
├── outputs/
│   └── result.json      # primary JSON object matching outputs_schema
├── artifacts/           # Markdown, CSV, PDF, charts, images, binaries
├── logs/                # redacted logs only
└── tmp/                 # temporary files, safe to delete

# Run with the standard runtime workspace
python scripts/relicex_run.py github_issue_summarizer \
  --inputs-json @examples/example_input.json \
  --run-dir ./runs/github_issue_summarizer_demo

# Common env vars made available to package code
RELICEX_RUN_DIR
RELICEX_INPUT_DIR
RELICEX_INPUT_FILES_DIR
RELICEX_INPUT_JSON / RELICEX_INPUT_FILE
RELICEX_OUTPUT_DIR
RELICEX_OUTPUT_JSON / RELICEX_OUTPUT_FILE
RELICEX_ARTIFACT_DIR
RELICEX_LOG_DIR
RELICEX_TMP_DIR