Agent skill

Job Stories

by killvxk in killvxk/pm-skills-zh

使用「当 [情境] 时,我想要 [动机],以便 [结果]」格式创建工作故事,附带详细的验收标准。适用于编写工作故事、创建 JTBD(用户待办任务)风格的待办事项,或表达用户情境和动机。

MITAuto-check passedProduct & Project Management

Install Job Stories

skills CLI
$ npx skills add killvxk/pm-skills-zh --skill job-stories -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install killvxk/pm-skills-zh job-stories --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/killvxk/pm-skills-zh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pm-execution/skills/job-stories .claude/skills/job-stories && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
job-stories
GitHub stars
167
Token cost
~351 tokens
SKILL.md length
116 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

使用「当 [情境] 时,我想要 [动机],以便 [结果]」格式创建工作故事,附带详细的验收标准。适用于编写工作故事、创建 JTBD(用户待办任务)风格的待办事项,或表达用户情境和动机。

  • Works in 8 steps: 识别触发需求的用户情境 → 定义用户行为背后的动机 → 明确用户想要实现的结果 → …
  • Tasks that involve User stories
  • SKILL.md covers Step-by-Step Process(分步流程), Story Template(故事模板), Example Job Story(工作故事示例) and Output Deliverables(输出交付物)
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Job Stories is an agent skill from killvxk/pm-skills-zh. 使用「当 [情境] 时,我想要 [动机],以便 [结果]」格式创建工作故事,附带详细的验收标准。适用于编写工作故事、创建 JTBD(用户待办任务)风格的待办事项,或表达用户情境和动机。

Its SKILL.md is about 350 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering User stories. The repository describes itself as: PM Skills Marketplace 简体中文版 - 65个产品经理技能和36个工作流,翻译自 https://github.com/phuryn/pm-skills/. The licence is MIT.

When your agent uses it

  • Tasks that involve User stories

Example prompts

  • “/job-stories”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. 识别触发需求的用户情境
  2. 定义用户行为背后的动机
  3. 明确用户想要实现的结果
  4. 应用 JTBD 框架: 聚焦于工作本身,而非角色
  5. 创建验收标准, 验证成果是否已实现
  6. 使用可观察、可量化的语言
  7. 链接设计原型或 Mockup
  8. 输出带详细验收标准的工作故事

What it can do on your machine

Read from SKILL.md and the folder at commit 5179784. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • productcompass.pm

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Job Stories loads about 351 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 116 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~351

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from killvxk/pm-skills-zh at commit 5179784, republished under its MIT licence (© killvxk). 116 words, ~351 tokens.

Download SKILL.mdSave it as .claude/skills/job-stories/SKILL.md (or your agent's skills folder).
name
job-stories
description
使用「当 [情境] 时,我想要 [动机],以便 [结果]」格式创建工作故事,附带详细的验收标准。适用于编写工作故事、创建 JTBD(用户待办任务)风格的待办事项,或表达用户情境和动机。

工作故事(Job Stories)

使用「当 [情境] 时,我想要 [动机],以便 [结果]」格式创建工作故事,聚焦于用户情境和成果,附带详细的验收标准。

适用场景: 编写工作故事、表达用户情境和动机、创建 JTBD(Jobs-to-be-Done,用户待办任务)风格的待办事项,或聚焦用户背景而非角色时。

参数:

  • $PRODUCT:产品或系统名称
  • $FEATURE:需要拆解为工作故事的新功能
  • $DESIGN:设计文件链接(Figma、Miro 等)
  • $CONTEXT:用户情境或工作场景

Step-by-Step Process(分步流程)

  1. 识别触发需求的用户情境
  2. 定义用户行为背后的动机
  3. 明确用户想要实现的结果
  4. 应用 JTBD 框架: 聚焦于工作本身,而非角色
  5. 创建验收标准, 验证成果是否已实现
  6. 使用可观察、可量化的语言
  7. 链接设计原型或 Mockup
  8. 输出带详细验收标准的工作故事

Story Template(故事模板)

标题: [工作成果或结果]

描述: 当 [情境] 时,我想要 [动机],以便 [结果]。

设计: [设计文件链接]

验收标准:

  1. [情境被正确识别]
  2. [系统支持预期的动机]
  3. [进度或反馈可见]
  4. [成果被高效实现]
  5. [边界情况被优雅处理]
  6. [集成和通知正常运行]

Example Job Story(工作故事示例)

标题: 追踪每周零食花费

描述: 当我在规划每周零食预算时(情境),我想要快速了解到目前为止花了多少钱(动机),以便确保在周末前不会花光零花钱(结果)。

设计: [Figma 链接]

验收标准:

  1. 显示"每周消费概览"板块,包含消费汇总
  2. 记录支出时实时更新
  3. 进度指示器(显示每周预算使用 0-100% 的进度条)
  4. 以醒目颜色突出显示剩余预算金额
  5. 详细消费记录,按类别分类展示
  6. 在预算使用达到 80% 时发送通知
  7. 在周四晚上预算使用达到 90% 时发送周末专属提醒
  8. 便于访问并可跳转至详细消费明细

Output Deliverables(输出交付物)

  • 该功能的完整工作故事集
  • 每个故事遵循「当……我想要……以便……」格式
  • 6-8 条聚焦于成果的验收标准
  • 故事强调用户情境和动机
  • 包含清晰的设计和原型链接

Further Reading(延伸阅读)

© killvxk, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in pm-execution/skills/job-stories of killvxk/pm-skills-zh.

Open the folder on GitHubat commit 5179784

Compare with similar skills

Job Stories next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Job Stories compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Job Stories this skillkillvxk/pm-skills-zh167—~351Automated safety check: PassMIT
User Story Writerdeanpeters/Product-Manager-Skills7.2k2 repos~2.9kAutomated safety check: PassCustom licence
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
To Specbestofjs/bestofjs3.1k21 repos~757Automated safety check: PassMIT

Similar skills

  • User Story Writer

    deanpeters/Product-Manager-Skills

    Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.

    7.2k GitHub starsUsed in 2 repos~2.9k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • To Spec

    bestofjs/bestofjs

    Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

    3.1k GitHub starsUsed in 21 repos~757 tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed

More from killvxk/pm-skills-zh

All 11 skills in this repo
  • Ab Test Analysis

    killvxk/pm-skills-zh

    分析 A/B 测试结果,涵盖统计显著性检验、样本量验证、置信区间计算及上线/延长/停止的决策建议。适用于评估实验结果、判断测试是否达到显著性、解读分流测试数据,或决定是否上线某个实验组。

    167 GitHub stars~480 tokensUpdated 6 mo ago
    Auto-check passed
  • Brainstorm Okrs

    killvxk/pm-skills-zh

    集思广益制定团队级 OKR(目标与关键成果),对齐公司目标——定性目标与可量化关键成果。适用于制定季度 OKR、将团队目标与公司战略对齐、起草目标,或学习如何编写有效的 OKR。

    167 GitHub stars~533 tokensUpdated 6 mo ago
    Auto-check passed
  • Cohort Analysis

    killvxk/pm-skills-zh

    对用户参与度数据执行同期群分析——留存曲线、功能采用趋势及分层洞察。适用于按同期群分析用户留存、研究功能随时间的采用情况、调查流失规律,或识别参与度趋势。

    167 GitHub stars~562 tokensUpdated 6 mo ago
    Auto-check passed
  • Dummy Dataset

    killvxk/pm-skills-zh

    生成用于测试的逼真虚拟数据集,支持自定义列、约束条件及输出格式(CSV、JSON、SQL、Python 脚本)。适用于创建测试数据、构建模拟数据集,或为开发和演示生成示例数据。

    167 GitHub stars~595 tokensUpdated 6 mo ago
    Auto-check passed
  • Interview Script

    killvxk/pm-skills-zh

    创建结构化的用户访谈脚本,包含 JTBD(用户待办任务)探测问题、破冰环节、核心探索及收尾部分。遵循"老妈测试"原则——不引导、不推销,聚焦过去的实际行为。适用于准备用户访谈、创建访谈指南或规划探索性研究时使用。

    167 GitHub stars~547 tokensUpdated 6 mo ago
    Auto-check passed
  • Metrics Dashboard

    killvxk/pm-skills-zh

    定义并设计产品指标看板,包含核心指标、数据来源、可视化类型和告警阈值。适用于创建指标看板、定义 KPI(关键绩效指标)、搭建产品分析体系或制定数据监控计划时使用。

    167 GitHub stars~741 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Job Stories

What does Job Stories do?

使用「当 [情境] 时,我想要 [动机],以便 [结果]」格式创建工作故事,附带详细的验收标准。适用于编写工作故事、创建 JTBD(用户待办任务)风格的待办事项,或表达用户情境和动机。. Job Stories is an agent skill from killvxk/pm-skills-zh.

When should I use Job Stories?

Job Stories fits situations like: tasks that involve User stories.

How do I install Job Stories in Claude Code?

Run `npx skills add killvxk/pm-skills-zh --skill job-stories -a claude-code`. Or copy the skill folder (pm-execution/skills/job-stories in killvxk/pm-skills-zh) into .claude/skills/job-stories in your project. Claude Code loads it when a task matches its description.

How do I install Job Stories in Codex?

Run `npx skills add killvxk/pm-skills-zh --skill job-stories -a codex`. Or copy the skill folder (pm-execution/skills/job-stories in killvxk/pm-skills-zh) into .agents/skills/job-stories in your project. Codex loads it when a task matches its description.

Can I use Job Stories in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add killvxk/pm-skills-zh --skill job-stories -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/job-stories, .gemini/skills/job-stories, .github/skills/job-stories and .opencode/skills/job-stories in your project.

What does Job Stories need to run?

SKILL.md names no scripts, command-line tools or credentials: Job Stories is instructions for the agent only.

Does Job Stories access the network?

SKILL.md names 1 domain. As links in the text: productcompass.pm. This is read from the text; nothing was executed.

Is Job Stories safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Job Stories use?

Job Stories is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Job Stories use?

About 351 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Job Stories?

Skills that share tags, products or a category with Job Stories: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Agile Product Owner (alirezarezvani/claude-skills, 28k stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Job Stories?

killvxk (a GitHub user) maintains it in killvxk/pm-skills-zh, which has 167 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on March 16, 2026.

Source: killvxk/pm-skills-zh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.