Community研究與資料分析github.com

Cism-Ch/aioseo-verification

AIOSEO TruSEO 驗證技術指南。定義邏輯連接詞的數學公式 15/41 (36.5%)、長句(>20 字)的 0% 嚴格限制以及 Standard B 中繼標題。

aioseo-verification 是什麼?

此技能(Cism-Ch/aioseo-verification)提供了一份詳盡的技術指南,用於確保 WordPress 產品頁面的內容完全符合 AIOSEO 的 TruSEO 演算法與 Big Tech 轉換原則。它定義了嚴格的內容生成與驗證規則,包括中繼標題長度(50-60 字元)、元描述長度(155-160 字元)、總字數(500-650 字)、段落長度(介紹段 ≤100 字,其餘 ≤60 字)、句子長度(最多 25% 句子可超過 20 字,目標 ≤20%)、被動語態比例(<10%)以及轉折詞使用密度(每句 30-70%)。此外,它還強調語法品質、自然語調、事實性語氣,並避免過度形容詞。技能內含一份完整的檢查清單、轉折詞列表、AI 代理人的生成指令,以及一個快速驗證工具對照表(例如使用 `audit_aioseo_sentences.py` 腳本)。此技能主要針對使用 AIOSEO 外掛的 WordPress 網站,說明文件以法文撰寫,但規則與方法可應用於任何語言的 SEO 內容優化。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cism-Ch/AI-Content-Management-and-PIM-workflow/tree/main/.agents/skills/aioseo-verification

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AIOSEO 驗證與內容生成指南

本指南定義了 WordPress 產品頁面的稿件標準,符合 AIOSEO 的 TruSEO 演算法與 Big Tech 轉換原則。


📋 AIOSEO (TruSEO) 驗證檢查清單

1. 標題與 Meta 分析

  • SEO 標題長度: 介於 50 至 60 個字元。主要關鍵字必須置於開頭。
  • Meta 描述長度: 介於 155 至 160 個字元。必須包含獨特的銷售主張(USP)與行動呼籲(CTA)。

2. 內容結構(遵循範本)

  • 內容長度: 長描述至少 500 字(可見文字,生產安全邊際,嚴格下限 450 字)。
  • 子標題分佈: 每個區塊一個標題(H2)。
  • 短描述標籤: 必須透過 <em> 標籤以斜體包含結論。
  • HTML 衛生: 短描述中不得使用 <div> 或自訂 CSS 樣式(WordPress SEO)。
  • 內部連結: 至少 1 個連結指向配件或上層類別。
  • 外部連結: 至少 1 個連結指向權威來源(例如製造商頁面)或獨立評測。
  • 圖片/影片: 需有媒體元素,且 alt 屬性需包含描述性文字與關鍵字。

3. 可讀性(TruSEO 因素)

  • 段落字數(關鍵——阻擋性):
    • 計算說明:僅計算可見文字(移除 HTML 標籤)。validate_html_template.py 腳本為字數計算的權威依據。或者,代理人於自我審計時執行此計數。
    • 引言段落:≤ 100 字(產品事實陳述)
    • 所有其他段落:每個段落 ≤ 60 字(根據規格表長度可在 45-60 間彈性調整)
    • 「簡要規格」部分:H2 加上表格總計約增加 50-60 字
    • 長描述總字數:500-650 字(安全目標至少 500 字——嚴格——不得低於 450 或超過 650)
    • 計算驗證:計算所有可見文字,包括 H2「規格」與表格內容(不含標籤)
  • 段落長度: 任何段落不得超過 60 字(引言段最多 100 字)。根據表格調整。
  • 句子長度(關鍵——阻擋性): 最多 25% 的句子可超過 20 字(目標:≤20%)。優先使用 12-18 字的句子。AI 寫手系統性地將任何達到 18 字的句子用句號分割。
  • 句子結構(注意): 複雜的技術描述應分為兩個獨立句子,而非使用過多的逗號。
  • 被動語態: 被動語態句子最多 10%。優先使用主動語態(例如:「處理器提升」而非「效能被…提升」)。
  • 轉折詞(每句,非每段): 至少 30% 的句子必須包含轉折詞(最佳區間 30-70%)。AIOSEO 在句子任何位置尋找轉折詞,不限於開頭。段落開頭的轉折詞最多 4 個(共 7 句),以避免風格過於冗贅。由 audit_aioseo_sentences.py 驗證。
  • 連續句子: 永遠不要連續三句以相同的詞開頭。
  • Flesch 閱讀難易度: 目標分數介於 60 至 70(「標準」可讀性)。

4. 文法品質與語氣(關鍵)

  • 標準文法: 僅使用正確的標準法文。不得有拐彎抹角的結構、人為句法或「機器人」語氣。
  • 冠詞與限定詞: 名詞前務必使用正確的冠詞(le, la, les, un, une, des),以產出語法正確的句子。
  • 母語流暢度: 文字必須讀起來自然。避免句子結構重複(例如:「它配備…它擁有…它搭載…」)。
  • 避免冗詞: 避免過於描述性的句子或華麗的詞藻。優先清晰簡潔。
  • 事實性語氣: 以直接、事實性的語氣書寫,靈感來自專業技術規格(Samsung/Apple 風格)。
  • 避免過度形容詞: 限制最高級與強調性形容詞(「驚人」、「革命性」)。偏好可衡量的事實。
  • 拼字校正: 檢查所有單字的拼字,特別是技術術語與品牌名稱。
  • 時態一致性: 描述產品特性時,一致使用直陳式現在式。

🔝 轉折詞列表(用於 TRUSEO)

多樣化使用這些詞語,以維持每句 30-70% 的比例(非每段)。AIOSEO 在句子任何位置尋找這些詞:

  • 附加: 此外、再者、另外、同樣地、加之、和、以及。
  • 對比/轉折: 然而、但是、儘管如此、相反地、卻、然而、雖然。
  • 原因/理由: 事實上、因為、由於、既然、因為、由於。
  • 結果/結論: 所以、因此、這就是為什麼、從而、因此、總而言之、結論是、簡而言之、最後。
  • 時間/順序: 首先、然後、最後、接著、第一、第二、第三、首先、其次、最後。
  • 舉例: 例如、特別是、尤其是、具體而言、像。
  • 選擇: 要么…要么、時而…時而、一方面…另一方面。

🤖 生成指令(AIOSEO 框架 - 專業文案撰寫)

方法:專業技術寫手

系統應像專業寫手一樣運作,根據真實技術規格撰寫多樣且自然的內容。

專業文案撰寫方法論

✅ 正確方法範例 - 自然撰寫:

規格: {"processeur": "MediaTek Helio G99", "batterie": "5500 mAh", "écran": "AMOLED 120Hz"}
撰寫: "Redmi Note 14 4G 搭載以 6nm 製程打造的 MediaTek Helio G99 處理器,
提供均衡效能,勝任多工與輕度遊戲。其 5500 mAh 電池可確保超過 12 小時的
重度使用續航。6.67 吋 120Hz AMOLED 螢幕讓每次互動都更加流暢。"

❌ 錯誤方法 - 僵硬替換:

僵硬模板: "[處理器] 提供 [形容詞]。"
結果: 重複且不自然的文字

AI 代理人指令

務必遵守的嚴格字數限制:

  • 說明:計算基準為僅可見文字(不含 HTML 標籤)。
  • 引言段落:最多 100 字
  • 所有其他段落:每個段落最多 60 字
  • 長描述總字數:500-650 字(生成的安全目標;驗證器基於相容性原因,接受 450 字以上的內容,但目標 500 字可避免任何拒絕)。
  • 必須在建立檔案前驗證 - 若超出則失敗檢查點

在階段 2(長描述)與階段 3(短描述)中:

  1. 分析規格

    • 完整閱讀 specs-[variant].html 檔案
    • 識別關鍵與差異化特性
    • 記錄精確的技術數據(容量、型號、技術)
    • 規格必須對應且為真
  2. 自然撰寫

    • 像專業技術寫手一樣書寫
    • 變化句子結構
    • 自然地使用轉折詞
    • 以平易近人的方式解釋技術規格
    • 將技術特性連結至真實效益
  3. 品質標準

    • 文法:完美的標準法文
    • 語氣:事實性、專業、Samsung/Apple 風格
    • 準確性:所有技術數據必須完全符合規格
    • 清晰度:短句(≤20 字,18 字時系統性分割),段落簡潔
    • 自然度:文字必須流暢易讀,而非像填寫的表格
  4. 應做的事

    • ✅ 變化句子開頭
    • ✅ 使用適當的同義詞
    • ✅ 在各區塊間建立流暢的過渡
    • ✅ 必要時解釋技術術語
    • ✅ 維持一致且專業的語氣
    • ✅ 使用有用且精確的形容詞
  5. 應避免的事

    • ❌ 編造規格或近似數字
    • ❌ 使用過度的行銷語言或未經證實的最高級
    • ❌ 重複相同的句子結構
    • ❌ 書寫冗長或複雜
    • ❌ 使用人為或機器人語氣
    • ❌ 避免過多形容詞,以免不必要地加重文字負擔

撰寫限制(嚴格):

  1. 長度: 長描述 500-650 字(安全目標),短描述 <60 字 teaser
  2. HTML 結構: 遵循範本結構(H1、H2、段落、列表)
  3. TruSEO 可讀性:
    • 短句(≤20 字,最多 25% 可超過)
    • 段落 2-4 句
    • 30-70% 的句子(非段落)包含轉折詞
    • 優先使用主動語態
    • 句子開頭多樣化
  4. SEO:
    • 焦點關鍵字出現在 H1、第一個段落以及至少一個 H2 中
    • SEO 標題(50-60 字元)與 Meta 描述(155-160 字元)
  5. 風格: 事實性、技術但平易近人、高級風格(Samsung/Apple)
  6. 準確性: 所有技術數據必須完全符合規格

🛠 快速驗證工具

檢查點工具/方法目標
長度wc -w 或線上計數器> 450 字
超過 20 字的句子audit_aioseo_sentences.py≤ 25%
被動語態文字分析器< 10%
每句轉折詞audit_aioseo_sentences.py30-70%
Flesch 分數Hemingway App / AIOSEO60-70

📝 最佳化結構範例

務必參考範本。

🔑 關鍵字管理

在每次生成或修訂時,必須以 HTML 註解形式在文件底部附加關鍵字列表。這可在不影響最終呈現的情況下快速驗證密度與相關性。

需新增的關鍵字結構:

  1. 焦點關鍵字: 目標主要關鍵字。
  2. LSI 關鍵字(潛在語義索引): 5 至 8 個語義相近的詞語(例如:技術規格、同義詞)。

在整合至 WordPress 時參考此列表,以填寫對應的 AIOSEO 欄位。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能