SuperAPI AI Directory

job-description-optimizer-cn

General & other

View repository

Updated 10-15 19:55

About this skill

job-description-optimizer-cn Business Diagnostic Assistant

Quick Start

More Skills

Overview

The Business Diagnostic Assistant is used to answer "how should this be done," recruiting, JD, and skill matching questions. It is suitable for human resources, managers, operations, and software after clarifying business goals, content materials, or analysis targets. It combines inputs such as JD text, pasted job responsibilities, qualifications, nice-to-haves, team introduction, and recruiting highlights. It organizes key context and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.

When to Use

Applicable Scenarios

  • The user raises questions such as "how should this be done" and needs to quickly break down goals, determine priorities, and form executable results
  • Human resources, managers, operations, and software need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the Business Diagnostic Assistant
  • The user has already prepared the role and team background (explain the level, reporting line, business stage, city, salary range, and hiring urgency.), recruiting reference links (fill in publicly accessible recruiting pages, job pages, team introductions, or competitor JD links.), uploaded JD materials (upload JD drafts, role profiles, performance requirements, competitor JDs, or recruiting retrospectives.), and hopes to organize them into executable analysis or optimization results
  • The user needs to turn Business Diagnostic Assistant-related materials into clear conclusions, priorities, and next actions

How to Call

Call the AI Skills API directly through the exported Python runner:

Command Examples

Basic Call

python3 scripts/run.py --params '{}'

Call with Common Parameters

python3 scripts/run.py --params '{"roleContext":"岗位与团队背景"}'

Parameter Description

Parameter Type Required Default Description
roleContext string No - Explain the level, reporting line, business stage, city, salary range, and hiring urgency
hiringPlanLink string No - Fill in publicly accessible recruiting pages, job pages, team introductions, or competitor JD links; a complete accessible URL must be provided
jdDocumentFile string No - Upload JD drafts, role profiles, performance requirements, competitor JDs, or recruiting retrospectives
jdOptimizeFocus string No 吸引力 Select the direction that needs the highest priority in this Chinese JD optimization; optional values:吸引力、要求清晰、合规表达、筛选标准
rolePostingText string No - Paste job responsibilities, qualifications, nice-to-haves, team introduction, and recruiting highlights
compensationConstraintNotes string No - Add hard requirements, content that cannot be promised, and requirements to exclude sensitive restrictions such as age/gender

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

The current skill has no category parameters that require additional lookup tables.

Supported Input Formats

The current skill directly accepts JSON parameters; if a parameter contains a link field, please provide a complete, accessible URL.

Example Request

The example parameters below can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"roleContext":"岗位与团队背景"}'

Equivalent --params JSON:

{
  "roleContext": "岗位与团队背景"
}

Example Return Result

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

  • Summary, diagnostic conclusions, action recommendations, and reusable deliverables: core results organized around user goals that can be directly read, reviewed, or delivered.
  • Input material interpretation: combine role and team background (explain job level, reporting line, business stage, city, salary range, and hiring urgency.), recruitment reference links (provide publicly accessible recruitment pages, job pages, team introductions, or competitor JD links.), uploaded JD materials (upload JD drafts, role profiles, performance requirements, competitor JDs, or recruitment reviews.) to extract key context and judgment bases.
  • Next steps: provide priorities, execution suggestions, or content frameworks that can be further developed.

Suggestions for Using the Results

  • First determine whether the output answers the user's core questions about the "Business Diagnostic Assistant."
  • Then check whether the results cover the summary, diagnostic conclusions, action recommendations, and reusable deliverables, and whether clear next steps are provided.
  • If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.

Preparation Before Running

  • AISKILLS_BASE_URL: default https://ai-skills.ai
  • AISKILLS_API_KEY: required, used for authenticated calls
  • AISKILLS_TENANT_ID: default default