ZeeLin Report Publisher
When To Use
Use this skill when the user asks to publish, upload, or add a report to the 智灵报告网站.
Trigger intent should include both:
- - the site phrase: INLINECODE0
- an action phrase:
发布 / 上架 / INLINECODE3
This skill supports multiple categories (not only OpenClaw).
Inputs
Collect these fields before running:
- -
report_file (required) - INLINECODE5 (required)
- INLINECODE6 (required)
- INLINECODE7 (optional, auto-infer if omitted)
- INLINECODE8 (optional, auto-generate if omitted)
- INLINECODE9 (optional, default
1.0) - INLINECODE11 (optional)
- INLINECODE12 (optional)
- INLINECODE13 (optional)
Field details: see report-metadata.md.
Workflow
- 1. On a new machine, run GitHub bootstrap first (section below).
- Confirm target repo path and that it contains
public/reports_config.json. - Run the publisher script (below).
- Verify build result.
- Confirm branch push and PR URL.
Bootstrap (New Machine)
Run this once per user machine to set git identity, authenticate GitHub, upload SSH key, and validate repo push permission:
CODEBLOCK0
INLINECODE15 should point to your local report-site repository (for example THU-ZeeLin-Reports).
Fork workflow setup (recommended for team members without write access on main repo):
CODEBLOCK1
INLINECODE17 is optional. If omitted, repo is cloned to current workspace as <workspace>/THU-ZeeLin-Reports.
Script
Primary command:
CODEBLOCK2
Default behavior:
- - Copies file into
public/<category_dir>/. - Inserts new entry at index
0 in public/reports_config.json. - Auto-detects
date from file name/title (YYYY-MM/YYYY) and falls back to current year. - Auto-generates
abstract when omitted. - Runs
npm run build. - Creates feature branch
codex/report-<id>. - Commits and pushes to
origin (fork). - Uses
upstream as PR base remote when available (otherwise origin). - Creates PR with
gh if available; otherwise prints manual compare URL.
Remote options:
- -
--push-remote controls where branches are pushed (default origin). - INLINECODE34 controls PR base remote (default auto:
upstream if exists, else origin).
Abstract Generation Standard
When abstract is omitted, generate a concise, neutral summary by these rules:
- - Use one sentence in Chinese, around 40-90 characters.
- Mention scope + value (for example: "核心进展、关键问题、落地路径").
- Avoid unverifiable claims and marketing tone.
- If content context is limited, use title/category-based generic summary.
Guardrails
- - Do not push directly to
main as final delivery; use PR workflow. - If working tree is dirty, stop unless user explicitly allows mixed changes.
- Validate git identity and push remote access before mutating files.
- Keep existing entry format compatible with site fields:
id/title/version/date/category/abstract/coverUrl/pdfUrl.
ZeeLin 报告发布器
使用时机
当用户要求发布、上传或新增报告到智灵报告网站时使用此技能。
触发意图应同时包含:
- - 网站短语:智灵报告网站
- 动作短语:发布 / 上架 / 新增报告
此技能支持多个分类(不仅限于 OpenClaw)。
输入参数
运行前需收集以下字段:
- - reportfile(必填)
- title(必填)
- category(必填)
- date(可选,省略时自动推断)
- abstract(可选,省略时自动生成)
- version(可选,默认 1.0)
- id(可选)
- coverurl(可选)
- category_dir(可选)
字段详情:参见 report-metadata.md。
工作流程
- 1. 在新机器上,先运行 GitHub 引导程序(见下方章节)。
- 确认目标仓库路径,且其中包含 public/reports_config.json。
- 运行发布脚本(见下方)。
- 验证构建结果。
- 确认分支推送和 PR 链接。
引导程序(新机器)
每台用户机器运行一次,用于设置 git 身份、认证 GitHub、上传 SSH 密钥并验证仓库推送权限:
bash
bash {baseDir}/scripts/bootstrap_github.sh \
--name 您的姓名 \
--email you@example.com \
--repo
应指向您的本地报告站点仓库(例如 THU-ZeeLin-Reports)。
Fork 工作流设置(推荐给主仓库无写入权限的团队成员):
bash
bash {baseDir}/scripts/bootstrap_github.sh \
--name 您的姓名 \
--email you@example.com \
--clone-url git@github.com:<您的用户名>/THU-ZeeLin-Reports.git \
--upstream-url git@github.com:thu-nmrc/THU-ZeeLin-Reports.git
--clone-dir 为可选参数。若省略,仓库将克隆到当前工作空间下的 /THU-ZeeLin-Reports。
脚本
主命令:
bash
python3 {baseDir}/scripts/publish_report.py \
--repo \
--report-file \
--title 报告标题 \
--category OpenClaw \
--date 2026 \
--version 1.0 \
--abstract 简短摘要文本。
默认行为:
- - 将文件复制到 public/dir>/ 目录下。
- 在 public/reportsconfig.json 的索引 0 处插入新条目。
- 从文件名/标题自动检测 date(YYYY-MM/YYYY 格式),若失败则回退到当前年份。
- 省略时自动生成 abstract。
- 运行 npm run build。
- 创建特性分支 codex/report-。
- 提交并推送到 origin(fork 仓库)。
- 可用时使用 upstream 作为 PR 基础远程仓库(否则使用 origin)。
- 可用时使用 gh 创建 PR;否则打印手动比较链接。
远程选项:
- - --push-remote 控制分支推送的目标远程仓库(默认 origin)。
- --base-remote 控制 PR 基础远程仓库(默认自动:若存在 upstream 则使用,否则使用 origin)。
摘要生成标准
当 abstract 省略时,按以下规则生成简洁中立的摘要:
- - 使用一句中文,约 40-90 个字符。
- 提及范围与价值(例如:核心进展、关键问题、落地路径)。
- 避免不可验证的声明和营销语气。
- 若内容上下文有限,则使用基于标题/分类的通用摘要。
防护措施
- - 不要直接推送到 main 作为最终交付;应使用 PR 工作流。
- 若工作区有未提交的更改,除非用户明确允许混合变更,否则停止操作。
- 在修改文件前,验证 git 身份和推送远程访问权限。
- 保持现有条目格式与站点字段兼容:id/title/version/date/category/abstract/coverUrl/pdfUrl。