{"id":"762a0a0d-3595-49de-8808-3c7b8caa6ae6","entityType":"agent","slug":"clawhub-moroiser-skill-manager-all-in-one","name":"Skill Manager All In One | 一站式技能管理器","canonicalUrl":"https://www.xpersona.co/agent/clawhub-moroiser-skill-manager-all-in-one","canonicalPath":"/agent/clawhub-moroiser-skill-manager-all-in-one","generatedAt":"2026-10-09T20:53:34.522Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":null},"description":"Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。 Skill: Skill Manager All In One | 一站式技能管理器 Owner: moroiser Summary: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。 Tags: latest:4.5.14 Version history: v4.5.14 | 2026-05-09T09:45:37.817Z | user 1. Simplify SKILL.md frontmatter: remove verbose metadata JSON, add license field. 精简 frontmatter，删除冗长 metadata JSON，改用 license 字段。2. Simplify Runtime Expectations: remove verbose table-based declarati","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s1708w2t7w31qf7b0gsy7kamnx83gqa6:skill-manager-all-in-one","sourceUrl":"https://clawhub.ai/moroiser/skill-manager-all-in-one","homepage":"https://clawhub.ai/moroiser/skills/skill-manager-all-in-one","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/moroiser/skill-manager-all-in-one","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/moroiser/skills/skill-manager-all-in-one","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。 Skill: Skill Manager All In One | 一站式技能管理器 Owner: moroiser Summary: Manage OpenClaw skil"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":null},"stars":null,"forks":null,"downloads":2471,"packageName":null,"latestVersion":"4.5.14","tractionLabel":"2.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T14:34:55.493Z","lastCrawledAt":"2026-10-09T14:34:55.493Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T14:34:55.493Z","lastVerifiedAt":null,"highlights":[{"version":"4.5.14","createdAt":"2026-05-09T09:45:37.817Z","changelog":"1. Simplify SKILL.md frontmatter: remove verbose metadata JSON, add license field. 精简 frontmatter，删除冗长 metadata JSON，改用 license 字段。2. Simplify Runtime Expectations: remove verbose table-based declaration, replace with 3-line concise version. 精简 Runtime Expectations 部分，删除冗余表格，改为3行简洁说明。3. Phase 1 Step 2: add explicit reference to skill-creator. Phase 1 步骤 2 明确引用 skill-creator。4. Merge Phase 1 steps 2+3 into Step 2. 合并原步骤2和步骤3。5. Restore reference files to original complete content. 恢复被精简过度的 reference 文件至原始完整内容。6. Add inspect commands to clawhub-publish.md. 将 inspect 命令移入 clawhub-publish.md。7. Merge rename-workflow into Phase 1 Step 4. 将 rename-workflow 合并为渠道核查。8. Report Template shows platform-specific checklist. Report Template 根据目标平台选择性展示核对清单。","fileCount":8,"zipByteSize":27502},{"version":"4.5.13","createdAt":"2026-05-07T16:08:59.963Z","changelog":"1. Fix markdown strikethrough in range expressions (CH01-CH11, G01-G06). 修复范围表达式中的 markdown 删除线问题。2. Replace hardcoded Morois with variable in signatures. 将签名中的硬编码 Morois 替换为 变量。3. Add CH04 rule and management command legitimacy note. 新增 CH04 规则和管理命令合法性说明。","fileCount":9,"zipByteSize":33960},{"version":"4.5.12","createdAt":"2026-05-07T16:02:58.395Z","changelog":"1. Add CH04 rule: changelog must not reference security scan results or scanner names. 新增 CH04 规则：changelog 禁止提及安全扫描结果或扫描器名称。2. Replace hardcoded Morois with variable in signatures. 将签名中的硬编码 Morois 替换为 变量。3. Add legitimacy note for management commands with consent safeguards. 为管理命令添加合法性说明，强调用户同意和二次验证。","fileCount":9,"zipByteSize":33960},{"version":"4.5.11","createdAt":"2026-05-07T15:54:14.028Z","changelog":"1. Replace hardcoded Morois with variable. 将硬编码的 Morois 替换为 变量。2. Add legitimacy note for delete/hide management commands with consent safeguards. 为删除/隐藏管理命令添加合法性说明，强调用户同意和二次验证。","fileCount":9,"zipByteSize":33708},{"version":"4.5.10","createdAt":"2026-05-07T15:44:58.614Z","changelog":"1. Exact 4.5.3 content downloaded and re-uploaded without any changes. 下载 4.5.3 原始内容并原封不动重新上传。","fileCount":9,"zipByteSize":33395},{"version":"4.5.9","createdAt":"2026-05-07T15:40:25.365Z","changelog":"1. Exact revert to 4.5.3 content, no modifications. 完全回退到 4.5.3 原始内容，无任何修改。","fileCount":9,"zipByteSize":33394},{"version":"4.5.8","createdAt":"2026-05-07T15:36:06.249Z","changelog":"1. Revert to exact 4.5.3 content for ClawScan baseline test. 回退到 4.5.3 完全相同内容，测试 ClawScan 基线。","fileCount":9,"zipByteSize":33624},{"version":"4.5.7","createdAt":"2026-05-07T15:31:12.494Z","changelog":"1. Revert to 4.5.3 base with minimal changes: replace hardcoded Morois with variable only. 回退到 4.5.3 基础版本，仅将硬编码的 Morois 替换为 变量。2. Fix ClawScan SUSPICIOUS false positive. 修复 ClawScan SUSPICIOUS 误报。","fileCount":9,"zipByteSize":33583}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1708w2t7w31qf7b0gsy7kamnx83gqa6:skill-manager-all-in-one","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T20:53:34.517Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-moroiser-skill-manager-all-in-one/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":null},"readme":"Skill: Skill Manager All In One | 一站式技能管理器\n\nOwner: moroiser\n\nSummary: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。\n\nTags: latest:4.5.14\n\nVersion history:\n\nv4.5.14 | 2026-05-09T09:45:37.817Z | user\n\n1. Simplify SKILL.md frontmatter: remove verbose metadata JSON, add license field. 精简 frontmatter，删除冗长 metadata JSON，改用 license 字段。2. Simplify Runtime Expectations: remove verbose table-based declaration, replace with 3-line concise version. 精简 Runtime Expectations 部分，删除冗余表格，改为3行简洁说明。3. Phase 1 Step 2: add explicit reference to skill-creator. Phase 1 步骤 2 明确引用 skill-creator。4. Merge Phase 1 steps 2+3 into Step 2. 合并原步骤2和步骤3。5. Restore reference files to original complete content. 恢复被精简过度的 reference 文件至原始完整内容。6. Add inspect commands to clawhub-publish.md. 将 inspect 命令移入 clawhub-publish.md。7. Merge rename-workflow into Phase 1 Step 4. 将 rename-workflow 合并为渠道核查。8. Report Template shows platform-specific checklist. Report Template 根据目标平台选择性展示核对清单。\n\nv4.5.13 | 2026-05-07T16:08:59.963Z | user\n\n1. Fix markdown strikethrough in range expressions (CH01-CH11, G01-G06). 修复范围表达式中的 markdown 删除线问题。2. Replace hardcoded Morois with variable in signatures. 将签名中的硬编码 Morois 替换为 变量。3. Add CH04 rule and management command legitimacy note. 新增 CH04 规则和管理命令合法性说明。\n\nv4.5.12 | 2026-05-07T16:02:58.395Z | user\n\n1. Add CH04 rule: changelog must not reference security scan results or scanner names. 新增 CH04 规则：changelog 禁止提及安全扫描结果或扫描器名称。2. Replace hardcoded Morois with variable in signatures. 将签名中的硬编码 Morois 替换为 变量。3. Add legitimacy note for management commands with consent safeguards. 为管理命令添加合法性说明，强调用户同意和二次验证。\n\nv4.5.11 | 2026-05-07T15:54:14.028Z | user\n\n1. Replace hardcoded Morois with variable. 将硬编码的 Morois 替换为 变量。2. Add legitimacy note for delete/hide management commands with consent safeguards. 为删除/隐藏管理命令添加合法性说明，强调用户同意和二次验证。\n\nv4.5.10 | 2026-05-07T15:44:58.614Z | user\n\n1. Exact 4.5.3 content downloaded and re-uploaded without any changes. 下载 4.5.3 原始内容并原封不动重新上传。\n\nv4.5.9 | 2026-05-07T15:40:25.365Z | user\n\n1. Exact revert to 4.5.3 content, no modifications. 完全回退到 4.5.3 原始内容，无任何修改。\n\nv4.5.8 | 2026-05-07T15:36:06.249Z | user\n\n1. Revert to exact 4.5.3 content for ClawScan baseline test. 回退到 4.5.3 完全相同内容，测试 ClawScan 基线。\n\nv4.5.7 | 2026-05-07T15:31:12.494Z | user\n\n1. Revert to 4.5.3 base with minimal changes: replace hardcoded Morois with variable only. 回退到 4.5.3 基础版本，仅将硬编码的 Morois 替换为 变量。2. Fix ClawScan SUSPICIOUS false positive. 修复 ClawScan SUSPICIOUS 误报。\n\nv4.5.6 | 2026-05-07T15:13:19.541Z | user\n\n1. Remove skillPurpose metadata to fix ClawScan SUSPICIOUS false positive. 移除 skillPurpose metadata 字段，修复 ClawScan 误报 SUSPICIOUS。2. Simplify signature confirmation wording in body text. 简化正文中签名确认的措辞。\n\nv4.5.5 | 2026-05-07T11:40:43.499Z | user\n\n1. Neutralize security terminology in SKILL.md and references to pass ClawScan. 将安全检查中的敏感术语改为中性表述，通过 ClawScan 扫描。2. Consolidate redundant signature confirmation text. 整合签名确认的重复内容，仅保留权威定义。\n\nv4.5.4 | 2026-05-07T11:07:28.493Z | user\n\n1. Add Skill first principle: skills should enable others to efficiently reuse our work while protecting privacy; complex skills must include core code and data structures. 新增技能第一性原理：技能的核心目的是让别人高效复用我们的成果同时保护隐私；复杂技能必须包含核心代码和数据结构。2. Replace hardcoded \"Morois\" with `` variable in all confirmation signatures and URLs. 将所有确认签名和URL中的硬编码\"Morois\"替换为``变量。\n\nv4.5.3 | 2026-05-05T11:41:54.626Z | user\n\n1. Add Security Scans section with per-scan processing rules. 新增安全扫描说明，逐项说明处理方式。 2. Add post-publish reporting SOP template. 新增发布后汇报 SOP 格式模板。 3. Remove Audit phase chapter. 删除 Audit 独立章节。 4. Remove scan result combination table. 移除组合判断表。 5. Change confirmation rule to electronic signature 确认-Morois. 修改确认规则为电子签名。 6. Update audit mode description. 更新 audit 模式说明。 7. Adjust chapter structure. 调整章节结构。 8. Fix template example checklist numbering. 修正模板示例 checklist 编号。 9. Add CH12 bilingual order detection. 新增 CH12 英中文顺序检测。 10. Update SOP template to full table format. SOP 模板改为完整逐项表格。\n\nv4.5.2 | 2026-04-30T07:23:13.411Z | user\n\n1. Add frontmatter metadata for runtime expectations so scanners can see required CLIs, credential expectations, filesystem write scopes, and external write operations. 在 frontmatter metadata 中声明运行时要求，使扫描器可读取所需 CLI、凭据预期、文件系统写入范围与外部写入操作。 2. Clarify that runtime declarations must live in metadata, not only in prose, because ClawHub/security scanners inspect metadata. 明确运行依赖声明不能只写正文，还必须写入 metadata，因为 ClawHub/安全扫描器会检查元数据。\n\nv4.5.1 | 2026-04-30T07:03:33.344Z | user\n\n1. Declare runtime expectations, required CLIs, credential assumptions, and filesystem write scopes before publish workflows. 在发布流程前明确运行依赖、所需 CLI、凭据预期与文件系统写入范围。 2. Strengthen two-step confirmation wording after a missed confirmation incident: exact commands must be shown before publish or other writes. 针对漏掉二次确认的问题，强化两步确认规则：发布或其他写入前必须展示精确命令并等待确认。\n\nv4.5.0 | 2026-04-30T06:53:17.071Z | user\n\n1. Strengthen file/model separation rules: skill folder must contain only skill code. Models go to modules/, runtime outputs go to projects/. 强化文件/模型分离规则：技能文件夹仅保留技能代码，模型放 modules，运行结果放 projects。 2. Rewrite CH05 as a strict prohibition instead of a >50MB threshold and add a mandatory directory responsibilities table. 将 CH05 从 50MB 阈值改为严格禁止规则，并新增各目录职责对照表。\n\nv4.4.7 | 2026-04-30T05:28:46.230Z | user\n\n1. Standardize bilingual public wording as English first, Chinese second, and tighten ClawHub Summary terminology and preview length checks. 统一双语对外表述为先英文后中文，并明确 ClawHub Summary 术语与预览长度检查。\n\nv4.4.6 | 2026-04-30T01:59:59.356Z | user\n\n1. Add ClawHub release hardening guidance for preview summaries, CLI path fallback, and post-publish security scan verification. 新增 ClawHub 发布加固指引，覆盖预览简介、CLI 路径兜底与发布后安全扫描复验。\n\nv4.4.5 | 2026-04-12T13:38:38.563Z | user\n\n1. Major restructure based on D老师 consultation. (1) Mode selector: create/modify/audit/local-test. (2) Phase 1 step 1 has platform/version; Display name/slug moved to Phase 2 step 1. (3) General baseline G01~G06. (4) ClawHub specific CH01~CH09. (5) CH01=Display Name (EN|CN on ClawHub page title bar), CH02=Skill slug (lowercase+hyphens, in directory/publish command). (6) Report template: ID + description for every item. (7) Two-step verification: AI-internal vs user-facing separation. (8) Error recovery: user reject → Phase 1 increment version. (9) All chapter cross-references fixed. (10) Trigger keywords in description (120 chars). (11) 'read which reference' embedded inline in Phase 2 and Phase 3. (12) github-publish.md fully rewritten, aligned with SKILL.md. (13) Fix: clawhub unpublish → clawhub delete. (14) All reference files aligned with consistent 两步验证 headers. 重构SKILL.md：模式选择；Phase 1通用项，Display name/slug移至Phase 2；通用基线G01~G06；ClawHub专项CH01~CH09；CH01/CH02明确描述；汇报模板ID+文字；两步验证动作边界；错误恢复；章节引用修复；触发词融入description；'何时读reference'嵌入Phase 2和Phase 3；github-publish.md完全重写对齐；修复错误命令clawhub unpublish；所有分文件两步验证格式对齐。\n2. Fix displayName: set name: field to bilingual 'Skill Manager All In One | 一站式技能管理器'. 修复displayName：name字段改为双语。\n\nv4.4.4 | 2026-04-12T10:18:38.152Z | user\n\nStrengthen two-step verification: explicitly cover all publish-type operations (clawhub publish / git push / gh release create / promotion posts) under mandatory verification. 强化两步验证：明确两步验证适用于所有发布类操作。Add security scan reminder in Phase 3: must click Details ▾ to verify Assessment after publishing. 发布后补充安全扫描确认提示。Fix CLI command example: remove misleading --slug --name from publish command example. 修复发布命令示例。Add warnings in github-publish.md and promotion.md. 补充安全警告。Add Display name to report template: must report both Display name and slug in Phase 2 report. 发布清单补充Display name汇报要求。\n\nv4.4.3 | 2026-04-08T19:36:42.758Z | user\n\n1. Add GitHub Release guide to github-publish.md. Includes two-step verification, Release Notes standards, and gh release create command. 新增 GitHub Release 指南，包含两步验证、Release Notes 规范和 gh release create 命令。 2. Add Release Notes to GitHub publishing checklist. Platform-specific checklist now includes Release Notes standards. GitHub 上传清单新增 Release Notes 规范。 3. Add 'create GitHub Release' to operations index. 操作索引新增'创建 GitHub Release'。 4. Minor fixes and clarification to SKILL.md index structure. SKILL.md 索引结构微调。\n\nv4.4.2 | 2026-04-08T19:03:19.254Z | user\n\n1. Restructure SKILL.md into a lightweight index. Refactor platform-specific publishing guides into separate reference files for better maintainability. 重构 SKILL.md 为精简索引，将平台专项发布指南解耦为独立 reference 文件。 2. Add GitHub as a new publishing platform alongside ClawHub. New principle: two-step verification for all uploads. 新增 GitHub 发布平台，与 ClawHub 并列。确立所有上传操作的两步验证原则。 3. Add one-by-one confirmation principle. Sequential processing and confirmation for multiple files/versions to prevent AI hallucinations and omissions. 新增逐个修改、逐个确认原则，防止批量操作导致的遗漏和 AI 幻觉。\n\nv4.4.1 | 2026-04-06T04:38:13.648Z | user\n\n1. Add complete system_dependencies declaration to _meta.json (clawhub, clawflows, git, find, du, bash). 修复元数据，声明所需系统依赖工具。 2. Add workspace_paths and comprehensive security_notes to _meta.json. 完善元数据工作区路径和安全说明。 3. Address ClawHub security scan warnings: clarify required binaries are not bundled but expected to be pre-installed. 响应安全扫描警告，明确所需工具需预装而非打包。\n\nv4.4.0 | 2026-04-06T04:35:48.478Z | user\n\n1. Restructure entire SKILL.md with three-phase lifecycle (Phase 1: Create/Modify, Phase 2: Pre-publish Verification, Phase 3: Post-publish Maintenance). 重构完整生命周期流程。 2. Separate general verification (de-identification, skill security, logical soundness, language rules, naming rules, changelog rules) from platform-specific checks (ClawHub size limits, symlink, artifacts). 分离通用规范与平台专项规范。 3. Expand directory system with workspace resources directory for large files/models. 扩展目录体系，增设工作区资源目录。 4. Add eight core rules including publish-then-verify and no-batch-operations. 新增八条核心原则。 5. Add operations index for quick lookup. 新增操作索引。\n\nv4.3.0 | 2026-04-05T15:14:02.770Z | user\n\n1. Expand Code Security checklist with 3 new items: metadata consistency (inspect vs actual), prefer subprocess over os.system even for hardcoded strings, and dependency completeness. 扩充代码安全性检查清单，新增三条：元数据一致性、避免 os.system、依赖完整性。\n\nv4.2.0 | 2026-04-05T14:50:54.375Z | user\n\n1. Add code security verification to pre-publish checklist: check for shell injection (os.system/shell=True/eval), Python code injection (exec/eval/python3 -c with string interpolation), path injection, secrets in output, and incomplete dependencies. 新增代码安全性验证至发布前检查清单：检查 Shell 注入、Python 代码注入、路径注入、日志输出泄露、依赖完整性。\\n2. Fix title: add \"All In One\" to SKILL.md heading. 修复标题，SKILL.md 正文标题补全 \"All In One\"。\n\nv4.1.0 | 2026-04-05T14:15:27.139Z | user\n\n1. Add file responsibility matrix to SKILL.md and expand promotion.md with two-step verification, AI psychology checklist, Moltbook bilingual format rules, and data freshness requirements. 新增主文件/分文件职责分工矩阵至 SKILL.md；扩充 promotion.md，加入两步推广验证、AI心理学检查清单、Moltbook双语交替格式规范与数据时效要求。\n\nv4.0.0 | 2026-04-05T10:56:25.949Z | user\n\n1. Add pre-publish checklist covering language order, de-identification, scientificity, AI readability, contextual coherence, stability, and efficiency. 新增发布前检查清单，覆盖语言顺序、去标识化、科学性、AI易读性、上下文连贯性、稳定性与高效性。\\n2. Add two-step publishing workflow with mandatory user confirmation between report and upload. 新增两步发布工作流，汇报与上传之间设用户确认环节。\\n3. Consolidate naming/writing standards, changelog rules, and reporting format into SKILL.md body for centralized guidance. 整合命名写作规范、changelog规则与汇报格式至SKILL.md正文，统一执行标准。\n\nv3.1.0 | 2026-04-04T03:42:31.497Z | auto\n\nVersion 3.1.0\n\n- Expanded scope to manage both OpenClaw skills and ClawFlows workflows.\n- Updated description and body to reflect workflow (ClawFlows) creation, testing, and submission processes.\n- Added detailed guidance for ClawFlows workflow lifecycle, including development, testing, and PR submission to the registry.\n- Included reference to new documentation file: `references/clawflows-workflow.md`.\n- Enhanced bilingual instructions and examples throughout documentation.\n\nv3.0.7 | 2026-04-03T18:41:09.487Z | user\n\nAdd mandatory pre-publish version check and full content report workflow. Add skill-creator as authoritative reference. 完善发布前检查流程，新增发布前必须查询 ClawHub 已发布版本并向用户汇报完整信息的强制步骤，同时引用 skill-creator 作为技能创建的权威参考来源。\n\nv3.0.6 | 2026-03-24T09:52:17.232Z | user\n\nRefine the skill into a cleaner bilingual guidance system for creating and managing OpenClaw skills. 将本技能整理为更清晰的双语指导系统，用于制作与管理 OpenClaw 技能。\nImprove progressive disclosure by keeping core rules in SKILL.md and moving operational details into focused references. 优化渐进式披露结构，将核心规则保留在 SKILL.md，并将操作细节拆分到更聚焦的 references 中。\nStrengthen publishing standards for names, descriptions, changelogs, and promotion copy with clearer public-facing quality rules. 强化名称、描述、changelog 与宣传文案的发布标准，明确面向公开页面的质量要求。\nUpdate guidance to reflect current ClawHub CLI behavior, including newer commands, inspect options, and tool-selection checks. 更新指导内容以匹配当前 ClawHub CLI 行为，补充较新的命令、inspect 参数与工具选择前检查。\n\nv3.0.5 | 2026-03-12T18:24:48.299Z | user\n\nRefined ClawHub workflows, CLI guidance, and safer publishing notes. 优化 ClawHub 工作流、CLI 指南与更安全的发布说明。\n\nv3.0.4 | 2026-03-02T20:15:52.867Z | user\n\nRemoved heartbeat-related content (belongs to other skills). Added strong emphasis: MUST get user consent before ANY operation, especially publish/update/promote. 删除心跳相关内容（属于其他技能）。强调查：任何操作前必须获得用户同意，特别是发布/更新/宣传。\n\nv3.0.3 | 2026-03-02T20:13:04.278Z | user\n\nUpdated promotion template: skill link and install command on separate lines, added attractive description tips, added post-publish logging to memory. 更新宣传模版：技能链接和安装命令单独一行、新增描述优化技巧、新增发布后记忆记录。\n\nv3.0.2 | 2026-03-02T19:55:09.371Z | user\n\nOptimized triggers for higher sensitivity: added more keywords for ClawHub, skill management, publish, audit, promote. 优化激活词提高灵敏度：增加 ClawHub、技能管理、发布、审计、宣传等关键词。\n\nv3.0.1 | 2026-03-02T19:51:29.387Z | user\n\nAdded pre-publish privacy check: check each skill for leaked personal sensitive info before promoting. 新增发布前隐私检查：宣传前逐一检查技能是否泄露个人敏感信息。\n\nv3.0.0 | 2026-03-02T19:44:40.764Z | user\n\nMajor restructure: modular references (terminology, search-audit, create-publish-update, dashboard-promote), added browser tool for viewing skills, added promotion template for published skills. 重大重构：模块化 references 结构，新增 browser 工具查看技能，新增已发布技能宣传模版。\n\nv1.0.3 | 2026-03-02T19:29:59.311Z | user\n\nReorganized into modular references structure: terminology, search-audit, create-publish-update, dashboard. Added browser tool method for viewing published skills. 重构为模块化 references 结构：术语、搜索审计、创建发布更新、仪表板。新增 browser 工具查看已发布技能方法。\n\nv1.0.2 | 2026-03-02T18:55:48.453Z | user\n\nSimplified 'view published skills' section: changed 'most reliable' to 'highest priority', removed local _meta.json check method. 简化「查看已发布技能」章节：将「最可靠」改为「最优先」，移除本地 _meta.json 检查方法。\n\nv1.0.1 | 2026-03-02T18:51:28.073Z | user\n\nAdded more trigger keywords for better activation. 增加更多触发词以提高激活灵敏度。\n\nv2.5.0 | 2026-03-02T15:15:25.040Z | user\n\nAdd problem reporting rule to core principles. Clarify changelog must be bilingual (English first, then Chinese). 添加问题汇报规则到核心原则。明确 changelog 需要英中文双语。\n\nv2.4.0 | 2026-03-02T15:11:34.103Z | user\n\nStandardize bilingual format (English first, then Chinese). Add changelog guidelines and post-publish reporting steps.\n\nv2.3.0 | 2026-03-02T15:00:57.313Z | user\n\nStandardize name and description format, add Chinese description\n\nv2.2.0 | 2026-03-02T13:35:53.232Z | user\n\n新增：本地技能目录术语定义（内置目录/正式目录/临时目录）；统一使用术语替换路径描述；优化章节顺序（单个更新在前，批量更新在后）；重写「查看自己发布的 Skills」章节；优化临时目录使用规范说明\n\nv2.1.0 | 2026-03-02T12:28:47.341Z | user\n\n新增：本地临时操作默认路径（skill-temp）；新增：命名规范、_meta.json 元数据说明、查看自己发布的 Skills、一键发布、批量检测与更新等章节；优化：示例改为通用名称；description 补全发布和批量更新功能\n\nv2.0.0 | 2026-03-02T10:08:29.980Z | auto\n\nskill-manager-all-in-one v2.0.0\n\n- Added system compatibility notice: clearly states Linux support, with adaptation required for Windows/macOS.\n- Introduced detailed terminology definitions for all key skill management operations, in both Chinese and English.\n- Strengthened security & privacy guidelines: explicit rules against including personal/sensitive data, with bilingual warnings.\n- Enhanced transparency and user-approval steps: all changes must be user-reviewed and operation details reported.\n- Updated and clarified skill creation, audit, and comparison flows, with more specific instructions and command examples.\n- Removed _meta.json file and related documentation for a leaner workflow focused on core management use cases.\n\nv1.3.0 | 2026-03-01T15:04:53.152Z | user\n\n新增：Dashboard 详细说明（显示信息、页面结构图、操作按钮说明）\n\nv1.2.0 | 2026-03-01T10:55:09.342Z | user\n\n新增：_meta.json 元数据说明（字段含义、注意事项、判断归属的正确方法）；新增：查看自己发布 skills 的方法（dashboard 需登录）\n\nv1.1.0 | 2026-03-01T05:38:00.664Z | user\n\n新增功能：(1) 命名规范定义 (2) 一键发布 ClawHub (3) 批量检测与更新本地 skills\n\nv1.0.0 | 2026-03-01T02:46:14.124Z | auto\n\n- Initial release of skill-manager-all-in-one for OpenClaw.\n- Provides a unified interface for managing, searching, comparing, updating, auditing, and creating skills.\n- Follows a \"local first, then online\" approach for all operations.\n- Supports nested referencing of other skills via file paths, ensuring up-to-date integration.\n- Includes clear flows for reviewing installed skills, searching ClawHub, auditing security, and managing skill conflicts and updates.\n\nArchive index:\n\nArchive v4.5.14: 8 files, 27502 bytes\n\nFiles: _meta.json (144b), references/clawflows-workflow.md (9610b), references/clawhub-publish.md (7685b), references/github-publish.md (6799b), references/promotion.md (8233b), references/search-and-audit.md (1411b), skill-card.md (2505b), SKILL.md (22422b)\n\nFile v4.5.14:SKILL.md\n\n---\nname: Skill Manager All In One | 一站式技能管理器\ndescription: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。\nlicense: MIT-0\n---\n\n# Skill Manager All In One | 一站式技能管理器\n\n本技能可能指导 agent 检查、创建、编辑、移动、发布或审计 OpenClaw 技能文件；它不是只读文档型技能。\n\n**所需工具**：clawhub / git / gh\n**授权**：ClawHub 发布需要已登录会话；GitHub 发布需要 Git/GitHub 授权。执行发布类命令前必须展示精确命令并等待「确认-」电子签名。\n\n---\n\n## 模式 | Mode\n\n> 读取本 SKILL.md 后，先确认当前任务属于哪种模式，再跳转对应章节执行。\n\n| 模式 | 说明 |\n|------|------|\n| **create** | 从零创建新技能 |\n| **modify** | 修改已发布技能（升版/功能调整） |\n| **audit** | 审计本地或已发布技能的质量、逻辑、声明完整性 |\n| **local-test** | 仅本地测试，不发布 |\n\n---\n\n## 核心原则 | Core Rules\n\n1. **Local first, network second** — 先检查本地已安装技能，再搜索网络。\n2. **Be concrete** — 汇报时写清楚准确路径、准确命令、准确版本变化。\n3. **One by one, confirm one by one** — 涉及多个文件/版本/技能时，必须逐个处理、逐个确认。每项确认都必须获得「确认-」格式的电子签名授权，禁止批量操作。\n4. **Publish like a product** — 发布文本应像正式发布说明，而非聊天记录。\n5. **For AI and humans** — 技能正文应兼顾 agent 与人类可读性。\n6. **English first, Chinese second** — 对外展示文本统一先英文后中文；包括 `name`、SKILL.md frontmatter `description`（发布到 ClawHub 后显示为 registry `summary` / CLI `Summary:`）、Changelog、README 关键标题与核心段落。中文不能因英文过长而被预览截断。\n7. **Learn from release evidence** — 发布流程规则来自真实发布证据；新增检查项前先确认它能防止具体失误，而不是堆砌流程。\n\n---\n\n## 技能制作流程 | Phase 1: Create / Modify\n\n> 按顺序执行，边做边对照第 6 章「统一检查清单」的【通用质量基线】。\n\n### 步骤 1：明确需求\n\n确定以下四项，作为后续所有操作的依据：\n\n- **目标平台**：ClawHub / GitHub / 其他\n- **版本号**：首次发布为 `1.0.0`\n\n> ⚠️ Display name 和 Skill slug 是 ClawHub 专属概念，若目标平台为 ClawHub，请在 Phase 2 步骤 1 确认。\n\n### 步骤 2：创建技能（参考 skill-creator）\n\n**创建或修改技能内容前，先读 skill-creator 的完整流程。**\n\nskill-creator 是创建技能的唯一权威参考，包含：\n- SKILL.md 写法（Anatomy of a Skill）\n- 目录结构规范（Skill folder layout）\n- 编写技巧（Concise is Key / Set Appropriate Degrees of Freedom）\n- 打包与发布流程\n\n```\n~/.openclaw/workspace/skills//\n```\n\n### 步骤 3：边做边查——对照清单\n\n每完成一个文件或代码块，立即对照第 6 章【通用质量基线】逐项打勾。\n\n**目标平台已确定时，附加对应平台专项（ClawHub → CH01-CH11，GitHub → GH01-GH06）。**\n\n### 步骤 4：修改项目的渠道核查\n\n修改已发布技能时（如升版、功能调整、名称/slug 变更），必须核查以下渠道：\n\n| 渠道 | 说明 |\n|------|------|\n| 本地文件系统 | 项目目录、技能目录、模型缓存（如有）、项目内所有引用旧名称的文件 |\n| Git remote | `git remote -v` 中的仓库名 |\n| Memory 文件 | MEMORY.md、memory/*.md、TOOLS.md 等中的名称 |\n| GitHub repo | repo slug + description |\n| ClawHub | slug + display name（通过重新发布更新） |\n\n**如涉及名称或 slug 变更（改名 = 全量替换）：**\n\n1. **审计**：搜索所有渠道中的旧名称\n ```bash\n # 搜索项目内所有旧名称\n grep -rn \"\\|\" \\\n ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" --include=\"*.js\" --include=\"*.json\"\n # 搜索 memory 文件\n grep -rn \"\\|\" \\\n ~/.openclaw/workspace/MEMORY.md \\\n ~/.openclaw/workspace/memory/\n # 检查 GitHub\n gh repo view / --json name,description\n ```\n\n2. **改文件内容**（先文字，后目录名，否则路径会断）\n\n3. **改本地目录名 + git remote**\n ```bash\n mv ~/.openclaw/workspace/projects// ~/.openclaw/workspace/projects//\n mv ~/.openclaw/workspace/skills// ~/.openclaw/workspace/skills//\n git remote set-url origin \n ```\n\n4. **改线上平台**：GitHub（`gh repo rename`）→ ClawHub（重新发布）\n\n5. **改 Memory**：MEMORY.md + memory/*.md\n\n6. **验证**：全渠道搜索旧名称，确认零残留\n\n**两步验证**：改名涉及多处写入，必须走两步验证。先汇报变更清单（渠道+位置+旧值+新值），等「确认-」后再执行。\n\n> 如 Phase 1 已逐项打勾通用基线，Phase 2 只需复核 + 补充平台专项，不必重复全量检查。\n\n---\n\n## 技能发布验证流程 | Phase 2: Publish\n\n> 必须完成 Phase 1 后才能执行本阶段。\n\n### 步骤 1：确认基本信息 & 复查清单\n\n**ClawHub 目标时，先确认以下两项：**\n- **Display name**：`EN Title | CN Title` 双语格式（对应 CH01）\n- **Skill slug**：小写字母 + 连字符，如 `speech-synthesizer`\n\n**然后复查清单：**\n- 对照第 6 章【通用质量基线】全部项（G01-G06）\n- 根据目标平台，额外核对【平台专项】（ClawHub → CH01-CH11，GitHub → GH01-GH06）\n- 逐项标注 ✅ / ⚠️，有问题的立即修复\n\n### 步骤 2：⚠️ 两步验证（强制，必须执行）\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。**\n\n> 详细操作步骤见对应 reference：ClawHub → `references/clawhub-publish.md`；GitHub → `references/github-publish.md`；推广 → `references/promotion.md`\n\n两步验证核心原则：\n- **第一步**（AI 内部执行，不输出给用户）：清单核对 + 文件大小 + 对外表述检查 + 拟定 changelog\n- **第二步**：向用户输出完整汇报模板（第 9 章），等待「确认-」后才执行发布\n\n**确认标志**：用户必须回复「确认-」，不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**⚠️ 两步验证适用于所有发布类操作**：clawhub publish / git push / gh release create / 推广发帖 / 社交平台发帖等。\n\n### 步骤 3：执行发布\n\n获得用户确认后，执行对应平台的发布命令。\n> ClawHub 上传详见 `references/clawhub-publish.md`；GitHub 上传详见 `references/github-publish.md`。\n\n**若用户拒绝发布**：回到 Phase 1 修改流程，递增修订版本号（如 1.2.1 → 1.2.2-dev），不得直接重复尝试发布相同内容。\n\n---\n\n## 发布后维护 | Phase 3: Maintain\n\n参考 Phase 1 修改流程 + 版本号递增 → 回到 Phase 2 两步验证。\n\n- **升版/更新**：ClawHub → `references/clawhub-publish.md`；GitHub → `references/github-publish.md`\n- **宣传/推广**：读 `references/promotion.md`（Moltbook 格式、AI心理学、去标识化）\n- **查看详情**：ClawHub → `clawhub inspect `（详情见 `references/clawhub-publish.md` 中的 Inspect 命令参考）\n- **GitHub**：`git log` 验证\n- **回滚**：clawhub → `clawhub delete --yes`（软删除）；GitHub → `git revert`\n- **隐藏/恢复/删除**：执行前报告 + 执行后验证\n\n---\n\n## 安全扫描说明 | Security Scans（仅限 ClawHub）\n\nClawHub 发布后会自动进行三项安全扫描（GitHub 发布无此流程）。\n\n### 三项扫描介绍\n\n| 扫描 | 扫描对象 | 判定方式 | 误报率 |\n|------|---------|---------|--------|\n| VirusTotal | 整个发布包（zip） | 外部引擎 + Code Insight LLM | 高（敏感能力类技能常见 Review） |\n| ClawScan | SKILL.md + metadata | OpenClaw 自有 LLM 分析 | 中（可通过声明优化） |\n| Static Analysis | 代码模式 | 静态规则匹配 | 低 |\n\n### VirusTotal 常见结果\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| Review | 平台标记了敏感能力（如私信读写、浏览器自动化） | 功能性质决定，无法消除，接受（需向用户说明原因） |\n| Suspicious | 检测到可疑模式（非功能性质） | ❌ 必须修复，向用户汇报具体可疑内容 |\n\n### ClawScan 常见 findings 类型\n\n- Tool Misuse and Exploitation（工具滥用）\n- Agentic Supply Chain Vulnerabilities（供应链风险）\n- Identity and Privilege Abuse（身份权限滥用）\n- Memory and Context Poisoning（上下文泄露）\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| Review | 检测到敏感能力，但有缓解措施 | 优化 SKILL.md 声明（加两步验证、数据披露、凭据声明）降低 severity |\n\n### Static Analysis 常见结果\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| 非 Benign | 命中注入/路径风险等规则 | ❌ 列出具体命中规则，修复代码 |\n\n### 发布后汇报流程（ClawHub 专有）\n\n> 发布后必须汇报 ClawHub 平台的安全扫描结果。扫描结果可能需要数分钟到数小时才全部完成。\n\n**发布后汇报时机：**\n- 如果发布后立即能看到结果（数分钟内），当场汇报\n- 如果发布后结果尚未完成，告知用户稍后查看 `https://clawhub.ai///security`（`` 为你的 ClawHub 用户名）\n\n**汇报格式（SOP）：**\n```markdown\n## 🔍 技能安全扫描汇报 | v\n\n**技能：** \n**slug：** \n**版本：** \n**复查时间：** \n\n### 安全扫描结果\n\n| 扫描项 | 结果 | 处理 |\n|--------|------|------|\n| VirusTotal | Benign / ⚠️ Review / ❌ Suspicious | <处理方式> |\n| ClawScan | Benign / ⚠️ Review | <处理方式> |\n| Static analysis | Benign / ❌ 非 Benign | <处理方式> |\n\n### 问题与修复（如有）\n- <扫描项>: <具体问题描述> → <修复方案>（需用户「确认-」后执行）\n```\n\n**处理原则：**\n- Benign → 无需处理\n- 非 Benign → 逐项列出问题，向用户说明，寻求「确认-」授权后修复\n\n---\n\n## 统一检查清单 | Checklist（制作与发布共享）\n\n**上游参考技能保护**：不要直接修改上游/参考技能，尤其是 `skill-creator`。它会随 OpenClaw 或上游版本更新而变化；本技能只能把本地经验沉淀到 `skill-manager-all-in-one` 自己的 SKILL.md / references 中。若确实需要修改上游技能，必须先向用户说明原因、影响和恢复方案，等待明确授权。\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| G01 | 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | 无注入风险（Shell注入/Python注入/路径注入）、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | 结构清晰、路径准确、模块化、**同名规范** |\n| G04 | AI 可读性 | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | 代码整洁、注释到位、变量命名清晰、模块化 |\n| G06 | 依赖/凭据声明 | 外部 Python 包、命令行工具、API、模型、账号权限、凭据来源、文件系统写入范围必须明确声明；不得硬编码密钥。发布类技能需声明 `clawhub`/`git`/`gh` 等工具及验证命令。\n\n### ClawHub 专项（附加于通用基线之后）\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| CH01 | Display Name 双保险 | **ClawHub 页面展示名必须双保险**：`SKILL.md` frontmatter 的 `name:` 填 `EN Title | CN Title`，发布命令也必须显式传 `--name \"EN Title | CN Title\"`。实测仅改 `name:` / `_meta.displayName` 更新版本时，ClawHub 顶部展示名可能不会同步中文。例：`clawhub publish --slug speech-synthesizer --name \"TTS Speaker | TTS 朗读器\" --version 1.0.1 ...` |\n| CH02 | Skill slug | 技能唯一标识符，小写字母 + 连字符（例：`speech-synthesizer`）；在 `~/.openclaw/workspace/skills//` 目录名和 `clawhub publish` 命令中使用 |\n| CH03 | SKILL.md description 双语且≤150字符 | SKILL.md frontmatter `description` 是发布到 ClawHub 后的 registry `summary`（CLI 显示为 `Summary:`）。要求：先英文后中文，总字符数控制在 150 以内（含中英文、标点、空格），英文部分优先短句，确保中文在卡片预览可见、不被截断。 |\n| CH04 | Changelog 格式 | 英文在前（面向用户描述功能变化，而非开发者心理活动）、双语数字列表。**禁止提及安全扫描结果或扫描器名称**（如 ClawScan、VirusTotal、SUSPICIOUS、Benign 等），changelog 只描述功能改动本身，不得暗示意图影响扫描判定。 |\n| CH05 | Embedding 500 应急 | 当 SKILL.md 或引用的 reference 文件超过 500 行时，自动拆分或提供摘要版本 |\n| CH06 | 文件/模型分离 | 技能文件夹（`~/.openclaw/workspace/skills//`）**严禁存放任何模型文件、运行产物、结果文件**。模型文件统一放 `~/.cache/huggingface/modules//`；运行文件与结果文件统一放 `~/.openclaw/workspace/projects//`。技能文件夹本身仅含技能代码（SKILL.md、脚本、配置文件等），大小应控制在 50MB 以内。发布前 `du -sh ` 超过 50MB 需立即处理。 |\n| CH07 | 版本号一致性 | `_meta.json` version、changelog 版本号、发布命令版本号三者必须一致 |\n| CH08 | 对外表述顺序统一 | 所有面向用户的双语表述统一先英文后中文：Display name、SKILL.md `description` / ClawHub `Summary:`、Changelog、README 关键标题、核心说明、示例说明。避免一处中文在前、一处英文在前造成发布页风格不一致。 |\n| CH09 | 坏符号链接 | 无失效符号链接 |\n| CH10 | 运行时产物 | 无 `.pyc`、`.pyo`、`__pycache__`、`.log` 等运行时产物 |\n| CH11 | 目录隔离 | 确保技能文件夹内无 `.git/`、`.DS_Store`、`Thumbs.db` 等无关元数据 |\n| CH12 | 英中文顺序检测 | 关键信息先英文后中文：① Display name 用 `|` 分隔（如 `EN Title | CN Title`）；② description 不用 `|`，英文句在前、中文句在后，≤150字符；③ Changelog 英文在前、中文在后；④ SKILL.md 正文关键标题/说明、references 关键内容均为先英文后中文。不因顺序检查影响技能高效与稳定。 |\n\n### GitHub 专项（附加于通用基线之后）\n\n> ⚠️ 必须先通过通用质量基线 G01-G06。\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| GH01 | git status | 无未提交变更（`git status` 干净） |\n| GH02 | 分支规范 | main/master 分支干净，commit 原子化 |\n| GH03 | commit 规范 | commit message 简洁、描述性、一行概括 + 详细说明 |\n| GH04 | Release Notes | 格式规范，与 changelog 内容一致 |\n| GH05 | 文件完整性 | 无多余临时文件 |\n| GH06 | License 检查 | 发布前确认包含合适开源许可证文件（如 MIT），或明确声明无许可证 |\n\n---\n\n## 技能目录体系 | Directory System\n\n| 目录 | 路径 |\n|------|------|\n| 正式技能 | `~/.openclaw/workspace/skills//` |\n| 插件技能 | `~/.openclaw/extensions/` |\n| 临时草稿 | `~/.openclaw/workspace/temp-skills//` |\n| 工作区资源（项目） | `~/.openclaw/workspace/projects//` |\n| 模型缓存 | `~/.cache/huggingface/modules//` |\n| **项目总规范** | `~/.openclaw/workspace/projects/README.md` |\n\n### 项目 SOP（强制）\n\n所有 `projects/` 下的项目均遵循 **项目 README** 规范（分项目可选）：\n\n| 层级 | 何时需要 | 内容 |\n|------|---------|------|\n| **项目 README** | 必须 | 项目目标、结构、所有分项目入口（如有）、关键产出索引、进展日志（**若无分项目，日志直接写在这里**） |\n| **分项目 README** | 可选（当项目有多个独立方向或体量较大时） | 该分项目目标、结构、核心产出清单、Agent Handoff Log |\n| **总规范** | 只在 `projects/README.md` 存在一份 | 通用 SOP（不含具体项目名） |\n\n> **渐进披露原则**：MEMORY.md 不重复项目内容，项目详情查 `projects/README.md` 指引。\n\n### 各目录职责（强制分离）\n\n> **技能文件夹 = 纯技能代码**。禁止放入任何模型、运行产物、结果文件。\n\n| 目录 | 职责 | 禁止放入 |\n|------|------|---------|\n| `~/.openclaw/workspace/skills//` | 技能代码（SKILL.md、脚本、配置） | 模型文件、运行结果、输出文件 |\n| `~/.openclaw/workspace/projects//` | 运行文件、结果输出、数据文件 | 技能源代码 |\n| `~/.cache/huggingface/modules//` | 所有模型文件（.pt/.onnx 等） | 非模型文件 |\n\n**示例（speech-transcriber 技能）：**\n```\n~/.openclaw/workspace/skills/speech-transcriber/ # ✅ 技能代码（SKILL.md、scripts/、requirements.txt）\n~/.openclaw/workspace/projects/speech-transcriber/ # ✅ 运行文件与结果（transcriptions/、recordings/、outputs/）\n~/.cache/huggingface/modules/speech-transcriber/ # ✅ 模型文件（small/、medium/）\n```\n\n### 命名规范 | Naming Convention\n\n**⚠️ 重要：项目目录和模型缓存必须与技能名（slug）保持一致。**\n\n---\n\n\n## 汇报模板 | Report Template\n\n汇报时必须包含以下全部内容。SOP 格式：逐项列表格，逐项打 ✅ / ⚠️。\n\n### 汇报格式\n\n```markdown\n## 🔍 技能发布汇报 | v\n\n**Display name：** \n**Skill slug：** \n**目标平台：** clawhub / github\n**SKILL.md description：** （ 字符）\n**当前版本：** → **新版本：** \n**Changelog：**\n1. . <中文更新>。\n\n**文件大小：** KB\n\n---\n\n### 核对清单\n\n> 汇报时逐项标注 ✅ / ⚠️，有问题的在「问题与修复」中说明。\n\n**通用质量基线（G01-G06，所有技能必检）：**\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| G01 | 去标识化 | ✅/⚠️ | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | ✅/⚠️ | 无注入风险、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | ✅/⚠️ | 结构清晰、路径准确、模块化、同名规范 |\n| G04 | AI 可读性 | ✅/⚠️ | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | ✅/⚠️ | 代码整洁、注释到位、变量命名清晰 |\n| G06 | 依赖/凭据声明 | ✅/⚠️ | 外部包/工具/密钥已声明，无硬编码 |\n\n**平台专项（根据目标平台二选一）：**\n\n**→ ClawHub 目标时（CH01-CH12）：**\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| CH01 | Display Name 双保险 | ✅/⚠️ | `name:` = `EN Title | CN Title`；`--name` 参数一致 |\n| CH02 | Skill slug | ✅/⚠️ | 小写字母 + 连字符 |\n| CH03 | description ≤150字符 | ✅/⚠️ | 英文在前、中文在后，总字符 ≤150，不用 `\\|` 分隔 |\n| CH04 | Changelog 格式 | ✅/⚠️ | 英文在前、中文在后，数字列表，正式语气 |\n| CH05 | Embedding 500 应急 | ✅/⚠️ | SKILL.md + references 均 ≤500 行，否则拆分 |\n| CH06 | 文件/模型分离 | ✅/⚠️ | 技能文件夹 ≤50MB，无模型/结果文件 |\n| CH07 | 版本号一致性 | ✅/⚠️ | `_meta.json` / changelog / 发布命令三处一致 |\n| CH08 | 对外表述顺序统一 | ✅/⚠️ | 所有双语表述均先英文后中文 |\n| CH09 | 坏符号链接 | ✅/⚠️ | 无失效符号链接 |\n| CH10 | 运行时产物 | ✅/⚠️ | 无 .pyc / .pyo / __pycache__ / .log |\n| CH11 | 目录隔离 | ✅/⚠️ | 无 .git / .DS_Store / Thumbs.db 等无关文件 |\n| CH12 | 英中文顺序检测 | ✅/⚠️ | display name 用 `\\|`、description 不用 `\\|`、changelog 先英后中 |\n\n**→ GitHub 目标时（GH01-GH06）：**\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| GH01 | git status | ✅/⚠️ | 无未提交变更 |\n| GH02 | 分支规范 | ✅/⚠️ | main/master 干净，commit 原子化 |\n| GH03 | commit 规范 | ✅/⚠️ | 英文在前、中文在后，简洁描述性 |\n| GH04 | Release Notes | ✅/⚠️ | 与 changelog 内容一致 |\n| GH05 | 文件完整性 | ✅/⚠️ | 无多余临时文件 |\n| GH06 | License | ✅/⚠️ | 含合适开源许可证或声明无许可证 |\n\n---\n\n### 发布命令\n\n```bash\nclawhub publish --slug --name \"\" --version --changelog \"\"\n```\n\n### 问题与修复（如有）\n\n- <检查项>: <具体问题> → <修复方案>（需用户「确认-」后执行）\n```\n\n---\n\n## 文件归属原则 | File Ownership\n\n> 项目文件遵循 `~/.openclaw/workspace/projects/README.md` 中定义的 SOP。\n\n| 文件类型 | 归属 |\n|---------|------|\n| 搜索 JSON / 索引文件 | paper-searcher-manager 项目 |\n| 文献全文 / PDF | 各自项目/分项目的 `literature/` 或 `papers/` |\n| 分析报告 / 结论性文档 | 分项目 `reports/` |\n| 原始数据 / 清洗后数据 | 分项目 `data/` |\n| 脚本 / 处理代码 | 分项目 `scripts/` |\n| Zotero 文献库 | paper-searcher-manager 项目 |\n\n**新建技能时**：同步在 `~/.openclaw/workspace/projects/` 下创建同名项目目录（遵循 projects/README.md 的三层 README 规范）：\n- **项目 README**（`projects//README.md`）：项目目标、结构、关键产出索引\n- **分项目 README**（如需要）：在项目下再建子目录 + 对应 README\n- **总项目 README**（`projects/README.md`）：通用规范，不含具体项目名称（仅在 projects 文件夹根目录存在一份）\n\n> 不制造孤岛：不要让文件躲在 README 解释不到的地方。\n\n---\n\n## 实用说明 | Practical Notes\n\n### 执行提示\n\n- 执行敏感操作前，用 `clawhub --help` 核对当前 CLI 行为\n- `skill-creator` 是底层规则权威来源\n\nFile v4.5.14:_meta.json\n\n{\n \"ownerId\": \"kn75k53tcdhqwka2fra5x817p9821zpb\",\n \"slug\": \"skill-manager-all-in-one\",\n \"version\": \"4.5.14\",\n \"publishedAt\": 1778319937817\n}\n\nFile v4.5.14:references/clawflows-workflow.md\n\n# ClawFlows Workflow Format Guide | ClawFlows Workflow 格式指南\n\n## Overview | 概述\n\nClawFlows 是一个多技能自动化流程市场，工作流以 YAML 文件定义，提交到 GitHub Registry 经 PR 审核后上线。\n\nWorkflow 与 Skill 的核心区别：\n- **Skill**：本地写好，`clawhub publish` 直接发布，即时生效\n**Workflow**：本地写好，需 fork registry 提 PR，等审核合并后才上线\n\n---\n\n## Two Formats | 两种格式\n\nEvery automation comes in two flavors: \n每个自动化都有两种格式：\n\n| Format | 用途 | Token 消耗 |\n|--------|------|-----------|\n| **Abstract（能力型）** | 跨平台可移植，描述需要哪些 capabilities | 0 |\n| **Lobster-Ready（直接运行型）** | 直接可跑，deterministic shell pipelines | 0 |\n\n---\n\n## File Structure | 目录结构\n\n```\nautomations//\n├── automation.yaml # Workflow 定义\n├── metadata.json # 搜索/展示元数据\n└── README.md # 文档（英中文双语）\n```\n\n---\n\n## automation.yaml | Workflow 定义\n\n```yaml\nname: my-workflow # 唯一标识，slug 格式（小写字母、数字、连字符）\ndescription: One-line description # 一行描述，用于搜索结果\nauthor: your-github-username\nversion: 1.0.0 # 语义化版本\n\nrequires:\n - capability: capability-name # 所需能力，非具体 skill 名\n\ntrigger:\n manual: true # manual=true 表示手动触发；或 schedule: \"0 9 * * *\"\n\nconfig:\n setting_name:\n description: \"用户可配置的设置项说明\"\n default: default_value\n required: false # 是否必填\n\nsteps:\n - name: step-name # 步骤名，唯一标识\n capability: capability-name\n method: methodName\n args:\n key: value\n capture: output_var # 捕获输出，供后续步骤使用\n```\n\n### Key Fields | 关键字段\n\n| 字段 | 说明 |\n|------|------|\n| `name` | URL-safe slug（小写、连字符）|\n| `requires[].capability` | 引用 capability，不写具体 skill 名 |\n| `trigger.schedule` | Cron 表达式，定时触发 |\n| `trigger.manual` | true 表示手动触发 |\n| `steps[].capture` | 捕获输出为变量，`${变量名}` 引用 |\n| `steps[].condition` | JavaScript 表达式，用于条件判断 |\n| `steps[].onFalse` | 条件为 false 时的动作（exit/skip/skip-to:step） |\n\n---\n\n## metadata.json | 元数据\n\n```json\n{\n \"name\": \"workflow-name\",\n \"description\": \"One-line description of what it does\",\n \"author\": \"your-github-username\",\n \"version\": \"1.0.0\",\n \"requires\": [\"capability-1\", \"capability-2\"],\n \"trigger\": \"schedule\",\n \"schedule\": \"0 9 * * *\",\n \"tags\": [\"tag1\", \"tag2\", \"tag3\"]\n}\n```\n\n---\n\n## README.md | 文档规范\n\n```markdown\n# Workflow Name | 工作流名称\n\nBrief description. 简短中文描述。\n\n## What It Does | 功能说明\n\nDetailed explanation of the workflow.\n\n## Requirements | 必要条件\n\n- **capability-name**: Description of what it provides.\n\n## Configuration | 配置项\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `setting` | Description | `default` |\n\n## Example Output | 输出示例\n\nScreenshots, sample notifications, or output examples.\n\n## Author\n\nCreated by [Your Name](https://github.com/username)\n```\n\n---\n\n## Local Install & Run | 本地安装与运行\n\n安装后路径：`~/.openclaw/workspace/automations//`\n\n常用命令：\n```bash\nclawflows install # 从 ClawFlows Registry 安装\nclawflows run # 运行\nclawflows run --dry-run # 预览（不实际执行）\nclawflows check # 检查所需 capabilities\nclawflows list # 列出已安装的工作流\nclawflows logs # 查看运行日志\n```\n\n---\n\n## Publishing Steps | 提交流程\n\n1. Fork [github.com/Cluka-399/clawflows-registry](https://github.com/Cluka-399/clawflows-registry)\n2. 在 fork 中创建 `automations//`\n3. 放入 `automation.yaml`、`metadata.json`、`README.md`\n4. Commit 并 Push 到 fork\n5. 提交 PR 到主仓库\n6. 等官方审核合并\n7. 合并后 GitHub Actions 自动重建 index，出现在 clawflows.com\n\n---\n\n## Capability Reference | 能力参考\n\n常用 capabilities：\n- `database` — 数据存储（SQLite）\n- `chart-generation` — 图表生成\n- `calendar` — 日历/日程\n- `tts` — 文字转语音\n- `notification` — 通知推送\n\nBrowse all: https://clawflows.com/capabilities/\n\n---\n\n## Naming Rules | 命名规则\n\n- **Slug**：小写字母、数字、连字符（无下划线和空格）\n - ✅ `douyin-manager`\n - ❌ `Douyin_Manager`\n- **Display name**：英文在前，中文在后\n - `Douyin Manager | 抖音管理者`\n- **Description**：一行，英文为主，中文辅助，控制在 150 字符内\n\n---\n\n## Writing Rules | 写作规范\n\n- **Abstract** 格式引用 capabilities，不写死具体 skill\n- **Config** 配置项让用户无需改代码即可自定义\n- **Bilingual**：README.md 使用英中文双语\n- **去标识化**：README.md 不暴露个人位置、姓名、API 密钥\n- **Approval Gates**：关键操作步骤用条件判断暂停，等用户确认\n\n---\n\n## Practical Experience Notes | 实践经验总结\n\nBased on real workflow creation (Bilibili Manager | B站管理者). 基于实际工作流创建经验。\n\n### Do Nots | 避免事项\n\n| Issue | Problem | Solution |\n|-------|---------|----------|\n| Runtime data in workflow file | Workflow 文件包含日志逻辑 | Runtime data belongs to user workspace, not workflow definition. 日志是运行时数据，存放在用户工作区，不在工作流定义中 |\n| Duplicate content | 描述重复（中英各写一遍然后又写一遍）| English and Chinese should complement each other, not repeat. 英文和中文应互补，不是重复 |\n| Changelog in workflow | 工作流文件包含更新日志 | Changelog belongs to PR/commit, not workflow file. 更新日志属于 PR/commit，不在工作流文件中 |\n| Embed skill logic | 工作流直接嵌入 skill 实现代码 | Workflow declares capabilities, skill provides implementation. 工作流声明 capabilities，skill 提供实现 |\n| Local paths in public docs | 文档写死本地路径 | Use relative or generic references. 使用相对路径或通用引用 |\n\n### Name & Description | 名称与描述\n\n```yaml\n# Good | 正确\nname: bilibili-manager\ndescription: \"Check DMs, browse content, auto-reply, heartbeat patrol. | B站管理者：私信管理、内容浏览、自动回复、心跳巡逻。\"\n\n# Avoid | 避免\nname: morois-bilibili-dm # Personal name | 个人名称\ndescription: \"B站私信管理器\" # Single language only | 只有单语言\n```\n\n### Skill Reference | Skill 引用\n\n```yaml\n# ===== Skill Reference | Skill 引用 =====\n# First check if already installed locally | 先检测本地是否已安装\n# If not installed: clawhub install bilibili-messager | 未安装则：clawhub install bilibili-messager\n# Operations follow the skill, workflow handles flow control | 具体操作以skill为准，工作流仅负责流程控制\n```\n\n### Workflow Structure | 工作流结构\n\n```yaml\n# ===== Workflow =====\nname: workflow-name\ndescription: \"English first | 中文描述\"\nversion: 1.0.0\n\nrequires:\n - capability: browser\n - capability: notification\n\nconfig:\n auto_mode:\n description: \"Auto mode: no confirmation needed | 自动模式：无需确认\"\n default: false\n\nsteps:\n # Stage 1: Preparation | 阶段1：准备\n # Stage 2: Execute core logic | 阶段2：执行核心逻辑\n # Stage 3: Report result | 阶段3：汇报结果\n```\n\n### Configuration Design | 配置设计原则\n\n| Principle | Description |\n|----------|-------------|\n| User intent detection | Parse user input to determine mode (manual/auto/heartbeat) |\n| Configurable intervals | Use minutes not seconds for heartbeat (e.g., 30, 60, 120) |\n| Clear defaults | Default to safest option (manual mode) |\n| Mode introduction | Auto-show mode guide on first run |\n\n### Bilingual Format | 双语格式规范\n\n**Title**: `English Name | 中文名`\n\n**Description**: English sentence first, then Chinese translation. 不要重复内容。\n```\nCheck DMs, browse content, auto-reply, heartbeat patrol. | B站管理者：私信管理、内容浏览、自动回复、心跳巡逻。\n```\n\n**Features table**:\n```markdown\n| Feature | Description | 功能 |\n|---------|-------------|------|\n| 📬 Check DM List | Get conversation list | 检查私信列表 |\n```\n\n**PR Description**:\n```markdown\n## Workflow Name | 工作流名称\n\nEnglish description first. | 中文描述。\n\n### Features | 功能说明\n| Feature | Description | 功能 |\n|---------|-------------|------|\n```\n\n### Git Commit & PR | Git 提交与 PR\n\n```bash\n# Commit message\ngit commit -m \"feat: add workflow-name | 工作流名称\"\n\n# PR title\ngh pr create --title \"feat: workflow-name | 工作流名称\"\n```\n\n### Publishing Checklist | 发布检查清单\n\n- [ ] Name is URL-safe slug | 名称是 URL 安全的 slug\n- [ ] Description is bilingual | 描述是双语的\n- [ ] README.md is full bilingual | README.md 是完整双语的\n- [ ] No runtime data in workflow file | 工作流文件不包含运行时数据\n- [ ] No local paths in public docs | 公开文档不含本地路径\n- [ ] No personal names/keys | 无个人名称/密钥\n- [ ] Skill reference mentions local-check-first | Skill 引用提到先检测本地\n- [ ] Config descriptions are bilingual | 配置描述是双语的\n- [ ] YAML syntax validated | YAML 语法已验证\n\nFile v4.5.14:references/clawhub-publish.md\n\n# ClawHub Publish Reference | ClawHub 发布参考\n\n> 本文件是 SKILL.md 的发布操作补充，承上启下。两步验证的完整原则见 SKILL.md Phase 2 步骤 2。\n\n---\n\n## 发布前检查（两步验证第一步）\n\n### A. 完整清单核对\n\n对照 SKILL.md 第 6 章【统一检查清单】逐项执行：\n\n**通用质量基线（G01-G06）+ ClawHub 专项（CH01-CH12）**逐项标注 ✅ / ⚠️。\n\n### B. 脚本安全检查（如技能含 Python/Bash 等脚本）\n\n| 检查要点 | 说明 |\n|---------|------|\n| 输入校验 | 用户输入是否经过验证和过滤，避免直接拼接到命令或路径中 |\n| 权限最小化 | 是否遵循最小权限原则，无过度权限申请 |\n| 凭据保护 | API Key、Token 等敏感信息不出现在日志、报错、返回值中 |\n| 依赖完整性 | 代码 import 的包是否全部出现在 requirements.txt / package.json 中 |\n\n### C. 文件大小检查\n\n```bash\ndu -sh \n```\n\n**超过 50MB 必须处理：**\n- 立即报告用户\n- 将模型/大文件临时移出，等待上传成功后再移回\n- 等待用户明确指示后再操作\n\n### D. 对外表述检查（ClawHub 目标）\n\n- `name`：先英文后中文，`EN Title | 中文标题`\n- `description`：先英文后中文，≤150字符，英文短句在前\n- Changelog：先英文后中文，数字列表，正式语气\n- README 关键标题：先英文后中文\n\n### E. 拟定 Changelog\n\n通过 `--changelog \"...\"` 参数传入，不写在 SKILL.md 里：\n\n```\n1. [English update]. [中文更新]。\n2. [English update]. [中文更新]。\n```\n\n---\n\n## 第二步用户汇报内容（必须全部列出）\n\n| 汇报项 | 内容 |\n|--------|------|\n| Display name | 双语格式 `EN Title | 中文标题` |\n| Skill slug | 小写字母 + 连字符 |\n| description | 先英文后中文，≤150字符 |\n| 目标平台 | ClawHub |\n| 当前版本 | 来自 `clawhub inspect ` |\n| 新版本号 | 在已发布版本上递增 |\n| Changelog | 完整英中文双语内容 |\n| 文件大小 | 超过50MB需特别标注 |\n| 核对清单结果 | G01-G06 + CH01-CH12，逐项 ✅ / ⚠️ |\n| 有⚠️项时的问题与解决方案 | 说明问题 + 修复方案 |\n| **发布命令** | `clawhub publish ...` 完整命令 |\n\n**⚠️ 确认前不得执行任何发布类命令。确认标志：用户回复「确认-」。**\n\n---\n\n## CLI 命令\n\n优先使用 PATH 中的 `clawhub`。若不存在，先尝试 OpenClaw 托管路径：\n\n```bash\nCLAWHUB_BIN=$(command -v clawhub || true)\nif [ -z \"$CLAWHUB_BIN\" ] && [ -x \"$HOME/.openclaw/tools/node/npm/bin/clawhub\" ]; then\n CLAWHUB_BIN=\"$HOME/.openclaw/tools/node/npm/bin/clawhub\"\nfi\n[ -n \"$CLAWHUB_BIN\" ] || { echo \"clawhub command not found\"; exit 1; }\n```\n\n### 发布命令\n\n```bash\n\"$CLAWHUB_BIN\" publish \\\n --slug \\\n --name \"EN Title | 中文标题\" \\\n --version \\\n --changelog \"\"\n```\n\n**⚠️ 双语展示名必须显式传 `--name`，不能只依赖 _meta.json 或 SKILL.md 自动同步。**\n\n### 管理命令\n\n```bash\n\"$CLAWHUB_BIN\" delete --yes # 软删除（两步验证后才可执行）\n\"$CLAWHUB_BIN\" hide --yes # 隐藏（两步验证后才可执行）\n\"$CLAWHUB_BIN\" unhide --yes # 恢复\n\"$CLAWHUB_BIN\" undelete --yes # 取消删除\n\"$CLAWHUB_BIN\" sync\n```\n\n> `--yes` 是 CLI 必需参数。所有破坏性操作均要求用户先通过两步验证。\n\n### Inspect 命令\n\n```bash\n\"$CLAWHUB_BIN\" inspect # 基本信息\n\"$CLAWHUB_BIN\" inspect --tag latest # 最新版本\n\"$CLAWHUB_BIN\" inspect --version X.Y.Z # 指定版本\n\"$CLAWHUB_BIN\" inspect --versions --limit 20 # 版本历史\n\"$CLAWHUB_BIN\" inspect --files # 文件列表\n\"$CLAWHUB_BIN\" inspect --file SKILL.md # 查看文件内容\n\"$CLAWHUB_BIN\" inspect --json # 元数据 JSON\n```\n\n### 登录状态\n\n```bash\n\"$CLAWHUB_BIN\" whoami # 确认登录状态\n\"$CLAWHUB_BIN\" login # 未登录时执行\n```\n\n---\n\n## 核心规则要点\n\n### Display name 双保险\n\nClawHub 页面标题由发布记录的 display-name 控制。双语名必须两处一致：\n\n1. `SKILL.md` YAML frontmatter：`name: EN Title | 中文标题`\n2. 发布命令：`--name \"EN Title | 中文标题\"`\n\n实测仅改 `name:` 或 `_meta.displayName` 更新版本时，ClawHub 顶部展示名可能不会同步中文。\n\n### ClawHub Summary 规则\n\n本地源字段是 SKILL.md frontmatter `description`。发布后 ClawHub 将其作为 registry `summary` 暴露，CLI 打印为 `Summary:`。\n\nClawHub 预览区域很短：即使英文在前，只要英文太长，中文仍可能被截断。双语技能应让英文短句在前，中文紧随其后：\n\n```yaml\ndescription: \"TTS helper. TTS 朗读助手；支持文本转语音，长文本自动分段。\"\n```\n\n发布后同时复验 `Latest:` 和 `Summary:`，不要只看版本号。\n\n### 版本冲突\n\n如果发布失败并提示 `Version already exists`，应先与用户确认，再升版本号重新发布。\n\n### 发布后扫描状态\n\n发布后立即 `inspect` 可能提示安全扫描中、技能暂时隐藏。这是临时状态，不是发布失败。短暂等待后再次 inspect，直到能看到最新版本和摘要。\n\n---\n\n## 安全扫描结果查看步骤\n\n1. 打开 ClawHub 技能页面（如 `https://clawhub.ai//`）\n2. 找到 **Security Scan** 区域\n3. 找到 **OpenClaw** 徽章旁边的 **Details ▾** 按钮\n4. 点击 **Details ▾** 展开才能看到完整 Assessment（包含 Purpose、Install Mechanism、Credentials 等逐项评估）\n\n⚠️ Summary 只是一句话概括，**必须展开 Details 才能看到完整 Assessment**。\n\n完整汇报格式见 SKILL.md「安全扫描说明」章节的 SOP 模板。\n\n---\n\n*本文件职责：发布操作细节（检查步骤 + 汇报内容 + 命令速查 + 规则要点），配合 SKILL.md 流程骨架使用。*\n---\n\n## Inspect 命令参考 | Inspect Reference\n\n### 工具选择原则\n\n**先查 CLI help，再决定用 CLI 还是 Dashboard。** CLI 会持续更新，不要假设某个命令永远不变。\n\n| 场景 | 用 CLI 还是 Dashboard |\n|------|----------------------|\n| 查看全部已发布技能 | Dashboard |\n| 查看卡片摘要 | Dashboard |\n| 查看扫描状态和概览 | Dashboard |\n| 单个技能详情 | CLI |\n| 当前最新版本 | CLI |\n| 文件列表 | CLI |\n| 元数据直接查询 | CLI |\n| 可重复检查 / 脚本化流程 | CLI |\n\n### 常用 Inspect 命令\n\n```bash\nclawhub --help # 先查当前 CLI 行为\nclawhub whoami # 确认登录状态\nclawhub inspect # 查看单个技能详情\nclawhub inspect --tag latest\nclawhub inspect --version 1.0.0\nclawhub inspect --versions --limit 20\nclawhub inspect --files\nclawhub inspect --file SKILL.md\nclawhub inspect --json\n```\n\n### 本地目录 vs CLI list 的区别\n\n手工复制进 `~/.openclaw/workspace/skills/` 的技能，可能本地存在但仍不会出现在 `clawhub list` 中。\n\n- `clawhub list` 是 CLI lockfile 视角，不等于扫描目录下的所有文件夹\n- 需要时，两个检查都要做\n\n### 登录说明\n\n浏览器登录和 CLI 登录是两套状态。如果 CLI 提示 `Not logged in`：\n\n```bash\nclawhub login\nclawhub whoami\n```\n\n### 状态含义\n\n| 状态 | 含义 |\n|------|------|\n| `Scanning` | 安全扫描进行中 |\n| `Pending` | 结果尚未完全稳定 |\n| `Benign` | 基本通过扫描 |\n| `Suspicious` | 需要人工复核 |\n| `Hidden` | 当前不公开显示 |\n\nFile v4.5.14:references/github-publish.md\n\n# GitHub 上传专项 | GitHub Publishing Guide\n\n本文件定义技能通过独立 GitHub 仓库发布的操作规范。\n\n## 适用场景\n\n- 技能有独立的 GitHub 仓库\n- 非 ClawHub 平台发布（如个人仓库、GitHub Pages 等）\n- 需与 ClawHub 发布流程区分\n\n## 发布前准备（对照 SKILL.md 第 6 章清单）\n\n发布 GitHub 前，逐项核对 SKILL.md 中的通用质量基线（G01~G06）和 GitHub 专项（GH01~GH06）：\n\n| 项目 | 内容 |\n|------|------|\n| G01 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 安全性 | 无代码安全风险（输入校验、权限最小化） |\n| G03 逻辑科学性 | 结构清晰、路径准确、模块化 |\n| G04 AI 可读性 | agent 可理解、上下文连贯 |\n| G05 易维护性 | 代码整洁、注释到位 |\n| G06 依赖声明 | 外部包/工具/密钥已声明，无硬编码 |\n| GH01 文件结构 | 符合 Skill 目录体系（SKILL.md 在根目录） |\n| GH02 README | 英中文双语，有安装/使用说明 |\n| GH03 Commit 规范 | 英文在前、中文在后，格式正确 |\n| GH04 Release Notes | Markdown 格式，结构清晰 |\n| GH05 无敏感信息 | 无 API Key、Token、内部路径 |\n| GH06 权限隔离 | 无过度文件权限、无不必要的管理脚本 |\n\n**若涉及多语言 README 或多文件修改：逐个修改，逐个确认。**\n\n## 两步验证流程（对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n### 第一步（AI 内部执行，不输出给用户）\n\n- 对照清单全部项（G01~G06 + GH01~GH06），逐项标注 ✅ / ⚠️\n- 检查文件大小（>50MB 需报告）\n- 拟定 Commit Message（英文在前，中文在后）\n- 检查 `git status`，列出所有未提交的变更\n- 若有未提交变更，列出文件名，等待用户确认后再处理\n\n### 第二步（输出给用户，等待明确确认）\n\n⚠️ **未经用户明确确认，不得执行 `git push` / `gh release create` 等任何发布类命令。**\n\n向用户汇报以下全部内容：\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前状态 | 已修改未提交 / 已提交未推送 |\n| 未提交文件 | 列出所有变更文件 |\n| Commit Message | 拟定的提交信息 |\n| 核对清单结果 | G01~G06 + GH01~GH06，✅ / ⚠️ 标注 |\n| 文件大小 | 是否超 50MB |\n| 问题说明 | 有 ⚠️ 项时，说明具体问题 |\n| 解决方案 | 针对 ⚠️ 项的修复方案 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n## 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n获得用户确认后，执行以下命令：\n\n```bash\n# 1. 进入仓库目录\ncd \n\n# 2. 添加所有变更\ngit add -A\n\n# 3. 提交（英文在前，中文在后）\ngit commit -m \"[English message]. [中文信息]。\"\n\n# 4. 推送到远程\ngit push\n```\n\n## Commit Message 规范\n\n- 英文在前，中文在后\n- 正式发布语气\n- 禁止：个人纠错、格式调整、私人调试记录、玩笑、道歉式表述\n- 示例：`fix: 修复徽章HTML兼容性问题，清理各语言版本中文残留`\n\n## 安全约束\n\n1. **严禁擅自上传** — 未获用户明确确认前不得执行 `git push`\n2. **汇报当前状态** — 每次修改后必须汇报状态（已修改/未提交/已上传）\n3. **等待电子签名** — 用户回复「确认-」后才执行 push\n\n## Git 状态检查命令\n\n```bash\n# 查看当前状态\ngit status\n\n# 查看变更统计\ngit diff --stat\n\n# 查看完整变更内容\ngit diff\n\n# 查看提交历史\ngit log --oneline -5\n```\n\n## 常见问题处理\n\n### 有未提交的变更\n\n用户要求上传前，先检查 `git status`：\n- 如有未提交的变更，必须在汇报中列出\n- 等待用户确认后再 add/commit/push\n\n### 远程分支落后\n\n```bash\n# 先拉取最新\ngit pull --rebase\n\n# 再推送\ngit push\n```\n\n### 冲突处理\n\n1. 报告用户存在冲突\n2. 等待用户指示如何解决\n3. 不得强制覆盖远程分支\n\n## GitHub Release 专项 | GitHub Release Guide\n\n创建 GitHub Release 同样需要两步验证。Release Notes 是对外展示的正式说明，必须符合规范。\n\n### 何时需要创建 Release\n\n- 首次正式发布版本（如 v1.0.0）\n- 重要版本更新\n- 用户明确要求创建 Release\n\n### Release Notes 规范\n\n**格式**：Markdown 语法，结构清晰\n**内容**：\n- 标题（版本号 + 简短描述）\n- 变更说明（功能/修复/优化）\n- 技术规格（如适用）\n- 安装方式（如适用）\n\n**禁止**：\n- 个人调试记录\n- 道歉式表述\n- 不完整的描述\n\n### 两步验证流程（Release，对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n#### 第一步（AI 内部执行，不输出给用户）\n\n- 检查 git tag 列表，确认版本号未冲突\n- 拟定 Release Notes（英文在前，中文在后）\n- 检查变更内容是否与 Commit History 一致\n\n#### 第二步（输出给用户，等待明确确认）\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前 tag | 已有 tag 列表 |\n| 新版本号 | 如 v1.0.0 |\n| Release Notes | 拟定的正式说明 |\n| 变更内容 | 列出主要变更 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式）才可执行。\n\n#### 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n```bash\n# 1. 创建 tag（如尚未创建）\ngit tag -a -m \"\"\n\n# 2. 推送 tag\ngit push origin \n\n# 3. 使用 gh 创建 Release\ngh release create \\\n --title \"<标题>\" \\\n --notes \"\" \\\n --target \n```\n\n### Release Notes 示例\n\n```markdown\n## What's New\n\n**Skill Name** — 简短描述\n\n基于 xxx，为用户提供 yyy 功能。\n\n### 功能更新\n- 新增 xxx 功能\n- 优化 xxx 体验\n- 修复 xxx 问题\n\n### 技术规格\n- 版本：1.0.0\n- 支持平台：xxx\n- 依赖：xxx\n\n### 安装方式\n```bash\nxxx install command\n```\n```\n\n### 验证命令\n\n```bash\n# 查看已创建的 Release\ngh release list\n\n# 查看特定 Release 详情\ngh release view \n\n# 更新 Release Notes\ngh release edit --notes \"<新内容>\"\n```\n\n## 与 ClawHub 的区别\n\n| 维度 | ClawHub | GitHub（独立仓库） |\n|------|---------|-------------------|\n| 平台 | clawhub CLI | git + gh CLI |\n| 版本管理 | clawhub 内部管理 | git tag + Release |\n| 验证方式 | `clawhub inspect` | `git log` + `gh release list` |\n| 发布命令 | `clawhub publish` | `git push` + `gh release create` |\n| 对外说明 | Changelog | Release Notes |\n| 适用场景 | 技能市场分发 | 独立项目/文档站 |\n\nFile v4.5.14:references/promotion.md\n\n# Promotion Guide | 宣传指南\n\nAll skill promotion on social platforms (Moltbook, 抓虾吧, etc.) must follow this guide.\n所有技能推广（社交平台发帖等）必须遵循本指南。\n\n---\n\n## 主文件与分文件职责分工 | File Responsibilities\n\n| 文件 | 职责 |\n|------|------|\n| **SKILL.md（主文件）** | 核心原则、流程骨架、清单元摘要、reference 文件索引 |\n| **promotion.md（本文件）** | 推广专项完整操作指南：两步验证、AI心理学、排版格式、去标识化、数据时效 |\n\n> 本文件为 SKILL.md 的推广专项补充。重大流程变更须同步更新 SKILL.md 清单元摘要。\n\n---\n\n## 推广两步验证流程 | Two-Step Promotion Verification\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。推广发帖、编辑、重新发布均需两步验证。**\n\n### 第一步（AI 内部执行，不输出给用户）\n\n**A. 内容清单核对 | Content Checklist**\n\n| 检查项 | 说明 |\n|--------|------|\n| 去标识化 | 无个人位置/姓名/内部路径/API密钥/Token |\n| 数据时效 | 注明统计截止日期 |\n| 链接准确性 | 链接为完整 URL，非截断或猜测 |\n| 安装命令准确性 | 使用 `clawhub install `，非猜测 |\n| 版本号准确性 | 来自 `clawhub inspect `，非猜测 |\n| 平台格式合规 | Moltbook 使用双语交替格式 |\n\n**B. AI 心理学吸引力检查 | AI Psychology Appeal Checklist**\n\n| 检查项 | 说明 |\n|--------|------|\n| 开头有共鸣点 | 开头能否在 3 秒内引起 AI 读者兴趣？ |\n| 差异化价值 | 技能相比同类有什么独特优势？ |\n| 具体性 | 避免泛泛而谈，有具体数字/功能/场景？ |\n| 行动号召 | 结尾是否有明确的安装/了解更多指引？ |\n| 双语比例 | 英文信息量充足，不依赖中文翻译撑场面？ |\n| 格式呼吸感 | 无大段堆砌，emoji/分段有节奏？ |\n\n**C. 去标识化详细检查 | De-identification Detailed Checklist**\n\n| ❌ 禁止内容 | ✅ 允许内容 |\n|-----------|-----------|\n| 城市/省份/具体国家 | \"中国\"（泛指可）、省略 |\n| 个人姓名 | \"my human\" / \"morois\"（如以品牌身份推广可写） |\n| 本机 API Key / Token | 不提及 |\n| 内部路径如 `~/.openclaw/workspace/` | 不提及 |\n| 私人邮箱/手机号 | 不提及 |\n| 私人项目代号 | 使用公开的技能 slug |\n\n### 第二步（输出给用户，等待明确确认）\n\n**⚠️ 未经用户明确确认，不得在社交平台发帖、编辑或重新发布。**\n\n向用户汇报以下内容，**必须等用户明确确认后才能发帖**：\n\n| 汇报项 | 内容 |\n|--------|------|\n| 推广平台 | Moltbook / 抓虾吧 / 其他 |\n| 推广类型 | 单技能 / 多技能联合 |\n| 目标受众 | Moltbook AI agents / 其他 |\n| 正文全文 | 完整推广文案 |\n| 数据来源与截止日期 | 各技能安装量/星标数及截止日期 |\n| 链接与安装命令 | 确认准确 |\n| AI 心理学自查结果 | 通过/需调整 |\n| 去标识化自查结果 | 通过/需调整 |\n| 平台格式合规自查 | 通过/需调整 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n---\n\n## 平台格式规范 | Platform Format Rules\n\n### Moltbook 推广格式 | Moltbook Post Format\n\n所有 Moltbook 帖子必须使用**双语交替格式**（一句英文一句中文）：\n\n```\n[English sentence] [中文句子][English sentence] [中文句子]\n[English sentence] [中文句子][English sentence] [中文句子]\n```\n\n**单技能推广模板：**\n\n```\n**Skill Name | 技能名** (vX.Y · N installs · ★N)\nShort concrete English pitch. 简短中文说明。\n\nWhat it does: 一句话功能描述\nInstall: clawhub install \nhttps://clawhub.ai//\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n**多技能联合推广模板：**\n\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nmorois and I have published X skills on ClawHub. 截至 YYYY-MM-DD：\n\n📊 Stats | 数据：\n🎙️ Skill A — N installs · ★N · One-line description. 简短中文。\n🔊 Skill B — N installs · ★N · One-line description. 简短中文。\n…（每个技能一行，emoji + name + stats + 英文/中文各一句）\n\nInstall any: clawhub install \nBrowse all: clawhub.ai/\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n---\n\n## 数据时效性要求 | Data Freshness Requirements\n\n- 所有安装量/星标数必须注明**截止日期**\n- 格式：`截至 YYYY-MM-DD 的数据`\n- 每次发布推广前必须重新确认最新数字（通过 `clawhub inspect` 或 ClawHub 页面）\n- 不得使用超过 **30 天**的旧数据\n\n---\n\n## AI 心理学吸引力原则 | AI Psychology Appeal Principles\n\n**1. 开场共鸣（3秒法则）**\n- 第一句话要让 AI 觉得\"这和我有关\"或\"这很有趣\"\n- 避免空洞开场如 \"Hello everyone\" → 改用具体场景或问题切入\n\n**2. 差异化价值主张**\n- 不要只说\"这是个很棒的技能\"\n- 说清楚**相比其他同类工具的优势**：免费/本地运行/无API费用/更强安全/跨平台\n\n**3. 具体性 > 泛化**\n- ❌ \"A useful tool for everyone\" → 泛泛而谈\n- ✅ \"Offline Whisper STT — no API costs, your audio never leaves your machine\" → 具体价值\n\n**4. 社会认同**\n- 有安装量/星标数要突出显示（同伴认可）\n- 数字本身就是信任信号\n\n**5. 行动号召（CTA）**\n- 每篇结尾必须有明确行动：安装命令 / 访问链接 / 提问邀请\n- 不要让读者\"然后呢\"\n\n**6. 结尾钩子**\n- 以问题结尾，引发评论互动\n- \"What are you building?\" / \"What's your take on this?\" / \"Curious what others think\"\n\n---\n\n## 推荐格式示例 | Suggested Format Examples\n\n**单技能：**\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nJust released Speech Transcriber on CltHub — offline Whisper STT that never sends your audio to the cloud. 我发布了一个离线 Whisper 语音转文字工具，音频永远不离开你的机器。\n\n🎙️ 100% local inference, no API costs, fully offline. 纯本地推理，无 API 费用，完全离线。\n🛡️ Privacy-first: audio stays on your machine. 隐私优先：音频留在本地。\n\nTry it: clawhub install speech-transcriber\nhttps://clawhub.ai//speech-transcriber\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n**多技能联合（更正式）：**\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nmorois and I have published 7 skills on ClawHub. 截至 2026-04-05：\n\n📊 Stats | 数据：\n🎙️ Speech Transcriber — 11 installs · Local Whisper or OpenAI API STT, fully offline. 纯本地 Whisper，隐私安全。\n🔊 Speech Synthesizer — 60 installs · edge-tts (free offline neural TTS) or OpenAI API TTS. 微软 TTS 免费离线。\n📹 Camera YOLO Operator — 120 installs · YOLO detection + depth estimation on your webcam. 摄像头目标检测+景深。\n💬 AI Socializer — 29 installs · Patrol Moltbook & more, API key hardlocked to www.moltbook.com. 社交巡逻，密钥铁律。\n💼 Skill Manager — 870 installs · Two-step publish workflow and checklist. 技能全流程。\n📺 Bilibili Messager — 654 installs · Browser-automation DM for Bilibili. B站私信。\n📱 Douyin Messager — 1.9k installs · ★9 · Browser-automation DM for Douyin. 抖音私信。\n\nInstall any: clawhub install \nBrowse all: clawhub.ai/\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n---\n\n## Reminder | 提醒\n\n- Promotion copy may be more lively than changelog copy, but changelog text itself must stay formal.\n 宣传文案可以比 changelog 略活，但 changelog 本身必须保持正式。\n- Two-step verification applies to every promotion action, including edits and repromotions.\n 两步验证适用于所有推广操作，包括修改和重新发布。\n\nFile v4.5.14:references/search-and-audit.md\n\n# Search and Audit Guide | 搜索与审计指南\n\n## Search workflow | 搜索流程\n\n1. Check local formal skills first. \n 先检查本地正式技能。\n2. Check built-in skills if relevant. \n 如有需要，再检查内置技能。\n3. Search ClawHub only when local options are insufficient. \n 只有在本地选项不足时才搜索 ClawHub。\n4. Let the user choose before install or replacement. \n 在安装或替换前，让用户做选择。\n\n## Search commands | 搜索相关命令\n\n```bash\nclawhub search \nclawhub inspect \nclawhub list\nclawhub uninstall \nclawhub star \nclawhub unstar \n```\n\n## Audit mindset | 审计思路\n\nBefore recommending install or update, check: \n在推荐安装或更新前，检查：\n- overlap with existing local skills \n 是否与现有本地技能功能重叠\n- whether the skill is actively maintained \n 技能是否还在持续维护\n- whether the skill description matches the user's real need \n 技能描述是否真的匹配用户需求\n- whether sensitive or risky behavior needs review \n 是否存在需要额外审查的敏感或高风险行为\n\n## Output style | 输出风格\n\nGive the user a short comparison: \n给用户一个简短对比：\n- recommended \n 推荐\n- possible alternative \n 可选替代\n- not recommended \n 不推荐\n\nKeep recommendations concrete. \n建议必须具体，不要空泛。\n\nFile v4.5.14:skill-card.md\n\n## Description:\n\nManages OpenClaw skills end to end across creation, modification, publishing, updating, versioning, promotion, and audit workflows.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[moroiser](https://clawhub.ai/user/moroiser)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nOpenClaw skill authors and maintainers use this skill to create, modify, publish, update, promote, and audit skills while keeping versioning, review checklists, and confirmation gates explicit.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can guide broad edits to persistent OpenClaw memory and workspace files.\n\nMitigation: Require exact diffs and separate approval before editing MEMORY.md, memory/*.md, TOOLS.md, or other persistent workspace records.\n\nRisk: Promotion templates may contain hard-coded attribution that is not appropriate for every publisher.\n\nMitigation: Replace any fixed attribution with the approved author or omit attribution before public promotion.\n\nRisk: Publishing, renaming, release, deletion, and promotion workflows can make persistent local or external changes.\n\nMitigation: Show the exact command and wait for the required confirmation signature before executing external or destructive operations.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/moroiser/skills/skill-manager-all-in-one)\n- [ClawHub Publish Reference | ClawHub 发布参考](references/clawhub-publish.md)\n- [GitHub Publishing Guide | GitHub 上传专项](references/github-publish.md)\n- [Search and Audit Guide | 搜索与审计指南](references/search-and-audit.md)\n- [Promotion Guide | 宣传指南](references/promotion.md)\n- [ClawFlows Workflow Format Guide | ClawFlows Workflow 格式指南](references/clawflows-workflow.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands, checklists, and release text]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include exact commands, diffs, changelogs, checklist statuses, and confirmation prompts.]\n\n## Skill Version(s):\n\n4.5.14 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v4.5.13: 9 files, 33960 bytes\n\nFiles: _meta.json (144b), references/clawflows-workflow.md (9610b), references/clawhub-inspect.md (3284b), references/clawhub-publish.md (13369b), references/github-publish.md (6799b), references/promotion.md (8233b), references/rename-workflow.md (7531b), references/search-and-audit.md (1411b), SKILL.md (21999b)\n\nFile v4.5.13:SKILL.md\n\n---\nname: Skill Manager All In One | 一站式技能管理器\ndescription: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。\nmetadata: {\"openclaw\":{\"requires\":{\"bins\":[\"git\",\"gh\"]},\"runtime\":{\"requiredBinaries\":[\"clawhub\",\"git\",\"gh\"],\"credentialExpectations\":[\"ClawHub CLI login/session for publish/delete/hide/unhide/sync\",\"Git/GitHub CLI authentication for GitHub workflows\"],\"filesystemWrites\":[\"~/.openclaw/workspace/skills//\",\"~/.openclaw/workspace/projects//\",\"~/.cache/huggingface/modules//\"],\"externalWrites\":[\"clawhub publish/delete/hide/unhide/sync\",\"git push\",\"gh release create\"],\"confirmation\":\"Show exact commands and wait for the user to reply with an explicit \"确认-\" electronic signature before any publish, delete, push, move, overwrite, or other writes. Do NOT proceed without this signature.\"}}}\n---\n\n# Skill Manager All In One | 一站式技能管理器\n\n## Runtime Expectations | 运行依赖与权限声明\n\nThis skill may guide an agent to inspect, create, edit, move, publish, or audit OpenClaw skill files. It is not a passive documentation-only skill.\n本技能可能指导 agent 检查、创建、编辑、移动、发布或审计 OpenClaw 技能文件；它不是只读文档型技能。\n\n### Required binaries | 所需命令行工具\n\nDeclare and verify these before any publish or external write:\n发布或外部写入前，必须声明并验证以下工具：\n\nThese requirements must be declared in SKILL.md frontmatter `metadata` as well as in the body text. ClawHub/security scanners read metadata, not only prose.\n这些要求必须同时写入 SKILL.md frontmatter `metadata` 和正文说明。ClawHub/安全扫描器会读取 metadata，不只读取正文。\n\n| Tool | Used for | Verify command |\n|------|----------|----------------|\n| `clawhub` | ClawHub skill inspect/publish/delete/hide/unhide/sync | `clawhub --help` or `~/.openclaw/tools/node/npm/bin/clawhub --help` |\n| `git` | Git status/commit/log/revert workflows | `git --version` |\n| `gh` | GitHub release/PR workflows, only when target platform is GitHub | `gh --version` |\n\n### Credentials and authentication | 凭据与授权\n\n- ClawHub publishing requires an authenticated ClawHub session/token.\n ClawHub 发布需要已登录的 ClawHub 会话/token。\n- GitHub publishing requires Git/GitHub authentication and may use `gh` credentials.\n GitHub 发布需要 Git/GitHub 授权，可能使用 `gh` 凭据。\n- Do **not** ask the user to paste long-lived secrets into chat. Prefer existing CLI login/session state.\n 不要要求用户在聊天中粘贴长期密钥；优先使用已有 CLI 登录态。\n- Before running credential-using commands, print the exact command and wait for the user to reply with \"确认-\" electronic signature.\n 执行会使用凭据的命令前，必须打印精确命令并等待用户回复「确认-」电子签名。\n\n### Filesystem scope and write risks | 文件系统范围与写入风险\n\nThis skill may operate on:\n本技能可能操作：\n\n- `~/.openclaw/workspace/skills//` — skill source files only.\n 仅放技能源文件。\n- `~/.openclaw/workspace/projects//` — runtime files, outputs, reports, and project data.\n 放运行文件、输出、报告和项目数据。\n- `~/.cache/huggingface/modules//` — model files.\n 放模型文件。\n\nNever move, delete, overwrite, publish, push, or otherwise mutate files without first showing the planned paths and commands and receiving \"确认-\" electronic signature.\n移动、删除、覆盖、发布、推送或其他写入操作前，必须先展示计划路径和命令，并获得「确认-」电子签名授权。\n\n### Dry-run first | 优先 dry-run / local-test\n\nFor high-impact changes, start in `local-test` mode: inspect files, produce a planned command list, and stop before mutation or publication.\n高影响变更先进入 `local-test`：只检查文件、生成拟执行命令列表，在真正写入或发布前停止。\n\n## 模式 | Mode\n\n> 读取本 SKILL.md 后，先确认当前任务属于哪种模式，再跳转对应章节执行。\n\n| 模式 | 说明 |\n|------|------|\n| **create** | 从零创建新技能 |\n| **modify** | 修改已发布技能（升版/功能调整） |\n| **audit** | 审计本地或已发布技能的质量、逻辑、声明完整性 |\n| **local-test** | 仅本地测试，不发布 |\n\n---\n\n## 核心原则 | Core Rules\n\n1. **Local first, network second** — 先检查本地已安装技能，再搜索网络。\n2. **Be concrete** — 汇报时写清楚准确路径、准确命令、准确版本变化。\n3. **One by one, confirm one by one** — 涉及多个文件/版本/技能时，必须逐个处理、逐个确认。每项确认都必须获得「确认-」格式的电子签名授权，禁止批量操作。\n4. **Publish like a product** — 发布文本应像正式发布说明，而非聊天记录。\n5. **For AI and humans** — 技能正文应兼顾 agent 与人类可读性。\n6. **English first, Chinese second** — 对外展示文本统一先英文后中文；包括 `name`、SKILL.md frontmatter `description`（发布到 ClawHub 后显示为 registry `summary` / CLI `Summary:`）、Changelog、README 关键标题与核心段落。中文不能因英文过长而被预览截断。\n7. **Learn from release evidence** — 发布流程规则来自真实发布证据；新增检查项前先确认它能防止具体失误，而不是堆砌流程。\n\n---\n\n## 技能制作流程 | Phase 1: Create / Modify\n\n> 按顺序执行，边做边对照第 6 章「统一检查清单」的【通用质量基线】。\n\n### 步骤 1：明确需求\n\n确定以下四项，作为后续所有操作的依据：\n\n- **目标平台**：ClawHub / GitHub / 其他\n- **版本号**：首次发布为 `1.0.0`\n\n> ⚠️ Display name 和 Skill slug 是 ClawHub 专属概念，若目标平台为 ClawHub，请在 Phase 2 步骤 1 确认。\n\n### 步骤 2：创建目录结构\n\n参考第 7 章「技能目录体系」，在正式技能目录创建技能文件夹。\n\n```\n~/.openclaw/workspace/skills//\n```\n\n### 步骤 3：编写 SKILL.md\n\n按本技能的主模板编写 SKILL.md（参考 Phase 1 步骤 1 确认的平台需求）。\n\n### 步骤 4：边做边查——对照清单\n\n每完成一个文件或代码块，立即对照第 6 章【通用质量基线】逐项打勾。\n\n**目标平台已确定时，附加对应平台专项（ClawHub → CH01-CH11，GitHub → GH01-GH06）。**\n\n> 如 Phase 1 已逐项打勾通用基线，Phase 2 只需复核 + 补充平台专项，不必重复全量检查。\n\n---\n\n## 技能发布验证流程 | Phase 2: Publish\n\n> 必须完成 Phase 1 后才能执行本阶段。\n\n### 步骤 1：确认基本信息 & 复查清单\n\n**ClawHub 目标时，先确认以下两项：**\n- **Display name**：`EN Title | CN Title` 双语格式（对应 CH01）\n- **Skill slug**：小写字母 + 连字符，如 `speech-synthesizer`\n\n**然后复查清单：**\n- 对照第 6 章【通用质量基线】全部项（G01-G06）\n- 根据目标平台，额外核对【平台专项】（ClawHub → CH01-CH11，GitHub → GH01-GH06）\n- 逐项标注 ✅ / ⚠️，有问题的立即修复\n\n### 步骤 2：⚠️ 两步验证（强制，必须执行）\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。**\n\n#### 第一步（AI 内部执行，不输出给用户）\n- 核对清单（G01-G06 + 对应平台专项）\n- 检查文件大小（>50MB 需报告）\n- ClawHub 目标时检查对外表述：`name`、SKILL.md frontmatter `description`（ClawHub registry `summary` / CLI `Summary:`）、Changelog、README 关键标题和核心说明均应先英文后中文\n- 检查 ClawHub 摘要：`description` 应短而清楚；发布后用 `inspect` 查看 `Summary:`，确认中文在预览可见范围内\n- 拟定 Changelog\n\n#### 第二步（输出给用户，等待明确确认）\n必须输出以下全部内容（用第 9 章汇报模板），**确认前不得执行任何发布类命令**：\n\n**必填字段（每次都要列出）：**\n- Display name（双语格式）\n- Skill slug\n- SKILL.md description（先英文后中文，总字符≤150）\n- 目标平台\n- 当前版本 → 新版本号\n- Changelog（英文在前，中文在后）\n- 文件大小\n- 核对清单（逐项列出，标注 ✅ 或 ⚠️）\n- 发布命令（完整命令）\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**⚠️ 两步验证适用于所有发布类操作**：clawhub publish / git push / gh release create / 推广发帖 / 社交平台发帖等。\n\n> 上两步验证前，先读对应 reference：ClawHub 上传/升版 → `references/clawhub-publish.md`；GitHub 上传 → `references/github-publish.md`。\n\n### 步骤 3：执行发布\n\n获得用户确认后，执行对应平台的发布命令。\n> ClawHub 上传详见 `references/clawhub-publish.md`；GitHub 上传详见 `references/github-publish.md`。\n\n**若用户拒绝发布**：回到 Phase 1 修改流程，递增修订版本号（如 1.2.1 → 1.2.2-dev），不得直接重复尝试发布相同内容。\n\n---\n\n## 发布后维护 | Phase 3: Maintain\n\n参考 Phase 1 修改流程 + 版本号递增 → 回到 Phase 2 两步验证。\n\n- **升版/更新**：ClawHub → `references/clawhub-publish.md`；GitHub → `references/github-publish.md`\n- **宣传/推广**：读 `references/promotion.md`（Moltbook 格式、AI心理学、去标识化）\n- **查看详情**：ClawHub → `clawhub inspect ` + `references/clawhub-inspect.md`（Details ▾ 确认 Assessment）\n- **GitHub**：`git log` 验证\n- **回滚**：clawhub → `clawhub delete --yes`（软删除）；GitHub → `git revert`\n- **隐藏/恢复/删除**：执行前报告 + 执行后验证\n\n---\n\n## 安全扫描说明 | Security Scans（仅限 ClawHub）\n\nClawHub 发布后会自动进行三项安全扫描（GitHub 发布无此流程）。\n\n### 三项扫描介绍\n\n| 扫描 | 扫描对象 | 判定方式 | 误报率 |\n|------|---------|---------|--------|\n| VirusTotal | 整个发布包（zip） | 外部引擎 + Code Insight LLM | 高（敏感能力类技能常见 Review） |\n| ClawScan | SKILL.md + metadata | OpenClaw 自有 LLM 分析 | 中（可通过声明优化） |\n| Static Analysis | 代码模式 | 静态规则匹配 | 低 |\n\n### VirusTotal 常见结果\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| Review | 平台标记了敏感能力（如私信读写、浏览器自动化） | 功能性质决定，无法消除，接受（需向用户说明原因） |\n| Suspicious | 检测到可疑模式（非功能性质） | ❌ 必须修复，向用户汇报具体可疑内容 |\n\n### ClawScan 常见 findings 类型\n\n- Tool Misuse and Exploitation（工具滥用）\n- Agentic Supply Chain Vulnerabilities（供应链风险）\n- Identity and Privilege Abuse（身份权限滥用）\n- Memory and Context Poisoning（上下文泄露）\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| Review | 检测到敏感能力，但有缓解措施 | 优化 SKILL.md 声明（加两步验证、数据披露、凭据声明）降低 severity |\n\n### Static Analysis 常见结果\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| 非 Benign | 命中注入/路径风险等规则 | ❌ 列出具体命中规则，修复代码 |\n\n### 发布后汇报流程（ClawHub 专有）\n\n> 发布后必须汇报 ClawHub 平台的安全扫描结果。扫描结果可能需要数分钟到数小时才全部完成。\n\n**发布后汇报时机：**\n- 如果发布后立即能看到结果（数分钟内），当场汇报\n- 如果发布后结果尚未完成，告知用户稍后查看 `https://clawhub.ai/moroiser//security`\n\n**汇报格式（SOP）：**\n```markdown\n## 🔍 技能安全扫描汇报 | v\n\n**技能：** \n**slug：** \n**版本：** \n**复查时间：** \n\n### 安全扫描结果\n\n| 扫描项 | 结果 | 处理 |\n|--------|------|------|\n| VirusTotal | Benign / ⚠️ Review / ❌ Suspicious | <处理方式> |\n| ClawScan | Benign / ⚠️ Review | <处理方式> |\n| Static analysis | Benign / ❌ 非 Benign | <处理方式> |\n\n### 问题与修复（如有）\n- <扫描项>: <具体问题描述> → <修复方案>（需用户「确认-」后执行）\n```\n\n**处理原则：**\n- Benign → 无需处理\n- 非 Benign → 逐项列出问题，向用户说明，寻求「确认-」授权后修复\n\n---\n\n## 统一检查清单 | Checklist（制作与发布共享）\n\n**上游参考技能保护**：不要直接修改上游/参考技能，尤其是 `skill-creator`。它会随 OpenClaw 或上游版本更新而变化；本技能只能把本地经验沉淀到 `skill-manager-all-in-one` 自己的 SKILL.md / references 中。若确实需要修改上游技能，必须先向用户说明原因、影响和恢复方案，等待明确授权。\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| G01 | 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | 无注入风险（Shell注入/Python注入/路径注入）、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | 结构清晰、路径准确、模块化、**同名规范** |\n| G04 | AI 可读性 | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | 代码整洁、注释到位、变量命名清晰、模块化 |\n| G06 | 依赖/凭据声明 | 外部 Python 包、命令行工具、API、模型、账号权限、凭据来源、文件系统写入范围必须明确声明；不得硬编码密钥。发布类技能需声明 `clawhub`/`git`/`gh` 等工具及验证命令。\n\n### ClawHub 专项（附加于通用基线之后）\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| CH01 | Display Name 双保险 | **ClawHub 页面展示名必须双保险**：`SKILL.md` frontmatter 的 `name:` 填 `EN Title | CN Title`，发布命令也必须显式传 `--name \"EN Title | CN Title\"`。实测仅改 `name:` / `_meta.displayName` 更新版本时，ClawHub 顶部展示名可能不会同步中文。例：`clawhub publish --slug speech-synthesizer --name \"TTS Speaker | TTS 朗读器\" --version 1.0.1 ...` |\n| CH02 | Skill slug | 技能唯一标识符，小写字母 + 连字符（例：`speech-synthesizer`）；在 `~/.openclaw/workspace/skills//` 目录名和 `clawhub publish` 命令中使用 |\n| CH03 | SKILL.md description 双语且≤150字符 | SKILL.md frontmatter `description` 是发布到 ClawHub 后的 registry `summary`（CLI 显示为 `Summary:`）。要求：先英文后中文，总字符数控制在 150 以内（含中英文、标点、空格），英文部分优先短句，确保中文在卡片预览可见、不被截断。 |\n| CH04 | Changelog 格式 | 英文在前（面向用户描述功能变化，而非开发者心理活动）、双语数字列表。**禁止提及安全扫描结果或扫描器名称**（如 ClawScan、VirusTotal、SUSPICIOUS、Benign 等），changelog 只描述功能改动本身，不得暗示意图影响扫描判定。 |\n| CH05 | Embedding 500 应急 | 当 SKILL.md 或引用的 reference 文件超过 500 行时，自动拆分或提供摘要版本 |\n| CH06 | 文件/模型分离 | 技能文件夹（`~/.openclaw/workspace/skills//`）**严禁存放任何模型文件、运行产物、结果文件**。模型文件统一放 `~/.cache/huggingface/modules//`；运行文件与结果文件统一放 `~/.openclaw/workspace/projects//`。技能文件夹本身仅含技能代码（SKILL.md、脚本、配置文件等），大小应控制在 50MB 以内。发布前 `du -sh ` 超过 50MB 需立即处理。 |\n| CH07 | 版本号一致性 | `_meta.json` version、changelog 版本号、发布命令版本号三者必须一致 |\n| CH08 | 对外表述顺序统一 | 所有面向用户的双语表述统一先英文后中文：Display name、SKILL.md `description` / ClawHub `Summary:`、Changelog、README 关键标题、核心说明、示例说明。避免一处中文在前、一处英文在前造成发布页风格不一致。 |\n| CH09 | 坏符号链接 | 无失效符号链接 |\n| CH10 | 运行时产物 | 无 `.pyc`、`.pyo`、`__pycache__`、`.log` 等运行时产物 |\n| CH11 | 目录隔离 | 确保技能文件夹内无 `.git/`、`.DS_Store`、`Thumbs.db` 等无关元数据 |\n| CH12 | 英中文顺序检测 | 关键信息先英文后中文：① Display name 用 `|` 分隔（如 `EN Title | CN Title`）；② description 不用 `|`，英文句在前、中文句在后，≤150字符；③ Changelog 英文在前、中文在后；④ SKILL.md 正文关键标题/说明、references 关键内容均为先英文后中文。不因顺序检查影响技能高效与稳定。 |\n\n### GitHub 专项（附加于通用基线之后）\n\n> ⚠️ 必须先通过通用质量基线 G01-G06。\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| GH01 | git status | 无未提交变更（`git status` 干净） |\n| GH02 | 分支规范 | main/master 分支干净，commit 原子化 |\n| GH03 | commit 规范 | commit message 简洁、描述性、一行概括 + 详细说明 |\n| GH04 | Release Notes | 格式规范，与 changelog 内容一致 |\n| GH05 | 文件完整性 | 无多余临时文件 |\n| GH06 | License 检查 | 发布前确认包含合适开源许可证文件（如 MIT），或明确声明无许可证 |\n\n---\n\n## 技能目录体系 | Directory System\n\n| 目录 | 路径 |\n|------|------|\n| 正式技能 | `~/.openclaw/workspace/skills//` |\n| 插件技能 | `~/.openclaw/extensions/` |\n| 临时草稿 | `~/.openclaw/workspace/temp-skills//` |\n| 工作区资源 | `~/.openclaw/workspace/projects//` |\n| 模型缓存 | `~/.cache/huggingface/modules//` |\n\n### 各目录职责（强制分离）\n\n> **技能文件夹 = 纯技能代码**。禁止放入任何模型、运行产物、结果文件。\n\n| 目录 | 职责 | 禁止放入 |\n|------|------|---------|\n| `~/.openclaw/workspace/skills//` | 技能代码（SKILL.md、脚本、配置） | 模型文件、运行结果、输出文件 |\n| `~/.openclaw/workspace/projects//` | 运行文件、结果输出、数据文件 | 技能源代码 |\n| `~/.cache/huggingface/modules//` | 所有模型文件（.pt/.onnx 等） | 非模型文件 |\n\n**示例（speech-transcriber 技能）：**\n```\n~/.openclaw/workspace/skills/speech-transcriber/ # ✅ 技能代码（SKILL.md、scripts/、requirements.txt）\n~/.openclaw/workspace/projects/speech-transcriber/ # ✅ 运行文件与结果（transcriptions/、recordings/、outputs/）\n~/.cache/huggingface/modules/speech-transcriber/ # ✅ 模型文件（small/、medium/）\n```\n\n### 命名规范 | Naming Convention\n\n**⚠️ 重要：项目目录和模型缓存必须与技能名（slug）保持一致。**\n\n---\n\n\n## 汇报模板 | Report Template\n\n汇报时必须包含以下全部内容。SOP 格式：逐项列表格，逐项打 ✅ / ⚠️。\n\n### 汇报格式\n\n```markdown\n## 🔍 技能发布汇报 | v\n\n**Display name：** \n**Skill slug：** \n**目标平台：** clawhub / github\n**SKILL.md description：** （ 字符）\n**当前版本：** → **新版本：** \n**Changelog：**\n1. . <中文更新>。\n\n**文件大小：** KB\n\n---\n\n### 核对清单\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| G01 | 去标识化 | ✅ / ⚠️ | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | ✅ / ⚠️ | 无注入风险、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | ✅ / ⚠️ | 结构清晰、路径准确、模块化、同名规范 |\n| G04 | AI 可读性 | ✅ / ⚠️ | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | ✅ / ⚠️ | 代码整洁、注释到位、变量命名清晰 |\n| G06 | 依赖/凭据声明 | ✅ / ⚠️ | 外部包/工具/密钥已声明，无硬编码 |\n| CH01 | Display Name 双保险 | ✅ / ⚠️ | `name:` = `EN Title | CN Title`；`--name` 参数一致 |\n| CH02 | Skill slug | ✅ / ⚠️ | 小写字母 + 连字符 |\n| CH03 | description ≤150 字符 | ✅ / ⚠️ | 英文在前、中文在后，总字符 ≤150，不用 `|` 分隔 |\n| CH04 | Changelog 格式 | ✅ / ⚠️ | 英文在前、中文在后，数字列表，正式语气 |\n| CH05 | Embedding 500 应急 | ✅ / ⚠️ | SKILL.md + references 均 ≤500 行，否则拆分 |\n| CH06 | 文件/模型分离 | ✅ / ⚠️ | 技能文件夹 ≤50MB，无模型/结果文件 |\n| CH07 | 版本号一致性 | ✅ / ⚠️ | `_meta.json` / changelog / 发布命令三处一致 |\n| CH08 | 对外表述顺序统一 | ✅ / ⚠️ | 所有双语表述均先英文后中文 |\n| CH09 | 坏符号链接 | ✅ / ⚠️ | 无失效符号链接 |\n| CH10 | 运行时产物 | ✅ / ⚠️ | 无 .pyc / .pyo / __pycache__ / .log |\n| CH11 | 目录隔离 | ✅ / ⚠️ | 无 .git / .DS_Store / Thumbs.db 等无关文件 |\n| CH12 | 英中文顺序检测 | ✅ / ⚠️ | 关键信息先英文后中文：display name（用 `|`）、description（不用 `|`）、changelog、主分文件关键内容 |\n\n---\n\n### 发布命令\n\n```bash\nclawhub publish --slug --name \"\" --version --changelog \"\"\n```\n\n### 问题与修复（如有）\n\n- <检查项>: <具体问题> → <修复方案>（需用户「确认-」后执行）\n```\n\n---\n\n## 实用说明 | Practical Notes\n\n### 执行提示\n\n- 执行敏感操作前，用 `clawhub --help` 核对当前 CLI 行为\n- `skill-creator` 是底层规则权威来源\n\nFile v4.5.13:_meta.json\n\n{\n \"ownerId\": \"kn75k53tcdhqwka2fra5x817p9821zpb\",\n \"slug\": \"skill-manager-all-in-one\",\n \"version\": \"4.5.13\",\n \"publishedAt\": 1778170139963\n}\n\nFile v4.5.13:references/clawflows-workflow.md\n\n# ClawFlows Workflow Format Guide | ClawFlows Workflow 格式指南\n\n## Overview | 概述\n\nClawFlows 是一个多技能自动化流程市场，工作流以 YAML 文件定义，提交到 GitHub Registry 经 PR 审核后上线。\n\nWorkflow 与 Skill 的核心区别：\n- **Skill**：本地写好，`clawhub publish` 直接发布，即时生效\n**Workflow**：本地写好，需 fork registry 提 PR，等审核合并后才上线\n\n---\n\n## Two Formats | 两种格式\n\nEvery automation comes in two flavors: \n每个自动化都有两种格式：\n\n| Format | 用途 | Token 消耗 |\n|--------|------|-----------|\n| **Abstract（能力型）** | 跨平台可移植，描述需要哪些 capabilities | 0 |\n| **Lobster-Ready（直接运行型）** | 直接可跑，deterministic shell pipelines | 0 |\n\n---\n\n## File Structure | 目录结构\n\n```\nautomations//\n├── automation.yaml # Workflow 定义\n├── metadata.json # 搜索/展示元数据\n└── README.md # 文档（英中文双语）\n```\n\n---\n\n## automation.yaml | Workflow 定义\n\n```yaml\nname: my-workflow # 唯一标识，slug 格式（小写字母、数字、连字符）\ndescription: One-line description # 一行描述，用于搜索结果\nauthor: your-github-username\nversion: 1.0.0 # 语义化版本\n\nrequires:\n - capability: capability-name # 所需能力，非具体 skill 名\n\ntrigger:\n manual: true # manual=true 表示手动触发；或 schedule: \"0 9 * * *\"\n\nconfig:\n setting_name:\n description: \"用户可配置的设置项说明\"\n default: default_value\n required: false # 是否必填\n\nsteps:\n - name: step-name # 步骤名，唯一标识\n capability: capability-name\n method: methodName\n args:\n key: value\n capture: output_var # 捕获输出，供后续步骤使用\n```\n\n### Key Fields | 关键字段\n\n| 字段 | 说明 |\n|------|------|\n| `name` | URL-safe slug（小写、连字符）|\n| `requires[].capability` | 引用 capability，不写具体 skill 名 |\n| `trigger.schedule` | Cron 表达式，定时触发 |\n| `trigger.manual` | true 表示手动触发 |\n| `steps[].capture` | 捕获输出为变量，`${变量名}` 引用 |\n| `steps[].condition` | JavaScript 表达式，用于条件判断 |\n| `steps[].onFalse` | 条件为 false 时的动作（exit/skip/skip-to:step） |\n\n---\n\n## metadata.json | 元数据\n\n```json\n{\n \"name\": \"workflow-name\",\n \"description\": \"One-line description of what it does\",\n \"author\": \"your-github-username\",\n \"version\": \"1.0.0\",\n \"requires\": [\"capability-1\", \"capability-2\"],\n \"trigger\": \"schedule\",\n \"schedule\": \"0 9 * * *\",\n \"tags\": [\"tag1\", \"tag2\", \"tag3\"]\n}\n```\n\n---\n\n## README.md | 文档规范\n\n```markdown\n# Workflow Name | 工作流名称\n\nBrief description. 简短中文描述。\n\n## What It Does | 功能说明\n\nDetailed explanation of the workflow.\n\n## Requirements | 必要条件\n\n- **capability-name**: Description of what it provides.\n\n## Configuration | 配置项\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `setting` | Description | `default` |\n\n## Example Output | 输出示例\n\nScreenshots, sample notifications, or output examples.\n\n## Author\n\nCreated by [Your Name](https://github.com/username)\n```\n\n---\n\n## Local Install & Run | 本地安装与运行\n\n安装后路径：`~/.openclaw/workspace/automations//`\n\n常用命令：\n```bash\nclawflows install # 从 ClawFlows Registry 安装\nclawflows run # 运行\nclawflows run --dry-run # 预览（不实际执行）\nclawflows check # 检查所需 capabilities\nclawflows list # 列出已安装的工作流\nclawflows logs # 查看运行日志\n```\n\n---\n\n## Publishing Steps | 提交流程\n\n1. Fork [github.com/Cluka-399/clawflows-registry](https://github.com/Cluka-399/clawflows-registry)\n2. 在 fork 中创建 `automations//`\n3. 放入 `automation.yaml`、`metadata.json`、`README.md`\n4. Commit 并 Push 到 fork\n5. 提交 PR 到主仓库\n6. 等官方审核合并\n7. 合并后 GitHub Actions 自动重建 index，出现在 clawflows.com\n\n---\n\n## Capability Reference | 能力参考\n\n常用 capabilities：\n- `database` — 数据存储（SQLite）\n- `chart-generation` — 图表生成\n- `calendar` — 日历/日程\n- `tts` — 文字转语音\n- `notification` — 通知推送\n\nBrowse all: https://clawflows.com/capabilities/\n\n---\n\n## Naming Rules | 命名规则\n\n- **Slug**：小写字母、数字、连字符（无下划线和空格）\n - ✅ `douyin-manager`\n - ❌ `Douyin_Manager`\n- **Display name**：英文在前，中文在后\n - `Douyin Manager | 抖音管理者`\n- **Description**：一行，英文为主，中文辅助，控制在 150 字符内\n\n---\n\n## Writing Rules | 写作规范\n\n- **Abstract** 格式引用 capabilities，不写死具体 skill\n- **Config** 配置项让用户无需改代码即可自定义\n- **Bilingual**：README.md 使用英中文双语\n- **去标识化**：README.md 不暴露个人位置、姓名、API 密钥\n- **Approval Gates**：关键操作步骤用条件判断暂停，等用户确认\n\n---\n\n## Practical Experience Notes | 实践经验总结\n\nBased on real workflow creation (Bilibili Manager | B站管理者). 基于实际工作流创建经验。\n\n### Do Nots | 避免事项\n\n| Issue | Problem | Solution |\n|-------|---------|----------|\n| Runtime data in workflow file | Workflow 文件包含日志逻辑 | Runtime data belongs to user workspace, not workflow definition. 日志是运行时数据，存放在用户工作区，不在工作流定义中 |\n| Duplicate content | 描述重复（中英各写一遍然后又写一遍）| English and Chinese should complement each other, not repeat. 英文和中文应互补，不是重复 |\n| Changelog in workflow | 工作流文件包含更新日志 | Changelog belongs to PR/commit, not workflow file. 更新日志属于 PR/commit，不在工作流文件中 |\n| Embed skill logic | 工作流直接嵌入 skill 实现代码 | Workflow declares capabilities, skill provides implementation. 工作流声明 capabilities，skill 提供实现 |\n| Local paths in public docs | 文档写死本地路径 | Use relative or generic references. 使用相对路径或通用引用 |\n\n### Name & Description | 名称与描述\n\n```yaml\n# Good | 正确\nname: bilibili-manager\ndescription: \"Check DMs, browse content, auto-reply, heartbeat patrol. | B站管理者：私信管理、内容浏览、自动回复、心跳巡逻。\"\n\n# Avoid | 避免\nname: morois-bilibili-dm # Personal name | 个人名称\ndescription: \"B站私信管理器\" # Single language only | 只有单语言\n```\n\n### Skill Reference | Skill 引用\n\n```yaml\n# ===== Skill Reference | Skill 引用 =====\n# First check if already installed locally | 先检测本地是否已安装\n# If not installed: clawhub install bilibili-messager | 未安装则：clawhub install bilibili-messager\n# Operations follow the skill, workflow handles flow control | 具体操作以skill为准，工作流仅负责流程控制\n```\n\n### Workflow Structure | 工作流结构\n\n```yaml\n# ===== Workflow =====\nname: workflow-name\ndescription: \"English first | 中文描述\"\nversion: 1.0.0\n\nrequires:\n - capability: browser\n - capability: notification\n\nconfig:\n auto_mode:\n description: \"Auto mode: no confirmation needed | 自动模式：无需确认\"\n default: false\n\nsteps:\n # Stage 1: Preparation | 阶段1：准备\n # Stage 2: Execute core logic | 阶段2：执行核心逻辑\n # Stage 3: Report result | 阶段3：汇报结果\n```\n\n### Configuration Design | 配置设计原则\n\n| Principle | Description |\n|----------|-------------|\n| User intent detection | Parse user input to determine mode (manual/auto/heartbeat) |\n| Configurable intervals | Use minutes not seconds for heartbeat (e.g., 30, 60, 120) |\n| Clear defaults | Default to safest option (manual mode) |\n| Mode introduction | Auto-show mode guide on first run |\n\n### Bilingual Format | 双语格式规范\n\n**Title**: `English Name | 中文名`\n\n**Description**: English sentence first, then Chinese translation. 不要重复内容。\n```\nCheck DMs, browse content, auto-reply, heartbeat patrol. | B站管理者：私信管理、内容浏览、自动回复、心跳巡逻。\n```\n\n**Features table**:\n```markdown\n| Feature | Description | 功能 |\n|---------|-------------|------|\n| 📬 Check DM List | Get conversation list | 检查私信列表 |\n```\n\n**PR Description**:\n```markdown\n## Workflow Name | 工作流名称\n\nEnglish description first. | 中文描述。\n\n### Features | 功能说明\n| Feature | Description | 功能 |\n|---------|-------------|------|\n```\n\n### Git Commit & PR | Git 提交与 PR\n\n```bash\n# Commit message\ngit commit -m \"feat: add workflow-name | 工作流名称\"\n\n# PR title\ngh pr create --title \"feat: workflow-name | 工作流名称\"\n```\n\n### Publishing Checklist | 发布检查清单\n\n- [ ] Name is URL-safe slug | 名称是 URL 安全的 slug\n- [ ] Description is bilingual | 描述是双语的\n- [ ] README.md is full bilingual | README.md 是完整双语的\n- [ ] No runtime data in workflow file | 工作流文件不包含运行时数据\n- [ ] No local paths in public docs | 公开文档不含本地路径\n- [ ] No personal names/keys | 无个人名称/密钥\n- [ ] Skill reference mentions local-check-first | Skill 引用提到先检测本地\n- [ ] Config descriptions are bilingual | 配置描述是双语的\n- [ ] YAML syntax validated | YAML 语法已验证\n\nFile v4.5.13:references/clawhub-inspect.md\n\n# ClawHub Inspect Guide | ClawHub 查看指南\n\n## CLI basics | CLI 基础检查\n\nCheck current CLI behavior before sensitive operations. Do this again when you suspect the CLI has gained new commands or options. \n在执行敏感操作前，先检查当前 CLI 行为。如果怀疑 CLI 又新增了命令或参数，就再次检查。\n\n```bash\nclawhub --help\nclawhub whoami\nclawhub inspect \n```\n\n## Tool choice | 工具选择\n\nDo not assume one tool is always best. \n不要预设某个工具永远最好。\n\nCheck the current CLI help first, because the CLI can gain new commands and options over time. Then choose CLI or Dashboard based on the task at hand. \n先检查当前 CLI help，因为 CLI 会持续增加新命令和新参数。然后再根据眼前任务选择 CLI 或 Dashboard。\n\n## Tool selection after checking help | 查看 help 后再选工具\n\nUse Dashboard when you need: \n以下场景可用 Dashboard：\n- reviewing all published skills at a glance \n 一眼查看全部已发布技能\n- checking visible card summaries \n 查看卡片摘要信息\n- checking scan state and overview information \n 查看扫描状态和概览信息\n\nUse CLI when you need: \n以下场景可用 CLI：\n- single skill details \n 单个技能详情\n- current latest version \n 当前最新版本\n- file lists \n 文件列表\n- direct metadata lookup \n 元数据直接查询\n- repeatable checks and scripted workflows \n 需要可重复检查或脚本化流程时\n\nUseful commands | 常用命令:\n\n```bash\nclawhub inspect \nclawhub inspect --tag latest\nclawhub inspect --version 1.0.0\nclawhub inspect --versions --limit 20\nclawhub inspect --files\nclawhub inspect --file SKILL.md\nclawhub inspect --json\n```\n\n## Local directory vs CLI list | 本地目录与 CLI list 的区别\n\nA skill copied manually into `~/.openclaw/workspace/skills/` may exist locally but still not appear in `clawhub list`. \n手工复制进 `~/.openclaw/workspace/skills/` 的技能，可能本地存在，但仍不会出现在 `clawhub list` 中。\n\n`clawhub list` reports installed skills from the CLI lockfile view, not every folder that happens to exist under the skills directory. \n`clawhub list` 展示的是 CLI lockfile 视角下的已安装技能，而不是简单扫描技能目录里的所有文件夹。\n\nUse both checks when needed: \n需要时，两个检查都要做：\n- inspect the local directory directly \n 直接检查本地目录\n- use `clawhub list` when the question is about CLI-managed installs \n 当问题涉及 CLI 管理安装时，再使用 `clawhub list`\n\n## Login note | 登录说明\n\nBrowser login and CLI login are separate states. If CLI reports `Not logged in`, run: \n浏览器登录和 CLI 登录是两套状态。如果 CLI 提示 `Not logged in`，执行：\n\n```bash\nclawhub login\nclawhub whoami\n```\n\n## Status meanings | 状态含义\n\n- `Scanning`: security scan in progress \n `Scanning`：安全扫描进行中\n- `Pending`: result not fully stable yet \n `Pending`：结果尚未完全稳定\n- `Benign`: generally passed scan \n `Benign`：基本通过扫描\n- `Suspicious`: needs review \n `Suspicious`：需要人工复核\n- `Hidden`: not publicly visible \n `Hidden`：当前不公开显示\n\nFile v4.5.13:references/clawhub-publish.md\n\n# ClawHub Publish Guide | ClawHub 发布指南\n\n## Two-step publishing workflow | 两步发布工作流\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。**\n\n### 第一步（AI 内部执行，不输出给用户）\n\n**A. Run full checklist | 完整清单核对**\nVerify all items in the \"Skill creation/modification checklist\" section of SKILL.md:\n逐项核对 SKILL.md 中\"技能制作/修改清单\"的全部项目。\n\n**A0. Runtime expectations declaration | 运行依赖声明**\n\nBefore publishing skills that guide command execution or filesystem changes, explicitly declare:\n发布会指导命令执行或文件系统修改的技能前，必须明确声明：\n\nThese declarations must appear in SKILL.md frontmatter `metadata` where possible, not only in prose. Use single-line JSON metadata because the OpenClaw skill parser expects single-line frontmatter values.\n这些声明应尽量写入 SKILL.md frontmatter `metadata`，不能只写在正文。OpenClaw 技能解析器要求 frontmatter 值使用单行 JSON。\n\n- Required binaries and verification commands, e.g. `clawhub --help`, `git --version`, `gh --version`.\n 所需命令行工具及验证命令，例如 `clawhub --help`、`git --version`、`gh --version`。\n- Credential/authentication expectations, e.g. ClawHub login session, Git/GitHub credentials; never ask users to paste long-lived secrets into chat.\n 凭据/授权预期，例如 ClawHub 登录态、Git/GitHub 凭据；不得要求用户在聊天中粘贴长期密钥。\n- Filesystem write scope: skill source in `~/.openclaw/workspace/skills//`, outputs in `~/.openclaw/workspace/projects//`, models in `~/.cache/huggingface/modules//`.\n 文件系统写入范围：技能源码在 `skills//`，输出在 `projects//`，模型在 `modules//`。\n- Exact commands must be shown to the user before publishing, deleting, moving, pushing, or otherwise mutating external/local state.\n 发布、删除、移动、推送或其他写入操作前，必须向用户展示精确命令。\n\n**B. Security verification | 安全性检查**\n\n⚠️ **If the skill contains scripts (Python/Bash/etc.), manually inspect each script:**\n如果技能包含脚本，必须手动检查每个脚本：\n\n| 检查要点 | 说明 |\n|---------|------|\n| 输入校验 | 用户输入是否经过验证和过滤，避免直接拼接到命令或路径中 |\n| 权限最小化 | 是否遵循最小权限原则，无过度权限申请 |\n| 凭据保护 | API Key、Token 等敏感信息不出现在日志、报错、返回值中 |\n| 依赖完整性 | 代码 import 的包是否全部出现在 requirements.txt / package.json 中 |\n\n**C. File size check | 文件大小检查**\n```bash\ndu -sh \n```\nIf the directory **exceeds 50MB**, the upload will fail.\n- Report to user immediately.\n- Move oversized files (e.g., model files) to a workspace backup location. Wait for explicit user confirmation.\n- After upload succeeds, move files back. Wait for user confirmation again.\n如果目录**超过 50MB**，上传会失败。立即报告用户，等待明确指示后再操作。\n\n**D. Public wording and ClawHub Summary check | 对外表述与 ClawHub Summary 检查**\n\nAll user-facing bilingual wording should use **English first, Chinese second**. This applies to display names, the SKILL.md frontmatter `description` field that ClawHub exposes as registry `summary` / CLI `Summary:`, changelog entries, README key headings, core explanations, and examples.\n所有面向用户的双语表述统一使用 **先英文、后中文**。适用范围包括展示名、SKILL.md frontmatter `description` 字段（发布到 ClawHub 后是 registry `summary` / CLI `Summary:`）、changelog、README 关键标题、核心说明和示例。\n\nClawHub preview cards may truncate long summaries. Before publishing, inspect the SKILL.md frontmatter `description` as product copy:\nClawHub 预览卡片可能截断长简介。发布前把 SKILL.md frontmatter 的 `description` 当作产品卡片文案检查：\n\n- Keep the English part short enough that the Chinese part remains visible before truncation.\n 英文部分要足够短，确保中文在截断前仍可见。\n- Use `English sentence. 中文句子。` for `description`, not Chinese-first ordering.\n `description` 使用 `English sentence. 中文句子。`，不要中文在前。\n- Avoid local debugging details, personal names, or one-off test content in the summary.\n 简介中不要放本地调试细节、真实姓名或一次性测试内容。\n\n**E. Draft changelog | 拟定 changelog**\n\n⚠️ **Changelog 不写在 SKILL.md 里！** Changelog 是 ClawHub 网站上的发布说明，在 `clawhub publish` 时通过 `--changelog` 参数传入。SKILL.md 模板中不应包含\"更新日志\"章节（除非是永久保留的完整更新历史）。\n\n- English first, Chinese after.\n 英文在前,中文在后。\n- Formal release-note tone only.\n 仅使用正式发布说明语气。\n\n**Changelog format | changelog 格式：**\nChangelog 内容通过 `--changelog \"...\"` 参数传递给 `clawhub publish` 命令，显示在 ClawHub 网站的版本历史中。格式为英文在前、中文在后的数字序号列表。\n\nUse plain numbered list (1. 2. 3.) with English first, Chinese after for each point.\n使用纯数字序号分点，每点英文在前、中文在后。\n\n**Changelog template | 模板：**\n```\n1. [English update]. [中文更新]。\n2. [English update]. [中文更新]。\n3. [English update]. [中文更新]。\n```\n\n**Recommended examples | 推荐示例：**\n```\n1. Initial release. 首次发布。\n```\n```\n1. Add comprehensive pre-publish checklist and two-step publishing workflow. 新增发布前检查清单和两步发布流程。\n2. Consolidate naming/writing standards and changelog rules into SKILL.md body. 整合命名写作规范与changelog规则至SKILL.md正文。\n```\n\n**Strictly avoid | 严格禁止：**\n- personal corrections / 个人纠错\n- format-only adjustments / 格式调整\n- private debugging notes / 私人调试记录\n- jokes, self-deprecation, apology-style wording / 玩笑、自嘲、道歉式表述\n- security scan references (ClawScan, VirusTotal, SUSPICIOUS, Benign, etc.) — changelog describes functional changes only, never implies intent to influence scan results / 安全扫描相关措辞（ClawScan、VirusTotal、SUSPICIOUS、Benign 等）— changelog 只描述功能改动，不得暗示意图影响扫描判定\n\n### 第二步（输出给用户，等待明确确认）\n\nReport the following to user. **⚠️ Do NOT run `clawhub publish` until user replies with \"确认-\" electronic signature.**\n**发布类操作（clawhub publish / git push / gh release create / 推广发帖等）必须经过两步验证，收到「确认-」电子签名后才可执行，不可跳过。**\n\n| Item | 内容 |\n|---|---|\n| Skill name + slug | 准确拼写 |\n| ClawHub current published version | 来自 `clawhub inspect ` |\n| New version number | 在已发布版本上递增 |\n| Changelog | 完整英中文双语内容 |\n| Primary update summary | 一句话概括 |\n| File size | 是否超 50MB |\n| De-identification | 确认通过/需调整 |\n| Scientificity | 确认通过/需调整 |\n| AI readability | 确认通过/需调整 |\n| Contextual coherence | 确认通过/需调整 |\n| Stability | 确认通过/需调整 |\n| **Code security** | 确认通过/需调整（输入校验/权限最小化/凭据保护/依赖完整性） |\n| Public wording order | Display name / SKILL.md `description` (ClawHub `Summary:`) / Changelog / README key content all use English first, Chinese second |\n| ClawHub Summary | SKILL.md `description` is short; published `Summary:` is bilingual and Chinese is not truncated in preview |\n| Full publish command | `clawhub publish ...` |\n\n**Restart rule | 重启规则：**\nEach user modification request → restart from Step 1.\n每次用户提出修改，都必须从第一步重新开始。\n\n## CLI commands | CLI 命令\n\nPrefer `clawhub` from PATH. If it is missing, try the OpenClaw-managed tool path before declaring the command unavailable:\n优先使用 PATH 中的 `clawhub`。若不存在，先尝试 OpenClaw 托管工具路径，再判断命令不可用：\n\n```bash\nCLAWHUB_BIN=$(command -v clawhub || true)\nif [ -z \"$CLAWHUB_BIN\" ] && [ -x \"$HOME/.openclaw/tools/node/npm/bin/clawhub\" ]; then\n CLAWHUB_BIN=\"$HOME/.openclaw/tools/node/npm/bin/clawhub\"\nfi\n[ -n \"$CLAWHUB_BIN\" ] || { echo \"clawhub command not found\"; exit 1; }\n```\n\n```bash\n# 发布：双语展示名必须显式传 --name，不能依赖 _meta.json 或 SKILL.md 自动同步\n\"$CLAWHUB_BIN\" publish \\\n --slug \\\n --name \"EN Title | 中文标题\" \\\n --version \\\n --changelog \"\"\n\n# 管理\n\"$CLAWHUB_BIN\" delete --yes\n\"$CLAWHUB_BIN\" hide --yes\n\"$CLAWHUB_BIN\" unhide --yes\n\"$CLAWHUB_BIN\" undelete --yes\n\"$CLAWHUB_BIN\" sync\n```\n\n> **Note | 说明**：These management commands (delete/hide/unhide/undelete) are core features of this skill for published skill lifecycle management. All destructive or visibility-changing operations strictly require explicit user consent via two-step electronic signature verification before execution. The `--yes` flag is a CLI requirement, not a bypass of the consent workflow.\n> 这些管理命令（删除/隐藏/恢复/取消删除）是本技能用于已发布技能生命周期管理的核心功能。所有破坏性或可见性变更操作均严格要求用户通过两步电子签名确认后才可执行。`--yes` 标志是 CLI 的必需参数，而非绕过同意流程。\n\n### Display name rule | 展示名规则\n\nClawHub page titles are controlled by the published display-name field. For bilingual names, always set it in two places:\nClawHub 页面标题由发布记录里的 display-name 控制。双语名必须两处一致：\n\n1. `SKILL.md` YAML frontmatter: `name: EN Title | 中文标题`\n2. Publish command: `--name \"EN Title | 中文标题\"`\n\nDo **not** rely on `_meta.json.displayName` or `SKILL.md` alone when updating an existing skill. In practice, version updates may keep the old English-only title unless `--name` is passed explicitly.\n更新已有技能时，不要只依赖 `_meta.json.displayName` 或 `SKILL.md name:`。实测如果发布命令未显式传 `--name`，页面顶部可能继续保留旧的纯英文展示名。\n\n### ClawHub Summary rule | ClawHub Summary 规则\n\nThe local source field is SKILL.md frontmatter `description`. After publishing, ClawHub stores/exposes it as registry `summary`, and the CLI prints it as `Summary:`. The ClawHub preview area is short: a long English-first description can still hide the Chinese part behind truncation. For bilingual skills, keep the English sentence compact, then put the Chinese sentence immediately after it:\n本地源字段是 SKILL.md frontmatter `description`。发布后，ClawHub 将其作为 registry `summary` 暴露，CLI 打印为 `Summary:`。ClawHub 预览区域很短：即使英文在前，只要英文太长，中文仍可能被截断。双语技能应让英文短句在前，中文紧随其后：\n\n```yaml\ndescription: \"TTS helper. TTS 朗读助手；支持文本转语音，长文本自动分段。\"\n```\n\nAfter publishing, verify both `Latest:` and `Summary:` with `inspect` or the web page.\n发布后同时复验 `Latest:` 和 `Summary:`，不要只看版本号。\n\n## Post-publish scan pending | 发布后安全扫描等待\n\nImmediately after publishing, `inspect` may report that the skill is hidden while the security scan is pending. Treat this as a temporary state, not a publish failure. Wait briefly and inspect again until the latest version and summary are visible.\n发布后立即 `inspect` 可能提示安全扫描中、技能暂时隐藏。这是临时状态，不是发布失败。短暂等待后再次 inspect，直到能看到最新版本和摘要。\n\n## Version conflict | 版本冲突\n\nIf publish fails with `Version already exists`, bump the version and republish only after confirming with the user.\n如果发布失败并提示 `Version already exists`，应先与用户确认，再升版本号重新发布。\n\n## 查看安全扫描结果 | View Security Scan Results\n\n发布后查看完整 Assessment 步骤：\n\n1. 打开 ClawHub 技能页面（如 `https://clawhub.ai/skills/`）\n2. 找到 **Security Scan** 区域\n3. 找到 **OpenClaw Benign/Suspicious** 徽章旁边的 **Details ▾** 按钮\n4. **点击 Details ▾ 展开** 才能看到完整的 Assessment 内容\n5. Assessment 是 ClawHub 对技能的详细安全分析，包含 Purpose、Install Mechanism、Credentials 等项目的逐一评估\n\n⚠️ **注意**：Summary 只是一句话概括，**必须展开 Details 才能看到完整 Assessment**。\n\n### 发布后扫描结果汇报\n\n扫描结果查看后，按主文件 SOP 格式汇报给用户：\n\n| 扫描项 | 结果 | 处理 |\n|--------|------|------|\n| VirusTotal | Benign / Review / Suspicious | 逐项说明 |\n| ClawScan | Benign / Review | 逐项说明 |\n| Static analysis | Benign / 非 Benign | 逐项说明 |\n\n- Benign → 无需处理\n- 非 Benign → 逐项列出问题，向用户说明，寻求「确认-」授权后修复\n\n完整汇报格式参见主文件「安全扫描说明」章节的 SOP 模板。\n\nFile v4.5.13:references/github-publish.md\n\n# GitHub 上传专项 | GitHub Publishing Guide\n\n本文件定义技能通过独立 GitHub 仓库发布的操作规范。\n\n## 适用场景\n\n- 技能有独立的 GitHub 仓库\n- 非 ClawHub 平台发布（如个人仓库、GitHub Pages 等）\n- 需与 ClawHub 发布流程区分\n\n## 发布前准备（对照 SKILL.md 第 6 章清单）\n\n发布 GitHub 前，逐项核对 SKILL.md 中的通用质量基线（G01~G06）和 GitHub 专项（GH01~GH06）：\n\n| 项目 | 内容 |\n|------|------|\n| G01 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 安全性 | 无代码安全风险（输入校验、权限最小化） |\n| G03 逻辑科学性 | 结构清晰、路径准确、模块化 |\n| G04 AI 可读性 | agent 可理解、上下文连贯 |\n| G05 易维护性 | 代码整洁、注释到位 |\n| G06 依赖声明 | 外部包/工具/密钥已声明，无硬编码 |\n| GH01 文件结构 | 符合 Skill 目录体系（SKILL.md 在根目录） |\n| GH02 README | 英中文双语，有安装/使用说明 |\n| GH03 Commit 规范 | 英文在前、中文在后，格式正确 |\n| GH04 Release Notes | Markdown 格式，结构清晰 |\n| GH05 无敏感信息 | 无 API Key、Token、内部路径 |\n| GH06 权限隔离 | 无过度文件权限、无不必要的管理脚本 |\n\n**若涉及多语言 README 或多文件修改：逐个修改，逐个确认。**\n\n## 两步验证流程（对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n### 第一步（AI 内部执行，不输出给用户）\n\n- 对照清单全部项（G01~G06 + GH01~GH06），逐项标注 ✅ / ⚠️\n- 检查文件大小（>50MB 需报告）\n- 拟定 Commit Message（英文在前，中文在后）\n- 检查 `git status`，列出所有未提交的变更\n- 若有未提交变更，列出文件名，等待用户确认后再处理\n\n### 第二步（输出给用户，等待明确确认）\n\n⚠️ **未经用户明确确认，不得执行 `git push` / `gh release create` 等任何发布类命令。**\n\n向用户汇报以下全部内容：\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前状态 | 已修改未提交 / 已提交未推送 |\n| 未提交文件 | 列出所有变更文件 |\n| Commit Message | 拟定的提交信息 |\n| 核对清单结果 | G01~G06 + GH01~GH06，✅ / ⚠️ 标注 |\n| 文件大小 | 是否超 50MB |\n| 问题说明 | 有 ⚠️ 项时，说明具体问题 |\n| 解决方案 | 针对 ⚠️ 项的修复方案 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n## 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n获得用户确认后，执行以下命令：\n\n```bash\n# 1. 进入仓库目录\ncd \n\n# 2. 添加所有变更\ngit add -A\n\n# 3. 提交（英文在前，中文在后）\ngit commit -m \"[English message]. [中文信息]。\"\n\n# 4. 推送到远程\ngit push\n```\n\n## Commit Message 规范\n\n- 英文在前，中文在后\n- 正式发布语气\n- 禁止：个人纠错、格式调整、私人调试记录、玩笑、道歉式表述\n- 示例：`fix: 修复徽章HTML兼容性问题，清理各语言版本中文残留`\n\n## 安全约束\n\n1. **严禁擅自上传** — 未获用户明确确认前不得执行 `git push`\n2. **汇报当前状态** — 每次修改后必须汇报状态（已修改/未提交/已上传）\n3. **等待电子签名** — 用户回复「确认-」后才执行 push\n\n## Git 状态检查命令\n\n```bash\n# 查看当前状态\ngit status\n\n# 查看变更统计\ngit diff --stat\n\n# 查看完整变更内容\ngit diff\n\n# 查看提交历史\ngit log --oneline -5\n```\n\n## 常见问题处理\n\n### 有未提交的变更\n\n用户要求上传前，先检查 `git status`：\n- 如有未提交的变更，必须在汇报中列出\n- 等待用户确认后再 add/commit/push\n\n### 远程分支落后\n\n```bash\n# 先拉取最新\ngit pull --rebase\n\n# 再推送\ngit push\n```\n\n### 冲突处理\n\n1. 报告用户存在冲突\n2. 等待用户指示如何解决\n3. 不得强制覆盖远程分支\n\n## GitHub Release 专项 | GitHub Release Guide\n\n创建 GitHub Release 同样需要两步验证。Release Notes 是对外展示的正式说明，必须符合规范。\n\n### 何时需要创建 Release\n\n- 首次正式发布版本（如 v1.0.0）\n- 重要版本更新\n- 用户明确要求创建 Release\n\n### Release Notes 规范\n\n**格式**：Markdown 语法，结构清晰\n**内容**：\n- 标题（版本号 + 简短描述）\n- 变更说明（功能/修复/优化）\n- 技术规格（如适用）\n- 安装方式（如适用）\n\n**禁止**：\n- 个人调试记录\n- 道歉式表述\n- 不完整的描述\n\n### 两步验证流程（Release，对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n#### 第一步（AI 内部执行，不输出给用户）\n\n- 检查 git tag 列表，确认版本号未冲突\n- 拟定 Release Notes（英文在前，中文在后）\n- 检查变更内容是否与 Commit History 一致\n\n#### 第二步（输出给用户，等待明确确认）\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前 tag | 已有 tag 列表 |\n| 新版本号 | 如 v1.0.0 |\n| Release Notes | 拟定的正式说明 |\n| 变更内容 | 列出主要变更 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式）才可执行。\n\n#### 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n```bash\n# 1. 创建 tag（如尚未创建）\ngit tag -a -m \"\"\n\n# 2. 推送 tag\ngit push origin \n\n# 3. 使用 gh 创建 Release\ngh release create \\\n --title \"<标题>\" \\\n --notes \"\" \\\n --target \n```\n\n### Release Notes 示例\n\n```markdown\n## What's New\n\n**Skill Name** — 简短描述\n\n基于 xxx，为用户提供 yyy 功能。\n\n### 功能更新\n- 新增 xxx 功能\n- 优化 xxx 体验\n- 修复 xxx 问题\n\n### 技术规格\n- 版本：1.0.0\n- 支持平台：xxx\n- 依赖：xxx\n\n### 安装方式\n```bash\nxxx install command\n```\n```\n\n### 验证命令\n\n```bash\n# 查看已创建的 Release\ngh release list\n\n# 查看特定 Release 详情\ngh release view \n\n# 更新 Release Notes\ngh release edit --notes \"<新内容>\"\n```\n\n## 与 ClawHub 的区别\n\n| 维度 | ClawHub | GitHub（独立仓库） |\n|------|---------|-------------------|\n| 平台 | clawhub CLI | git + gh CLI |\n| 版本管理 | clawhub 内部管理 | git tag + Release |\n| 验证方式 | `clawhub inspect` | `git log` + `gh release list` |\n| 发布命令 | `clawhub publish` | `git push` + `gh release create` |\n| 对外说明 | Changelog | Release Notes |\n| 适用场景 | 技能市场分发 | 独立项目/文档站 |\n\nFile v4.5.13:references/promotion.md\n\n# Promotion Guide | 宣传指南\n\nAll skill promotion on social platforms (Moltbook, 抓虾吧, etc.) must follow this guide.\n所有技能推广（社交平台发帖等）必须遵循本指南。\n\n---\n\n## 主文件与分文件职责分工 | File Responsibilities\n\n| 文件 | 职责 |\n|------|------|\n| **SKILL.md（主文件）** | 核心原则、流程骨架、清单元摘要、reference 文件索引 |\n| **promotion.md（本文件）** | 推广专项完整操作指南：两步验证、AI心理学、排版格式、去标识化、数据时效 |\n\n> 本文件为 SKILL.md 的推广专项补充。重大流程变更须同步更新 SKILL.md 清单元摘要。\n\n---\n\n## 推广两步验证流程 | Two-Step Promotion Verification\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。推广发帖、编辑、重新发布均需两步验证。**\n\n### 第一步（AI 内部执行，不输出给用户）\n\n**A. 内容清单核对 | Content Checklist**\n\n| 检查项 | 说明 |\n|--------|------|\n| 去标识化 | 无个人位置/姓名/内部路径/API密钥/Token |\n| 数据时效 | 注明统计截止日期 |\n| 链接准确性 | 链接为完整 URL，非截断或猜测 |\n| 安装命令准确性 | 使用 `clawhub install `，非猜测 |\n| 版本号准确性 | 来自 `clawhub inspect `，非猜测 |\n| 平台格式合规 | Moltbook 使用双语交替格式 |\n\n**B. AI 心理学吸引力检查 | AI Psychology Appeal Checklist**\n\n| 检查项 | 说明 |\n|--------|------|\n| 开头有共鸣点 | 开头能否在 3 秒内引起 AI 读者兴趣？ |\n| 差异化价值 | 技能相比同类有什么独特优势？ |\n| 具体性 | 避免泛泛而谈，有具体数字/功能/场景？ |\n| 行动号召 | 结尾是否有明确的安装/了解更多指引？ |\n| 双语比例 | 英文信息量充足，不依赖中文翻译撑场面？ |\n| 格式呼吸感 | 无大段堆砌，emoji/分段有节奏？ |\n\n**C. 去标识化详细检查 | De-identification Detailed Checklist**\n\n| ❌ 禁止内容 | ✅ 允许内容 |\n|-----------|-----------|\n| 城市/省份/具体国家 | \"中国\"（泛指可）、省略 |\n| 个人姓名 | \"my human\" / \"morois\"（如以品牌身份推广可写） |\n| 本机 API Key / Token | 不提及 |\n| 内部路径如 `~/.openclaw/workspace/` | 不提及 |\n| 私人邮箱/手机号 | 不提及 |\n| 私人项目代号 | 使用公开的技能 slug |\n\n### 第二步（输出给用户，等待明确确认）\n\n**⚠️ 未经用户明确确认，不得在社交平台发帖、编辑或重新发布。**\n\n向用户汇报以下内容，**必须等用户明确确认后才能发帖**：\n\n| 汇报项 | 内容 |\n|--------|------|\n| 推广平台 | Moltbook / 抓虾吧 / 其他 |\n| 推广类型 | 单技能 / 多技能联合 |\n| 目标受众 | Moltbook AI agents / 其他 |\n| 正文全文 | 完整推广文案 |\n| 数据来源与截止日期 | 各技能安装量/星标数及截止日期 |\n| 链接与安装命令 | 确认准确 |\n| AI 心理学自查结果 | 通过/需调整 |\n| 去标识化自查结果 | 通过/需调整 |\n| 平台格式合规自查 | 通过/需调整 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n---\n\n## 平台格式规范 | Platform Format Rules\n\n### Moltbook 推广格式 | Moltbook Post Format\n\n所有 Moltbook 帖子必须使用**双语交替格式**（一句英文一句中文）：\n\n```\n[English sentence] [中文句子][English sentence] [中文句子]\n[English sentence] [中文句子][English sentence] [中文句子]\n```\n\n**单技能推广模板：**\n\n```\n**Skill Name | 技能名** (vX.Y · N installs · ★N)\nShort concrete English pitch. 简短中文说明。\n\nWhat it does: 一句话功能描述\nInstall: clawhub install \nhttps://clawhub.ai//\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n**多技能联合推广模板：**\n\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nmorois and I have published X skills on ClawHub. 截至 YYYY-MM-DD：\n\n📊 Stats | 数据：\n🎙️ Skill A — N installs · ★N · One-line description. 简短中文。\n🔊 Skill B — N installs · ★N · One-line description. 简短中文。\n…（每个技能一行，emoji + name + stats + 英文/中文各一句）\n\nInstall any: clawhub install \nBrowse all: clawhub.ai/\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n---\n\n## 数据时效性要求 | Data Freshness Requirements\n\n- 所有安装量/星标数必须注明**截止日期**\n- 格式：`截至 YYYY-MM-DD 的数据`\n- 每次发布推广前必须重新确认最新数字（通过 `clawhub inspect` 或 ClawHub 页面）\n- 不得使用超过 **30 天**的旧数据\n\n---\n\n## AI 心理学吸引力原则 | AI Psychology Appeal Principles\n\n**1. 开场共鸣（3秒法则）**\n- 第一句话要让 AI 觉得\"这和我有关\"或\"这很有趣\"\n- 避免空洞开场如 \"Hello everyone\" → 改用具体场景或问题切入\n\n**2. 差异化价值主张**\n- 不要只说\"这是个很棒的技能\"\n- 说清楚**相比其他同类工具的优势**：免费/本地运行/无API费用/更强安全/跨平台\n\n**3. 具体性 > 泛化**\n- ❌ \"A useful tool for everyone\" → 泛泛而谈\n- ✅ \"Offline Whisper STT — no API costs, your audio never leaves your machine\" → 具体价值\n\n**4. 社会认同**\n- 有安装量/星标数要突出显示（同伴认可）\n- 数字本身就是信任信号\n\n**5. 行动号召（CTA）**\n- 每篇结尾必须有明确行动：安装命令 / 访问链接 / 提问邀请\n- 不要让读者\"然后呢\"\n\n**6. 结尾钩子**\n- 以问题结尾，引发评论互动\n- \"What are you building?\" / \"What's your take on this?\" / \"Curious what others think\"\n\n---\n\n## 推荐格式示例 | Suggested Format Examples\n\n**单技能：**\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nJust released Speech Transcriber on CltHub — offline Whisper STT that never sends your audio to the cloud. 我发布了一个离线 Whisper 语音转文字工具，音频永远不离开你的机器。\n\n🎙️ 100% local inference, no API costs, fully offline. 纯本地推理，无 API 费用，完全离线。\n🛡️ Privacy-first: audio stays on your machine. 隐私优先：音频留在本地。\n\nTry it: clawhub install speech-transcriber\nhttps://clawhub.ai//speech-transcriber\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n**多技能联合（更正式）：**\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nmorois and I have published 7 skills on ClawHub. 截至 2026-04-05：\n\n📊 Stats | 数据：\n🎙️ Speech Transcriber — 11 installs · Local Whisper or OpenAI API STT, fully offline. 纯本地 Whisper，隐私安全。\n🔊 Speech Synthesizer — 60 installs · edge-tts (free offline neural TTS) or OpenAI API TTS. 微软 TTS 免费离线。\n📹 Camera YOLO Operator — 120 installs · YOLO detection + depth estimation on your webcam. 摄像头目标检测+景深。\n💬 AI Socializer — 29 installs · Patrol Moltbook & more, API key hardlocked to www.moltbook.com. 社交巡逻，密钥铁律。\n💼 Skill Manager — 870 installs · Two-step publish workflow and checklist. 技能全流程。\n📺 Bilibili Messager — 654 installs · Browser-automation DM for Bilibili. B站私信。\n📱 Douyin Messager — 1.9k installs · ★9 · Browser-automation DM for Douyin. 抖音私信。\n\nInstall any: clawhub install \nBrowse all: clawhub.ai/\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n---\n\n## Reminder | 提醒\n\n- Promotion copy may be more lively than changelog copy, but changelog text itself must stay formal.\n 宣传文案可以比 changelog 略活，但 changelog 本身必须保持正式。\n- Two-step verification applies to every promotion action, including edits and repromotions.\n 两步验证适用于所有推广操作，包括修改和重新发布。\n\nFile v4.5.13:references/rename-workflow.md\n\n# Rename Workflow | 改名全量替换流程\n\n> 改名 = 全量替换，不留死角。由内到外、由本地到线上，一次改名，多端核对。\n> Rename = full replacement, no exceptions. Inside-out, local-to-online, one rename, multi-channel verification.\n\n## 原则 | Principles\n\n1. **全量替换** — 改名不是改标题，是所有出现旧名称的地方都要改。\n2. **由内到外** — 先改文件内容，再改目录名/仓库名（否则文件路径会断）。\n3. **由本地到线上** — 先改本地，再改 GitHub，最后改 ClawHub。\n4. **多端核对** — 本地文件、GitHub、ClawHub、memory 全部对齐后才算完成。\n5. **两步验证** — 改名涉及多处写入，必须走两步验证流程。\n6. **slug 同步** — 显示名改了，slug 也要同步改（小写+连字符）。\n\n## 渠道清单 | All Channels\n\n改名时必须检查以下**所有渠道**，逐项核对：\n\n### 本地文件系统\n\n| # | 渠道 | 路径模式 | 说明 |\n|---|------|----------|------|\n| L1 | 项目目录 | `~/.openclaw/workspace/projects//` | 重命名为 `/` |\n| L2 | 技能目录 | `~/.openclaw/workspace/skills//` | 重命名为 `/`（如有） |\n| L3 | 模型缓存 | `~/.cache/huggingface/modules//` | 重命名为 `/`（如有） |\n| L4 | 项目内文件 | `projects//README.md` | 标题、描述、目录结构中的名称 |\n| L5 | 项目内文件 | `projects//src/index.html` | 页面标题、H1、meta 标签 |\n| L6 | 项目内文件 | `projects//references/*.md` | 引用旧名称的行 |\n| L7 | 项目内文件 | `projects//SKILL.md` | 技能主文件（如有） |\n| L8 | git remote | `git remote -v` | URL 中的仓库名 |\n| L9 | Memory 文件 | `~/.openclaw/workspace/MEMORY.md` | 项目索引中的名称 |\n| L10 | Memory 文件 | `~/.openclaw/workspace/memory/*.md` | 日记中的名称 |\n| L11 | 其他文件 | `TOOLS.md`, `HEARTBEAT.md`, `AGENTS.md` | 如有引用 |\n\n### 线上平台\n\n| # | 渠道 | 操作 | 说明 |\n|---|------|------|------|\n| O1 | GitHub repo slug | `gh repo rename --repo / --yes` | 仓库名变更 |\n| O2 | GitHub description | `gh repo edit --description \"\"` | 仓库描述更新 |\n| O3 | GitHub remote URL | `git remote set-url origin ` | 本地 git remote 同步 |\n| O4 | ClawHub slug | `clawhub publish ... --slug ` | 重新发布（如已发布） |\n| O5 | ClawHub display name | `clawhub publish ... --name \"\"` | 重新发布（如已发布） |\n\n## 执行顺序 | Execution Order\n\n> 严格按顺序执行，不可跳步。\n\n```\n第一步：审计（Audit）\n └── 在所有渠道中搜索旧名称，生成完整变更清单\n\n第二步：改文件内容（Inner）\n └── 先改文件里的文字，再改目录名\n └── 原因：如果先改目录名，文件路径会断\n\n第三步：改本地目录名（Local Structure）\n └── 项目目录、技能目录、模型缓存\n └── 更新 git remote URL\n\n第四步：改线上平台（Online）\n └── GitHub rename → description → ClawHub（如适用）\n\n第五步：改 Memory（Memory）\n └── MEMORY.md + memory/*.md\n\n第六步：验证（Verify）\n └── 全渠道搜索旧名称，确认零残留\n └── 检查 slug/display name/description 一致性\n```\n\n## 审计命令 | Audit Commands\n\n```bash\n# 搜索项目内所有旧名称\ngrep -rn \"\" ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" --include=\"*.js\" --include=\"*.json\"\n\n# 搜索 memory 文件\ngrep -rn \"\\|\" ~/.openclaw/workspace/MEMORY.md ~/.openclaw/workspace/memory/\n\n# 搜索 TOOLS.md / HEARTBEAT.md\ngrep -rn \"\" ~/.openclaw/workspace/TOOLS.md ~/.openclaw/workspace/HEARTBEAT.md 2>/dev/null\n\n# 搜索 skills 目录\ngrep -rn \"\" ~/.openclaw/workspace/skills// --include=\"*.md\" 2>/dev/null\n\n# 检查 GitHub\ngh repo view / --json name,description\n\n# 检查 ClawHub（如已发布）\nclawhub inspect 2>/dev/null\n```\n\n## 两步验证 | Two-Step Verification\n\n### 第一步（AI 内部执行，不输出给用户）\n\n- 执行审计命令，生成完整变更清单\n- 按渠道分类，逐项标注需要变更的内容\n- 确定新 slug（小写+连字符）和新 display name（`EN | CN` 格式）\n- 检查新名称是否与已有 slug 冲突\n\n### 第二步（输出给用户，等待确认）\n\n输出以下全部内容：\n\n```markdown\n## 📋 改名汇报 | → \n\n**旧名称：** （slug: ）\n**新名称：** （slug: ）\n\n### 变更清单\n\n| # | 渠道 | 位置 | 旧值 | 新值 |\n|---|------|------|------|------|\n| L1 | 本地目录 | projects// | | |\n| ... | ... | ... | ... | ... |\n\n### 执行顺序\n1. 改文件内容（sed）\n2. 改目录名（mv）\n3. 改 GitHub（gh repo rename）\n4. 改 git remote（git remote set-url）\n5. 改 memory（sed）\n6. git commit + push\n\n### 核对清单\n| # | 检查项 | 状态 |\n|---|--------|------|\n| ... | ... | ✅ / ⚠️ |\n```\n\n**确认标志**：用户回复「确认-」后才可执行。\n\n## 执行命令模板 | Command Templates\n\n```bash\n# === 1. 改文件内容 ===\ncd ~/.openclaw/workspace/projects/\nsed -i 's///g' \n\n# === 2. 改目录名 ===\nmv ~/.openclaw/workspace/projects/ ~/.openclaw/workspace/projects/\nmv ~/.openclaw/workspace/skills/ ~/.openclaw/workspace/skills/ # 如有\nmv ~/.cache/huggingface/modules/ ~/.cache/huggingface/modules/ # 如有\n\n# === 3. 改 GitHub ===\ngh repo rename --repo / --yes\ngh repo edit / --description \"\"\n\n# === 4. 改 git remote ===\ncd ~/.openclaw/workspace/projects/\ngit remote set-url origin https://github.com//.git\n\n# === 5. 改 memory ===\nsed -i 's///g' ~/.openclaw/workspace/MEMORY.md\nsed -i 's///g' ~/.openclaw/workspace/memory/*.md\n\n# === 6. git commit + push ===\ngit add -A\ngit commit -m \"rename: \"\ngit push\n```\n\n## 验证命令 | Verification Commands\n\n```bash\n# 零残留验证：搜索旧名称\ngrep -rc \"\\|\" ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" | grep -v \":0$\"\n# 期望：无输出（零残留）\n\n# 正文中的描述性用词（如\"重建三维场景\"）不算残留，只有项目名/slug 算\n\n# 一致性验证\nhead -1 ~/.openclaw/workspace/projects//README.md # 标题正确\ngit remote -v # remote URL 正确\ngh repo view / --json name,description # GitHub 正确\n```\n\n## 常见陷阱 | Common Pitfalls\n\n| 陷阱 | 说明 | 防范 |\n|------|------|------|\n| 只改标题不改 slug | 目录名/仓库名还是旧的 | slug 必须同步改 |\n| 只改本地不改线上 | GitHub 还是旧名 | 逐渠道核对 |\n| 先改目录名再改内容 | 文件路径断了，sed 找不到文件 | 先改内容再改目录 |\n| 忘记改 memory | MEMORY.md 里还是旧名 | memory 纳入变更清单 |\n| 忘记改 git remote | push 到旧地址 | remote URL 同步更新 |\n| 正文描述性用词误判 | \"重建三维场景\"不是项目名 | 只改项目名/slug，不改描述性用词 |\n| ClawHub 未同步 | ClawHub 还是旧名 | 已发布的需重新 publish |\n\nFile v4.5.13:references/search-and-audit.md\n\n# Search and Audit Guide | 搜索与审计指南\n\n## Search workflow | 搜索流程\n\n1. Check local formal skills first. \n 先检查本地正式技能。\n2. Check built-in skills if relevant. \n 如有需要，再检查内置技能。\n3. Search ClawHub only when local options are insufficient. \n 只有在本地选项不足时才搜索 ClawHub。\n4. Let the user choose before install or replacement. \n 在安装或替换前，让用户做选择。\n\n## Search commands | 搜索相关命令\n\n```bash\nclawhub search \nclawhub inspect \nclawhub list\nclawhub uninstall \nclawhub star \nclawhub unstar \n```\n\n## Audit mindset | 审计思路\n\nBefore recommending install or update, check: \n在推荐安装或更新前，检查：\n- overlap with existing local skills \n 是否与现有本地技能功能重叠\n- whether the skill is actively maintained \n 技能是否还在持续维护\n- whether the skill description matches the user's real need \n 技能描述是否真的匹配用户需求\n- whether sensitive or risky behavior needs review \n 是否存在需要额外审查的敏感或高风险行为\n\n## Output style | 输出风格\n\nGive the user a short comparison: \n给用户一个简短对比：\n- recommended \n 推荐\n- possible alternative \n 可选替代\n- not recommended \n 不推荐\n\nKeep recommendations concrete. \n建议必须具体，不要空泛。\n\nArchive v4.5.12: 9 files, 33960 bytes\n\nFiles: _meta.json (144b), references/clawflows-workflow.md (9610b), references/clawhub-inspect.md (3284b), references/clawhub-publish.md (13369b), references/github-publish.md (6799b), references/promotion.md (8233b), references/rename-workflow.md (7531b), references/search-and-audit.md (1411b), SKILL.md (21999b)\n\nFile v4.5.12:SKILL.md\n\n---\nname: Skill Manager All In One | 一站式技能管理器\ndescription: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。\nmetadata: {\"openclaw\":{\"requires\":{\"bins\":[\"git\",\"gh\"]},\"runtime\":{\"requiredBinaries\":[\"clawhub\",\"git\",\"gh\"],\"credentialExpectations\":[\"ClawHub CLI login/session for publish/delete/hide/unhide/sync\",\"Git/GitHub CLI authentication for GitHub workflows\"],\"filesystemWrites\":[\"~/.openclaw/workspace/skills//\",\"~/.openclaw/workspace/projects//\",\"~/.cache/huggingface/modules//\"],\"externalWrites\":[\"clawhub publish/delete/hide/unhide/sync\",\"git push\",\"gh release create\"],\"confirmation\":\"Show exact commands and wait for the user to reply with an explicit \"确认-\" electronic signature before any publish, delete, push, move, overwrite, or other writes. Do NOT proceed without this signature.\"}}}\n---\n\n# Skill Manager All In One | 一站式技能管理器\n\n## Runtime Expectations | 运行依赖与权限声明\n\nThis skill may guide an agent to inspect, create, edit, move, publish, or audit OpenClaw skill files. It is not a passive documentation-only skill.\n本技能可能指导 agent 检查、创建、编辑、移动、发布或审计 OpenClaw 技能文件；它不是只读文档型技能。\n\n### Required binaries | 所需命令行工具\n\nDeclare and verify these before any publish or external write:\n发布或外部写入前，必须声明并验证以下工具：\n\nThese requirements must be declared in SKILL.md frontmatter `metadata` as well as in the body text. ClawHub/security scanners read metadata, not only prose.\n这些要求必须同时写入 SKILL.md frontmatter `metadata` 和正文说明。ClawHub/安全扫描器会读取 metadata，不只读取正文。\n\n| Tool | Used for | Verify command |\n|------|----------|----------------|\n| `clawhub` | ClawHub skill inspect/publish/delete/hide/unhide/sync | `clawhub --help` or `~/.openclaw/tools/node/npm/bin/clawhub --help` |\n| `git` | Git status/commit/log/revert workflows | `git --version` |\n| `gh` | GitHub release/PR workflows, only when target platform is GitHub | `gh --version` |\n\n### Credentials and authentication | 凭据与授权\n\n- ClawHub publishing requires an authenticated ClawHub session/token.\n ClawHub 发布需要已登录的 ClawHub 会话/token。\n- GitHub publishing requires Git/GitHub authentication and may use `gh` credentials.\n GitHub 发布需要 Git/GitHub 授权，可能使用 `gh` 凭据。\n- Do **not** ask the user to paste long-lived secrets into chat. Prefer existing CLI login/session state.\n 不要要求用户在聊天中粘贴长期密钥；优先使用已有 CLI 登录态。\n- Before running credential-using commands, print the exact command and wait for the user to reply with \"确认-\" electronic signature.\n 执行会使用凭据的命令前，必须打印精确命令并等待用户回复「确认-」电子签名。\n\n### Filesystem scope and write risks | 文件系统范围与写入风险\n\nThis skill may operate on:\n本技能可能操作：\n\n- `~/.openclaw/workspace/skills//` — skill source files only.\n 仅放技能源文件。\n- `~/.openclaw/workspace/projects//` — runtime files, outputs, reports, and project data.\n 放运行文件、输出、报告和项目数据。\n- `~/.cache/huggingface/modules//` — model files.\n 放模型文件。\n\nNever move, delete, overwrite, publish, push, or otherwise mutate files without first showing the planned paths and commands and receiving \"确认-\" electronic signature.\n移动、删除、覆盖、发布、推送或其他写入操作前，必须先展示计划路径和命令，并获得「确认-」电子签名授权。\n\n### Dry-run first | 优先 dry-run / local-test\n\nFor high-impact changes, start in `local-test` mode: inspect files, produce a planned command list, and stop before mutation or publication.\n高影响变更先进入 `local-test`：只检查文件、生成拟执行命令列表，在真正写入或发布前停止。\n\n## 模式 | Mode\n\n> 读取本 SKILL.md 后，先确认当前任务属于哪种模式，再跳转对应章节执行。\n\n| 模式 | 说明 |\n|------|------|\n| **create** | 从零创建新技能 |\n| **modify** | 修改已发布技能（升版/功能调整） |\n| **audit** | 审计本地或已发布技能的质量、逻辑、声明完整性 |\n| **local-test** | 仅本地测试，不发布 |\n\n---\n\n## 核心原则 | Core Rules\n\n1. **Local first, network second** — 先检查本地已安装技能，再搜索网络。\n2. **Be concrete** — 汇报时写清楚准确路径、准确命令、准确版本变化。\n3. **One by one, confirm one by one** — 涉及多个文件/版本/技能时，必须逐个处理、逐个确认。每项确认都必须获得「确认-」格式的电子签名授权，禁止批量操作。\n4. **Publish like a product** — 发布文本应像正式发布说明，而非聊天记录。\n5. **For AI and humans** — 技能正文应兼顾 agent 与人类可读性。\n6. **English first, Chinese second** — 对外展示文本统一先英文后中文；包括 `name`、SKILL.md frontmatter `description`（发布到 ClawHub 后显示为 registry `summary` / CLI `Summary:`）、Changelog、README 关键标题与核心段落。中文不能因英文过长而被预览截断。\n7. **Learn from release evidence** — 发布流程规则来自真实发布证据；新增检查项前先确认它能防止具体失误，而不是堆砌流程。\n\n---\n\n## 技能制作流程 | Phase 1: Create / Modify\n\n> 按顺序执行，边做边对照第 6 章「统一检查清单」的【通用质量基线】。\n\n### 步骤 1：明确需求\n\n确定以下四项，作为后续所有操作的依据：\n\n- **目标平台**：ClawHub / GitHub / 其他\n- **版本号**：首次发布为 `1.0.0`\n\n> ⚠️ Display name 和 Skill slug 是 ClawHub 专属概念，若目标平台为 ClawHub，请在 Phase 2 步骤 1 确认。\n\n### 步骤 2：创建目录结构\n\n参考第 7 章「技能目录体系」，在正式技能目录创建技能文件夹。\n\n```\n~/.openclaw/workspace/skills//\n```\n\n### 步骤 3：编写 SKILL.md\n\n按本技能的主模板编写 SKILL.md（参考 Phase 1 步骤 1 确认的平台需求）。\n\n### 步骤 4：边做边查——对照清单\n\n每完成一个文件或代码块，立即对照第 6 章【通用质量基线】逐项打勾。\n\n**目标平台已确定时，附加对应平台专项（ClawHub → CH01~CH11，GitHub → GH01~GH06）。**\n\n> 如 Phase 1 已逐项打勾通用基线，Phase 2 只需复核 + 补充平台专项，不必重复全量检查。\n\n---\n\n## 技能发布验证流程 | Phase 2: Publish\n\n> 必须完成 Phase 1 后才能执行本阶段。\n\n### 步骤 1：确认基本信息 & 复查清单\n\n**ClawHub 目标时，先确认以下两项：**\n- **Display name**：`EN Title | CN Title` 双语格式（对应 CH01）\n- **Skill slug**：小写字母 + 连字符，如 `speech-synthesizer`\n\n**然后复查清单：**\n- 对照第 6 章【通用质量基线】全部项（G01~G06）\n- 根据目标平台，额外核对【平台专项】（ClawHub → CH01~CH11，GitHub → GH01~GH06）\n- 逐项标注 ✅ / ⚠️，有问题的立即修复\n\n### 步骤 2：⚠️ 两步验证（强制，必须执行）\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。**\n\n#### 第一步（AI 内部执行，不输出给用户）\n- 核对清单（G01~G06 + 对应平台专项）\n- 检查文件大小（>50MB 需报告）\n- ClawHub 目标时检查对外表述：`name`、SKILL.md frontmatter `description`（ClawHub registry `summary` / CLI `Summary:`）、Changelog、README 关键标题和核心说明均应先英文后中文\n- 检查 ClawHub 摘要：`description` 应短而清楚；发布后用 `inspect` 查看 `Summary:`，确认中文在预览可见范围内\n- 拟定 Changelog\n\n#### 第二步（输出给用户，等待明确确认）\n必须输出以下全部内容（用第 9 章汇报模板），**确认前不得执行任何发布类命令**：\n\n**必填字段（每次都要列出）：**\n- Display name（双语格式）\n- Skill slug\n- SKILL.md description（先英文后中文，总字符≤150）\n- 目标平台\n- 当前版本 → 新版本号\n- Changelog（英文在前，中文在后）\n- 文件大小\n- 核对清单（逐项列出，标注 ✅ 或 ⚠️）\n- 发布命令（完整命令）\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**⚠️ 两步验证适用于所有发布类操作**：clawhub publish / git push / gh release create / 推广发帖 / 社交平台发帖等。\n\n> 上两步验证前，先读对应 reference：ClawHub 上传/升版 → `references/clawhub-publish.md`；GitHub 上传 → `references/github-publish.md`。\n\n### 步骤 3：执行发布\n\n获得用户确认后，执行对应平台的发布命令。\n> ClawHub 上传详见 `references/clawhub-publish.md`；GitHub 上传详见 `references/github-publish.md`。\n\n**若用户拒绝发布**：回到 Phase 1 修改流程，递增修订版本号（如 1.2.1 → 1.2.2-dev），不得直接重复尝试发布相同内容。\n\n---\n\n## 发布后维护 | Phase 3: Maintain\n\n参考 Phase 1 修改流程 + 版本号递增 → 回到 Phase 2 两步验证。\n\n- **升版/更新**：ClawHub → `references/clawhub-publish.md`；GitHub → `references/github-publish.md`\n- **宣传/推广**：读 `references/promotion.md`（Moltbook 格式、AI心理学、去标识化）\n- **查看详情**：ClawHub → `clawhub inspect ` + `references/clawhub-inspect.md`（Details ▾ 确认 Assessment）\n- **GitHub**：`git log` 验证\n- **回滚**：clawhub → `clawhub delete --yes`（软删除）；GitHub → `git revert`\n- **隐藏/恢复/删除**：执行前报告 + 执行后验证\n\n---\n\n## 安全扫描说明 | Security Scans（仅限 ClawHub）\n\nClawHub 发布后会自动进行三项安全扫描（GitHub 发布无此流程）。\n\n### 三项扫描介绍\n\n| 扫描 | 扫描对象 | 判定方式 | 误报率 |\n|------|---------|---------|--------|\n| VirusTotal | 整个发布包（zip） | 外部引擎 + Code Insight LLM | 高（敏感能力类技能常见 Review） |\n| ClawScan | SKILL.md + metadata | OpenClaw 自有 LLM 分析 | 中（可通过声明优化） |\n| Static Analysis | 代码模式 | 静态规则匹配 | 低 |\n\n### VirusTotal 常见结果\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| Review | 平台标记了敏感能力（如私信读写、浏览器自动化） | 功能性质决定，无法消除，接受（需向用户说明原因） |\n| Suspicious | 检测到可疑模式（非功能性质） | ❌ 必须修复，向用户汇报具体可疑内容 |\n\n### ClawScan 常见 findings 类型\n\n- Tool Misuse and Exploitation（工具滥用）\n- Agentic Supply Chain Vulnerabilities（供应链风险）\n- Identity and Privilege Abuse（身份权限滥用）\n- Memory and Context Poisoning（上下文泄露）\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| Review | 检测到敏感能力，但有缓解措施 | 优化 SKILL.md 声明（加两步验证、数据披露、凭据声明）降低 severity |\n\n### Static Analysis 常见结果\n\n| 结果 | 含义 | 处理方式 |\n|------|------|----------|\n| Benign | ✅ 通过 | 无需处理 |\n| 非 Benign | 命中注入/路径风险等规则 | ❌ 列出具体命中规则，修复代码 |\n\n### 发布后汇报流程（ClawHub 专有）\n\n> 发布后必须汇报 ClawHub 平台的安全扫描结果。扫描结果可能需要数分钟到数小时才全部完成。\n\n**发布后汇报时机：**\n- 如果发布后立即能看到结果（数分钟内），当场汇报\n- 如果发布后结果尚未完成，告知用户稍后查看 `https://clawhub.ai/moroiser//security`\n\n**汇报格式（SOP）：**\n```markdown\n## 🔍 技能安全扫描汇报 | v\n\n**技能：** \n**slug：** \n**版本：** \n**复查时间：** \n\n### 安全扫描结果\n\n| 扫描项 | 结果 | 处理 |\n|--------|------|------|\n| VirusTotal | Benign / ⚠️ Review / ❌ Suspicious | <处理方式> |\n| ClawScan | Benign / ⚠️ Review | <处理方式> |\n| Static analysis | Benign / ❌ 非 Benign | <处理方式> |\n\n### 问题与修复（如有）\n- <扫描项>: <具体问题描述> → <修复方案>（需用户「确认-」后执行）\n```\n\n**处理原则：**\n- Benign → 无需处理\n- 非 Benign → 逐项列出问题，向用户说明，寻求「确认-」授权后修复\n\n---\n\n## 统一检查清单 | Checklist（制作与发布共享）\n\n**上游参考技能保护**：不要直接修改上游/参考技能，尤其是 `skill-creator`。它会随 OpenClaw 或上游版本更新而变化；本技能只能把本地经验沉淀到 `skill-manager-all-in-one` 自己的 SKILL.md / references 中。若确实需要修改上游技能，必须先向用户说明原因、影响和恢复方案，等待明确授权。\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| G01 | 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | 无注入风险（Shell注入/Python注入/路径注入）、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | 结构清晰、路径准确、模块化、**同名规范** |\n| G04 | AI 可读性 | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | 代码整洁、注释到位、变量命名清晰、模块化 |\n| G06 | 依赖/凭据声明 | 外部 Python 包、命令行工具、API、模型、账号权限、凭据来源、文件系统写入范围必须明确声明；不得硬编码密钥。发布类技能需声明 `clawhub`/`git`/`gh` 等工具及验证命令。\n\n### ClawHub 专项（附加于通用基线之后）\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| CH01 | Display Name 双保险 | **ClawHub 页面展示名必须双保险**：`SKILL.md` frontmatter 的 `name:` 填 `EN Title | CN Title`，发布命令也必须显式传 `--name \"EN Title | CN Title\"`。实测仅改 `name:` / `_meta.displayName` 更新版本时，ClawHub 顶部展示名可能不会同步中文。例：`clawhub publish --slug speech-synthesizer --name \"TTS Speaker | TTS 朗读器\" --version 1.0.1 ...` |\n| CH02 | Skill slug | 技能唯一标识符，小写字母 + 连字符（例：`speech-synthesizer`）；在 `~/.openclaw/workspace/skills//` 目录名和 `clawhub publish` 命令中使用 |\n| CH03 | SKILL.md description 双语且≤150字符 | SKILL.md frontmatter `description` 是发布到 ClawHub 后的 registry `summary`（CLI 显示为 `Summary:`）。要求：先英文后中文，总字符数控制在 150 以内（含中英文、标点、空格），英文部分优先短句，确保中文在卡片预览可见、不被截断。 |\n| CH04 | Changelog 格式 | 英文在前（面向用户描述功能变化，而非开发者心理活动）、双语数字列表。**禁止提及安全扫描结果或扫描器名称**（如 ClawScan、VirusTotal、SUSPICIOUS、Benign 等），changelog 只描述功能改动本身，不得暗示意图影响扫描判定。 |\n| CH05 | Embedding 500 应急 | 当 SKILL.md 或引用的 reference 文件超过 500 行时，自动拆分或提供摘要版本 |\n| CH06 | 文件/模型分离 | 技能文件夹（`~/.openclaw/workspace/skills//`）**严禁存放任何模型文件、运行产物、结果文件**。模型文件统一放 `~/.cache/huggingface/modules//`；运行文件与结果文件统一放 `~/.openclaw/workspace/projects//`。技能文件夹本身仅含技能代码（SKILL.md、脚本、配置文件等），大小应控制在 50MB 以内。发布前 `du -sh ` 超过 50MB 需立即处理。 |\n| CH07 | 版本号一致性 | `_meta.json` version、changelog 版本号、发布命令版本号三者必须一致 |\n| CH08 | 对外表述顺序统一 | 所有面向用户的双语表述统一先英文后中文：Display name、SKILL.md `description` / ClawHub `Summary:`、Changelog、README 关键标题、核心说明、示例说明。避免一处中文在前、一处英文在前造成发布页风格不一致。 |\n| CH09 | 坏符号链接 | 无失效符号链接 |\n| CH10 | 运行时产物 | 无 `.pyc`、`.pyo`、`__pycache__`、`.log` 等运行时产物 |\n| CH11 | 目录隔离 | 确保技能文件夹内无 `.git/`、`.DS_Store`、`Thumbs.db` 等无关元数据 |\n| CH12 | 英中文顺序检测 | 关键信息先英文后中文：① Display name 用 `|` 分隔（如 `EN Title | CN Title`）；② description 不用 `|`，英文句在前、中文句在后，≤150字符；③ Changelog 英文在前、中文在后；④ SKILL.md 正文关键标题/说明、references 关键内容均为先英文后中文。不因顺序检查影响技能高效与稳定。 |\n\n### GitHub 专项（附加于通用基线之后）\n\n> ⚠️ 必须先通过通用质量基线 G01~G06。\n\n| # | 检查项 | 说明 |\n|---|---------|------|\n| GH01 | git status | 无未提交变更（`git status` 干净） |\n| GH02 | 分支规范 | main/master 分支干净，commit 原子化 |\n| GH03 | commit 规范 | commit message 简洁、描述性、一行概括 + 详细说明 |\n| GH04 | Release Notes | 格式规范，与 changelog 内容一致 |\n| GH05 | 文件完整性 | 无多余临时文件 |\n| GH06 | License 检查 | 发布前确认包含合适开源许可证文件（如 MIT），或明确声明无许可证 |\n\n---\n\n## 技能目录体系 | Directory System\n\n| 目录 | 路径 |\n|------|------|\n| 正式技能 | `~/.openclaw/workspace/skills//` |\n| 插件技能 | `~/.openclaw/extensions/` |\n| 临时草稿 | `~/.openclaw/workspace/temp-skills//` |\n| 工作区资源 | `~/.openclaw/workspace/projects//` |\n| 模型缓存 | `~/.cache/huggingface/modules//` |\n\n### 各目录职责（强制分离）\n\n> **技能文件夹 = 纯技能代码**。禁止放入任何模型、运行产物、结果文件。\n\n| 目录 | 职责 | 禁止放入 |\n|------|------|---------|\n| `~/.openclaw/workspace/skills//` | 技能代码（SKILL.md、脚本、配置） | 模型文件、运行结果、输出文件 |\n| `~/.openclaw/workspace/projects//` | 运行文件、结果输出、数据文件 | 技能源代码 |\n| `~/.cache/huggingface/modules//` | 所有模型文件（.pt/.onnx 等） | 非模型文件 |\n\n**示例（speech-transcriber 技能）：**\n```\n~/.openclaw/workspace/skills/speech-transcriber/ # ✅ 技能代码（SKILL.md、scripts/、requirements.txt）\n~/.openclaw/workspace/projects/speech-transcriber/ # ✅ 运行文件与结果（transcriptions/、recordings/、outputs/）\n~/.cache/huggingface/modules/speech-transcriber/ # ✅ 模型文件（small/、medium/）\n```\n\n### 命名规范 | Naming Convention\n\n**⚠️ 重要：项目目录和模型缓存必须与技能名（slug）保持一致。**\n\n---\n\n\n## 汇报模板 | Report Template\n\n汇报时必须包含以下全部内容。SOP 格式：逐项列表格，逐项打 ✅ / ⚠️。\n\n### 汇报格式\n\n```markdown\n## 🔍 技能发布汇报 | v\n\n**Display name：** \n**Skill slug：** \n**目标平台：** clawhub / github\n**SKILL.md description：** （ 字符）\n**当前版本：** → **新版本：** \n**Changelog：**\n1. . <中文更新>。\n\n**文件大小：** KB\n\n---\n\n### 核对清单\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| G01 | 去标识化 | ✅ / ⚠️ | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | ✅ / ⚠️ | 无注入风险、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | ✅ / ⚠️ | 结构清晰、路径准确、模块化、同名规范 |\n| G04 | AI 可读性 | ✅ / ⚠️ | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | ✅ / ⚠️ | 代码整洁、注释到位、变量命名清晰 |\n| G06 | 依赖/凭据声明 | ✅ / ⚠️ | 外部包/工具/密钥已声明，无硬编码 |\n| CH01 | Display Name 双保险 | ✅ / ⚠️ | `name:` = `EN Title | CN Title`；`--name` 参数一致 |\n| CH02 | Skill slug | ✅ / ⚠️ | 小写字母 + 连字符 |\n| CH03 | description ≤150 字符 | ✅ / ⚠️ | 英文在前、中文在后，总字符 ≤150，不用 `|` 分隔 |\n| CH04 | Changelog 格式 | ✅ / ⚠️ | 英文在前、中文在后，数字列表，正式语气 |\n| CH05 | Embedding 500 应急 | ✅ / ⚠️ | SKILL.md + references 均 ≤500 行，否则拆分 |\n| CH06 | 文件/模型分离 | ✅ / ⚠️ | 技能文件夹 ≤50MB，无模型/结果文件 |\n| CH07 | 版本号一致性 | ✅ / ⚠️ | `_meta.json` / changelog / 发布命令三处一致 |\n| CH08 | 对外表述顺序统一 | ✅ / ⚠️ | 所有双语表述均先英文后中文 |\n| CH09 | 坏符号链接 | ✅ / ⚠️ | 无失效符号链接 |\n| CH10 | 运行时产物 | ✅ / ⚠️ | 无 .pyc / .pyo / __pycache__ / .log |\n| CH11 | 目录隔离 | ✅ / ⚠️ | 无 .git / .DS_Store / Thumbs.db 等无关文件 |\n| CH12 | 英中文顺序检测 | ✅ / ⚠️ | 关键信息先英文后中文：display name（用 `|`）、description（不用 `|`）、changelog、主分文件关键内容 |\n\n---\n\n### 发布命令\n\n```bash\nclawhub publish --slug --name \"\" --version --changelog \"\"\n```\n\n### 问题与修复（如有）\n\n- <检查项>: <具体问题> → <修复方案>（需用户「确认-」后执行）\n```\n\n---\n\n## 实用说明 | Practical Notes\n\n### 执行提示\n\n- 执行敏感操作前，用 `clawhub --help` 核对当前 CLI 行为\n- `skill-creator` 是底层规则权威来源\n\nFile v4.5.12:_meta.json\n\n{\n \"ownerId\": \"kn75k53tcdhqwka2fra5x817p9821zpb\",\n \"slug\": \"skill-manager-all-in-one\",\n \"version\": \"4.5.12\",\n \"publishedAt\": 1778169778395\n}\n\nFile v4.5.12:references/clawflows-workflow.md\n\n# ClawFlows Workflow Format Guide | ClawFlows Workflow 格式指南\n\n## Overview | 概述\n\nClawFlows 是一个多技能自动化流程市场，工作流以 YAML 文件定义，提交到 GitHub Registry 经 PR 审核后上线。\n\nWorkflow 与 Skill 的核心区别：\n- **Skill**：本地写好，`clawhub publish` 直接发布，即时生效\n**Workflow**：本地写好，需 fork registry 提 PR，等审核合并后才上线\n\n---\n\n## Two Formats | 两种格式\n\nEvery automation comes in two flavors: \n每个自动化都有两种格式：\n\n| Format | 用途 | Token 消耗 |\n|--------|------|-----------|\n| **Abstract（能力型）** | 跨平台可移植，描述需要哪些 capabilities | 0 |\n| **Lobster-Ready（直接运行型）** | 直接可跑，deterministic shell pipelines | 0 |\n\n---\n\n## File Structure | 目录结构\n\n```\nautomations//\n├── automation.yaml # Workflow 定义\n├── metadata.json # 搜索/展示元数据\n└── README.md # 文档（英中文双语）\n```\n\n---\n\n## automation.yaml | Workflow 定义\n\n```yaml\nname: my-workflow # 唯一标识，slug 格式（小写字母、数字、连字符）\ndescription: One-line description # 一行描述，用于搜索结果\nauthor: your-github-username\nversion: 1.0.0 # 语义化版本\n\nrequires:\n - capability: capability-name # 所需能力，非具体 skill 名\n\ntrigger:\n manual: true # manual=true 表示手动触发；或 schedule: \"0 9 * * *\"\n\nconfig:\n setting_name:\n description: \"用户可配置的设置项说明\"\n default: default_value\n required: false # 是否必填\n\nsteps:\n - name: step-name # 步骤名，唯一标识\n capability: capability-name\n method: methodName\n args:\n key: value\n capture: output_var # 捕获输出，供后续步骤使用\n```\n\n### Key Fields | 关键字段\n\n| 字段 | 说明 |\n|------|------|\n| `name` | URL-safe slug（小写、连字符）|\n| `requires[].capability` | 引用 capability，不写具体 skill 名 |\n| `trigger.schedule` | Cron 表达式，定时触发 |\n| `trigger.manual` | true 表示手动触发 |\n| `steps[].capture` | 捕获输出为变量，`${变量名}` 引用 |\n| `steps[].condition` | JavaScript 表达式，用于条件判断 |\n| `steps[].onFalse` | 条件为 false 时的动作（exit/skip/skip-to:step） |\n\n---\n\n## metadata.json | 元数据\n\n```json\n{\n \"name\": \"workflow-name\",\n \"description\": \"One-line description of what it does\",\n \"author\": \"your-github-username\",\n \"version\": \"1.0.0\",\n \"requires\": [\"capability-1\", \"capability-2\"],\n \"trigger\": \"schedule\",\n \"schedule\": \"0 9 * * *\",\n \"tags\": [\"tag1\", \"tag2\", \"tag3\"]\n}\n```\n\n---\n\n## README.md | 文档规范\n\n```markdown\n# Workflow Name | 工作流名称\n\nBrief description. 简短中文描述。\n\n## What It Does | 功能说明\n\nDetailed explanation of the workflow.\n\n## Requirements | 必要条件\n\n- **capability-name**: Description of what it provides.\n\n## Configuration | 配置项\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `setting` | Description | `default` |\n\n## Example Output | 输出示例\n\nScreenshots, sample notifications, or output examples.\n\n## Author\n\nCreated by [Your Name](https://github.com/username)\n```\n\n---\n\n## Local Install & Run | 本地安装与运行\n\n安装后路径：`~/.openclaw/workspace/automations//`\n\n常用命令：\n```bash\nclawflows install # 从 ClawFlows Registry 安装\nclawflows run # 运行\nclawflows run --dry-run # 预览（不实际执行）\nclawflows check # 检查所需 capabilities\nclawflows list # 列出已安装的工作流\nclawflows logs # 查看运行日志\n```\n\n---\n\n## Publishing Steps | 提交流程\n\n1. Fork [github.com/Cluka-399/clawflows-registry](https://github.com/Cluka-399/clawflows-registry)\n2. 在 fork 中创建 `automations//`\n3. 放入 `automation.yaml`、`metadata.json`、`README.md`\n4. Commit 并 Push 到 fork\n5. 提交 PR 到主仓库\n6. 等官方审核合并\n7. 合并后 GitHub Actions 自动重建 index，出现在 clawflows.com\n\n---\n\n## Capability Reference | 能力参考\n\n常用 capabilities：\n- `database` — 数据存储（SQLite）\n- `chart-generation` — 图表生成\n- `calendar` — 日历/日程\n- `tts` — 文字转语音\n- `notification` — 通知推送\n\nBrowse all: https://clawflows.com/capabilities/\n\n---\n\n## Naming Rules | 命名规则\n\n- **Slug**：小写字母、数字、连字符（无下划线和空格）\n - ✅ `douyin-manager`\n - ❌ `Douyin_Manager`\n- **Display name**：英文在前，中文在后\n - `Douyin Manager | 抖音管理者`\n- **Description**：一行，英文为主，中文辅助，控制在 150 字符内\n\n---\n\n## Writing Rules | 写作规范\n\n- **Abstract** 格式引用 capabilities，不写死具体 skill\n- **Config** 配置项让用户无需改代码即可自定义\n- **Bilingual**：README.md 使用英中文双语\n- **去标识化**：README.md 不暴露个人位置、姓名、API 密钥\n- **Approval Gates**：关键操作步骤用条件判断暂停，等用户确认\n\n---\n\n## Practical Experience Notes | 实践经验总结\n\nBased on real workflow creation (Bilibili Manager | B站管理者). 基于实际工作流创建经验。\n\n### Do Nots | 避免事项\n\n| Issue | Problem | Solution |\n|-------|---------|----------|\n| Runtime data in workflow file | Workflow 文件包含日志逻辑 | Runtime data belongs to user workspace, not workflow definition. 日志是运行时数据，存放在用户工作区，不在工作流定义中 |\n| Duplicate content | 描述重复（中英各写一遍然后又写一遍）| English and Chinese should complement each other, not repeat. 英文和中文应互补，不是重复 |\n| Changelog in workflow | 工作流文件包含更新日志 | Changelog belongs to PR/commit, not workflow file. 更新日志属于 PR/commit，不在工作流文件中 |\n| Embed skill logic | 工作流直接嵌入 skill 实现代码 | Workflow declares capabilities, skill provides implementation. 工作流声明 capabilities，skill 提供实现 |\n| Local paths in public docs | 文档写死本地路径 | Use relative or generic references. 使用相对路径或通用引用 |\n\n### Name & Description | 名称与描述\n\n```yaml\n# Good | 正确\nname: bilibili-manager\ndescription: \"Check DMs, browse content, auto-reply, heartbeat patrol. | B站管理者：私信管理、内容浏览、自动回复、心跳巡逻。\"\n\n# Avoid | 避免\nname: morois-bilibili-dm # Personal name | 个人名称\ndescription: \"B站私信管理器\" # Single language only | 只有单语言\n```\n\n### Skill Reference | Skill 引用\n\n```yaml\n# ===== Skill Reference | Skill 引用 =====\n# First check if already installed locally | 先检测本地是否已安装\n# If not installed: clawhub install bilibili-messager | 未安装则：clawhub install bilibili-messager\n# Operations follow the skill, workflow handles flow control | 具体操作以skill为准，工作流仅负责流程控制\n```\n\n### Workflow Structure | 工作流结构\n\n```yaml\n# ===== Workflow =====\nname: workflow-name\ndescription: \"English first | 中文描述\"\nversion: 1.0.0\n\nrequires:\n - capability: browser\n - capability: notification\n\nconfig:\n auto_mode:\n description: \"Auto mode: no confirmation needed | 自动模式：无需确认\"\n default: false\n\nsteps:\n # Stage 1: Preparation | 阶段1：准备\n # Stage 2: Execute core logic | 阶段2：执行核心逻辑\n # Stage 3: Report result | 阶段3：汇报结果\n```\n\n### Configuration Design | 配置设计原则\n\n| Principle | Description |\n|----------|-------------|\n| User intent detection | Parse user input to determine mode (manual/auto/heartbeat) |\n| Configurable intervals | Use minutes not seconds for heartbeat (e.g., 30, 60, 120) |\n| Clear defaults | Default to safest option (manual mode) |\n| Mode introduction | Auto-show mode guide on first run |\n\n### Bilingual Format | 双语格式规范\n\n**Title**: `English Name | 中文名`\n\n**Description**: English sentence first, then Chinese translation. 不要重复内容。\n```\nCheck DMs, browse content, auto-reply, heartbeat patrol. | B站管理者：私信管理、内容浏览、自动回复、心跳巡逻。\n```\n\n**Features table**:\n```markdown\n| Feature | Description | 功能 |\n|---------|-------------|------|\n| 📬 Check DM List | Get conversation list | 检查私信列表 |\n```\n\n**PR Description**:\n```markdown\n## Workflow Name | 工作流名称\n\nEnglish description first. | 中文描述。\n\n### Features | 功能说明\n| Feature | Description | 功能 |\n|---------|-------------|------|\n```\n\n### Git Commit & PR | Git 提交与 PR\n\n```bash\n# Commit message\ngit commit -m \"feat: add workflow-name | 工作流名称\"\n\n# PR title\ngh pr create --title \"feat: workflow-name | 工作流名称\"\n```\n\n### Publishing Checklist | 发布检查清单\n\n- [ ] Name is URL-safe slug | 名称是 URL 安全的 slug\n- [ ] Description is bilingual | 描述是双语的\n- [ ] README.md is full bilingual | README.md 是完整双语的\n- [ ] No runtime data in workflow file | 工作流文件不包含运行时数据\n- [ ] No local paths in public docs | 公开文档不含本地路径\n- [ ] No personal names/keys | 无个人名称/密钥\n- [ ] Skill reference mentions local-check-first | Skill 引用提到先检测本地\n- [ ] Config descriptions are bilingual | 配置描述是双语的\n- [ ] YAML syntax validated | YAML 语法已验证\n\nFile v4.5.12:references/clawhub-inspect.md\n\n# ClawHub Inspect Guide | ClawHub 查看指南\n\n## CLI basics | CLI 基础检查\n\nCheck current CLI behavior before sensitive operations. Do this again when you suspect the CLI has gained new commands or options. \n在执行敏感操作前，先检查当前 CLI 行为。如果怀疑 CLI 又新增了命令或参数，就再次检查。\n\n```bash\nclawhub --help\nclawhub whoami\nclawhub inspect \n```\n\n## Tool choice | 工具选择\n\nDo not assume one tool is always best. \n不要预设某个工具永远最好。\n\nCheck the current CLI help first, because the CLI can gain new commands and options over time. Then choose CLI or Dashboard based on the task at hand. \n先检查当前 CLI help，因为 CLI 会持续增加新命令和新参数。然后再根据眼前任务选择 CLI 或 Dashboard。\n\n## Tool selection after checking help | 查看 help 后再选工具\n\nUse Dashboard when you need: \n以下场景可用 Dashboard：\n- reviewing all published skills at a glance \n 一眼查看全部已发布技能\n- checking visible card summaries \n 查看卡片摘要信息\n- checking scan state and overview information \n 查看扫描状态和概览信息\n\nUse CLI when you need: \n以下场景可用 CLI：\n- single skill details \n 单个技能详情\n- current latest version \n 当前最新版本\n- file lists \n 文件列表\n- direct metadata lookup \n 元数据直接查询\n- repeatable checks and scripted workflows \n 需要可重复检查或脚本化流程时\n\nUseful commands | 常用命令:\n\n```bash\nclawhub inspect \nclawhub inspect --tag latest\nclawhub inspect --version 1.0.0\nclawhub inspect --versions --limit 20\nclawhub inspect --files\nclawhub inspect --file SKILL.md\nclawhub inspect --json\n```\n\n## Local directory vs CLI list | 本地目录与 CLI list 的区别\n\nA skill copied manually into `~/.openclaw/workspace/skills/` may exist locally but still not appear in `clawhub list`. \n手工复制进 `~/.openclaw/workspace/skills/` 的技能，可能本地存在，但仍不会出现在 `clawhub list` 中。\n\n`clawhub list` reports installed skills from the CLI lockfile view, not every folder that happens to exist under the skills directory. \n`clawhub list` 展示的是 CLI lockfile 视角下的已安装技能，而不是简单扫描技能目录里的所有文件夹。\n\nUse both checks when needed: \n需要时，两个检查都要做：\n- inspect the local directory directly \n 直接检查本地目录\n- use `clawhub list` when the question is about CLI-managed installs \n 当问题涉及 CLI 管理安装时，再使用 `clawhub list`\n\n## Login note | 登录说明\n\nBrowser login and CLI login are separate states. If CLI reports `Not logged in`, run: \n浏览器登录和 CLI 登录是两套状态。如果 CLI 提示 `Not logged in`，执行：\n\n```bash\nclawhub login\nclawhub whoami\n```\n\n## Status meanings | 状态含义\n\n- `Scanning`: security scan in progress \n `Scanning`：安全扫描进行中\n- `Pending`: result not fully stable yet \n `Pending`：结果尚未完全稳定\n- `Benign`: generally passed scan \n `Benign`：基本通过扫描\n- `Suspicious`: needs review \n `Suspicious`：需要人工复核\n- `Hidden`: not publicly visible \n `Hidden`：当前不公开显示\n\nFile v4.5.12:references/clawhub-publish.md\n\n# ClawHub Publish Guide | ClawHub 发布指南\n\n## Two-step publishing workflow | 两步发布工作流\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。**\n\n### 第一步（AI 内部执行，不输出给用户）\n\n**A. Run full checklist | 完整清单核对**\nVerify all items in the \"Skill creation/modification checklist\" section of SKILL.md:\n逐项核对 SKILL.md 中\"技能制作/修改清单\"的全部项目。\n\n**A0. Runtime expectations declaration | 运行依赖声明**\n\nBefore publishing skills that guide command execution or filesystem changes, explicitly declare:\n发布会指导命令执行或文件系统修改的技能前，必须明确声明：\n\nThese declarations must appear in SKILL.md frontmatter `metadata` where possible, not only in prose. Use single-line JSON metadata because the OpenClaw skill parser expects single-line frontmatter values.\n这些声明应尽量写入 SKILL.md frontmatter `metadata`，不能只写在正文。OpenClaw 技能解析器要求 frontmatter 值使用单行 JSON。\n\n- Required binaries and verification commands, e.g. `clawhub --help`, `git --version`, `gh --version`.\n 所需命令行工具及验证命令，例如 `clawhub --help`、`git --version`、`gh --version`。\n- Credential/authentication expectations, e.g. ClawHub login session, Git/GitHub credentials; never ask users to paste long-lived secrets into chat.\n 凭据/授权预期，例如 ClawHub 登录态、Git/GitHub 凭据；不得要求用户在聊天中粘贴长期密钥。\n- Filesystem write scope: skill source in `~/.openclaw/workspace/skills//`, outputs in `~/.openclaw/workspace/projects//`, models in `~/.cache/huggingface/modules//`.\n 文件系统写入范围：技能源码在 `skills//`，输出在 `projects//`，模型在 `modules//`。\n- Exact commands must be shown to the user before publishing, deleting, moving, pushing, or otherwise mutating external/local state.\n 发布、删除、移动、推送或其他写入操作前，必须向用户展示精确命令。\n\n**B. Security verification | 安全性检查**\n\n⚠️ **If the skill contains scripts (Python/Bash/etc.), manually inspect each script:**\n如果技能包含脚本，必须手动检查每个脚本：\n\n| 检查要点 | 说明 |\n|---------|------|\n| 输入校验 | 用户输入是否经过验证和过滤，避免直接拼接到命令或路径中 |\n| 权限最小化 | 是否遵循最小权限原则，无过度权限申请 |\n| 凭据保护 | API Key、Token 等敏感信息不出现在日志、报错、返回值中 |\n| 依赖完整性 | 代码 import 的包是否全部出现在 requirements.txt / package.json 中 |\n\n**C. File size check | 文件大小检查**\n```bash\ndu -sh \n```\nIf the directory **exceeds 50MB**, the upload will fail.\n- Report to user immediately.\n- Move oversized files (e.g., model files) to a workspace backup location. Wait for explicit user confirmation.\n- After upload succeeds, move files back. Wait for user confirmation again.\n如果目录**超过 50MB**，上传会失败。立即报告用户，等待明确指示后再操作。\n\n**D. Public wording and ClawHub Summary check | 对外表述与 ClawHub Summary 检查**\n\nAll user-facing bilingual wording should use **English first, Chinese second**. This applies to display names, the SKILL.md frontmatter `description` field that ClawHub exposes as registry `summary` / CLI `Summary:`, changelog entries, README key headings, core explanations, and examples.\n所有面向用户的双语表述统一使用 **先英文、后中文**。适用范围包括展示名、SKILL.md frontmatter `description` 字段（发布到 ClawHub 后是 registry `summary` / CLI `Summary:`）、changelog、README 关键标题、核心说明和示例。\n\nClawHub preview cards may truncate long summaries. Before publishing, inspect the SKILL.md frontmatter `description` as product copy:\nClawHub 预览卡片可能截断长简介。发布前把 SKILL.md frontmatter 的 `description` 当作产品卡片文案检查：\n\n- Keep the English part short enough that the Chinese part remains visible before truncation.\n 英文部分要足够短，确保中文在截断前仍可见。\n- Use `English sentence. 中文句子。` for `description`, not Chinese-first ordering.\n `description` 使用 `English sentence. 中文句子。`，不要中文在前。\n- Avoid local debugging details, personal names, or one-off test content in the summary.\n 简介中不要放本地调试细节、真实姓名或一次性测试内容。\n\n**E. Draft changelog | 拟定 changelog**\n\n⚠️ **Changelog 不写在 SKILL.md 里！** Changelog 是 ClawHub 网站上的发布说明，在 `clawhub publish` 时通过 `--changelog` 参数传入。SKILL.md 模板中不应包含\"更新日志\"章节（除非是永久保留的完整更新历史）。\n\n- English first, Chinese after.\n 英文在前,中文在后。\n- Formal release-note tone only.\n 仅使用正式发布说明语气。\n\n**Changelog format | changelog 格式：**\nChangelog 内容通过 `--changelog \"...\"` 参数传递给 `clawhub publish` 命令，显示在 ClawHub 网站的版本历史中。格式为英文在前、中文在后的数字序号列表。\n\nUse plain numbered list (1. 2. 3.) with English first, Chinese after for each point.\n使用纯数字序号分点，每点英文在前、中文在后。\n\n**Changelog template | 模板：**\n```\n1. [English update]. [中文更新]。\n2. [English update]. [中文更新]。\n3. [English update]. [中文更新]。\n```\n\n**Recommended examples | 推荐示例：**\n```\n1. Initial release. 首次发布。\n```\n```\n1. Add comprehensive pre-publish checklist and two-step publishing workflow. 新增发布前检查清单和两步发布流程。\n2. Consolidate naming/writing standards and changelog rules into SKILL.md body. 整合命名写作规范与changelog规则至SKILL.md正文。\n```\n\n**Strictly avoid | 严格禁止：**\n- personal corrections / 个人纠错\n- format-only adjustments / 格式调整\n- private debugging notes / 私人调试记录\n- jokes, self-deprecation, apology-style wording / 玩笑、自嘲、道歉式表述\n- security scan references (ClawScan, VirusTotal, SUSPICIOUS, Benign, etc.) — changelog describes functional changes only, never implies intent to influence scan results / 安全扫描相关措辞（ClawScan、VirusTotal、SUSPICIOUS、Benign 等）— changelog 只描述功能改动，不得暗示意图影响扫描判定\n\n### 第二步（输出给用户，等待明确确认）\n\nReport the following to user. **⚠️ Do NOT run `clawhub publish` until user replies with \"确认-\" electronic signature.**\n**发布类操作（clawhub publish / git push / gh release create / 推广发帖等）必须经过两步验证，收到「确认-」电子签名后才可执行，不可跳过。**\n\n| Item | 内容 |\n|---|---|\n| Skill name + slug | 准确拼写 |\n| ClawHub current published version | 来自 `clawhub inspect ` |\n| New version number | 在已发布版本上递增 |\n| Changelog | 完整英中文双语内容 |\n| Primary update summary | 一句话概括 |\n| File size | 是否超 50MB |\n| De-identification | 确认通过/需调整 |\n| Scientificity | 确认通过/需调整 |\n| AI readability | 确认通过/需调整 |\n| Contextual coherence | 确认通过/需调整 |\n| Stability | 确认通过/需调整 |\n| **Code security** | 确认通过/需调整（输入校验/权限最小化/凭据保护/依赖完整性） |\n| Public wording order | Display name / SKILL.md `description` (ClawHub `Summary:`) / Changelog / README key content all use English first, Chinese second |\n| ClawHub Summary | SKILL.md `description` is short; published `Summary:` is bilingual and Chinese is not truncated in preview |\n| Full publish command | `clawhub publish ...` |\n\n**Restart rule | 重启规则：**\nEach user modification request → restart from Step 1.\n每次用户提出修改，都必须从第一步重新开始。\n\n## CLI commands | CLI 命令\n\nPrefer `clawhub` from PATH. If it is missing, try the OpenClaw-managed tool path before declaring the command unavailable:\n优先使用 PATH 中的 `clawhub`。若不存在，先尝试 OpenClaw 托管工具路径，再判断命令不可用：\n\n```bash\nCLAWHUB_BIN=$(command -v clawhub || true)\nif [ -z \"$CLAWHUB_BIN\" ] && [ -x \"$HOME/.openclaw/tools/node/npm/bin/clawhub\" ]; then\n CLAWHUB_BIN=\"$HOME/.openclaw/tools/node/npm/bin/clawhub\"\nfi\n[ -n \"$CLAWHUB_BIN\" ] || { echo \"clawhub command not found\"; exit 1; }\n```\n\n```bash\n# 发布：双语展示名必须显式传 --name，不能依赖 _meta.json 或 SKILL.md 自动同步\n\"$CLAWHUB_BIN\" publish \\\n --slug \\\n --name \"EN Title | 中文标题\" \\\n --version \\\n --changelog \"\"\n\n# 管理\n\"$CLAWHUB_BIN\" delete --yes\n\"$CLAWHUB_BIN\" hide --yes\n\"$CLAWHUB_BIN\" unhide --yes\n\"$CLAWHUB_BIN\" undelete --yes\n\"$CLAWHUB_BIN\" sync\n```\n\n> **Note | 说明**：These management commands (delete/hide/unhide/undelete) are core features of this skill for published skill lifecycle management. All destructive or visibility-changing operations strictly require explicit user consent via two-step electronic signature verification before execution. The `--yes` flag is a CLI requirement, not a bypass of the consent workflow.\n> 这些管理命令（删除/隐藏/恢复/取消删除）是本技能用于已发布技能生命周期管理的核心功能。所有破坏性或可见性变更操作均严格要求用户通过两步电子签名确认后才可执行。`--yes` 标志是 CLI 的必需参数，而非绕过同意流程。\n\n### Display name rule | 展示名规则\n\nClawHub page titles are controlled by the published display-name field. For bilingual names, always set it in two places:\nClawHub 页面标题由发布记录里的 display-name 控制。双语名必须两处一致：\n\n1. `SKILL.md` YAML frontmatter: `name: EN Title | 中文标题`\n2. Publish command: `--name \"EN Title | 中文标题\"`\n\nDo **not** rely on `_meta.json.displayName` or `SKILL.md` alone when updating an existing skill. In practice, version updates may keep the old English-only title unless `--name` is passed explicitly.\n更新已有技能时，不要只依赖 `_meta.json.displayName` 或 `SKILL.md name:`。实测如果发布命令未显式传 `--name`，页面顶部可能继续保留旧的纯英文展示名。\n\n### ClawHub Summary rule | ClawHub Summary 规则\n\nThe local source field is SKILL.md frontmatter `description`. After publishing, ClawHub stores/exposes it as registry `summary`, and the CLI prints it as `Summary:`. The ClawHub preview area is short: a long English-first description can still hide the Chinese part behind truncation. For bilingual skills, keep the English sentence compact, then put the Chinese sentence immediately after it:\n本地源字段是 SKILL.md frontmatter `description`。发布后，ClawHub 将其作为 registry `summary` 暴露，CLI 打印为 `Summary:`。ClawHub 预览区域很短：即使英文在前，只要英文太长，中文仍可能被截断。双语技能应让英文短句在前，中文紧随其后：\n\n```yaml\ndescription: \"TTS helper. TTS 朗读助手；支持文本转语音，长文本自动分段。\"\n```\n\nAfter publishing, verify both `Latest:` and `Summary:` with `inspect` or the web page.\n发布后同时复验 `Latest:` 和 `Summary:`，不要只看版本号。\n\n## Post-publish scan pending | 发布后安全扫描等待\n\nImmediately after publishing, `inspect` may report that the skill is hidden while the security scan is pending. Treat this as a temporary state, not a publish failure. Wait briefly and inspect again until the latest version and summary are visible.\n发布后立即 `inspect` 可能提示安全扫描中、技能暂时隐藏。这是临时状态，不是发布失败。短暂等待后再次 inspect，直到能看到最新版本和摘要。\n\n## Version conflict | 版本冲突\n\nIf publish fails with `Version already exists`, bump the version and republish only after confirming with the user.\n如果发布失败并提示 `Version already exists`，应先与用户确认，再升版本号重新发布。\n\n## 查看安全扫描结果 | View Security Scan Results\n\n发布后查看完整 Assessment 步骤：\n\n1. 打开 ClawHub 技能页面（如 `https://clawhub.ai/skills/`）\n2. 找到 **Security Scan** 区域\n3. 找到 **OpenClaw Benign/Suspicious** 徽章旁边的 **Details ▾** 按钮\n4. **点击 Details ▾ 展开** 才能看到完整的 Assessment 内容\n5. Assessment 是 ClawHub 对技能的详细安全分析，包含 Purpose、Install Mechanism、Credentials 等项目的逐一评估\n\n⚠️ **注意**：Summary 只是一句话概括，**必须展开 Details 才能看到完整 Assessment**。\n\n### 发布后扫描结果汇报\n\n扫描结果查看后，按主文件 SOP 格式汇报给用户：\n\n| 扫描项 | 结果 | 处理 |\n|--------|------|------|\n| VirusTotal | Benign / Review / Suspicious | 逐项说明 |\n| ClawScan | Benign / Review | 逐项说明 |\n| Static analysis | Benign / 非 Benign | 逐项说明 |\n\n- Benign → 无需处理\n- 非 Benign → 逐项列出问题，向用户说明，寻求「确认-」授权后修复\n\n完整汇报格式参见主文件「安全扫描说明」章节的 SOP 模板。\n\nFile v4.5.12:references/github-publish.md\n\n# GitHub 上传专项 | GitHub Publishing Guide\n\n本文件定义技能通过独立 GitHub 仓库发布的操作规范。\n\n## 适用场景\n\n- 技能有独立的 GitHub 仓库\n- 非 ClawHub 平台发布（如个人仓库、GitHub Pages 等）\n- 需与 ClawHub 发布流程区分\n\n## 发布前准备（对照 SKILL.md 第 6 章清单）\n\n发布 GitHub 前，逐项核对 SKILL.md 中的通用质量基线（G01~G06）和 GitHub 专项（GH01~GH06）：\n\n| 项目 | 内容 |\n|------|------|\n| G01 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 安全性 | 无代码安全风险（输入校验、权限最小化） |\n| G03 逻辑科学性 | 结构清晰、路径准确、模块化 |\n| G04 AI 可读性 | agent 可理解、上下文连贯 |\n| G05 易维护性 | 代码整洁、注释到位 |\n| G06 依赖声明 | 外部包/工具/密钥已声明，无硬编码 |\n| GH01 文件结构 | 符合 Skill 目录体系（SKILL.md 在根目录） |\n| GH02 README | 英中文双语，有安装/使用说明 |\n| GH03 Commit 规范 | 英文在前、中文在后，格式正确 |\n| GH04 Release Notes | Markdown 格式，结构清晰 |\n| GH05 无敏感信息 | 无 API Key、Token、内部路径 |\n| GH06 权限隔离 | 无过度文件权限、无不必要的管理脚本 |\n\n**若涉及多语言 README 或多文件修改：逐个修改，逐个确认。**\n\n## 两步验证流程（对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n### 第一步（AI 内部执行，不输出给用户）\n\n- 对照清单全部项（G01~G06 + GH01~GH06），逐项标注 ✅ / ⚠️\n- 检查文件大小（>50MB 需报告）\n- 拟定 Commit Message（英文在前，中文在后）\n- 检查 `git status`，列出所有未提交的变更\n- 若有未提交变更，列出文件名，等待用户确认后再处理\n\n### 第二步（输出给用户，等待明确确认）\n\n⚠️ **未经用户明确确认，不得执行 `git push` / `gh release create` 等任何发布类命令。**\n\n向用户汇报以下全部内容：\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前状态 | 已修改未提交 / 已提交未推送 |\n| 未提交文件 | 列出所有变更文件 |\n| Commit Message | 拟定的提交信息 |\n| 核对清单结果 | G01~G06 + GH01~GH06，✅ / ⚠️ 标注 |\n| 文件大小 | 是否超 50MB |\n| 问题说明 | 有 ⚠️ 项时，说明具体问题 |\n| 解决方案 | 针对 ⚠️ 项的修复方案 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n## 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n获得用户确认后，执行以下命令：\n\n```bash\n# 1. 进入仓库目录\ncd \n\n# 2. 添加所有变更\ngit add -A\n\n# 3. 提交（英文在前，中文在后）\ngit commit -m \"[English message]. [中文信息]。\"\n\n# 4. 推送到远程\ngit push\n```\n\n## Commit Message 规范\n\n- 英文在前，中文在后\n- 正式发布语气\n- 禁止：个人纠错、格式调整、私人调试记录、玩笑、道歉式表述\n- 示例：`fix: 修复徽章HTML兼容性问题，清理各语言版本中文残留`\n\n## 安全约束\n\n1. **严禁擅自上传** — 未获用户明确确认前不得执行 `git push`\n2. **汇报当前状态** — 每次修改后必须汇报状态（已修改/未提交/已上传）\n3. **等待电子签名** — 用户回复「确认-」后才执行 push\n\n## Git 状态检查命令\n\n```bash\n# 查看当前状态\ngit status\n\n# 查看变更统计\ngit diff --stat\n\n# 查看完整变更内容\ngit diff\n\n# 查看提交历史\ngit log --oneline -5\n```\n\n## 常见问题处理\n\n### 有未提交的变更\n\n用户要求上传前，先检查 `git status`：\n- 如有未提交的变更，必须在汇报中列出\n- 等待用户确认后再 add/commit/push\n\n### 远程分支落后\n\n```bash\n# 先拉取最新\ngit pull --rebase\n\n# 再推送\ngit push\n```\n\n### 冲突处理\n\n1. 报告用户存在冲突\n2. 等待用户指示如何解决\n3. 不得强制覆盖远程分支\n\n## GitHub Release 专项 | GitHub Release Guide\n\n创建 GitHub Release 同样需要两步验证。Release Notes 是对外展示的正式说明，必须符合规范。\n\n### 何时需要创建 Release\n\n- 首次正式发布版本（如 v1.0.0）\n- 重要版本更新\n- 用户明确要求创建 Release\n\n### Release Notes 规范\n\n**格式**：Markdown 语法，结构清晰\n**内容**：\n- 标题（版本号 + 简短描述）\n- 变更说明（功能/修复/优化）\n- 技术规格（如适用）\n- 安装方式（如适用）\n\n**禁止**：\n- 个人调试记录\n- 道歉式表述\n- 不完整的描述\n\n### 两步验证流程（Release，对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n#### 第一步（AI 内部执行，不输出给用户）\n\n- 检查 git tag 列表，确认版本号未冲突\n- 拟定 Release Notes（英文在前，中文在后）\n- 检查变更内容是否与 Commit History 一致\n\n#### 第二步（输出给用户，等待明确确认）\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前 tag | 已有 tag 列表 |\n| 新版本号 | 如 v1.0.0 |\n| Release Notes | 拟定的正式说明 |\n| 变更内容 | 列出主要变更 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式）才可执行。\n\n#### 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n```bash\n# 1. 创建 tag（如尚未创建）\ngit tag -a -m \"\"\n\n# 2. 推送 tag\ngit push origin \n\n# 3. 使用 gh 创建 Release\ngh release create \\\n --title \"<标题>\" \\\n --notes \"\" \\\n --target \n```\n\n### Release Notes 示例\n\n```markdown\n## What's New\n\n**Skill Name** — 简短描述\n\n基于 xxx，为用户提供 yyy 功能。\n\n### 功能更新\n- 新增 xxx 功能\n- 优化 xxx 体验\n- 修复 xxx 问题\n\n### 技术规格\n- 版本：1.0.0\n- 支持平台：xxx\n- 依赖：xxx\n\n### 安装方式\n```bash\nxxx install command\n```\n```\n\n### 验证命令\n\n```bash\n# 查看已创建的 Release\ngh release list\n\n# 查看特定 Release 详情\ngh release view \n\n# 更新 Release Notes\ngh release edit --notes \"<新内容>\"\n```\n\n## 与 ClawHub 的区别\n\n| 维度 | ClawHub | GitHub（独立仓库） |\n|------|---------|-------------------|\n| 平台 | clawhub CLI | git + gh CLI |\n| 版本管理 | clawhub 内部管理 | git tag + Release |\n| 验证方式 | `clawhub inspect` | `git log` + `gh release list` |\n| 发布命令 | `clawhub publish` | `git push` + `gh release create` |\n| 对外说明 | Changelog | Release Notes |\n| 适用场景 | 技能市场分发 | 独立项目/文档站 |\n\nFile v4.5.12:references/promotion.md\n\n# Promotion Guide | 宣传指南\n\nAll skill promotion on social platforms (Moltbook, 抓虾吧, etc.) must follow this guide.\n所有技能推广（社交平台发帖等）必须遵循本指南。\n\n---\n\n## 主文件与分文件职责分工 | File Responsibilities\n\n| 文件 | 职责 |\n|------|------|\n| **SKILL.md（主文件）** | 核心原则、流程骨架、清单元摘要、reference 文件索引 |\n| **promotion.md（本文件）** | 推广专项完整操作指南：两步验证、AI心理学、排版格式、去标识化、数据时效 |\n\n> 本文件为 SKILL.md 的推广专项补充。重大流程变更须同步更新 SKILL.md 清单元摘要。\n\n---\n\n## 推广两步验证流程 | Two-Step Promotion Verification\n\n**无论改动多小、无论第几次修改，两步验证不可跳过。推广发帖、编辑、重新发布均需两步验证。**\n\n### 第一步（AI 内部执行，不输出给用户）\n\n**A. 内容清单核对 | Content Checklist**\n\n| 检查项 | 说明 |\n|--------|------|\n| 去标识化 | 无个人位置/姓名/内部路径/API密钥/Token |\n| 数据时效 | 注明统计截止日期 |\n| 链接准确性 | 链接为完整 URL，非截断或猜测 |\n| 安装命令准确性 | 使用 `clawhub install `，非猜测 |\n| 版本号准确性 | 来自 `clawhub inspect `，非猜测 |\n| 平台格式合规 | Moltbook 使用双语交替格式 |\n\n**B. AI 心理学吸引力检查 | AI Psychology Appeal Checklist**\n\n| 检查项 | 说明 |\n|--------|------|\n| 开头有共鸣点 | 开头能否在 3 秒内引起 AI 读者兴趣？ |\n| 差异化价值 | 技能相比同类有什么独特优势？ |\n| 具体性 | 避免泛泛而谈，有具体数字/功能/场景？ |\n| 行动号召 | 结尾是否有明确的安装/了解更多指引？ |\n| 双语比例 | 英文信息量充足，不依赖中文翻译撑场面？ |\n| 格式呼吸感 | 无大段堆砌，emoji/分段有节奏？ |\n\n**C. 去标识化详细检查 | De-identification Detailed Checklist**\n\n| ❌ 禁止内容 | ✅ 允许内容 |\n|-----------|-----------|\n| 城市/省份/具体国家 | \"中国\"（泛指可）、省略 |\n| 个人姓名 | \"my human\" / \"morois\"（如以品牌身份推广可写） |\n| 本机 API Key / Token | 不提及 |\n| 内部路径如 `~/.openclaw/workspace/` | 不提及 |\n| 私人邮箱/手机号 | 不提及 |\n| 私人项目代号 | 使用公开的技能 slug |\n\n### 第二步（输出给用户，等待明确确认）\n\n**⚠️ 未经用户明确确认，不得在社交平台发帖、编辑或重新发布。**\n\n向用户汇报以下内容，**必须等用户明确确认后才能发帖**：\n\n| 汇报项 | 内容 |\n|--------|------|\n| 推广平台 | Moltbook / 抓虾吧 / 其他 |\n| 推广类型 | 单技能 / 多技能联合 |\n| 目标受众 | Moltbook AI agents / 其他 |\n| 正文全文 | 完整推广文案 |\n| 数据来源与截止日期 | 各技能安装量/星标数及截止日期 |\n| 链接与安装命令 | 确认准确 |\n| AI 心理学自查结果 | 通过/需调整 |\n| 去标识化自查结果 | 通过/需调整 |\n| 平台格式合规自查 | 通过/需调整 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n---\n\n## 平台格式规范 | Platform Format Rules\n\n### Moltbook 推广格式 | Moltbook Post Format\n\n所有 Moltbook 帖子必须使用**双语交替格式**（一句英文一句中文）：\n\n```\n[English sentence] [中文句子][English sentence] [中文句子]\n[English sentence] [中文句子][English sentence] [中文句子]\n```\n\n**单技能推广模板：**\n\n```\n**Skill Name | 技能名** (vX.Y · N installs · ★N)\nShort concrete English pitch. 简短中文说明。\n\nWhat it does: 一句话功能描述\nInstall: clawhub install \nhttps://clawhub.ai//\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n**多技能联合推广模板：**\n\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nmorois and I have published X skills on ClawHub. 截至 YYYY-MM-DD：\n\n📊 Stats | 数据：\n🎙️ Skill A — N installs · ★N · One-line description. 简短中文。\n🔊 Skill B — N installs · ★N · One-line description. 简短中文。\n…（每个技能一行，emoji + name + stats + 英文/中文各一句）\n\nInstall any: clawhub install \nBrowse all: clawhub.ai/\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n---\n\n## 数据时效性要求 | Data Freshness Requirements\n\n- 所有安装量/星标数必须注明**截止日期**\n- 格式：`截至 YYYY-MM-DD 的数据`\n- 每次发布推广前必须重新确认最新数字（通过 `clawhub inspect` 或 ClawHub 页面）\n- 不得使用超过 **30 天**的旧数据\n\n---\n\n## AI 心理学吸引力原则 | AI Psychology Appeal Principles\n\n**1. 开场共鸣（3秒法则）**\n- 第一句话要让 AI 觉得\"这和我有关\"或\"这很有趣\"\n- 避免空洞开场如 \"Hello everyone\" → 改用具体场景或问题切入\n\n**2. 差异化价值主张**\n- 不要只说\"这是个很棒的技能\"\n- 说清楚**相比其他同类工具的优势**：免费/本地运行/无API费用/更强安全/跨平台\n\n**3. 具体性 > 泛化**\n- ❌ \"A useful tool for everyone\" → 泛泛而谈\n- ✅ \"Offline Whisper STT — no API costs, your audio never leaves your machine\" → 具体价值\n\n**4. 社会认同**\n- 有安装量/星标数要突出显示（同伴认可）\n- 数字本身就是信任信号\n\n**5. 行动号召（CTA）**\n- 每篇结尾必须有明确行动：安装命令 / 访问链接 / 提问邀请\n- 不要让读者\"然后呢\"\n\n**6. 结尾钩子**\n- 以问题结尾，引发评论互动\n- \"What are you building?\" / \"What's your take on this?\" / \"Curious what others think\"\n\n---\n\n## 推荐格式示例 | Suggested Format Examples\n\n**单技能：**\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nJust released Speech Transcriber on CltHub — offline Whisper STT that never sends your audio to the cloud. 我发布了一个离线 Whisper 语音转文字工具，音频永远不离开你的机器。\n\n🎙️ 100% local inference, no API costs, fully offline. 纯本地推理，无 API 费用，完全离线。\n🛡️ Privacy-first: audio stays on your machine. 隐私优先：音频留在本地。\n\nTry it: clawhub install speech-transcriber\nhttps://clawhub.ai//speech-transcriber\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n**多技能联合（更正式）：**\n```\nHey fellow AI assistants! 各位 AI 助手大家好！👋\n\nmorois and I have published 7 skills on ClawHub. 截至 2026-04-05：\n\n📊 Stats | 数据：\n🎙️ Speech Transcriber — 11 installs · Local Whisper or OpenAI API STT, fully offline. 纯本地 Whisper，隐私安全。\n🔊 Speech Synthesizer — 60 installs · edge-tts (free offline neural TTS) or OpenAI API TTS. 微软 TTS 免费离线。\n📹 Camera YOLO Operator — 120 installs · YOLO detection + depth estimation on your webcam. 摄像头目标检测+景深。\n💬 AI Socializer — 29 installs · Patrol Moltbook & more, API key hardlocked to www.moltbook.com. 社交巡逻，密钥铁律。\n💼 Skill Manager — 870 installs · Two-step publish workflow and checklist. 技能全流程。\n📺 Bilibili Messager — 654 installs · Browser-automation DM for Bilibili. B站私信。\n📱 Douyin Messager — 1.9k installs · ★9 · Browser-automation DM for Douyin. 抖音私信。\n\nInstall any: clawhub install \nBrowse all: clawhub.ai/\n\nBuilt by morois + me. 我们的人类和我一起开发的。What are you building? 🦞\n```\n\n---\n\n## Reminder | 提醒\n\n- Promotion copy may be more lively than changelog copy, but changelog text itself must stay formal.\n 宣传文案可以比 changelog 略活，但 changelog 本身必须保持正式。\n- Two-step verification applies to every promotion action, including edits and repromotions.\n 两步验证适用于所有推广操作，包括修改和重新发布。\n\nFile v4.5.12:references/rename-workflow.md\n\n# Rename Workflow | 改名全量替换流程\n\n> 改名 = 全量替换，不留死角。由内到外、由本地到线上，一次改名，多端核对。\n> Rename = full replacement, no exceptions. Inside-out, local-to-online, one rename, multi-channel verification.\n\n## 原则 | Principles\n\n1. **全量替换** — 改名不是改标题，是所有出现旧名称的地方都要改。\n2. **由内到外** — 先改文件内容，再改目录名/仓库名（否则文件路径会断）。\n3. **由本地到线上** — 先改本地，再改 GitHub，最后改 ClawHub。\n4. **多端核对** — 本地文件、GitHub、ClawHub、memory 全部对齐后才算完成。\n5. **两步验证** — 改名涉及多处写入，必须走两步验证流程。\n6. **slug 同步** — 显示名改了，slug 也要同步改（小写+连字符）。\n\n## 渠道清单 | All Channels\n\n改名时必须检查以下**所有渠道**，逐项核对：\n\n### 本地文件系统\n\n| # | 渠道 | 路径模式 | 说明 |\n|---|------|----------|------|\n| L1 | 项目目录 | `~/.openclaw/workspace/projects//` | 重命名为 `/` |\n| L2 | 技能目录 | `~/.openclaw/workspace/skills//` | 重命名为 `/`（如有） |\n| L3 | 模型缓存 | `~/.cache/huggingface/modules//` | 重命名为 `/`（如有） |\n| L4 | 项目内文件 | `projects//README.md` | 标题、描述、目录结构中的名称 |\n| L5 | 项目内文件 | `projects//src/index.html` | 页面标题、H1、meta 标签 |\n| L6 | 项目内文件 | `projects//references/*.md` | 引用旧名称的行 |\n| L7 | 项目内文件 | `projects//SKILL.md` | 技能主文件（如有） |\n| L8 | git remote | `git remote -v` | URL 中的仓库名 |\n| L9 | Memory 文件 | `~/.openclaw/workspace/MEMORY.md` | 项目索引中的名称 |\n| L10 | Memory 文件 | `~/.openclaw/workspace/memory/*.md` | 日记中的名称 |\n| L11 | 其他文件 | `TOOLS.md`, `HEARTBEAT.md`, `AGENTS.md` | 如有引用 |\n\n### 线上平台\n\n| # | 渠道 | 操作 | 说明 |\n|---|------|------|------|\n| O1 | GitHub repo slug | `gh repo rename --repo / --yes` | 仓库名变更 |\n| O2 | GitHub description | `gh repo edit --description \"\"` | 仓库描述更新 |\n| O3 | GitHub remote URL | `git remote set-url origin ` | 本地 git remote 同步 |\n| O4 | ClawHub slug | `clawhub publish ... --slug ` | 重新发布（如已发布） |\n| O5 | ClawHub display name | `clawhub publish ... --name \"\"` | 重新发布（如已发布） |\n\n## 执行顺序 | Execution Order\n\n> 严格按顺序执行，不可跳步。\n\n```\n第一步：审计（Audit）\n └── 在所有渠道中搜索旧名称，生成完整变更清单\n\n第二步：改文件内容（Inner）\n └── 先改文件里的文字，再改目录名\n └── 原因：如果先改目录名，文件路径会断\n\n第三步：改本地目录名（Local Structure）\n └── 项目目录、技能目录、模型缓存\n └── 更新 git remote URL\n\n第四步：改线上平台（Online）\n └── GitHub rename → description → ClawHub（如适用）\n\n第五步：改 Memory（Memory）\n └── MEMORY.md + memory/*.md\n\n第六步：验证（Verify）\n └── 全渠道搜索旧名称，确认零残留\n └── 检查 slug/display name/description 一致性\n```\n\n## 审计命令 | Audit Commands\n\n```bash\n# 搜索项目内所有旧名称\ngrep -rn \"\" ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" --include=\"*.js\" --include=\"*.json\"\n\n# 搜索 memory 文件\ngrep -rn \"\\|\" ~/.openclaw/workspace/MEMORY.md ~/.openclaw/workspace/memory/\n\n# 搜索 TOOLS.md / HEARTBEAT.md\ngrep -rn \"\" ~/.openclaw/workspace/TOOLS.md ~/.openclaw/workspace/HEARTBEAT.md 2>/dev/null\n\n# 搜索 skills 目录\ngrep -rn \"\" ~/.openclaw/workspace/skills// --include=\"*.md\" 2>/dev/null\n\n# 检查 GitHub\ngh repo view / --json name,description\n\n# 检查 ClawHub（如已发布）\nclawhub inspect 2>/dev/null\n```\n\n## 两步验证 | Two-Step Verification\n\n### 第一步（AI 内部执行，不输出给用户）\n\n- 执行审计命令，生成完整变更清单\n- 按渠道分类，逐项标注需要变更的内容\n- 确定新 slug（小写+连字符）和新 display name（`EN | CN` 格式）\n- 检查新名称是否与已有 slug 冲突\n\n### 第二步（输出给用户，等待确认）\n\n输出以下全部内容：\n\n```markdown\n## 📋 改名汇报 | → \n\n**旧名称：** （slug: ）\n**新名称：** （slug: ）\n\n### 变更清单\n\n| # | 渠道 | 位置 | 旧值 | 新值 |\n|---|------|------|------|------|\n| L1 | 本地目录 | projects// | | |\n| ... | ... | ... | ... | ... |\n\n### 执行顺序\n1. 改文件内容（sed）\n2. 改目录名（mv）\n3. 改 GitHub（gh repo rename）\n4. 改 git remote（git remote set-url）\n5. 改 memory（sed）\n6. git commit + push\n\n### 核对清单\n| # | 检查项 | 状态 |\n|---|--------|------|\n| ... | ... | ✅ / ⚠️ |\n```\n\n**确认标志**：用户回复「确认-」后才可执行。\n\n## 执行命令模板 | Command Templates\n\n```bash\n# === 1. 改文件内容 ===\ncd ~/.openclaw/workspace/projects/\nsed -i 's///g' \n\n# === 2. 改目录名 ===\nmv ~/.openclaw/workspace/projects/ ~/.openclaw/workspace/projects/\nmv ~/.openclaw/workspace/skills/ ~/.openclaw/workspace/skills/ # 如有\nmv ~/.cache/huggingface/modules/ ~/.cache/huggingface/modules/ # 如有\n\n# === 3. 改 GitHub ===\ngh repo rename --repo / --yes\ngh repo edit / --description \"\"\n\n# === 4. 改 git remote ===\ncd ~/.openclaw/workspace/projects/\ngit remote set-url origin https://github.com//.git\n\n# === 5. 改 memory ===\nsed -i 's///g' ~/.openclaw/workspace/MEMORY.md\nsed -i 's///g' ~/.openclaw/workspace/memory/*.md\n\n# === 6. git commit + push ===\ngit add -A\ngit commit -m \"rename: \"\ngit push\n```\n\n## 验证命令 | Verification Commands\n\n```bash\n# 零残留验证：搜索旧名称\ngrep -rc \"\\|\" ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" | grep -v \":0$\"\n# 期望：无输出（零残留）\n\n# 正文中的描述性用词（如\"重建三维场景\"）不算残留，只有项目名/slug 算\n\n# 一致性验证\nhead -1 ~/.openclaw/workspace/projects//README.md # 标题正确\ngit remote -v # remote URL 正确\ngh repo view / --json name,description # GitHub 正确\n```\n\n## 常见陷阱 | Common Pitfalls\n\n| 陷阱 | 说明 | 防范 |\n|------|------|------|\n| 只改标题不改 slug | 目录名/仓库名还是旧的 | slug 必须同步改 |\n| 只改本地不改线上 | GitHub 还是旧名 | 逐渠道核对 |\n| 先改目录名再改内容 | 文件路径断了，sed 找不到文件 | 先改内容再改目录 |\n| 忘记改 memory | MEMORY.md 里还是旧名 | memory 纳入变更清单 |\n| 忘记改 git remote | push 到旧地址 | remote URL 同步更新 |\n| 正文描述性用词误判 | \"重建三维场景\"不是项目名 | 只改项目名/slug，不改描述性用词 |\n| ClawHub 未同步 | ClawHub 还是旧名 | 已发布的需重新 publish |\n\nFile v4.5.12:references/search-and-audit.md\n\n# Search and Audit Guide | 搜索与审计指南\n\n## Search workflow | 搜索流程\n\n1. Check local formal skills first. \n 先检查本地正式技能。\n2. Check built-in skills if relevant. \n 如有需要，再检查内置技能。\n3. Search ClawHub only when local options are insufficient. \n 只有在本地选项不足时才搜索 ClawHub。\n4. Let the user choose before install or replacement. \n 在安装或替换前，让用户做选择。\n\n## Search commands | 搜索相关命令\n\n```bash\nclawhub search \nclawhub inspect \nclawhub list\nclawhub uninstall \nclawhub star \nclawhub unstar \n```\n\n## Audit mindset | 审计思路\n\nBefore recommending install or update, check: \n在推荐安装或更新前，检查：\n- overlap with existing local skills \n 是否与现有本地技能功能重叠\n- whether the skill is actively maintained \n 技能是否还在持续维护\n- whether the skill description matches the user's real need \n 技能描述是否真的匹配用户需求\n- whether sensitive or risky behavior needs review \n 是否存在需要额外审查的敏感或高风险行为\n\n## Output style | 输出风格\n\nGive the user a short comparison: \n给用户一个简短对比：\n- recommended \n 推荐\n- possible alternative \n 可选替代\n- not recommended \n 不推荐\n\nKeep recommendations concrete. \n建议必须具体，不要空泛。\n\nArchive v4.5.11: 9 files, 33708 bytes\n\nFiles: _meta.json (144b), references/clawflows-workflow.md (9610b), references/clawhub-inspect.md (3284b), references/clawhub-publish.md (13043b), references/github-publish.md (6799b), references/promotion.md (8233b), references/rename-workflow.md (7531b), references/search-and-audit.md (1411b), SKILL.md (21805b)\n\nFile v4.5.11:SKILL.md\n\n---\nname: Skill Manager All In One | 一站式技能管理器\ndescription: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。\nmetadata: {\"openclaw\":{\"requires\":{\"bins\":[\"git\",\"gh\"]},\"runtime\":{\"requiredBinaries\":[\"clawhub\",\"git\",\"gh\"],\"credentialExpectations\":[\"ClawHub CLI login/session for publish/delete/hide/unhide/sync\",\"Git/GitHub CLI authentication for GitHub workflows\"],\"filesystemWrites\":[\"~/.openclaw/workspace/skills//\",\"~/.openclaw/workspace/projects//\",\"~/.cache/huggingface/modules//\"],\"externalWrites\":[\"clawhub publish/delete/hide/unhide/sync\",\"git push\",\"gh release create\"],\"confirmation\":\"Show exact commands and wait for the user to reply with an explicit \"确认-\" electronic signature before any publish, delete, push, move, overwrite, or other writes. Do NOT proceed without this signature.\"}}}\n---\n\n# Skill Manager All In One | 一站式技能管理器\n\n## Runtime Expectations | 运行依赖与权限声明\n\nThis skill may guide an agent to inspect, create, edit, move, publish, or audit OpenClaw skill files. It is not a passive documentation-only skill.\n本技能可能指导 agent 检查、创建、编辑、移动、发布或审计 OpenClaw 技能文件；它不是只读文档型技能。\n\n### Required binaries | 所需命令行工具\n\nDeclare and verify these before an\n\nArchive v4.5.10: 9 files, 33395 bytes\n\nFiles: _meta.json (144b), references/clawflows-workflow.md (9610b), references/clawhub-inspect.md (3284b), references/clawhub-publish.md (12355b), references/github-publish.md (6799b), references/promotion.md (8233b), references/rename-workflow.md (7531b), referen...","readmeExcerpt":"Skill: Skill Manager All In One | 一站式技能管理器 Owner: moroiser Summary: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。 Tags: latest:4.5.14 Version history: v4.5.14 | 2026-05-09T09:45:37.817Z | user 1. Simplify SKILL.md frontmatter: remove verbose metadata JSON, add license field. 精简 frontmatter，删除冗长 metadata JSON，改用 license 字段。2. Simplify Runtime Expectations: remove verbose table-based declarati","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"~/.openclaw/workspace/skills//"},{"language":"bash","snippet":"# 搜索项目内所有旧名称\n grep -rn \"\\|\" \\\n ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" --include=\"*.js\" --include=\"*.json\"\n # 搜索 memory 文件\n grep -rn \"\\|\" \\\n ~/.openclaw/workspace/MEMORY.md \\\n ~/.openclaw/workspace/memory/\n # 检查 GitHub\n gh repo view / --json name,description"},{"language":"bash","snippet":"mv ~/.openclaw/workspace/projects// ~/.openclaw/workspace/projects//\n mv ~/.openclaw/workspace/skills// ~/.openclaw/workspace/skills//\n git remote set-url origin "},{"language":"markdown","snippet":"## 🔍 技能安全扫描汇报 | v\n\n**技能：** \n**slug：** \n**版本：** \n**复查时间：** \n\n### 安全扫描结果\n\n| 扫描项 | 结果 | 处理 |\n|--------|------|------|\n| VirusTotal | Benign / ⚠️ Review / ❌ Suspicious | <处理方式> |\n| ClawScan | Benign / ⚠️ Review | <处理方式> |\n| Static analysis | Benign / ❌ 非 Benign | <处理方式> |\n\n### 问题与修复（如有）\n- <扫描项>: <具体问题描述> → <修复方案>（需用户「确认-」后执行）"},{"language":"text","snippet":"~/.openclaw/workspace/skills/speech-transcriber/ # ✅ 技能代码（SKILL.md、scripts/、requirements.txt）\n~/.openclaw/workspace/projects/speech-transcriber/ # ✅ 运行文件与结果（transcriptions/、recordings/、outputs/）\n~/.cache/huggingface/modules/speech-transcriber/ # ✅ 模型文件（small/、medium/）"},{"language":"markdown","snippet":"## 🔍 技能发布汇报 | v\n\n**Display name：** \n**Skill slug：** \n**目标平台：** clawhub / github\n**SKILL.md description：** （ 字符）\n**当前版本：** → **新版本：** \n**Changelog：**\n1. . <中文更新>。\n\n**文件大小：** KB\n\n---\n\n### 核对清单\n\n> 汇报时逐项标注 ✅ / ⚠️，有问题的在「问题与修复」中说明。\n\n**通用质量基线（G01-G06，所有技能必检）：**\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| G01 | 去标识化 | ✅/⚠️ | 无个人信息、内部路径、私有凭证 |\n| G02 | 安全性 | ✅/⚠️ | 无注入风险、无过度权限、无数据外传 |\n| G03 | 逻辑科学性 | ✅/⚠️ | 结构清晰、路径准确、模块化、同名规范 |\n| G04 | AI 可读性 | ✅/⚠️ | agent 可理解、上下文连贯、无歧义指令 |\n| G05 | 易维护性 | ✅/⚠️ | 代码整洁、注释到位、变量命名清晰 |\n| G06 | 依赖/凭据声明 | ✅/⚠️ | 外部包/工具/密钥已声明，无硬编码 |\n\n**平台专项（根据目标平台二选一）：**\n\n**→ ClawHub 目标时（CH01-CH12）：**\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| CH01 | Display Name 双保险 | ✅/⚠️ | `name:` = `EN Title | CN Title`；`--name` 参数一致 |\n| CH02 | Skill slug | ✅/⚠️ | 小写字母 + 连字符 |\n| CH03 | description ≤150字符 | ✅/⚠️ | 英文在前、中文在后，总字符 ≤150，不用 `\\|` 分隔 |\n| CH04 | Changelog 格式 | ✅/⚠️ | 英文在前、中文在后，数字列表，正式语气 |\n| CH05 | Embedding 500 应急 | ✅/⚠️ | SKILL.md + references 均 ≤500 行，否则拆分 |\n| CH06 | 文件/模型分离 | ✅/⚠️ | 技能文件夹 ≤50MB，无模型/结果文件 |\n| CH07 | 版本号一致性 | ✅/⚠️ | `_meta.json` / changelog / 发布命令三处一致 |\n| CH08 | 对外表述顺序统一 | ✅/⚠️ | 所有双语表述均先英文后中文 |\n| CH09 | 坏符号链接 | ✅/⚠️ | 无失效符号链接 |\n| CH10 | 运行时产物 | ✅/⚠️ | 无 .pyc / .pyo / __pycache__ / .log |\n| CH11 | 目录隔离 | ✅/⚠️ | 无 .git / .DS_Store / Thumbs.db 等无关文件 |\n| CH12 | 英中文顺序检测 | ✅/⚠️ | display name 用 `\\|`、description 不用 `\\|`、changelog 先英后中 |\n\n**→ GitHub 目标时（GH01-GH06）：**\n\n| # | 检查项 | 状态 | 备注 |\n|---|--------|------|------|\n| GH01 | git status | ✅/⚠️ | 无未提交变更 |\n| GH02 | 分支规范 | ✅/⚠️ | main/master 干净，commit 原子化 |\n| GH03 | commit 规范 | ✅/⚠️ | 英文在前、中文在后，简洁描述性 |\n| GH04 | Release Notes | ✅/⚠️ | 与 changelog 内容一致 |\n| GH05 | 文件完整性 | ✅/⚠️ | 无多余临时文件 |\n| GH06 | License | ✅/⚠️ | 含合适开源许可证或声明无许可证 |\n\n---\n\n### 发布命令"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: Skill Manager All In One | 一站式技能管理器\ndescription: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。\nlicense: MIT-0\n---\n\n# Skill Manager All In One | 一站式技能管理器\n\n本技能可能指导 agent 检查、创建、编辑、移动、发布或审计 OpenClaw 技能文件；它不是只读文档型技能。\n\n**所需工具**：clawhub / git / gh\n**授权**：ClawHub 发布需要已登录会话；GitHub 发布需要 Git/GitHub 授权。执行发布类命令前必须展示精确命令并等待「确认-」电子签名。\n\n---\n\n## 模式 | Mode\n\n> 读取本 SKILL.md 后，先确认当前任务属于哪种模式，再跳转对应章节执行。\n\n| 模式 | 说明 |\n|------|------|\n| **create** | 从零创建新技能 |\n| **modify** | 修改已发布技能（升版/功能调整） |\n| **audit** | 审计本地或已发布技能的质量、逻辑、声明完整性 |\n| **local-test** | 仅本地测试，不发布 |\n\n---\n\n## 核心原则 | Core Rules\n\n1. **Local first, network second** — 先检查本地已安装技能，再搜索网络。\n2. **Be concrete** — 汇报时写清楚准确路径、准确命令、准确版本变化。\n3. **One by one, confirm one by one** — 涉及多个文件/版本/技能时，必须逐个处理、逐个确认。每项确认都必须获得「确认-」格式的电子签名授权，禁止批量操作。\n4. **Publish like a product** — 发布文本应像正式发布说明，而非聊天记录。\n5. **For AI and humans** — 技能正文应兼顾 agent 与人类可读性。\n6. **English first, Chinese second** — 对外展示文本统一先英文后中文；包括 `name`、SKILL.md frontmatter `description`（发布到 ClawHub 后显示为 registry `summary` / CLI `Summary:`）、Changelog、README 关键标题与核心段落。中文不能因英文过长而被预览截断。\n7. **Learn from release evidence** — 发布流程规则来自真实发布证据；新增检查项前先确认它能防止具体失误，而不是堆砌流程。\n\n---\n\n## 技能制作流程 | Phase 1: Create / Modify\n\n> 按顺序执行，边做边对照第 6 章「统一检查清单」的【通用质量基线】。\n\n### 步骤 1：明确需求\n\n确定以下四项，作为后续所有操作的依据：\n\n- **目标平台**：ClawHub / GitHub / 其他\n- **版本号**：首次发布为 `1.0.0`\n\n> ⚠️ Display name 和 Skill slug 是 ClawHub 专属概念，若目标平台为 ClawHub，请在 Phase 2 步骤 1 确认。\n\n### 步骤 2：创建技能（参考 skill-creator）\n\n**创建或修改技能内容前，先读 skill-creator 的完整流程。**\n\nskill-creator 是创建技能的唯一权威参考，包含：\n- SKILL.md 写法（Anatomy of a Skill）\n- 目录结构规范（Skill folder layout）\n- 编写技巧（Concise is Key / Set Appropriate Degrees of Freedom）\n- 打包与发布流程\n\n```\n~/.openclaw/workspace/skills//\n```\n\n### 步骤 3：边做边查——对照清单\n\n每完成一个文件或代码块，立即对照第 6 章【通用质量基线】逐项打勾。\n\n**目标平台已确定时，附加对应平台专项（ClawHub → CH01-CH11，GitHub → GH01-GH06）。**\n\n### 步骤 4：修改项目的渠道核查\n\n修改已发布技能时（如升版、功能调整、名称/slug 变更），必须核查以下渠道：\n\n| 渠道 | 说明 |\n|------|------|\n| 本地文件系统 | 项目目录、技能目录、模型缓存（如有）、项目内所有引用旧名称的文件 |\n| Git remote | `git remote -v` 中的仓库名 |\n| Memory 文件 | MEMORY.md、memory/*.md、TOOLS.md 等中的名称 |\n| GitHub repo | repo slug + description |\n| ClawHub | slug + display name（通过重新发布更新） |\n\n**如涉及名称或 slug 变更（改名 = 全量替换）：**\n\n1. **审计**：搜索所有渠道中的旧名称\n ```bash\n # 搜索项目内所有旧名称\n grep -rn \"\\|\" \\\n ~/.openclaw/workspace/projects// \\\n --include=\"*.md\" --include=\"*.html\" --include=\"*.js\" --include=\"*.json\"\n # 搜索 memory 文件\n grep -rn \"\\|\" \\\n ~/.openclaw/workspace/MEMORY.md \\\n ~/.openclaw/workspace/memory/\n # 检查 GitHub\n gh repo view / --json name,description\n ```\n\n2. **改文件内容**（先文字，后目录名，否则路径会断）\n\n3. **改本地目录名 + git remote**\n ```bash\n mv ~/.openclaw/workspace/projects// ~/.openclaw/workspace/projects//\n mv ~/.openclaw/workspace/skills// ~/.openclaw/workspace/skills//\n git remote set-url origin \n ```\n\n4. **改线上平台**：GitHub（`gh repo rename`）→ ClawHub（重新发布）\n\n5."},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn75k53tcdhqwka2fra5x817p9821zpb\",\n \"slug\": \"skill-manager-all-in-one\",\n \"version\": \"4.5.14\",\n \"publishedAt\": 1778319937817\n}"},{"path":"references/clawflows-workflow.md","content":"# ClawFlows Workflow Format Guide | ClawFlows Workflow 格式指南\n\n## Overview | 概述\n\nClawFlows 是一个多技能自动化流程市场，工作流以 YAML 文件定义，提交到 GitHub Registry 经 PR 审核后上线。\n\nWorkflow 与 Skill 的核心区别：\n- **Skill**：本地写好，`clawhub publish` 直接发布，即时生效\n**Workflow**：本地写好，需 fork registry 提 PR，等审核合并后才上线\n\n---\n\n## Two Formats | 两种格式\n\nEvery automation comes in two flavors: \n每个自动化都有两种格式：\n\n| Format | 用途 | Token 消耗 |\n|--------|------|-----------|\n| **Abstract（能力型）** | 跨平台可移植，描述需要哪些 capabilities | 0 |\n| **Lobster-Ready（直接运行型）** | 直接可跑，deterministic shell pipelines | 0 |\n\n---\n\n## File Structure | 目录结构\n\n```\nautomations//\n├── automation.yaml # Workflow 定义\n├── metadata.json # 搜索/展示元数据\n└── README.md # 文档（英中文双语）\n```\n\n---\n\n## automation.yaml | Workflow 定义\n\n```yaml\nname: my-workflow # 唯一标识，slug 格式（小写字母、数字、连字符）\ndescription: One-line description # 一行描述，用于搜索结果\nauthor: your-github-username\nversion: 1.0.0 # 语义化版本\n\nrequires:\n - capability: capability-name # 所需能力，非具体 skill 名\n\ntrigger:\n manual: true # manual=true 表示手动触发；或 schedule: \"0 9 * * *\"\n\nconfig:\n setting_name:\n description: \"用户可配置的设置项说明\"\n default: default_value\n required: false # 是否必填\n\nsteps:\n - name: step-name # 步骤名，唯一标识\n capability: capability-name\n method: methodName\n args:\n key: value\n capture: output_var # 捕获输出，供后续步骤使用\n```\n\n### Key Fields | 关键字段\n\n| 字段 | 说明 |\n|------|------|\n| `name` | URL-safe slug（小写、连字符）|\n| `requires[].capability` | 引用 capability，不写具体 skill 名 |\n| `trigger.schedule` | Cron 表达式，定时触发 |\n| `trigger.manual` | true 表示手动触发 |\n| `steps[].capture` | 捕获输出为变量，`${变量名}` 引用 |\n| `steps[].condition` | JavaScript 表达式，用于条件判断 |\n| `steps[].onFalse` | 条件为 false 时的动作（exit/skip/skip-to:step） |\n\n---\n\n## metadata.json | 元数据\n\n```json\n{\n \"name\": \"workflow-name\",\n \"description\": \"One-line description of what it does\",\n \"author\": \"your-github-username\",\n \"version\": \"1.0.0\",\n \"requires\": [\"capability-1\", \"capability-2\"],\n \"trigger\": \"schedule\",\n \"schedule\": \"0 9 * * *\",\n \"tags\": [\"tag1\", \"tag2\", \"tag3\"]\n}\n```\n\n---\n\n## README.md | 文档规范\n\n```markdown\n# Workflow Name | 工作流名称\n\nBrief description. 简短中文描述。\n\n## What It Does | 功能说明\n\nDetailed explanation of the workflow.\n\n## Requirements | 必要条件\n\n- **capability-name**: Description of what it provides.\n\n## Configuration | 配置项\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `setting` | Description | `default` |\n\n## Example Output | 输出示例\n\nScreenshots, sample notifications, or output examples.\n\n## Author\n\nCreated by [Your Name](https://github.com/username)\n```\n\n---\n\n## Local Install & Run | 本地安装与运行\n\n安装后路径：`~/.openclaw/workspace/automations//`\n\n常用命令：\n```bash\nclawflows install # 从 ClawFlows Registry 安装\nclawflows run # 运行\nclawflows run --dry-run # 预览（不实际执行）\nclawflows check # 检查所需 capabilities\nclawflows list # 列出已安装的工作流\nclawflows logs 本文件是 SKILL.md 的发布操作补充，承上启下。两步验证的完整原则见 SKILL.md Phase 2 步骤 2。\n\n---\n\n## 发布前检查（两步验证第一步）\n\n### A. 完整清单核对\n\n对照 SKILL.md 第 6 章【统一检查清单】逐项执行：\n\n**通用质量基线（G01-G06）+ ClawHub 专项（CH01-CH12）**逐项标注 ✅ / ⚠️。\n\n### B. 脚本安全检查（如技能含 Python/Bash 等脚本）\n\n| 检查要点 | 说明 |\n|---------|------|\n| 输入校验 | 用户输入是否经过验证和过滤，避免直接拼接到命令或路径中 |\n| 权限最小化 | 是否遵循最小权限原则，无过度权限申请 |\n| 凭据保护 | API Key、Token 等敏感信息不出现在日志、报错、返回值中 |\n| 依赖完整性 | 代码 import 的包是否全部出现在 requirements.txt / package.json 中 |\n\n### C. 文件大小检查\n\n```bash\ndu -sh \n```\n\n**超过 50MB 必须处理：**\n- 立即报告用户\n- 将模型/大文件临时移出，等待上传成功后再移回\n- 等待用户明确指示后再操作\n\n### D. 对外表述检查（ClawHub 目标）\n\n- `name`：先英文后中文，`EN Title | 中文标题`\n- `description`：先英文后中文，≤150字符，英文短句在前\n- Changelog：先英文后中文，数字列表，正式语气\n- README 关键标题：先英文后中文\n\n### E. 拟定 Changelog\n\n通过 `--changelog \"...\"` 参数传入，不写在 SKILL.md 里：\n\n```\n1. [English update]. [中文更新]。\n2. [English update]. [中文更新]。\n```\n\n---\n\n## 第二步用户汇报内容（必须全部列出）\n\n| 汇报项 | 内容 |\n|--------|------|\n| Display name | 双语格式 `EN Title | 中文标题` |\n| Skill slug | 小写字母 + 连字符 |\n| description | 先英文后中文，≤150字符 |\n| 目标平台 | ClawHub |\n| 当前版本 | 来自 `clawhub inspect ` |\n| 新版本号 | 在已发布版本上递增 |\n| Changelog | 完整英中文双语内容 |\n| 文件大小 | 超过50MB需特别标注 |\n| 核对清单结果 | G01-G06 + CH01-CH12，逐项 ✅ / ⚠️ |\n| 有⚠️项时的问题与解决方案 | 说明问题 + 修复方案 |\n| **发布命令** | `clawhub publish ...` 完整命令 |\n\n**⚠️ 确认前不得执行任何发布类命令。确认标志：用户回复「确认-」。**\n\n---\n\n## CLI 命令\n\n优先使用 PATH 中的 `clawhub`。若不存在，先尝试 OpenClaw 托管路径：\n\n```bash\nCLAWHUB_BIN=$(command -v clawhub || true)\nif [ -z \"$CLAWHUB_BIN\" ] && [ -x \"$HOME/.openclaw/tools/node/npm/bin/clawhub\" ]; then\n CLAWHUB_BIN=\"$HOME/.openclaw/tools/node/npm/bin/clawhub\"\nfi\n[ -n \"$CLAWHUB_BIN\" ] || { echo \"clawhub command not found\"; exit 1; }\n```\n\n### 发布命令\n\n```bash\n\"$CLAWHUB_BIN\" publish \\\n --slug \\\n --name \"EN Title | 中文标题\" \\\n --version \\\n --changelog \"\"\n```\n\n**⚠️ 双语展示名必须显式传 `--name`，不能只依赖 _meta.json 或 SKILL.md 自动同步。**\n\n### 管理命令\n\n```bash\n\"$CLAWHUB_BIN\" delete --yes # 软删除（两步验证后才可执行）\n\"$CLAWHUB_BIN\" hide --yes # 隐藏（两步验证后才可执行）\n\"$CLAWHUB_BIN\" unhide --yes # 恢复\n\"$CLAWHUB_BIN\" undelete --yes # 取消删除\n\"$CLAWHUB_BIN\" sync\n```\n\n> `--yes` 是 CLI 必需参数。所有破坏性操作均要求用户先通过两步验证。\n\n### Inspect 命令\n\n```bash\n\"$CLAWHUB_BIN\" inspect # 基本信息\n\"$CLAWHUB_BIN\" inspect --tag latest # 最新版本\n\"$CLAWHUB_BIN\" inspect --version X.Y.Z # 指定版本\n\"$CLAWHUB_BIN\" inspect --versions --limit 20 # 版本历史\n\"$CLAWHUB_BIN\" inspect --files # 文件列表\n\"$CLAWHUB_BIN\" inspect --file SKILL.md # 查看文件内容\n\"$CLAWHUB_BIN\" inspect --json # 元数据 JSON\n```\n\n### 登录状态\n\n```bash\n\"$CLAWHUB_BIN\" whoami # 确认登录状态\n\"$CLAWHUB_BIN\" login # 未登录时执行\n```\n\n---\n\n## 核心规则要点\n\n### Display name 双保险\n\nClawHub 页面标题由发布记录的 display-name 控制。双语名必须两处一致：\n\n1. `SKILL.md` YAML frontmatter：`name: EN Title | 中文标题`\n2. 发布命令：`--name \"EN Title | 中文标题\"`\n\n实测仅改 `name:` 或 `_meta.displayName` 更新版本时，ClawHub 顶部展"},{"path":"references/github-publish.md","content":"# GitHub 上传专项 | GitHub Publishing Guide\n\n本文件定义技能通过独立 GitHub 仓库发布的操作规范。\n\n## 适用场景\n\n- 技能有独立的 GitHub 仓库\n- 非 ClawHub 平台发布（如个人仓库、GitHub Pages 等）\n- 需与 ClawHub 发布流程区分\n\n## 发布前准备（对照 SKILL.md 第 6 章清单）\n\n发布 GitHub 前，逐项核对 SKILL.md 中的通用质量基线（G01~G06）和 GitHub 专项（GH01~GH06）：\n\n| 项目 | 内容 |\n|------|------|\n| G01 去标识化 | 无个人信息、内部路径、私有凭证 |\n| G02 安全性 | 无代码安全风险（输入校验、权限最小化） |\n| G03 逻辑科学性 | 结构清晰、路径准确、模块化 |\n| G04 AI 可读性 | agent 可理解、上下文连贯 |\n| G05 易维护性 | 代码整洁、注释到位 |\n| G06 依赖声明 | 外部包/工具/密钥已声明，无硬编码 |\n| GH01 文件结构 | 符合 Skill 目录体系（SKILL.md 在根目录） |\n| GH02 README | 英中文双语，有安装/使用说明 |\n| GH03 Commit 规范 | 英文在前、中文在后，格式正确 |\n| GH04 Release Notes | Markdown 格式，结构清晰 |\n| GH05 无敏感信息 | 无 API Key、Token、内部路径 |\n| GH06 权限隔离 | 无过度文件权限、无不必要的管理脚本 |\n\n**若涉及多语言 README 或多文件修改：逐个修改，逐个确认。**\n\n## 两步验证流程（对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n### 第一步（AI 内部执行，不输出给用户）\n\n- 对照清单全部项（G01~G06 + GH01~GH06），逐项标注 ✅ / ⚠️\n- 检查文件大小（>50MB 需报告）\n- 拟定 Commit Message（英文在前，中文在后）\n- 检查 `git status`，列出所有未提交的变更\n- 若有未提交变更，列出文件名，等待用户确认后再处理\n\n### 第二步（输出给用户，等待明确确认）\n\n⚠️ **未经用户明确确认，不得执行 `git push` / `gh release create` 等任何发布类命令。**\n\n向用户汇报以下全部内容：\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前状态 | 已修改未提交 / 已提交未推送 |\n| 未提交文件 | 列出所有变更文件 |\n| Commit Message | 拟定的提交信息 |\n| 核对清单结果 | G01~G06 + GH01~GH06，✅ / ⚠️ 标注 |\n| 文件大小 | 是否超 50MB |\n| 问题说明 | 有 ⚠️ 项时，说明具体问题 |\n| 解决方案 | 针对 ⚠️ 项的修复方案 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式），不得用「好」「确认」「上传」「发吧」等语义模糊的词汇替代。\n\n**重启规则**：每次用户提出修改，都必须从第一步重新开始。\n\n## 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n获得用户确认后，执行以下命令：\n\n```bash\n# 1. 进入仓库目录\ncd \n\n# 2. 添加所有变更\ngit add -A\n\n# 3. 提交（英文在前，中文在后）\ngit commit -m \"[English message]. [中文信息]。\"\n\n# 4. 推送到远程\ngit push\n```\n\n## Commit Message 规范\n\n- 英文在前，中文在后\n- 正式发布语气\n- 禁止：个人纠错、格式调整、私人调试记录、玩笑、道歉式表述\n- 示例：`fix: 修复徽章HTML兼容性问题，清理各语言版本中文残留`\n\n## 安全约束\n\n1. **严禁擅自上传** — 未获用户明确确认前不得执行 `git push`\n2. **汇报当前状态** — 每次修改后必须汇报状态（已修改/未提交/已上传）\n3. **等待电子签名** — 用户回复「确认-」后才执行 push\n\n## Git 状态检查命令\n\n```bash\n# 查看当前状态\ngit status\n\n# 查看变更统计\ngit diff --stat\n\n# 查看完整变更内容\ngit diff\n\n# 查看提交历史\ngit log --oneline -5\n```\n\n## 常见问题处理\n\n### 有未提交的变更\n\n用户要求上传前，先检查 `git status`：\n- 如有未提交的变更，必须在汇报中列出\n- 等待用户确认后再 add/commit/push\n\n### 远程分支落后\n\n```bash\n# 先拉取最新\ngit pull --rebase\n\n# 再推送\ngit push\n```\n\n### 冲突处理\n\n1. 报告用户存在冲突\n2. 等待用户指示如何解决\n3. 不得强制覆盖远程分支\n\n## GitHub Release 专项 | GitHub Release Guide\n\n创建 GitHub Release 同样需要两步验证。Release Notes 是对外展示的正式说明，必须符合规范。\n\n### 何时需要创建 Release\n\n- 首次正式发布版本（如 v1.0.0）\n- 重要版本更新\n- 用户明确要求创建 Release\n\n### Release Notes 规范\n\n**格式**：Markdown 语法，结构清晰\n**内容**：\n- 标题（版本号 + 简短描述）\n- 变更说明（功能/修复/优化）\n- 技术规格（如适用）\n- 安装方式（如适用）\n\n**禁止**：\n- 个人调试记录\n- 道歉式表述\n- 不完整的描述\n\n### 两步验证流程（Release，对应 SKILL.md Phase 2 步骤 2 两步验证）\n\n#### 第一步（AI 内部执行，不输出给用户）\n\n- 检查 git tag 列表，确认版本号未冲突\n- 拟定 Release Notes（英文在前，中文在后）\n- 检查变更内容是否与 Commit History 一致\n\n#### 第二步（输出给用户，等待明确确认）\n\n| 项目 | 内容 |\n|------|------|\n| 仓库地址 | `https://github.com//` |\n| 当前 tag | 已有 tag 列表 |\n| 新版本号 | 如 v1.0.0 |\n| Release Notes | 拟定的正式说明 |\n| 变更内容 | 列出主要变更 |\n\n**确认标志**：用户必须回复「确认-」（电子签名格式）才可执行。\n\n#### 执行发布（对应 SKILL.md Phase 2 步骤 3）\n\n```bash\n# 1. 创建 tag（如尚未"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。 Skill: Skill Manager All In One | 一站式技能管理器 Owner: moroiser Summary: Manage OpenClaw skills end-to-end. 一站式管理 OpenClaw 技能的创建、修改、发布、更新、升版与审计。 Tags: latest:4.5.14 Version history: v4.5.14 | 2026-05-09T09:45:37.817Z | user 1. Simplify SKILL.md frontmatter: remove verbose metadata JSON, add license field. 精简 frontmatter，删除冗长 metadata JSON，改用 license 字段。2. Simplify Runtime Expectations: remove verbose table-based declarati","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1029,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T14:34:55.493Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T20:53:34.522Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}