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

图片

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