文件 / 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 協助下翻譯;官方職稱保留英文。