文档 / 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(通过管理 API 无法写入图片文件夹,请通过 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 协助下翻译;官方职位名称保留英文。