Skip to main content
Jenks Guo

文档 / how to

添加新的经历

适用于 Jenks —— 创建一条新的经历、项目、社区或教育条目,通过校验并在各处显示。

文件应放在哪里

一个条目对应一个 Markdown 文件。其文件夹取决于其 kind:

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,且每个画廊项都需要 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 协助下翻译;官方职位名称保留英文。