sop-readability-check

sop-readability-check Business Diagnostic Assistant

Quick Start

More Skills

Overview

The Business Diagnostic Assistant is used to answer "how should this be done," SOP, work instructions, and training. It is suitable for operations, managers, manufacturing, and SOP to invoke after clarifying business goals, content materials, or analysis targets. It combines SOP step text, pasted work steps, precautions, exception handling, responsibility assignments, and checkpoints. and other inputs, organizes key context, and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables, making it easy to continue execution, review, or delivery.

When to Use

Applicable Scenarios

• When users raise questions like "how should this be done," needing to quickly break down goals, determine priorities, and form actionable results
• Operations, managers, manufacturing, and SOP need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the Business Diagnostic Assistant
• The user has already prepared inspection priorities (select the direction that most needs priority handling in this SOP readability check.), uploaded SOP documents (upload SOPs, work instructions, checklists, training materials, or flowcharts.), SOP step text (paste work steps, precautions, exception handling, responsibility assignments, and checkpoints.), 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 steps

Invocation Method

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

Command Examples

Basic Invocation

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

Invocation with Common Parameters

python3 scripts/run.py --params '{"sopCheckFocus":"步骤清晰"}'

Parameter Description

Parameter	Type	Required	Default	Description
sopCheckFocus	string	No	步骤清晰	Select the direction that most needs priority handling in this SOP readability check; optional values:步骤清晰、风险提示、异常处理、点检清单
sopDocumentFile	string	No	-	Upload SOPs, work instructions, checklists, training materials, or flowcharts
sopProcedureText	string	No	-	Paste work steps, precautions, exception handling, responsibility assignments, and checkpoints
sopReferenceLink	string	No	-	Fill in publicly accessible process standards, equipment manuals, or reference specification links; a complete accessible URL is required
safetyControlNotes	string	No	-	Supplement safety tips, quality checkpoints, shutdown conditions, and approval nodes that must be retained
operatorScenarioContext	string	No	-	Describe positions, shifts, equipment, environment, safety risks, training levels, and usage frequency

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

Parameter Value Reference

The current skill has no categorical parameters requiring additional lookup.

Supported Input Formats

The current skill directly accepts JSON parameters; if a parameter contains a link field, pass 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 '{"sopCheckFocus":"步骤清晰"}'

Equivalent --params JSON：

{
  "sopCheckFocus": "步骤清晰"
}

Example Return Result

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

Deliverables

• Summary, diagnostic conclusions, action recommendations, and reusable deliverables: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
• Interpretation of input materials: combine the inspection focus (choose the direction that needs the highest priority in this SOP readability check.), uploaded SOP documents (upload SOPs, work instructions, checklists, training materials, or flowcharts.), and SOP step text (paste work steps, precautions, exception handling, responsibility assignments, and checkpoints.) to extract key context and basis for judgment.
• Next steps: provide priorities, execution recommendations, or a content framework that can be further processed.

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 given.
• If there is little input material, it is recommended that the user supplement the goals, audience, constraints, or source materials before running it.

Preparation Before Running

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