文档 / 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 协助下翻译;官方职位名称保留英文。