ドキュメント&知識ベース · nexu-io/html-anything

hr-onboarding

初週スケジュール + バディ + 学習パス + 備品 + 完了定義

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仕組みと動作原理

6セクション構成の入社ワンページャー:hero(氏名/入社日/チーム)→ 初週スケジュール → Manager + Buddyカード → learning track → equipment checklist → 「準備完了の基準(You're set when…)」受け入れエリア。

next/src/lib/templates/skills/hr-onboarding/SKILL.md
- Welcome hero (姓名 + 入职日 + 团队)
構造そのものがコンテンツのチェックリスト:HRはこの6セクションを埋めるだけで自然と完成度の高いページを作成でき、ドキュメント系テンプレートとして最も手間がかかりません。

初週スケジュールは日ごとの時間枠まで細分化:サンプルではDay 1の09:00–14:00スケジュールとMon–Friの5日間タイムラインを提供。

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 }` を用いた2列グリッドで実装され、行間は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/社員証が利用可能か)も兼ね備えており、本テンプレートで最もプロダクト思考が反映された設計です。

テンプレート本体がプロンプトそのもの: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本文を取得してプロンプトのメインとし、ローカルでログイン済みの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をピッカーのメタデータとして抽出し、本文を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日間のタイムライン(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によるログイン済みローカル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結論

  • 6セクション構造がそのまま納品チェックリストになり、HRは埋めるだけで作成可能
  • 「完了基準」をインタラクティブにチェック可能な検収エリアとして設計
  • タイムラインにテーブルではなくCSSグリッドを採用し、クリーンなセマンティクスを実現
  • スクリプトおよび外部リンク不使用で、完全オフライン稼働に対応
  • 最適な用途: 新入社員の初週ガイダンス、リモート入社用のワンページャー、チームWikiのオンボーディングページ。「新人に渡すだけで自律的に進められる」成果物を必要とするHR/People Opsに最適。
    不向きな用途: ワークフローエンジンやフォーム送信を必要とする入社管理システム(成果物は静的HTMLページ);厳格なコンプライアンス監査ログが必要な用途;カレンダーシステムとの双方向同期が求められる運用。
    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.