技能 technical-clarity
📦

technical-clarity

內容修訂 r1 安全

提升技術寫作清晰度

技術內容對專家來說可能很清楚，卻讓學習者感到困惑。此技能會檢視草稿是否符合受眾需求、是否有過多術語、缺少脈絡、無障礙問題，以及實用的修訂步驟。

支援: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 銅級

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求
Review the Skillstore skill "technical-clarity" from https://skillstore.io/skills/92bilal26-technical-clarity.md and its manifest at https://skillstore.io/api/skills/92bilal26-technical-clarity/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/92bilal26-technical-clarity.md 已簽名 manifest GET /api/skills/92bilal26-technical-clarity/manifest 已簽名 lockfile GET /api/skills/92bilal26-technical-clarity/lockfile

測試它

正在使用「technical-clarity」。 一段文字聲稱某個概念很明顯，並使用多個未定義術語。

預期結果:

  • 標示可能讓學習者感到被排除在外的排他性語言。
  • 列出未定義術語，並建議首次使用時的定義。
  • 建議更清楚的開頭，說明該概念為何重要。

正在使用「technical-clarity」。 一個教學段落先從抽象理論開始，之後才展示範例。

預期結果:

  • 將先抽象後說明的結構辨識為理解風險。
  • 建議先放置具體範例，再進行解釋。
  • 為目標學習者加入先備知識與動機說明。

正在使用「technical-clarity」。 依賴色彩與螢幕截圖來解釋錯誤的文件。

預期結果:

  • 將僅靠視覺傳達的方式標示為無障礙問題。
  • 建議加入文字標籤、說明文字與替代文字。
  • 建議適合螢幕閱讀器使用者的措辭。

安全審計

安全
v5 • 2026/7/20 開啟版本化報告

All 39 static detections are false positives. The external-command detections match Markdown code fences and inline-code examples, while the reconnaissance detections match ordinary educational prose. No executable commands, data collection, network activity, prompt injection, or malicious intent was found in SKILL.md.

1
已掃描檔案
497
分析行數
0
複核項目
0
已忽略的誤報
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: claude 檢視審計紀錄 →
分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/92bilal26-technical-clarity/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/92bilal26-technical-clarity/security.svg)](https://skillstore.io/skills/92bilal26-technical-clarity?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/92bilal26-technical-clarity?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/92bilal26-technical-clarity/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/92bilal26-technical-clarity.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
學術引用 (APA · BibTeX · CFF)

APA 引用

92Bilal26. (2026). technical-clarity security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/92bilal26-technical-clarity/audits/5

BibTeX 引用

@techreport{92bilal26-92bilal26-technical-clarity-2026, author = {92Bilal26}, title = {technical-clarity security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/92bilal26-technical-clarity/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "technical-clarity security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "92Bilal26" date-released: "2026-07-20" url: "https://skillstore.io/skills/92bilal26-technical-clarity/audits/5" identifiers: - type: other value: "skillstore:92bilal26-technical-clarity:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據 證據置信度: 高
55
架構
85
可維護性
87
內容
70
社群
83
規範符合度

你可以打造什麼

審查初學者教學

檢查教學是否說明先備知識、定義術語，並避免專家假設。

準備 API 文件

改善參考文字，讓讀者理解目的、限制、範例與錯誤情境。

稽核課程教材

評估課程的閱讀程度、術語密度、無障礙性與學習者信心。

試試這些提示

快速清晰度檢查 
Review this technical explanation for clarity. Identify confusing phrases, undefined terms, and missing context. Target audience: beginner. Draft: [paste text].
受眾程度審查 
Audit this content for a B1 intermediate learner. Check sentence length, jargon density, prerequisites, examples, and accessibility. Provide prioritized fixes. Content: [paste text].
教學修訂計畫 
Review this tutorial and create a revision plan. Focus on show-before-tell structure, definitions, motivation, error cases, and learner confidence. Tutorial: [paste text].
完整文件稽核 
Perform a full technical clarity audit for this documentation. Include audience assumptions, readability risks, accessibility issues, issue severity, impact, and rewritten examples where useful. Documentation: [paste text].

最佳實務

  • 提供目標受眾、學習脈絡與預期的先備知識。
  • 要求提供問題嚴重程度、學習者影響與具體改寫建議。
  • 套用主要清晰度修改後，再次審查修訂後的文字。

避免

  • 當你需要的是學習者理解度分析時，不要只要求一般校對。
  • 不要省略目標熟練程度或預期讀者背景。
  • 不要在未檢查範例、脈絡與無障礙性的情況下接受可讀性分數。

常見問題

此技能可以審查哪些內容？
它可以審查技術文件、教學、課程單元、API 指南、範例與教育性解釋。
它會改寫文件嗎？
它可以建議改寫與更清楚的範例，但主要用途是結構化清晰度稽核。
它可以檢查無障礙性嗎？
可以。它會檢查僅靠視覺的提示、缺少替代文字、程式碼可讀性與不清楚的結構。
它會驗證程式碼正確性嗎？
不會。它專注於理解度與無障礙性，而不是執行時行為或技術驗證。
我的提示中應該包含哪些內容？
請包含草稿、目標受眾、熟練程度、內容類型，以及任何已知的先備知識。
Claude、Codex 和 Claude Code 可以使用它嗎？
可以。報告列出對 Claude、Codex 和 Claude Code 的支援。

開發者詳細資訊

作者

92Bilal26

授權

MIT

Skillstore 修訂

r1

版本提示

作者未聲明版本。

儲存庫

https://github.com/92Bilal26/TaskPilotAI/tree/main/.claude/skills/technical-clarity

引用

820ccb93d2e2fe828678ed05433bafd1054e5000

維護新鮮度

2026/7/21

使用量

13 次下載 · 194 次瀏覽

檔案結構

📄 SKILL.md

92Bilal26 的更多技能

查看全部

相關技能

查看全部