Claude Skills白皮書 202512 -AI Agent 能力擴(kuò)展完全指南_第1頁
Claude Skills白皮書 202512 -AI Agent 能力擴(kuò)展完全指南_第2頁
Claude Skills白皮書 202512 -AI Agent 能力擴(kuò)展完全指南_第3頁
Claude Skills白皮書 202512 -AI Agent 能力擴(kuò)展完全指南_第4頁
Claude Skills白皮書 202512 -AI Agent 能力擴(kuò)展完全指南_第5頁
已閱讀5頁,還剩134頁未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報或認(rèn)領(lǐng)

文檔簡介

官方文檔、社區(qū)討論、實戰(zhàn)案例的綜合梳理為「AI編程:從入門到精通」知識星球用戶創(chuàng)建2025-12-241核心概念:什么是Skills1.2通俗理解1.3技術(shù)層面的定義2為什么需要Skills2.1解決的核心問題2.2核心價值3技術(shù)架構(gòu):Skills如何工作3.1三層加載機(jī)制(ProgressiveDisclosure)3.2加載過程示例3.3文件系統(tǒng)驅(qū)動架構(gòu)3.4與傳統(tǒng)Tools的對比4Skillsvs其他方案對比4.1SkillsvsPrompts4.2SkillsvsMCP(ModelContextProtocol)4.3SkillsvsProjects(Claude.ai)4.4SkillsvsSubagents5如何創(chuàng)建和使用Skills5.1最小可行Skill(MinimalViableSkill)5.2完整Skill結(jié)構(gòu)5.3SKILL.md編寫規(guī)范5.4在不同平臺使用Skills5.5最佳實踐6真實案例分析6.1案例1:SionicAI-ML實驗知識管理6.2案例2:文檔處理Skills6.3案例3:代碼審查Skill7社區(qū)評價與討論7.1技術(shù)社區(qū)反響7.2行業(yè)媒體報道7.3Reddit社區(qū)討論(r/ClaudeAI)7.4企業(yè)采用情況7.5開發(fā)者反饋7.6與OpenAI的對比8使用場景與最佳實踐8.1典型使用場景ClaudeSkills完全指南(2025年12月)38.2最佳實踐總結(jié)9局限性與注意事項9.2安全風(fēng)險9.3性能考慮9.4使用建議10.1開放標(biāo)準(zhǔn)化(2025-12-18)10.2企業(yè)級功能10.5與其他技術(shù)的融合ClaudeSkills完全指南(2025年12月)41.核心概念:什么是Skills2.為什么需要Skills3.技術(shù)架構(gòu):Skills如何工作4.Skillsvs其他方案對比5.如何創(chuàng)建和使用Skills6.真實案例分析7.社區(qū)評價與討論8.使用場景與最佳實踐9.局限性與注意事項10.未來展望ClaudeSkills完全指南(2025年12月)5Skills是模塊化的能力包,包含指令、元數(shù)據(jù)和可選資源(腳本、模板),讓Claude在需要時自動加載和使用。想象你在給新員工做入職培訓(xùn):?傳統(tǒng)方式:每次都重復(fù)講解相同的工作流程?Skills方式:準(zhǔn)備好工作手冊,需要時自己翻閱Skills就像是給Claude準(zhǔn)備的"工作手冊庫":?平時只知道手冊目錄(低成本)?需要時才打開具體章節(jié)(按需加載)?包含詳細(xì)步驟和工具腳本(完整指導(dǎo))1.3技術(shù)層面的定義Skills是一種文件系統(tǒng)驅(qū)動的能力擴(kuò)展機(jī)制,核心特點:skill-name/SKILL.md#核心指令文件(YAMLfrontmatter+Markdown)scripts/#可執(zhí)行腳本(Python/Bash)references/#參考文檔assets/#模板和資源文件關(guān)鍵技術(shù)特性:?基于文件系統(tǒng),通過Bash命令訪問ClaudeSkills完全指南(2025年12月)6?漸進(jìn)式披露(ProgressiveDisclosure)架構(gòu)?與模型無關(guān)(Model-agnostic)ClaudeSkills完全指南(2025年12月)72.為什么需要Skills問題1:重復(fù)性工作的低效現(xiàn)狀:每次對話都要重新描述相同的工作流程用戶:"幫我按XX格式生成報告"用戶:"記得要包含XX部分"用戶:"別忘了XX細(xì)節(jié)"(每次都要重復(fù)這個過程)Skills方案:name:report-generatordescription:按照公司標(biāo)準(zhǔn)格式生成報告#報告生成流程#報告生成流程1.包含封面頁(模板見templates/cover.md)2.執(zhí)行數(shù)據(jù)分析(腳本見scripts/analyze.py)3.生成圖表和摘要3.生成圖表和摘要問題2:上下文窗口(ContextWindow)的浪費(fèi)傳統(tǒng)方式:所有指令都占用上下文?MCP服務(wù)器:單個可能消耗數(shù)萬tokens?詳細(xì)Prompt:每次對話都重新加載ClaudeSkills完全指南(2025年12月)8Skills方案:?元數(shù)據(jù)階段:僅~100tokens(只知道Skill存在)?指令階段:<5,000tokens(需要時才加載)?資源階段:幾乎無限(文件不進(jìn)入上下文)問題3:專業(yè)領(lǐng)域知識的復(fù)用困難場景:?醫(yī)療診斷流程?法律文書審查?代碼審計規(guī)范?ML實驗參數(shù)配置這些領(lǐng)域知識需要:?結(jié)構(gòu)化存儲?團(tuán)隊共享?版本管理?跨平臺使用ClaudeSkills完全指南(2025年12月)92.2核心價值全量加載(數(shù)千-數(shù)萬)ClaudeSkills完全指南(2025年12月)103.技術(shù)架構(gòu):Skills如何工作這是Skills最核心的設(shè)計理念:分階段、按需加載內(nèi)容:SKILL.md的YAMLfrontmattername:pdf-processingdescription:ExtracttextandtablesfromPDFfiles,fillforms,mergedocuments. UsewhenworkingwithPDFfilesorwhentheusermentionsPDFs.加載時機(jī):啟動時加載到系統(tǒng)提示(SystemPrompt)Token成本:~100tokens/Skill作用:讓Claude知道有哪些Skills可用,什么時候該用關(guān)鍵優(yōu)勢:可以安裝數(shù)十個Skills,幾乎沒有性能損失Level2:指令(Instructions)-觸發(fā)時加載內(nèi)容:SKILL.md的主體部分 #PDFProcessing##QuickstartUsepdfplumbertoextracttext:```pythonimportpdfplumberwithpdfplumber.open("document.pdf")aspdf: text=pdf.pages[0].extract_text()```ClaudeSkills完全指南(2025年12月)11Foradvancedformfilling,see[FORMS.md](FORMS.md).加載時機(jī):當(dāng)用戶請求匹配Skill的description時加載方式:通過bash命令讀取文件(如catpdf-skill/SKILL.md)Token成本:<5,000tokens作用:提供詳細(xì)的操作指南和最佳實踐Level3+:資源和代碼(Resources&Code)-引用時加載內(nèi)容類型:pdf-skill/├──SKILL.md#Level2├──FORMS.md#Level3-表單填寫指南├──REFERENCE.md#Level3-API參考文檔├──templates/│└──report_template.md└──scripts/├──fill_form.py#Level3-表單填充腳本└──validate.py#Level3-驗證腳本加載時機(jī):當(dāng)SKILL.md中的指令引用這些文件時加載方式:?額外文檔:catFORMS.md(進(jìn)入上下文)?可執(zhí)行腳本:pythonscripts/fill_form.py(僅輸出進(jìn)入上下文)?模板文件:按需讀取?文檔:實際文件大小?腳本:僅腳本輸出(代碼不進(jìn)入上下文)?幾乎無限制關(guān)鍵優(yōu)勢:?腳本執(zhí)行不消耗上下文(僅結(jié)果消耗)ClaudeSkills完全指南(2025年12月)12?可以包含大量參考資料(不用時不占token)3.2加載過程示例啟動階段(所有Skills)SystemPrompt包含:-"PDFProcessing-ExtracttextandtablesfromPDFs"-"ExcelAnalysis-Analyzespreadsheetdata"-...(其他所有Skills的元數(shù)據(jù))Token成本:100tokens×10Skills=1,000tokens用戶請求User:"ExtractthetextfromthisPDFandsummarizeit"Claude判斷并觸發(fā)Claude識別到需要PDF處理能力執(zhí)行:bash:catpdf-skill/SKILL.mdToken成本:+3,000tokens(SKILL.md內(nèi)容)Claude評估是否需要更多資源-不需要表單填寫→不讀取FORMS.md-需要提取表格→執(zhí)行pythonscripts/extract_tables.pyToken成本:+200tokens(腳本輸出)完成任務(wù)總Token消耗:1,000+3,000+200=4,200tokens對比傳統(tǒng)方式:?MCP方式:可能需要10,000+tokens(預(yù)先加載所有能力描述)?Prompt方式:每次都要重新輸入3,000+tokensClaudeSkills完全指南(2025年12月)133.3文件系統(tǒng)驅(qū)動架構(gòu)Skills運(yùn)行在代碼執(zhí)行環(huán)境(CodeExecutionContainer)中:┌┐ClaudeClaude(LLM)│-接收用戶請求│-決定使用哪個Skill│-生成Bash命令││││└┘↓┌─────────────────────────────────────────┐│VirtualMachine(VM)│││││││││││││││/skills/│││├──pdf-skill/│││├──excel-skill/│││└──custom-skill/│││Bash環(huán)境││-cat,ls,grep,find││-python,node,pip││↓執(zhí)行結(jié)果返回給Claude工作流程:1.Claude通過Bash命令訪問文件(如catSKILL.md)2.文件內(nèi)容進(jìn)入上下文窗口3.如果需要執(zhí)行腳本,運(yùn)行pythonscript.py4.僅腳本輸出返回(代碼本身不進(jìn)入上下文)ClaudeSkills完全指南(2025年12月)143.4與傳統(tǒng)Tools的對比示例對比:#傳統(tǒng)#傳統(tǒng)Tool方式defextract_pdf_text(file_path:str)->str:#直接執(zhí)行,返回結(jié)果#直接執(zhí)行,返回結(jié)果 returnpdfplumber.open(file_path).pages[0].extract_text() #Skills方式name:pdf-processingdescription:ExtracttextfromPDFfiles#PDFProcessingSkillWhenuserprovidesaPDF:1.Usepdfplumberlibrary2.Extracttextpagebypage3.Handleerrorsgracefully4.Forcomplexlayouts,usetabula-py[詳細(xì)步驟和腳本...]ClaudeSkills完全指南(2025年12月)15ClaudeSkills完全指南(2025年12月)164.Skillsvs其他方案對比示例:Prompt方式:User:"請按以下格式生成報告:1.封面2.摘要3.詳細(xì)分析..."(每次都要重復(fù)輸入格式要求)Skills方式:User:"生成月度報告"(Claude自動加載monthly-reportskill)這是最重要的對比,也是社區(qū)討論最多的話題。ClaudeSkills完全指南(2025年12月)17核心區(qū)別架構(gòu)定位:?MCP:連接外部系統(tǒng)的"橋梁"(What-提供什么數(shù)據(jù)/能力)?Skills:使用這些能力的"說明書"(How-如何使用)形象比喻:?MCP=給Claude配備工具箱(扳手、螺絲刀、鋸子)?Skills=教Claude如何使用這些工具(安裝步驟、注意事項)詳細(xì)對比表需要運(yùn)行服務(wù)器、配置JSON客戶端-服務(wù)器協(xié)議使用場景對比應(yīng)該用MCP的場景:?連接企業(yè)數(shù)據(jù)庫(客戶信息、訂單數(shù)據(jù))ClaudeSkills完全指南(2025年12月)18?實時API調(diào)用(天氣查詢、股票價格)?跨系統(tǒng)操作(Jira、Notion、GitHub)?需要中心化治理的企業(yè)集成應(yīng)該用Skills的場景:?標(biāo)準(zhǔn)化工作流程(代碼審查清單、文檔模板)?團(tuán)隊規(guī)范和最佳實踐?重復(fù)性任務(wù)自動化(報告生成、數(shù)據(jù)分析)?領(lǐng)域?qū)I(yè)知識(醫(yī)療診斷流程、法律審查)互補(bǔ)關(guān)系(最佳實踐)Skills和MCP不是競爭關(guān)系,而是互補(bǔ)關(guān)系:場景:生成銷售報告MCP提供數(shù)據(jù)連接-連接Salesforce(客戶數(shù)據(jù))-連接PostgreSQL(銷售記錄)-連接GoogleSheets(目標(biāo)數(shù)據(jù))Skills提供工作流程-數(shù)據(jù)提取順序-計算邏輯(增長率、完成率)-報告格式和模板-異常處理規(guī)則結(jié)果:-MCP解決"能訪問什么數(shù)據(jù)"-Skills解決"如何使用這些數(shù)據(jù)生成報告"生命周期互補(bǔ):ClaudeSkills完全指南(2025年12月)19項目初期:用Skills快速搭建工作流↓發(fā)現(xiàn)需要實時數(shù)據(jù):添加MCP集成↓數(shù)據(jù)量增大:優(yōu)化MCP性能↓工作流復(fù)雜:擴(kuò)展Skills指令"Skills可能比MCP更重要。MCP存在token消耗過度的問題,而Skills優(yōu)雅地避免了這一點。"1.簡潔即優(yōu)勢:Skills利用LLM的核心能力(理解文本),而不是復(fù)雜的協(xié)議2.Token效率:MCP的GitHub服務(wù)器單獨(dú)就消耗"數(shù)萬tokens",Skills僅需數(shù)百3.生態(tài)爆發(fā):預(yù)測Skills將比MCP帶來"更壯觀的寒武紀(jì)大爆發(fā)"使用建議:?Projects存放項目背景、產(chǎn)品文檔、設(shè)計規(guī)范ClaudeSkills完全指南(2025年12月)20?Skills存放可復(fù)用的工作流程和自動化腳本組合使用:場景:代碼審查工作流Subagent:執(zhí)行完整的代碼審查流程↓加載Skills:code-review-checklist↓使用Skills中的規(guī)范和腳本↓返回審查報告ClaudeSkills完全指南(2025年12月)215.如何創(chuàng)建和使用Skills最簡結(jié)構(gòu):name:hello-skilldescription:Asimpleskillthatgreetsusers#HelloSkillWhenusersayshello,respondwithafriendlygreeting.字段要求:namename descriptionClaudeSkills完全指南(2025年12月)22my-skill/├──SKILL.md#主文件(必需)├──scripts/#可執(zhí)行腳本(可選)│├──process.py│└──validate.sh├──references/#參考文檔(可選)│├──API_DOCS.md│└──EXAMPLES.md├──templates/#模板文件(可選)│└──output_template.md└──assets/#其他資源(可選)└──schema.json5.3SKILL.md編寫規(guī)范基礎(chǔ)模板name:my-custom-skilldescription:Briefdescriptionofwhatthisskilldoesandwhentouseit.IncludeIncludetriggerkeywordsandscenarios.#SkillName##OverviewBriefexplanationoftheskill'spurpose.##WhentoUse-Scenario1-Scenario2-Scenario3##InstructionsClaudeSkills完全指南(2025年12月)23###Step1:InitialSetupDetailedinstructions...###Step2:ProcessingCodeexamples:#Examplescriptdefprocess_data(input_data): returnprocessed_dataUsetemplate:output_template.md````````````ClaudeSkills完全指南(2025年12月)24?scripts/process.py-Mainprocessingscript?scripts/validate.sh-Validationscript?MoreExamplesCommonissuesandsolutions...####Description編寫技巧**核心原則**:既要說明"做什么",也要說明"什么時候用"**不好的description**:```yamldescription:ProcessPDFfiles description:ExtracttextandtablesfromPDFfiles,fillforms,mergedocuments. UsewhenworkingwithPDFfilesorwhentheusermentionsPDFs,forms,forms,ordocumentextraction.建議包含:1.核心功能(Extracttextandtables)2.次要功能(fillforms,merge)ClaudeSkills完全指南(2025年12月)253.觸發(fā)關(guān)鍵詞(PDF,forms,documentextraction)4.使用場景(whenworkingwith...)5.4在不同平臺使用Skills importanthropicclient=anthropic.Anthropic()response=client.messages.create( model="claude-sonnet-4-5-20250929",maxmax_tokens=1024, betas=["code-execution-2025-08-25","skills-2025-10-02"],toolstools=[""type":"code_execution_2025_08_25","container""container":{"skill_id""skill_id":"pptx"#使用PowerPointskill],],messagesmessages=["role""role":"user","content""content":"CreateapresentationaboutAItrends")可用的預(yù)置Skills:?pptx-PowerPoint演示文稿?xlsx-Excel表格?docx-Word文檔ClaudeSkills完全指南(2025年12月)26?pdf-PDF文檔2.上傳自定義Skills#上傳#上傳Skillskill=client.skills.create( name="my-custom-skill", description="Customskillformyworkflow",filesfiles=[ {"name":"SKILL.md","content":skill_md_content}, {"name":"scripts/process.py","content":script_content})#使用自定義#使用自定義Skillresponse=client.messages.create( model="claude-sonnet-4-5-20250929",maxmax_tokens=1024, betas=["code-execution-2025-08-25","skills-2025-10-02"],toolstools=[""type":"code_execution_2025_08_25","container""container":{""skill_id":skill.id#使用自定義skill],], messages=[{"role":"user","content":"Executemyworkflow"}])#在用戶主目錄創(chuàng)建#在用戶主目錄創(chuàng)建mkdir-p~/.claude/skills/my-skillcd~/.claude/skills/my-skill#創(chuàng)建SKILL.mdClaudeSkills完全指南(2025年12月)27cat>SKILL.md<<'EOF'name:my-skilldescription:Mypersonalworkflowskill#MySkill [Instructionshere...]EOFEOF2.創(chuàng)建項目級Skill#在項目目錄創(chuàng)建#在項目目錄創(chuàng)建cd/path/to/projectmkdir-p.claude/skills/project-skill#...創(chuàng)建SKILL.md3.通過插件市場安裝#在#在ClaudeCode中/pluginmarketplaceaddanthropics/skills/plugininstalldocument-skills@anthropic-agent-skillsC.Claude.ai?已經(jīng)內(nèi)置,無需配置?創(chuàng)建文檔時自動使用2.上傳自定義Skills2.上傳Skillzip文件3.需要Pro/Max/Team/Enterprise計劃限制:?僅個人可用(不共享給團(tuán)隊)?管理員無法集中管理ClaudeSkills完全指南(2025年12月)28配置文件:.claude/config.json { "allowed_tools":["Skill","Bash","Read","Write"], "skills_directory":".claude/skills/"}創(chuàng)建Skill: mkdir-p.claude/skills/my-skill#創(chuàng)建SKILL.mdSDK會自動發(fā)現(xiàn)并加載Skills。5.5最佳實踐目標(biāo):幫助LLM準(zhǔn)確匹配用戶意圖##太簡短description:Codereview##太泛化description:Reviewcodeforqualityandbugs##清晰具體description:| Reviewcodeforsecurityvulnerabilities,performanceissues,andstylecompliance. Usewhenuseraskstoreviewcode,checkforbugs,orvalidatesecurity. Includesscriptsforlinting,securityscanning,andcomplexityanalysis.包含要素:?核心功能?觸發(fā)場景?關(guān)鍵詞?可用工具ClaudeSkills完全指南(2025年12月)292.漸進(jìn)式披露(ProgressiveDisclosure)原則:只在需要時才引用詳細(xì)文檔 #SKILL.md-保持簡潔##QuickStartBasicinstructionsforcommoncases...##AdvancedUsageForcomplexscenarios,see[ADVANCED.md](references/ADVANCED.md)##APIReferenceFullAPIdocs:[API_DOCS.md](references/API_DOCS.md)效果:?基礎(chǔ)任務(wù):僅加載SKILL.md(<2,000tokens)?復(fù)雜任務(wù):額外加載ADVANCED.md(+3,000tokens)?查找API:臨時加載API_DOCS.md(+5,000tokens)3.腳本優(yōu)先于生成代碼為什么:?腳本代碼不進(jìn)入上下文(僅輸出消耗token)?確定性強(qiáng)(預(yù)先測試過)?可復(fù)用性高##讓Claude每次生成代碼##DataProcessingUsepandastoprocesstheCSVfileandgeneratestatistics.##提供預(yù)置腳本##DataProcessingRuntheanalysisscript:\```bashpythonscripts/analyze_data.pyinput.csv--outputreport.jsonClaudeSkills完全指南(2025年12月)30Thescriptwill:?Loadandvalidatedata?Calculatekeymetrics?Generatevisualization####4.模塊化設(shè)計####4.模塊化設(shè)計**單一職責(zé)**:-一個Skill做所有事情-多個Skills各司其職skills/├──code-review/#代碼審查├──test-generation/#測試生成├──documentation/#文檔生成└──deployment/#部署流程**組合使用**:User:"審查代碼并生成測試"Claude:1.觸發(fā)code-reviewskill2.觸發(fā)test-generationskill3.組合兩者完成任務(wù)ClaudeSkills完全指南(2025年12月)31####5.路徑可移植性**使用變量而非絕對路徑**:```markdown#不可移植Run:python/Users/john/.claude/skills/my-skill/scripts/process.pyRun:python{baseDir}/scripts/process.py6.安全性考慮只使用可信來源的Skills:?自己創(chuàng)建的?Anthropic官方的?經(jīng)過審計的企業(yè)內(nèi)部Skills?未知來源的第三方Skills審計清單:口?檢查所有腳本代碼口?查看網(wǎng)絡(luò)請求(是否連接外部URL)?口?驗證文件訪問模式口?檢查是否有權(quán)限提升口?確認(rèn)沒有惡意代碼ClaudeSkills完全指南(2025年12月)326.真實案例分析背景:?團(tuán)隊規(guī)模:ML研究團(tuán)隊?問題:研究人員重復(fù)相同的實驗,浪費(fèi)大量時間?數(shù)據(jù)量:每天1,000+個模型訓(xùn)練實驗核心痛點:場景:調(diào)試ColBERT參數(shù)第一周:Sigrid花了3天測試50+種參數(shù)組合發(fā)現(xiàn):4,000字符塊大小讓FDE優(yōu)于MaxSim問題:這個知識存在Slack線程里,90%的人沒看到第三周:另一個研究員又花了3天測試相同的東西解決方案:兩個命令的知識管理系統(tǒng)命令1:/advise-實驗前咨詢#研究員開始新實驗前#研究員開始新實驗前User:/adviseTrainingtransformerforadditionwith0.5M-4MparameterbudgetClaudeClaude搜索Skills倉庫: ├──找到:colbert-parameter-searchskill ├──讀取:skills/training/colbert/SKILL.md└──提取關(guān)鍵發(fā)現(xiàn)ClaudeClaude返回: -ksim=4worksbecause"16bucketsfittokendistribution"ClaudeSkills完全指南(2025年12月)33 -d_proj=32causesinformationloss(avoid) -R_reps=16isoptimalwithmemorytradeoffs 來自:Sigrid的ColBERT參數(shù)搜索(2025-12-08)效果:?跳過已知的失敗配置?直接獲得最優(yōu)參數(shù)?避免重復(fù)勞動命令2:/retrospective-實驗后沉淀#實驗完成后#實驗完成后User:/retrospectiveClaudeClaude自動執(zhí)行:1.讀取整個對話歷史1.讀取整個對話歷史 2.提取核心洞察、失敗嘗試、成功參數(shù)3.生成結(jié)構(gòu)化3.生成結(jié)構(gòu)化Skill文件4.創(chuàng)建4.創(chuàng)建GitHubPR生成的生成的Skill示例: #skills/training/grpo-external-vllm-server/SKILL.mdname:grpo-external-vllm-serverdescription:| GRPOtrainingwithexternalvLLMserverusingms-swift. Usewhen:(1)GRPOtrainingwithvLLMonseparateGPU(2)(2)Encounteringvllm_skip_weight_syncerrors(3)(3)OpenAIAPIresponseparsingerrors Verifiedon:gemma-3-12b-itauthor:HojinYangdate:2025-12-08##FailedAttempts(VeryImportant!)ClaudeSkills完全指南(2025年12月)34 |Attempt|WhyitFailed|Lesson||||||Without`vllm_skip_weight_sync`|404`/update_flattened_params/`error|Mandatoryflagw|vLLMwithout`--served-model-name`|404Model'default'notfound|ms-swiftexpectsmo##WorkingConfiguration(Copy-PasteReady)```bash#StartvLLMservervllmservegemma-3-12b-it\ --served-model-namedefault\port8000#Trainingcommandswiftrlhf\--rlhf_type--rlhf_typegrpo\--use_vllm--use_vllmtrue\ --vllm_skip_weight_synctrue\ --model_id_or_pathgemma-3-12b-it?vllm_skip_weight_syncpreventsweightsyncerrors?--served-model-namedefaultmatchesms-swiftexpectations?ExternalvLLMallowsseparateGPUallocationClaudeSkills完全指南(2025年12月)35**關(guān)鍵設(shè)計**:-失敗案例優(yōu)先(避免踩坑)-可復(fù)制的配置(Copy-PasteReady)-上下文說明(為什么這樣配置)**實際效果**:||||||知識沉淀耗時|30分鐘(手動)|30秒(自動)|60倍|**為什么成功**:1.**摩擦力極低**:一條命令(`/retrospective`)vs寫文檔2.**即時價值**:下次實驗立即受益3.**失敗驅(qū)動**:被坑過的人最積極使用Anthropic<h3id="6-2-案例2:文檔處理-skills(anthropic-官方)">6.2案例2:文檔處理Skills(Anthropic**可用Skills**:-`pptx`-PowerPoint生成-`xlsx`-Excel分析-`docx`-Word文檔-`pdf`-PDF處理**使用場景**:```python#場景1:生成演示文稿response=client.messages.create(model="claude-sonnet-4-5-20250929",tools=[{"type":"code_execution_2025_08_25","container":{"skill_id":"pptx"}}],messages=[{"role":"user","content":"Createa10-slidepresentationaboutAItrendsin2025")#場景2:分析Excel數(shù)據(jù)ClaudeSkills完全指南(2025年12月)36responseresponse=client.messages.create(tools=[{"type":"code_execution_2025_08_25","container":{"skill_id":"xlsx"}}],messages=[{"role":"user","content":"Analyzethissalesdataandcreateapivottable")Skills做了什么:2.提供模板和最佳實踐3.處理常見錯誤4.生成專業(yè)格式的輸出用戶體驗:#無SkillsUser:"生成PPT"Claude:"我需要更多信息:主題?風(fēng)格?布局?..."User:"關(guān)于AI趨勢,專業(yè)風(fēng)格,標(biāo)題頁+內(nèi)容頁"Claude:[生成代碼]→可能報錯→調(diào)試→修復(fù)#有SkillsUser:"生成AI趨勢的PPT"Claude:[自動使用pptxskill]→直接生成專業(yè)PPT6.3案例3:代碼審查SkillSkill結(jié)構(gòu):ClaudeSkills完全指南(2025年12月)37code-review-skill/_code-review-skill/_├──lint.py├──lint.py├──security_scan.py└──complexity.py──SKILL.md──scripts/──references/├──SECURITY_RULES.md└──STYLE_GUIDE.md──templates/└──reviewreport.md##審查流程#代碼風(fēng)格檢查#安全掃描#復(fù)雜度分析#安全規(guī)則詳解#代碼風(fēng)格指南#審查報告模板SKILL.md內(nèi)容:name:code-reviewdescription:| Comprehensivecodereviewforsecurity,performance,andstyle. Usewhenuseraskstoreviewcode,checkforvulnerabilities, orvalidatebestpractices.SupportsPython,JavaScript,TypeScript.#CodeReviewSkill##QuickReviewProcess1.1.**SecurityScan**(Critical)``````bash pythonscripts/security_scan.py{code_file} pythonscripts/lint.py{code_file}--strict pythonscripts/complexity.py{code_file}ClaudeSkills完全指南(2025年12月)38口SQLinjectionvulnerabilitiesXSSattackvectors口Authenticationbypass口SensitivedataexposureFordetailedsecurityrules:SECURITY_RULES.md口?口?Unnecessarydatabasequeries口口Forfullstyleguide:STYLE_GUIDE.mdClaudeSkills完全指南(2025年12月)39Usetemplate:review_report.md**使用效果**:用戶請求User:"審查這段代碼"[上傳auth.py]1.觸發(fā)code-reviewskill2.運(yùn)行security_scan.py→發(fā)現(xiàn)SQL注入風(fēng)險3.運(yùn)行l(wèi)int.py→發(fā)現(xiàn)5處風(fēng)格問題5.參考SECURITY_RULES.md給出修復(fù)建議6.生成結(jié)構(gòu)化報告輸出CriticalIssues(1):Fix:UseparameterizedqueriesStyleIssues(5):?Inconsistentnaming:getUserDatavsget_user_dataClaudeSkills完全指南(2025年12月)40...ClaudeSkills完全指南(2025年12月)41**Token效率**:-基礎(chǔ)審查:~3,000tokens(SKILL.md+腳本輸出)-詳細(xì)審查:+5,000tokens(加載SECURITY_RULES.md)-vs.傳統(tǒng)方式:~15,000tokens(每次重新描述所有規(guī)則)<divclass="chapter-break"></div><h2id="7-社區(qū)評價與討論">7.社區(qū)評價與討論</h2><h3id="7-1-技術(shù)社區(qū)反響">7.1技術(shù)社區(qū)反響</h3>####SimonWillison(業(yè)界權(quán)威AI技術(shù)博主)**核心觀點**:"Skills可能比MCP更重要"**關(guān)鍵論據(jù)**:1.**簡潔即優(yōu)勢**>"Skills的理念極其簡單:一個Markdown文件加上可選的腳本和資源。關(guān)鍵創(chuàng)新在于token效率。"2.**MCP的Token問題**>"GitHub官方MCP服務(wù)器單獨(dú)就消耗數(shù)萬個tokens。Skills通過讓LLM自行探索工具避免了這一問題。"3.**生態(tài)預(yù)測**>"我預(yù)測Skills將帶來比去年MCP熱潮更壯觀的寒武紀(jì)大爆發(fā)。"4.**模型無關(guān)性**>"Skills不依賴Anthropic專有技術(shù),可用于CodexCLI、GeminiCLI等任何提供代碼執(zhí)行的LLM工具**文章鏈接**:[ClaudeSkillsareawesome,maybeabiggerdealthanMCP](https://simonwillis####LeeHanchung(深度技術(shù)分析)**架構(gòu)洞察**:1.**Skills不是工具,是元工具**>"Skills通過promptinjection修改對話上下文,而非直接執(zhí)行代碼。"2.**雙消息機(jī)制**ClaudeSkills完全指南(2025年12月)42消息1(isMeta:false):用戶可見的狀態(tài)指示消息2(isMeta:true):發(fā)送給API的詳細(xì)指令3.**動態(tài)權(quán)限管理**>"Skills通過contextModifier預(yù)先批準(zhǔn)特定工具,無需每次用戶確認(rèn)。"**文章鏈接**:[ClaudeAgentSkills:AFirstPrinciplesDeepDive](https://leehanchung.githu<h3id="7-2-行業(yè)媒體報道">7.2行業(yè)媒體報道</h3>####VentureBeat(2025-12-18)**標(biāo)題**:"Anthropic推出企業(yè)級AgentSkills并開放標(biāo)準(zhǔn)"**關(guān)鍵信息**:-與Atlassian、Canva、Cloudflare、Figma、Notion、Ramp、Sentry等企業(yè)合作-發(fā)布Skills目錄(Directory)-OpenAI已悄然在ChatGPT和CodexCLI中采用相同架構(gòu)####SiliconANGLE(2025-12-18)**標(biāo)題**:"Anthropic將AgentSkills變?yōu)殚_放標(biāo)準(zhǔn)"**核心觀點**:>"這是Anthropic繼MCP后的又一次標(biāo)準(zhǔn)化嘗試,旨在像MCP成為事實標(biāo)準(zhǔn)一樣,讓Skills成為AIagent能####TheNewStack(2025-12-18)**標(biāo)題**:"AgentSkills:Anthropic定義AI標(biāo)準(zhǔn)的下一次嘗試"**分析角度**:-與MCP的關(guān)系(互補(bǔ)而非競爭)-開放標(biāo)準(zhǔn)的戰(zhàn)略意義-對AI生態(tài)的影響<h3id="7-3-reddit-社區(qū)討論(r/claudeai)">7.3Reddit社區(qū)討論(r/ClaudeAI)</h3>**熱門話題**:1.**"Skills比MCP簡單太多了"**ClaudeSkills完全指南(2025年12月)43User1:"終于不用配置服務(wù)器了,寫個Markdown就能用"User2:"我把之前的MCP服務(wù)器改成Skills,token消耗降低了80%"User3:"但Skills不能訪問實時數(shù)據(jù),還是得用MCP"2.**"Skills+MCP=完美組合"**User1:"我用MCP連接數(shù)據(jù)庫,用Skills定義查詢流程,完美!"User2:"對,MCP是數(shù)據(jù)源,Skills是使用手冊"3.**"Skills的安全性擔(dān)憂"**User1:"Skills可以執(zhí)行任意代碼,怎么保證安全?"User2:"只用官方和自己寫的Skills,審查代碼"User3:"Claude.ai有沙箱,API需要自己防護(hù)"ClaudeSkills完全指南(2025年12月)44<h3id="7-4-企業(yè)采用情況">7.4企業(yè)采用情況</h3>**已集成Skills的企業(yè)**(2025-12-18公布):|企業(yè)|用途|Skills類型||||||**Atlassian**|Jira工作流自動化|項目管理Skills||**Canva**|設(shè)計模板生成|創(chuàng)意設(shè)計Skills||**Cloudflare**|安全配置審查|DevOpsSkills||**Figma**|設(shè)計系統(tǒng)規(guī)范|UI/UXSkills||**Notion**|文檔模板和工作流|知識管理Skills||**Ramp**|財務(wù)報告生成|企業(yè)財務(wù)Skills||**Sentry**|錯誤分析流程|調(diào)試Skills|<h3id="7-5-開發(fā)者反饋">7.5開發(fā)者反饋</h3>**GitHubanthropics/skills倉庫統(tǒng)計**(2025-12-24):-50+Issues-58+PullRequests**常見評價**:**正面反饋**:-"比預(yù)期簡單太多"-"終于可以復(fù)用工作流了"-"Token效率驚人"-"跨平臺支持很好"**改進(jìn)建議**:-"希望支持Skill版本管理"-"需要更好的調(diào)試工具"-"希望有Skill測試框架"-"文檔還可以更詳細(xì)"**批評意見**:-"Claude.ai的Skills不能團(tuán)隊共享"-"API的網(wǎng)絡(luò)限制太嚴(yán)格"-"缺少Skillmarketplace"<h3id="7-6-與-openai-的對比">7.6與OpenAI的對比</h3>ClaudeSkills完全指南(2025年12月)45**重要發(fā)現(xiàn)**(2025-12EliasJudin>"OpenAI已經(jīng)在ChatGPT和CodexCLI中采用了與Skills結(jié)構(gòu)相同的架構(gòu),包含類似的Skill文件和YAM**含義**:-Skills可能成為事實標(biāo)準(zhǔn)(類似MCP)-跨模型、跨平臺復(fù)用成為可能-生態(tài)系統(tǒng)快速擴(kuò)展<divclass="chapter-break"></div><h2id="8-使用場景與最佳實踐">8.使用場景與最佳實踐</h2><h3id="8-1-典型使用場景">8.1典型使用場景</h3>####場景1:企業(yè)標(biāo)準(zhǔn)化工作流**適用情況**:-有明確的工作流程規(guī)范-需要團(tuán)隊統(tǒng)一標(biāo)準(zhǔn)-重復(fù)性高的任務(wù)**示例Skills**:```markdown#客戶支持工單處理Skillname:customer-ticket-handlerdescription:|Standardworkflowforhandlingcustomersupporttickets.Usewhenprocessingcustomercomplaints,featurerequests,orbugreports.##TicketClassification1.Determinetickettype:-BugReport→RoutetoEngineering-FeatureRequest→RoutetoProduct-BillingIssue→RoutetoFinance-GeneralQuestion→HandledirectlyClaudeSkills完全指南(2025年12月)462.2.PriorityAssignment:-P0(Critical):Systemdown,dataloss-P1(High):Majorfeatureb

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論