Skip to main content
Jenks 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。

圖片

將照片、影片剪輯或 PDF 上傳至媒體庫(主控台的 Media 分頁,或 jenks admin media upload <file>),然後引用回傳的 /media/… URL:

image: /media/2026/10/acme-workshop-3f9a1c2b7d.webp
imageAlt: Jenks running an AI workshop at Acme
gallery:
  - src: /media/2026/10/acme-team-0c1d2e3f4a.webp
    alt: The Acme leadership team at the kick-off

當設定 image 時必須提供 imageAlt,且每個 gallery 項目都需要 alt。若對應的 /media/… 檔案不存在,將拒絕儲存。在主控台的視覺化編輯器中,你可以從媒體庫挑選,而無需手動輸入 URL。參見 Upload and use images and files。

發佈

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