yao-positioning-skill

Positioning analysis and report

Owned Job

Generate a positioning report for an individual, course, product, service, or brand.
Research five types of competitive references.
Compare 2 to 3 options and recommend or downgrade.

Workflow

Per references/intake-and-readiness-gate.md accept Q&A, attachments, or URLs, organize the templates/intake-brief.schema.json that conforms to intake-brief.json, run python3 scripts/validate-intake.py intake-brief.json。
Only when validation returns intake_ready begin retrieval; otherwise stop and use the returned missing items and examples, asking 1 to 3 questions per round. Before starting, echo the object, purpose, scope, collected materials, self-reported items, and items to be verified.
Choose local、standard or deep research mode. When current competitor, price, or market facts are needed, online verification is mandatory.
Read references/theory-system.md. For personal IP or course tasks, also read references/course-marketing-method.md。
Per references/ai-workflow.md establish the claims list, competitive set, research plan, and evidence ledger.
Per references/source-credibility-policy.md distinguish facts, self-reports, inferences, assumptions, and recommendations; sources must pass checks for authority, claim fit, directness, timeliness, independence, and market fit.
Per references/competitor-research-method.md research competition and mental positioning. It is prohibited to write "no public evidence found" as "does not exist."
Per references/demand-and-differentiation-method.md analyze demand, market gaps, and D6 advantages, and execute the veto rules.
After passing the diagnosis and recommendation thresholds, generate 2 to 3 positioning options and stress-test them, recommending only one; if not passed, output only preliminary observations and a supplementary evidence plan.
Per references/plain-language-positioning-method.md generate a plain-language mental snapshot, then proceed to the visual report.
First generate the JSON that conforms to templates/report-data.schema.json , then run python3 scripts/validate-report-data.py positioning-report-data.json。
After validation passes, run python3 scripts/render-report.py positioning-report-data.json --out positioning-report。
Run python3 scripts/review-report.py positioning-report, fix semantics, charts, mobile, print, and cross-format regressions; warnings must not be eliminated by deleting evidence or upgrading confidence.
Per references/report-contract.md verify the consistency of conclusions, metrics, and citations across HTML, JSON, and Markdown. For template or chart changes, then per references/report-review-method.md perform three-viewport and A4 PDF rasterization review.

Downgrade Rules

Research readiness threshold not passed: only supplement information, do not retrieve competitors, do not generate options.
Diagnosis threshold not passed: output only preliminary observations and a supplementary evidence plan.
Unable to access external materials and the user has not provided competitors: enter local evidence mode and output a supplementary evidence checklist.
No evidence of user demand: must not claim a market gap.
No provable advantage: output capability-building recommendations, do not fabricate differentiation labels.
Involving first, only, leading, or effect promises: require independent evidence and compliance review.

Output Contract

Default deliverables:

positioning-report.html: offline visual decision report.
positioning-report-data.json: the single structured source of truth.
positioning-report.md: script-free degraded version and audit record.

First use a one-page mental snapshot to clearly state the conclusion, then provide demand, competition, advantages, options, actions, risks, evidence, and validation plan. For personal IP or courses, add four-layer consistency; for courses, additionally add the action path, 4P, and course mechanism. For missing data, display "insufficient evidence"; do not fabricate charts or total scores.

Before delivery, review-report.py must pass. Source timeliness and evidence warnings may remain, but must be visible in the report and review results; for zero-warning delivery use --strict。

Reference Map

Theory:references/theory-system.md、references/plain-language-positioning-method.md、references/course-marketing-method.md
Execution:references/intake-and-readiness-gate.md、references/ai-workflow.md
Research:references/source-credibility-policy.md、references/competitor-research-method.md
Analysis:references/demand-and-differentiation-method.md
Delivery:references/report-contract.md、references/report-review-method.md、references/html-report-spec.md、references/metric-dictionary.md
Render assets:assets/report-template.html、assets/echarts.min.js
System description:reports/positioning-skill-system-overview-2026-07-16/index.html
Distribution sanitization:scripts/sanitize-package.py(executed only after rebuilding the ZIP)