Skip to main content
JGJenks Guo

文件 / how to

新增一則經驗

適用於 Jenks——建立新的經驗、專案、社群或學歷條目,通過驗證並在所有位置顯示。

檔案放在哪裡

一個條目對應一個 Markdown 檔。資料夾位置取決於其 kind:

類型 路徑
experience content/corpus/experiences/<slug>.md
project content/corpus/projects/<slug>.md
community content/corpus/community/<slug>.md
education content/corpus/education/<slug>.md

slug 採用 kebab-case,且必須與檔名相同。

範本

---
slug: acme-ai-advisor
kind: experience
title: AI Advisor
org: Acme Pty Ltd
orgUrl: https://acme.example
location: Melbourne
start: 2026-11
end: present
tags: [ai, consulting]
lenses: [ai-transformation-consultant, head-of-ai]
skills: [AI strategy, Governance]
metrics:
  - One short, factual key result with a number where known
summary: One sentence that says what Jenks did and why it mattered.
featured: false
proof:
  - { type: article, title: "Case study", url: "https://acme.example/case-study" }
---

## Overview

The organisation, the situation and Jenks's mandate.

## What Jenks did

- Concrete actions, one per bullet.

## Achievements

- Results with numbers where they are known.

## Why it matters to employers

Why this experience is relevant to the roles Jenks is targeting.

欄位規則

  • start 為 YYYY-MM;end 為 YYYY-MM 或 present。當無法確切得知月份時,使用 period(例如 "2010 — 2011"),日期為概略時加上 approx: true。
  • tags 必須從以下集合選取:it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative。
  • lenses 必須從以下集合選取:head-of-ai, ai-transformation-consultant, engineering-manager, solution-architect, system-integrator, support-engineer, ict-specialist, developer-advocate, developer-evangelist, digital-marketer, hospitality。
  • proof 項目需要 type(article, video, code, talk, paper, site)與 title;url 必須為 http(s)。
  • 專案可設定 timeline: true 以同時出現在職涯時間軸中。
  • 官方職稱請與 LinkedIn 上完全一致。

完整清單見 data model reference 與 jenks admin schema。

圖片

在 web/public/img/jenks/ 下新增一張 WebP(透過 admin API 無法寫入 images 資料夾,請透過 git 新增)。然後設定:

image: /img/jenks/acme-workshop.webp
imageAlt: Jenks running an AI workshop at Acme

當設定了 image 時必須同時提供 imageAlt,若影像檔缺失將導致建置失敗。

發佈

jenks admin validate content/corpus/experiences/acme-ai-advisor.md acme-ai-advisor.md
jenks admin put content/corpus/experiences/acme-ai-advisor.md acme-ai-advisor.md \
  -m "Add Acme AI Advisor" --branch dev
jenks admin deploys

檢查 https://dev.jenksguo.xyz/career/acme-ai-advisor,然後執行 jenks admin promote。

發佈後,該條目會出現在職涯頁與其專屬頁面、提供全部七種語言版本、包含於 /llms-full.txt 與 /experience.json,並被 Ask Jenks 助理與 MCP 工具的回答所使用。

.md本頁內容在 AI 協助下翻譯;官方職稱保留英文。