AI 生成岗位三级技能：页面创建与更新

岗位技能页面的历史接口与实现记录：读取一二级配置树、解析 AI 三级技能结果，再映射 firstSkill / secondSkill 保存。

#work #howto #growing

AI 生成岗位三级技能：页面创建与更新

[!info] related notes

岗位入口: OLP 列表实现：handleSkillGenerate 按岗位与 JD 导航到 /edp/skill-generate。

接口边界: Structured Output, 输出校验

范围

这里的 skill 是岗位能力分类（Soft Skill、Hard Skill、HSE），不是 Agent 的 SKILL.md 能力包。以下保留历史配置和响应样本，不作为当前 API schema 的部署核验。

问题详情

样例有三个一级技能，id 为 1–3；二级技能由后端配置，样例 id 为 4–9。ID 只在本样例中对应这些分类，页面不应按数值范围猜层级或父子关系。然后调用 ai 来自动生成每个二级技能的下属三级技能，以 json 格式返回（包含一级技能、二级技能，然后前端再将对应三级技能渲染到）

解决方案

第一步

后端提供一个接口（传入 positionId,返回配置好的二级技能）

这是配置树的结构：

{
  "code": 0,
  "data": [
    {
      "level": 1,
      "id": 1,
      "parentId": 0,
      "name": "Soft Skill",
      "children": [
        {
          "level": 2,
          "id": 4,
          "parentId": 1,
          "name": "Problem Solving & Critical Thinking",
          "children": []
        },
        {
          "level": 2,
          "id": 5,
          "parentId": 1,
          "name": "Communication & Interpersonal Skills",
          "children": []
        },
        {
          "level": 2,
          "id": 6,
          "parentId": 1,
          "name": "Leadership & Management",
          "children": []
        }
      ]
    },
    {
      "level": 1,
      "id": 2,
      "parentId": 0,
      "name": "Hard Skill",
      "children": [
        {
          "level": 2,
          "id": 7,
          "parentId": 2,
          "name": "Industry-Specific Skills",
          "children": []
        },
        {
          "level": 2,
          "id": 8,
          "parentId": 2,
          "name": "Domain-Specific Skills",
          "children": []
        }
      ]
    },
    {
      "level": 1,
      "id": 3,
      "parentId": 0,
      "name": "HSE",
      "children": [
        {
          "level": 2,
          "id": 9,
          "parentId": 3,
          "name": "Health Safety & Security Environment",
          "children": []
        }
      ]
    }
  ],
  "msg": ""
}

此时前端已经可以渲染一级技能+二级技能的框架，并且三级技能可以让用户手动生成

第二步：生成候选并映射配置

点击 AI 生成按钮后获取响应。下面历史样本的外层是 SSE data: JSON，但 data.answer 是 Markdown 加一个 JSON 代码块，不能直接把 answer 整体 JSON.parse。样本只返回 Hard Skill，未包含请求模板中的 Soft Skill 与 HSE，因此不能当作完整成功结果覆盖全部分类。

处理时按协议完整解析事件，再提取并校验约定输出；现有混合文本接口可做有边界的兼容解析，失败时保留人工输入。一级、二级分类需匹配后端配置树；同名分类无法唯一定位时应报错，不能猜 ID。只将校验后的三级技能作为可编辑候选。

历史原始响应（保留输入与输出便于排障）

data:{"code": 0, "message": "", "data": {"answer": "# Hard Skill\n\n## Industry-Specific Skills\n- Talent Acquisition\n- Performance Management\n- Employee Relations\n- Training & Development\n- Compensation & Benefits Administration\n- HR Data Analysis\n- Policy Development\n- HRIS Systems\n- IT Recruitment\n- Technical Talent Sourcing\n- IT Performance Review\n- IT Training Needs Analysis\n- IT Compensation Benchmarking\n- IT Policy Implementation\n- Data Analysis for HR\n- Workforce Planning\n- Succession Planning\n- HR Metrics & Reporting\n\n## Domain-Specific Skills\n- Human Resource Management\n- Labor Law Compliance\n- Data Science (for HR Analytics)\n- Statistical Analysis\n- Computer Science (understanding IT roles)\n- Economics (compensation analysis)\n- Quantitative Analysis\n- Microsoft Office Suite\n- Reporting & Dashboarding\n- Data Interpretation\n- Predictive Modeling (HR)\n- HR Technology Implementation\n- Change Management (HR initiatives)\n- Organizational Development\n- Employee Lifecycle Management\n\n---\n\n```json\n{\n  \"Hard Skill\": {\n    \"Industry-Specific Skills\": [\n      \"Talent Acquisition\",\n      \"Performance Management\",\n      \"Employee Relations\",\n      \"Training & Development\",\n      \"Compensation & Benefits Administration\",\n      \"HR Data Analysis\",\n      \"Policy Development\",\n      \"HRIS Systems\",\n      \"IT Recruitment\",\n      \"Technical Talent Sourcing\",\n      \"IT Performance Review\",\n      \"IT Training Needs Analysis\",\n      \"IT Compensation Benchmarking\",\n      \"IT Policy Implementation\",\n      \"Data Analysis for HR\",\n      \"Workforce Planning\",\n      \"Succession Planning\",\n      \"HR Metrics & Reporting\"\n    ],\n    \"Domain-Specific Skills\": [\n      \"Human Resource Management\",\n      \"Labor Law Compliance\",\n      \"Data Science (for HR Analytics)\",\n      \"Statistical Analysis\",\n      \"Computer Science (understanding IT roles)\",\n      \"Economics (compensation analysis)\",\n      \"Quantitative Analysis\",\n      \"Microsoft Office Suite\",\n      \"Reporting & Dashboarding\",\n      \"Data Interpretation\",\n      \"Predictive Modeling (HR)\",\n      \"HR Technology Implementation\",\n      \"Change Management (HR initiatives)\",\n      \"Organizational Development\",\n      \"Employee Lifecycle Management\"\n    ]\n  }\n}\n```", "reference": {}, "param": [{"key": "job_title", "name": "job_title", "optional": false, "type": "line", "value": "Deputy HR Manager"}, {"key": "job_description", "name": "job_description", "optional": false, "type": "line", "value": "**Deputy HR Manager**\n\n**Department:** Information Technology **Reporting Line:** IM Manager\n\n**Job Purpose**\n\nTo support the development and implementation of HR strategies and initiatives aligned with the organization’s goals, specifically within the Information Technology department. This role focuses on attracting, developing, and retaining top talent to drive innovation and achieve business objectives.\n\n**Key Responsibilities**\n\n-   **Talent Acquisition:** Manage the full recruitment lifecycle for IT positions, including job posting, screening resumes, conducting interviews, and extending offers.\n    \n-   **Performance Management:** Facilitate the performance review process for IT employees, providing guidance to managers and employees on goal setting, feedback, and development planning.\n    \n-   **Employee Relations:** Address employee relations issues within the IT department, ensuring fair and consistent application of company policies and procedures.\n    \n-   **Training and Development:** Identify training needs within the IT department and coordinate training programs to enhance employee skills and knowledge.\n    \n-   **Compensation and Benefits:** Administer compensation and benefits programs for IT employees, ensuring compliance with company policies and legal regulations.\n    \n-   **HR Data Analysis:** Collect and analyze HR data to identify trends and insights, and make recommendations for improving HR programs and initiatives.\n    \n-   **Policy Development:** Assist in the development and implementation of HR policies and procedures.\n    \n-   **Employee Engagement:** Implement initiatives to promote employee engagement and create a positive work environment.\n    \n-   **Compliance:** Ensure compliance with all applicable labor laws and regulations.\n    \n\n**Required Qualifications**\n\n-   Master’s degree or PhD in Data Science, Statistics, Computer Science, Economics, or a related quantitative field.\n    \n-   Proven experience in a human resources role, with a focus on talent management and employee relations.\n    \n-   Strong understanding of HR principles, practices, and legal regulations.\n    \n-   Excellent communication, interpersonal, and problem-solving skills.\n    \n-   Ability to work independently and as part of a team.\n    \n-   Proficiency in Microsoft Office Suite and HRIS systems.\n    \n-   Experience working in a fast-paced, dynamic environment.\n    \n-   Strong analytical and data interpretation skills."}, {"key": "position_tags_last", "name": "position_tags_last", "optional": true, "type": "line"}, {"key": "skill_library", "name": "skill_library", "optional": true, "type": "line", "value": ["Health and Safety (Office Environment)", "Company HSE Policy", "Safe Work Practices", "English Language Skills", "H2S Awareness"]}, {"key": "skill_classification_command_template", "name": "skill_classification_command_template", "optional": true, "type": "line", "value": "一级分类: Hard Skill\n  二级分类: Industry-Specific Skills\n  二级分类: Domain-Specific Skills\n一级分类: HSE\n  二级分类: Health Safety & Security Environment\n一级分类: Soft Skill\n  二级分类: Problem Solving & Critical Thinking\n  二级分类: Communication & Interpersonal Skills\n  二级分类: Leadership & Management"}, {"key": "skill_template_markdown", "name": "skill_template_markdown", "optional": true, "type": "line", "value": "# Hard Skill\n## Industry-Specific Skills\n## Domain-Specific Skills\n... (No more than 20 tags, one per line, starting with \"- \") \n\n---\n# HSE\n## Health Safety & Security Environment\n... (No more than 20 tags, one per line, starting with \"- \") \n\n---\n# Soft Skill\n## Problem Solving & Critical Thinking\n## Communication & Interpersonal Skills\n## Leadership & Management\n... (No more than 20 tags, one per line, starting with \"- \") "}, {"key": "skill_template_json", "name": "skill_template_json", "optional": true, "type": "line", "value": "{\n  \"Hard Skill\":   {\n    \"Industry-Specific Skills\": [\"Industry-Specific Skills 1\", \"Industry-Specific Skills 2\"],\n    \"Domain-Specific Skills\": [\"Domain-Specific Skills 1\", \"Domain-Specific Skills 2\"]\n  },\n  \"HSE\":   {\n    \"Health Safety & Security Environment\": [\"Health Safety & Security Environment 1\", \"Health Safety & Security Environment 2\"]\n  },\n  \"Soft Skill\":   {\n    \"Problem Solving & Critical Thinking\": [\"Problem Solving & Critical Thinking 1\", \"Problem Solving & Critical Thinking 2\"],\n    \"Communication & Interpersonal Skills\": [\"Communication & Interpersonal Skills 1\", \"Communication & Interpersonal Skills 2\"],\n    \"Leadership & Management\": [\"Leadership & Management 1\", \"Leadership & Management 2\"]\n  }\n}"}], "id": "7a3eee1f-58c2-4a2a-9b4f-45a0d59b7f26", "session_id": "65cb01d2b62f11f0981c0242ac140003"}}

第三步：保存创建或更新

下面是原有 update / create 参数样例，与上面的 Deputy HR Manager 生成响应不是同一岗位。firstSkill、secondSkill 指向配置树中的父子节点，thirdSkill 是三级技能文本；id: 53 为该保存样例的记录标识，不能据此假定 create 与 update 都要求相同字段，需核对实际接口合同。

{
    "positionId": 1,
    "positionName": "Managing Director",
    "positionReportsTo": "manager lead",
    "skills": [
        {
            "firstSkill": 1,
            "secondSkill": 4,
            "thirdSkill": "Root Cause Analysis"
        },
        {
            "firstSkill": 1,
            "secondSkill": 4,
            "thirdSkill": "Innovation Management"
        }
    ],
    "id": 53
}

保存前检查

校验岗位权限、分类父子关系、空文本和重复候选；不能仅检查 JSON 语法。
配置或岗位切换后，旧生成响应不得覆盖新页面；保留用户已编辑内容。
缺失分类应显式提示并保留现有内容；创建 / 更新成功后再显示已保存，重复提交按接口幂等合同处理。