首页 / 全部技能 / 文档与知识 / hr-onboarding
文档与知识 · nexu-io/html-anything

hr-onboarding

首周日程 + buddy + 学习路径 + 设备 + 完成标准

L1 基础 · 登记来源即可V1 已固定Dual-pass Audit
Author nexu-ioGitHub nexu-io/html-anything ↗Stars 8827License Apache-2.0(仓库根 LICENSE 文件为 Apache License Version 2.0;package.json "license": "Apache-2.0";GitHub API spdx_id Apache-2.0)Commit 553ed98c28
管控等级描述 skill 的能力与建议配套的管控措施,不代表质量或安全认证,也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同,请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者,使用风险由使用者自行承担。

1实现原理 · 为什么它能做到

六段式入职单页:hero(姓名/入职日/团队)→ 首周 schedule → Manager + Buddy 卡片 → learning track → equipment checklist → 「你设置好了当且仅当…」验收区。

next/src/lib/templates/skills/hr-onboarding/SKILL.md
- Welcome hero (姓名 + 入职日 + 团队)
结构即内容清单:HR 只要按这六段填,页面自然完整——这是文档类模板最省心的写法。

首周日程按天落到逐时段:示例给出 Day 1 的 09:00–14:00 时间表与 Mon–Fri 五天时间线。

next/src/lib/templates/skills/hr-onboarding/example.html
<div class="schedule-row"><div class="time">11:30</div><div class="item"><strong>Coffee with Sasha (buddy)</strong><span>The unwritten rules, who-to-ask map, where the good lunch spots are.</span></div></div>
时间线用 `.schedule-row { display: contents }` 的两列网格实现,不依赖表格,行间用 border-top 分隔。

验收区用可打勾的「You're set when…」清单表达完成标准,把 HR 交付物变成可核对项。

next/src/lib/templates/skills/hr-onboarding/example.html
<h3>You're set when…</h3>
同一区块同时承载 equipment checklist(Laptop/SSO/badge 是否可用),是这份模板最有产品思维的一处。

模板本体就是 prompt:SKILL.md 正文经 loader 读出后与共享前言、用户内容拼装,交给本机 agent CLI 执行。

next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
运行时不吃模板目录里的代码:/api/convert 只收 {agent, templateId, content},用 loadSkill(templateId) 取 SKILL.md 正文当 prompt 主体,再交给本机已登录的 agent CLI;HTML 由 stdout 流回前端。

skill 目录是纯文本资产:loader 读盘取 SKILL.md 正文,目录内无任何可执行代码被加载。

next/src/lib/templates/loader.ts
const raw = safeRead(path.join(dir, "SKILL.md"));
文件系统里的 skill 只是文本:loader 逐个目录读 SKILL.md,frontmatter 抽成 picker 元数据、正文作为 body 返回;本模板目录内没有任何模块被 import 或执行。

共享前言先于模板注入,把「模板只定义版面/风格/配色/字体/组件库,数量由用户内容决定」定为最高优先级。

next/src/lib/templates/shared.ts
【内容驱动数量 — 最高优先级, 覆盖模板里的任何数字】
共享前言在模板正文之前注入,规定「模板只定义版面/风格/配色/字体/组件库,数量由用户内容决定」——所以本模板里的版式清单是「可复用版式池」,不是页数/帧数上限。

共享前言先于模板注入,把「模板只定义版面/风格/配色/字体/组件库,数量由用户内容决定」定为最高优先级。

next/src/lib/templates/shared.ts
- **禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
前言明令禁用文件系统工具、要求纯 HTML 从回复正文流式输出,落盘由前端负责——skill 侧因此没有写盘行为。

skill 目录是纯文本资产:loader 读盘取 SKILL.md 正文,目录内无任何可执行代码被加载。

next/src/lib/templates/loader.ts
const exampleHtml = safeRead(path.join(dir, "example.html"));
目录里的 example.html 是随仓库分发的黄金样本,预览路由直接读盘返回(无构建、无编译),既是质量基线也是详情页素材。

2核心能力

01Welcome hero(姓名 / 入职日 / 团队)
02首周 5 天 timeline(Mon–Fri 逐时段)
03Manager + Buddy 卡片(含 buddy coffee 条目)
04learning track 列表
05equipment checklist 与 outcomes 验收区(可勾选)
06示例扩展:30·60·90 里程碑与 Things to bookmark 资源区

4管控建议与判定依据

建议配套管控措施
面向 Agent
可自动加载
面向管理者
登记来源与版本
判定依据(文件路径与关键语句摘要)
  • SKILL.md: 纯提示词指令与规则文本,无脚本执行与外部影响
审计说明: 🟢 绿色()。判级对象=skill 自身目录:目录内零 URL(example.html 也无任何 http(s) 端点)。目录内只有 SKILL.md、example.html,零脚本、零可执行代码、零网络端点、零凭证读取、零写盘指令——照 SKILL.md 执行的结果是宿主模型输出一段 HTML 文本,不含任何外发或落盘动作。宿主壳与产物使用侧行为不作为档位依据,只记入 verdict.risks:shared.ts 前言要求产物引 Tailwind CDN(https://cdn.tailwindcss.com) 与 Google Fonts、runtime 会 spawn 本机已登录的 agent CLI(envFor 透传 process.env)、预览 iframe 为 sandbox="allow-scripts allow-same-origin"。

5第二遍独立确认

  • [ok] 规范↔示例:六区覆盖 — hero(Start date/Manager/Buddy/Sasha)、Day 1 时段表、First week timeline(Mon–Fri 五行)、30·60·90 里程碑、Resources 与 You're set when… 全部命中;equipment checklist 并入 Resources & 验收清单区而非独立区块。
  • [ok] 规范↔示例:超出规范的区块 — 示例追加 30·60·90 day milestones 与 Things to bookmark,属「超出」而非违背(共享前言明确模板数字是下限)。
  • [ok] 规范↔示例:5 天 timeline — 正文要求 5 天,示例 day-head 为 Mon→Fri(Nov 4–Nov 8)五天,日数与正文一致。
  • [ok] example.md 缺失 — 目录只有 SKILL.md + example.html;无输入样例属该批模板的常见形态(9 份中 6 份如此),非缺陷但少了一份「喂什么」的示范。
  • [ok] 目录资产面普查 — glob 全量:SKILL.md、example.html;无 scripts/、无 references/、无数据文件、无包管理器清单。
  • [ok] 可执行代码普查 — example.html 内 <script> 计数 = 0,fetch/XMLHttpRequest/WebSocket 命中 0;SKILL.md 全篇无脚本或可执行代码。
  • [ok] 外链端点普查 — 目录内(含 example.html)零 http(s) 命中,产物离线自持。
  • [ok] official_desc 逐字核对 — meta.official_desc 与 SKILL.md frontmatter 的 description 逐字一致。

6结论

  • 六段结构即交付清单,HR 照填即可
  • 把「完成标准」做成可勾选验收区
  • 时间线用 grid 而非表格,语义干净
  • 零脚本零外链,离线自持
  • 适合: 新员工首周指引、远程入职 one-pager、团队 wiki 的 onboarding 页;HR/People Ops 需要「发给新人就能自助」的交付物时最合适。
    不适合: 需要流程引擎/表单提交的入职系统(产物是静态页);需要严格合规审计追踪的场景;日程需与日历系统双向同步的场合。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload hr-onboarding.tar.gz
    sha256: 8cc280cfe9045903…
    Option B · Copy Guide for Agent
    install.json
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 553ed98c28.