{"id":"6d6f2244-b6d0-4f81-9431-08f03c11332b","entityType":"agent","slug":"clawhub-zhelunsun-skillfactory","name":"Skill Factory","canonicalUrl":"https://www.xpersona.co/agent/clawhub-zhelunsun-skillfactory","canonicalPath":"/agent/clawhub-zhelunsun-skillfactory","generatedAt":"2026-10-11T15:16:15.702Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:54:42.859Z","emptyReason":null},"description":"Turn any idea into a polished, versioned, publishable OpenClaw skill — no scaffolding, no guesswork. Just say \"新 skill\" or \"build a skill\" and Skill Factory...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s178q41vf3nvhgdhvwtgx794p5858ce6:skillfactory","sourceUrl":"https://clawhub.ai/zhelunsun/skillfactory","homepage":"https://clawhub.ai/zhelunsun/skills/skillfactory","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/zhelunsun/skillfactory","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/zhelunsun/skills/skillfactory","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Skill Factory technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:54:42.859Z","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-11T11:54:42.859Z","emptyReason":null},"stars":null,"forks":null,"downloads":1071,"packageName":null,"latestVersion":"2.4.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:54:42.844Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T11:54:42.859Z","lastCrawledAt":"2026-10-11T11:54:42.844Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T11:54:42.844Z","lastVerifiedAt":null,"highlights":[{"version":"2.4.0","createdAt":"2026-05-13T11:02:49.661Z","changelog":"Added ClawHub CLI publishing workflow (login via device flow, publish, verify, sync). Captured proxy/SSH and requirement-creep lessons. Fixed path inconsistencies.","fileCount":9,"zipByteSize":22229},{"version":"2.3.0","createdAt":"2026-05-12T09:58:44.913Z","changelog":"Added first-class Upgrade Workflow (Inspect -> Classify -> Propose -> Apply -> Summary), version bump decision framework, enhanced CHANGELOG discipline, trigger words for upgrade/maintenance scenarios.","fileCount":8,"zipByteSize":19689},{"version":"2.2.2","createdAt":"2026-04-21T13:16:17.359Z","changelog":"## Skill Factory 2.2.2 - fix text error","fileCount":5,"zipByteSize":12052},{"version":"2.2.1","createdAt":"2026-04-21T13:11:19.199Z","changelog":"Skill Factory 2.2.1 — Workflow and Documentation Updates - Enhanced SKILL.md with detailed, four-phase SOP for building and iterating OpenClaw skills. - Added clear descriptions of triggers, user scenarios, and skill activation phrases (both English and Chinese). - Clarified repo structure requirements, including bilingual README handling and best practices for publishing. - Expanded guidelines for semantic versioning, changelog hygiene, and commit message conventions. - Outlined upgrade workflow and workspace management for skill development and maintenance.","fileCount":5,"zipByteSize":12066}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178q41vf3nvhgdhvwtgx794p5858ce6:skillfactory","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s178q41vf3nvhgdhvwtgx794p5858ce6:skillfactory` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/zhelunsun/skillfactory before using production credentials."],"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-zhelunsun-skillfactory/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/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-11T15:16:15.699Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zhelunsun-skillfactory/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":"medium","updatedAt":"2026-10-11T11:54:42.859Z","emptyReason":null},"readme":"Skill: Skill Factory\n\nOwner: zhelunsun\n\nSummary: Turn any idea into a polished, versioned, publishable OpenClaw skill — no scaffolding, no guesswork. Just say \"新 skill\" or \"build a skill\" and Skill Factory...\n\nTags: latest:2.4.0\n\nVersion history:\n\nv2.4.0 | 2026-05-13T11:02:49.661Z | user\n\nAdded ClawHub CLI publishing workflow (login via device flow, publish, verify, sync). Captured proxy/SSH and requirement-creep lessons. Fixed path inconsistencies.\n\nv2.3.0 | 2026-05-12T09:58:44.913Z | user\n\nAdded first-class Upgrade Workflow (Inspect -> Classify -> Propose -> Apply -> Summary), version bump decision framework, enhanced CHANGELOG discipline, trigger words for upgrade/maintenance scenarios.\n\nv2.2.2 | 2026-04-21T13:16:17.359Z | user\n\n## Skill Factory 2.2.2\n\n- fix text error\n\nv2.2.1 | 2026-04-21T13:11:19.199Z | user\n\nSkill Factory 2.2.1 — Workflow and Documentation Updates\n\n- Enhanced SKILL.md with detailed, four-phase SOP for building and iterating OpenClaw skills.\n- Added clear descriptions of triggers, user scenarios, and skill activation phrases (both English and Chinese).\n- Clarified repo structure requirements, including bilingual README handling and best practices for publishing.\n- Expanded guidelines for semantic versioning, changelog hygiene, and commit message conventions.\n- Outlined upgrade workflow and workspace management for skill development and maintenance.\n\nArchive index:\n\nArchive v2.4.0: 9 files, 22229 bytes\n\nFiles: CHANGELOG.md (6966b), CLAWHUB.md (1957b), LICENSE (1089b), README_zh.md (5270b), README.md (5560b), skill-card.md (2491b), SKILL-SOP.md (5041b), SKILL.md (16268b), _meta.json (131b)\n\nFile v2.4.0:SKILL.md\n\n---\r\nname: skill-factory\r\nversion: \"2.4.0\"\r\ndescription: >\r\n  Turn any idea into a polished, versioned, publishable OpenClaw skill — no\r\n  scaffolding, no guesswork. Just say \"新 skill\" or \"build a skill\" and Skill\r\n  Factory handles the rest: captures the spec, collects sources, distills\r\n  knowledge, and packages it into a GitHub-ready repo. Also supports upgrading\r\n  existing skills with \"升级 skill\" or \"upgrade skill\". Built for makers who\r\n  want quality without reinventing the process. Triggers: \"新 skill\", \"做一个skill\",\r\n  \"build a skill\", \"create skill\", \"skill制作\", \"把这个做成skill\", \"帮我把...打包成skill\",\r\n  \"skill升级\", \"skill发行\", \"skill factory\", \"制造skill\", \"skill工厂\", \"skill from scratch\",\r\n  \"我有个skill想法\", \"skill迭代\", \"skill打磨\", \"做一个关于...的skill\",\r\n  \"skill版本管理\", \"skill如何发行\", \"skill如何升级\", \"skill生产\", \"skill自动化\",\r\n  \"更新skill\", \"升级skill\", \"维护skill\", \"升级已有skill\", \"upgrade skill\",\r\n  \"update skill\", \"维护现有skill\", \"skill版本升级\", \"skill生命周期\".\r\n---\r\n\r\n# Skill Factory — The Meta-Skill for Making Skills\r\n\r\n> \"The first industrial revolution was marked by using machines to make machines.\r\n> Skill Factory is the machine that makes skills.\"\r\n\r\n## Purpose\r\n\r\nSkill Factory provides a **repeatable, human-AI collaborative SOP** for going from a raw idea to a polished, publishable OpenClaw skill. It handles:\r\n\r\n- **0→1**: Rapid capture of fuzzy ideas → structured BRIEF → distilled skill\r\n- **1→N**: Iterating an existing skill with new sources or structural improvements\r\n- **N→∞**: Publishing, versioning, ClawHub distribution, and ongoing maintenance\r\n\r\nThe key insight: **this is not about capability, it's about workflow.** Any Claw instance with this skill loaded can build production-quality skills — the process is the product.\r\n\r\n---\r\n\r\n## How to Trigger This Skill\r\n\r\nJust say something like:\r\n\r\n> `New skill: [name], [1-2 sentences], [source URL (optional)]`\r\n> `Upgrade skill: [skill name/path], [change request], [new source URL (optional)]`\r\n\r\n### New skill examples:\r\n- `New skill: prompt-engineering, best practices from Anthropic and OpenAI`\r\n- `New skill: git-workflow, standardize my branching and PR flow, https://...`\r\n- `新 skill：简历筛选，用关键词匹配和语义分析筛选简历`\r\n\r\n### Upgrade skill examples:\r\n- `Upgrade skill: nova-reader, add Semantic Scholar data source`\r\n- `Upgrade skill: harness, strengthen governance rules from Phase 3.5 lessons`\r\n- `升级 skill：skill-factory，增加显式升级模式`\r\n\r\nClaw will enter **Phase 0** for new skills or the **Upgrade Workflow** for existing skills — no more information needed to start.\r\n\r\n**中文用户**: `新 skill：[名字]，[1-2句说明]，[来源URL（可选）]` for new; `升级 skill：[skill名字/路径]，[变更要求]，[新来源URL（可选）]` for upgrades.\r\n\r\n---\r\n\r\n## Four-Phase SOP\r\n\r\n### Phase 0 · Capture（≤5 min）\r\n\r\n**Goal**: Lock down the spec before any work begins.\r\n\r\n1. Save raw idea to `inbox/<skill-name>.md` (防止遗失)\r\n2. Ask exactly **3 questions** — no more:\r\n   - What is the target scenario / user?\r\n   - Are there reference sources? (If not, Claw will search)\r\n   - Publish scope: local-only / GitHub / ClawHub distribution?\r\n3. Generate `wip/<skill-name>/BRIEF.md`\r\n\r\n**Key principle**: Phase 0 prevents over-engineering (LRN-003). Don't start building until the 3 questions are answered.\r\n\r\n---\r\n\r\n### Phase 1 · Collect（automated）\r\n\r\n**Goal**: Gather raw material without processing.\r\n\r\n1. `web_fetch` each source → save to `wip/<skill-name>/raw/`\r\n2. If no sources provided, `web_search` for 2–3 high-quality references\r\n3. Prioritize: official docs > primary blog posts > secondary analysis\r\n\r\n**Rule**: At least 1 first-party source (official docs / original author's post). Raw content is saved as-is — no processing yet.\r\n\r\n---\r\n\r\n### Phase 2 · Distill（core work）\r\n\r\n**Goal**: Extract signal, discard noise.\r\n\r\n1. Read all `raw/` files\r\n2. Write per skill-creator spec:\r\n   - `SKILL.md` — triggers + workflow (≤200 lines)\r\n   - `references/` — detailed knowledge, split by topic\r\n   - `scripts/` — reusable code, only if needed\r\n3. **Mandatory verification** (LRN-001): Re-fetch original source, diff against draft, check for gaps\r\n\r\n**Quality checklist**:\r\n- [ ] Trigger words are broad enough to cover all user phrasings\r\n- [ ] SKILL.md has a clear \"when to use\" section\r\n- [ ] Detail lives in `references/`, not bloating `SKILL.md`\r\n- [ ] At least one mandatory re-read of primary source after distillation\r\n\r\n---\r\n\r\n### Phase 3 · Publish\r\n\r\n**Goal**: Clean, versioned, standalone repo ready for GitHub/ClawHub.\r\n\r\n#### Repo Structure (Minimal)\r\n\r\n```\r\n<skill-name>/\r\n├── SKILL.md          # Entry point (triggers + workflow)\r\n├── README.md         # Human-facing intro — bilingual (EN + ZH)\r\n├── CHANGELOG.md      # Version history\r\n├── LICENSE           # MIT recommended\r\n├── .gitignore\r\n└── references/       # Knowledge base\r\n    └── *.md\r\n```\r\n\r\nFor script-heavy skills, add:\r\n```\r\n└── scripts/\r\n    └── *.py\r\n```\r\n\r\n#### README Spec\r\n\r\nA skill README must answer 3 questions in ≤60 seconds of reading:\r\n1. **What problem does it solve?** (1-2 sentences, no jargon)\r\n2. **What makes it better than asking without it?** (key differentiator)\r\n3. **How do I use it?** (one concrete example)\r\n\r\n**Bilingual (EN + ZH)**: Use two separate files for maximum clarity.\r\n\r\n```\r\nREADME.md       # English only — no Chinese text anywhere\r\nREADME_zh.md    # Chinese only — full detail, selling points, usage\r\n```\r\n\r\nEach file includes a badge linking to the other version. This allows GitHub to render clean language-specific views and enables future ClawHub to surface the right version per locale.\r\n\r\n#### ClawHub Distribution\r\n\r\nWhen the user wants to publish to ClawHub:\r\n1. Ensure `SKILL.md` frontmatter has: `name`, `version`, `description`\r\n2. `description` must contain broad trigger phrases covering multiple phrasings\r\n3. `LICENSE` file present (MIT recommended)\r\n4. Tag the release: `git tag v1.0.0 && git push --tags`\r\n\r\n#### ClawHub CLI Publishing (实操工作流)\r\n\r\nWhen the skill is already published and needs a version update on ClawHub, use the `clawhub` CLI:\r\n\r\n**Prerequisites:**\r\n- Node.js environment with clawhub package installed:\r\n  ```\r\n  npm install clawhub\r\n  ```\r\n- ClawHub account with device flow login (headless-friendly):\r\n  ```\r\n  clawhub login --device\r\n  # Visit the provided URL, enter the code, authorize in browser\r\n  # Note: login process must stay running in background while user authorizes\r\n  ```\r\n\r\n**Publish update workflow:**\r\n```bash\r\n# 1. Push latest commit to GitHub first\r\ngit push origin main\r\n\r\n# 2. Tag the release\r\ngit tag v<new-version>\r\ngit push --tags\r\n\r\n# 3. Publish to ClawHub\r\nclawhub skill publish <repo-path> --slug <slug> --version <new-version> --changelog \"<summary>\"\r\n\r\n# 4. Verify\r\nclawhub inspect <slug>\r\n\r\n# 5. Sync to local workspace\r\nCopy-Item -Recurse -Force \"D:\\Agent\\WorkBuddy\\skills\\<skill-name>\\*\" \"$env:USERPROFILE\\.workbuddy\\skills\\<skill-name>\\\"\r\n```\r\n\r\n**Protocol: GitHub first, ClawHub second.** Always push to GitHub before publishing to ClawHub. This ensures the source code is available for moderation review and users can link back to the repo.\r\n\r\n**Windows + Proxy note:** Use HTTPS remote (not SSH) on Windows environments with proxy/VPN. SSH port 22 may be intercepted by proxy tools (Clash/V2Ray). Configure:\r\n```\r\ngit remote set-url origin https://github.com/<owner>/<repo>.git\r\n```\r\n\r\n**Limitation:** ClawHub Summary is derived from SKILL.md frontmatter `description` field. To update the summary, edit `description` in SKILL.md and republish.\r\n\r\n#### Auto-Sync Automation (Optional)\r\n\r\nA local workbuddy automation can periodically check and sync all skills:\r\n\r\n```yaml\r\n# One-time manual: for each repo, push + publish + sync\r\n# Or set a weekly cron via workbuddy automation\r\n```\r\n\r\nSee `automation` system in WorkBuddy for setting up recurring sync tasks.\r\n\r\n#### Sync to Local Workspace\r\n\r\nAfter publishing, sync to `~/.workbuddy/skills/<skill-name>/` so Claw can use it immediately:\r\n\r\n```powershell\r\nCopy-Item -Recurse -Force \"D:\\Agent\\WorkBuddy\\skills\\<skill-name>\\*\" \"$env:USERPROFILE\\.workbuddy\\skills\\<skill-name>\\\"\r\n```\r\n\r\n---\r\n\r\n## Upgrade Workflow (1→N Maintenance)\r\n\r\n**Goal**: Update an existing skill without starting from scratch.\r\n\r\nThis is a **first-class workflow**, distinct from creating a new skill. When the user invokes `Upgrade skill:`, follow these steps:\r\n\r\n### Step 1 · Inspect (read existing state)\r\n\r\n1. Read the existing skill repo:\r\n   - `SKILL.md` — current version, triggers, workflow\r\n   - `CHANGELOG.md` — version history (especially recent entries)\r\n   - `README.md` — public description\r\n   - `references/` — existing knowledge base\r\n   - Git log — recent changes and commit history\r\n2. Identify the current version (from `SKILL.md` frontmatter or git tag)\r\n\r\n### Step 2 · Classify the change\r\n\r\nCompare the requested change against the skill's **public API** — its documented behavior:\r\n\r\n| Public API element | Examples |\r\n|-------------------|----------|\r\n| Use cases | What scenarios the skill serves |\r\n| Input format | What the user says to trigger the skill |\r\n| Output format | What files/code the skill produces |\r\n| Workflow phases | The SOP structure |\r\n| Safety boundaries | What the agent must not do |\r\n| File structure | Repo layout conventions |\r\n| Publishing behavior | How the skill is distributed |\r\n\r\nDetermine the version bump:\r\n\r\n| Bump | When | Examples |\r\n|------|------|----------|\r\n| **PATCH** `x.x.1` | Fixes that don't change behavior | Typo fix, clarification, trigger word tweak |\r\n| **MINOR** `x.1.0` | Backward-compatible additions | New workflow mode, new reference source, optional publishing path |\r\n| **MAJOR** `x.0.0` | Breaking changes | Changed triggering format, restructured SOP, removed phase, changed safety assumptions |\r\n\r\n### Step 3 · Propose (generate upgrade plan)\r\n\r\nBefore making any changes, produce an upgrade plan:\r\n\r\n```markdown\r\n## Upgrade Plan\r\n\r\nCurrent version: <version from SKILL.md>\r\nProposed version: <computed bump>\r\nChange type: PATCH / MINOR / MAJOR\r\n\r\nReason:\r\n<why this change belongs in this category>\r\n\r\nFiles to modify:\r\n<list of files that need changes>\r\n\r\nRisk level: low / medium / high\r\nBackward compatibility: yes / no\r\n\r\nProposed changelog entry:\r\n### Added\r\n- <new features>\r\n\r\n### Changed\r\n- <behavior changes>\r\n\r\n### Fixed\r\n- <bug fixes>\r\n\r\nSuggested commit message:\r\n<semantic commit message>\r\n\r\nSuggested tag:\r\nv<new version>\r\n```\r\n\r\nPresent this plan to the user. Do not apply changes until the user confirms.\r\n\r\n### Step 4 · Apply\r\n\r\nAfter user confirmation:\r\n\r\n1. Update files (SKILL.md, README, CHANGELOG, references)\r\n2. Bump version in SKILL.md frontmatter and README badges\r\n3. Update `CHANGELOG.md` with proper format (see below)\r\n4. Commit with semantic message\r\n5. Tag the release: `git tag v<new-version> && git push --tags`\r\n6. Re-sync to local workspace\r\n\r\n### Step 5 · Upgrade Summary\r\n\r\nAfter applying, produce a summary:\r\n\r\n```\r\n## Upgrade Complete\r\n\r\n<old version> → <new version>\r\nFiles changed: <list>\r\nChangelog: <link or excerpt>\r\nNext steps: <optional>\r\n```\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nVersion semantics follow **Semantic Versioning** adapted for skills:\r\n\r\n```\r\nMAJOR.MINOR.PATCH\r\n```\r\n\r\n| Version bump | When | Example trigger |\r\n|---|---|---|\r\n| **PATCH** `x.x.1` | Typo fix, trigger word tweak, minor clarification | \"修复了一个例子描述不准\" |\r\n| **MINOR** `x.1.0` | New reference source, new phase step, extended trigger coverage | \"加入 Anthropic 最新文档\" |\r\n| **MAJOR** `2.0.0` | Scope change, structural refactor, paradigm shift | \"从单文档改为多 reference 结构\" |\r\n\r\n### What warrants a MAJOR bump?\r\n\r\nA MAJOR version (e.g. 1.x → 2.0) signals a **breaking change in the skill's mental model**:\r\n- The core SOP phases are restructured\r\n- The skill's scope is fundamentally redefined\r\n- Files are reorganized in ways that break the previous structure\r\n- The activation paradigm changes (e.g. from \"ask anything\" to \"four-phase SOP\")\r\n\r\n**MAJOR ≠ more content**. A skill that doubles its references but keeps the same structure is still a MINOR bump.\r\n\r\n### What warrants a MINOR bump?\r\n\r\nA MINOR version (e.g. 1.0 → 1.1 → 1.2) signals **additive improvements** that don't break the existing pattern:\r\n- New knowledge source added to `references/`\r\n- New trigger words added to frontmatter\r\n- New section added to SOP without restructuring existing phases\r\n- README improvements, badge updates\r\n\r\n### Commit message convention\r\n\r\n```\r\nfeat: add [source] to references        → MINOR\r\nfix: correct [description]              → PATCH\r\nrefactor: restructure [component]       → could be MAJOR\r\nrelease: v2.0.0 - [summary]            → tag release commits\r\n```\r\n\r\n### Changelog discipline\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\nEvery release must update `CHANGELOG.md` with:\r\n- `[Unreleased]` section at the top (collects next-version changes)\r\n- Version section for each release: `[X.Y.Z] — YYYY-MM-DD`\r\n- Grouped changes under: **Added**, **Changed**, **Fixed**, **Deprecated**, **Removed**, **Security**\r\n- User-readable summaries, not raw git diffs\r\n- A single-line **Summary** at the top of each version\r\n\r\nThe `[Unreleased]` section captures changes that will go into the next release. Before cutting a new version, review `[Unreleased]`, classify entries, and move them into the version section.\r\n\r\n**Distinction**: git history = developer log; CHANGELOG = user-facing narrative. Do not substitute one for the other.\r\n\r\n---\r\n\r\n## Skill Iteration (Legacy — use Upgrade Workflow above)\r\n\r\nThe legacy iteration path is preserved for quick edits. For structured upgrades, use the **Upgrade Workflow** (produces planned changes and version bump).\r\n\r\nWhen doing a quick upgrade:\r\n\r\n1. Create a new branch or directly update `D:/Agent/WorkBuddy/skills/<skill-name>/`\r\n2. Add new source to `references/` with dated filename (`source-YYYYMMDD.md`)\r\n3. Update `SKILL.md` version field and trigger words if needed\r\n4. Update `CHANGELOG.md`\r\n5. Bump version (MAJOR / MINOR / PATCH per rules above)\r\n6. Commit with semantic message\r\n7. Re-sync to local workspace\r\n\r\n**Upgrade triggers**: User sends new URL, user says \"skill has a gap\", Claw detects missing knowledge during a task execution.\r\n\r\n---\r\n\r\n## Workspace Layout\r\n\r\n```\r\nD:/WorkBuddy/\r\n└── .workspace-index.md      # Master skill status board\r\n\r\nD:/Agent/WorkBuddy/skills/\r\n├── skill-factory/           # This meta-skill repo\r\n│   ├── SKILL.md             # This file\r\n│   ├── README.md\r\n│   ├── CHANGELOG.md\r\n│   ├── LICENSE\r\n│   ├── .gitignore\r\n│   ├── CLAWHUB.md\r\n│   ├── inbox/               # Raw ideas drop zone\r\n│   └── wip/                 # Active work-in-progress\r\n│       └── <skill-name>/\r\n│           ├── BRIEF.md\r\n│           ├── raw/\r\n│           └── draft/\r\n│\r\n├── harness/                 # ✅ v1.2.0 — ready for GitHub\r\n├── nova-reader/             # ✅ v1.1.0 — ready for GitHub\r\n└── <future-skills>/\r\n```\r\n\r\n---\r\n\r\n## Lessons Learned (from .learnings)\r\n\r\n| ID | Lesson | Fix in SOP |\r\n|----|--------|-----------|\r\n| LRN-001 | Missed content after distillation without re-reading source | Phase 2 mandatory re-fetch |\r\n| LRN-002 | Skill evolved in workspace, hard to publish as standalone | Phase 3 independent repo |\r\n| LRN-003 | Over-engineered before confirming real need | Phase 0 three-question lock |\r\n| LRN-004 | Research notes mixed with skill docs | `raw/` vs `references/` separation |\r\n| LRN-005 | ClawHub login needs background process to wait for user auth | Device Flow requires staying alive |\r\n| LRN-006 | Git push blocked by proxy/VPN (SSH 22) on Windows | Use HTTPS + PAT, configure remote |\r\n| LRN-007 | Requirement creep during simple tasks | Core first, periphery later |\n\nFile v2.4.0:README.md\n\n# Skill Factory\r\n\r\n> **\"The first industrial revolution ended when machines began building machines.\"**\r\n> **Skill Factory is the machine that builds skills.**\r\n\r\nA **meta-skill** for OpenClaw that automates the full lifecycle of skill creation — from a fuzzy idea to a polished, versioned, distributable package.\r\n\r\n[![Version](https://img.shields.io/badge/version-2.4.0-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![中文说明](https://img.shields.io/badge/README-中文版-orange.svg)](README_zh.md)\r\n\r\n---\r\n\r\n## What Problem Does It Solve?\r\n\r\nCreating an OpenClaw skill without a workflow leads to: fuzzy specs, missed knowledge during distillation, scattered files impossible to publish, and skills that stagnate at v1.0 with no clear upgrade path.\r\n\r\n**Skill Factory solves all of this** by treating skill creation as a repeatable, improvable process — not a one-off creative act.\r\n\r\n## What Makes It Different?\r\n\r\nMost skill-making is ad hoc. Skill Factory is an **end-to-end automated SOP** that any Claw instance can follow:\r\n\r\n**Foundation** — lock scope before work begins:\r\n- **Phase 0 three-question lock** — prevents scope creep and over-engineering\r\n\r\n**Quality** — ensure nothing is missed:\r\n- **Mandatory source re-verification** — catches missed content after distillation\r\n\r\n**Structure** — ship-ready from day one:\r\n- **Independent repo per skill** — every skill is GitHub/ClawHub-ready from day one\r\n- **Semantic versioning for skills** — clear rules for MAJOR vs MINOR vs PATCH\r\n\r\n**Evolution** — not just 0→1, but 1→N:\r\n- **Human-AI collaborative iteration** — ongoing improvement with versioned upgrades\r\n\r\nIt is not about what Claw *can* do — it is about turning an unbounded capability into a **reliable, high-quality pipeline**. The process is the product.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust send Claw an idea:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nClaw enters **Phase 0** immediately — no setup required.\r\n\r\n---\r\n\r\n## Example: Building the `harness` Skill\r\n\r\nHere is how Skill Factory handled a real request end-to-end:\r\n\r\n**Input** (30 seconds):\r\n```\r\nNew skill: harness, distill OpenAI's agent engineering article,\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — Three questions answered in one message:\r\n- Target: any Claw working on agent-first engineering\r\n- Source: OpenAI Harness Engineering blog post\r\n- Scope: GitHub + local workspace\r\n\r\n**Phase 1** — `web_fetch` the source, saved to `wip/harness/raw/`\r\n\r\n**Phase 2** — Distilled into `SKILL.md` (10 principles) + `references/` (two documents). Mandatory re-read caught 4 missed concepts including the \"Ralph Wiggum loop\".\r\n\r\n**Phase 3** — Independent repo, MIT license, bilingual README, git-tagged `v1.2.0`, synced to workspace.\r\n\r\n**Total time**: ~10 minutes. Without the factory, the same work took a full day of iteration and still had gaps.\r\n\r\n---\r\n\r\n## Four-Phase SOP Overview\r\n\r\n| Phase | Name | Output |\r\n|-------|------|--------|\r\n| 0 | Capture | `BRIEF.md` — locked spec |\r\n| 1 | Collect | `raw/` — raw source material |\r\n| 2 | Distill | `SKILL.md` + `references/` |\r\n| 3 | Publish | versioned repo, synced to workspace |\r\n\r\nFull SOP details are in [SKILL.md](SKILL.md).\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nSkills use **Semantic Versioning** adapted for this format:\r\n\r\n| Bump | When |\r\n|------|------|\r\n| `PATCH` (x.x.1) | Typo fix, trigger word tweak |\r\n| `MINOR` (x.1.0) | New source, new section, extended triggers |\r\n| `MAJOR` (2.0.0) | Paradigm shift, structural refactor |\r\n\r\n**MAJOR does not mean more content** — a skill that doubles its references but keeps the same structure is still MINOR.\r\n\r\n---\r\n\r\n## Maintaining Existing Skills (1→N)\r\n\r\nSkill Factory is not only a 0→1 generator. It also supports **structured upgrades** to existing skills:\r\n\r\n```\r\nUpgrade skill: [skill name/path], [change request], [new source URL (optional)]\r\n```\r\n\r\nThe upgrade workflow:\r\n1. **Inspect** — reads the existing repo state\r\n2. **Classify** — determines a PATCH/MINOR/MAJOR bump\r\n3. **Propose** — generates an upgrade plan before making changes\r\n4. **Apply** — updates files, CHANGELOG, version\r\n5. **Summary** — reports what changed\r\n\r\nThis ensures v2, v3, and v4 are as disciplined as v1. Git versioning, semantic versioning, CHANGELOG discipline, and the upgrade plan work together to prevent skill degradation over time.\r\n\r\n---\r\n\r\n## Repo Structure\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # Full SOP — four phases, version management, publishing spec\r\n├── README.md        # This file (English)\r\n├── README_zh.md     # Chinese version\r\n├── CHANGELOG.md     # Version history\r\n├── LICENSE          # MIT\r\n├── inbox/           # Drop zone for raw ideas\r\n└── wip/             # Active work-in-progress\r\n    └── <skill>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### From ClawHub (Recommended)\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\nOr use the full identifier:\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### Manual Installation\r\n\r\n1. Clone this repo to your skills directory:\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.workbuddy/skills/skillfactory\r\n```\r\n\r\n2. Restart your Claw session — the skill will auto-load.\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — fork it, adapt it, build your own factory.\n\nFile v2.4.0:_meta.json\n\n{\n  \"ownerId\": \"kn75mmeqmz6rt3hwpt8qy83cj1858fnw\",\n  \"slug\": \"skillfactory\",\n  \"version\": \"2.4.0\",\n  \"publishedAt\": 1778670169661\n}\n\nFile v2.4.0:CHANGELOG.md\n\n# Changelog — skill-factory\r\n\r\nAll notable changes to skill-factory will be documented in this file.\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\n---\r\n\r\n## [Unreleased]\r\n\r\nNo unreleased changes yet.\r\n\r\n---\r\n\r\n## [2.4.0] — 2026-05-13\r\n\r\n### Summary\r\n\r\n**End-to-end ClawHub CLI publishing workflow.** Phase 3 now includes a full, battle-tested SOP for publishing skill updates to ClawHub via CLI — covering login, publish, verify, and local sync. Lessons from earlier failures (proxy issues, requirement creep, device flow) are captured.\r\n\r\n### Added\r\n- Phase 3 → ClawHub CLI Publishing: device flow login, publish command, verify, local sync steps\r\n- Phase 3 → Windows proxy notes: HTTPS vs SSH guidance\r\n- Lessons Learned table: LRN-005 (ClawHub device flow background), LRN-006 (SSH/proxy), LRN-007 (requirement creep)\r\n\r\n### Changed\r\n- SKILL.md version bumped from v2.3.0 to v2.4.0\r\n- README.md / README_zh.md version badges updated to v2.4.0\r\n\r\n### Fixed\r\n- CLAWHUB.md version updated from v2.1.0 to v2.3.0 (was out of sync)\r\n- SKILL.md Workspace Layout: corrected `D:/WorkBuddy/` → `D:/Agent/WorkBuddy/skills/` for skill repo paths\r\n- SKILL.md Legacy section: `D:/WorkBuddy/<skill-name>/` → `D:/Agent/WorkBuddy/skills/<skill-name>/`\r\n- README_zh.md: OpenAI URL changed from Chinese-localized to canonical English URL\r\n- README.md / README_zh.md: manual install path from `~/.claw/skills/` → `~/.workbuddy/skills/`\r\n- .workspace-index.md: directory structure comment updated from v2.2.0 to v2.3.0\r\n\r\n## [2.3.0] — 2026-05-12\r\n\r\n### Summary\r\n\r\n**First-class upgrade workflow for existing skills.** Skill Factory now explicitly supports 1→N maintenance alongside 0→1 creation.\r\n\r\n### Added\r\n- `Upgrade skill:` as a first-class entry point alongside `New skill:`\r\n- Upgrade Workflow section in SKILL.md: Inspect → Classify → Propose → Apply → Summary\r\n- Version bump decision framework: skill's \"public API\" defined (use cases, input/output, workflow phases, safety boundaries, file structure)\r\n- Upgrade plan template: current version, proposed version, change type, files to modify, risk level, changelog entry, commit message, tag\r\n- Enhanced trigger words covering upgrade and maintenance scenarios\r\n\r\n### Changed\r\n- SKILL.md: `[Unreleased]` section added to CHANGELOG guidance per Keep a Changelog standard\r\n- CHANGELOG discipline: now requires grouped changes (Added / Changed / Fixed / Deprecated / Removed / Security) and user-readable summaries\r\n- README.md: added \"Maintaining Existing Skills (1→N)\" section\r\n- README_zh.md: updated quick start with skill upgrade example\r\n- Legacy \"Skill Iteration\" section renamed to \"Skill Iteration (Legacy)\" with redirect to Upgrade Workflow\r\n\r\n### Fixed\r\n- Workspace layout path in SKILL.md now consistent with actual directory structure\r\n\r\n---\r\n\r\n## [2.2.2] — 2026-04-27\r\n\r\n### Summary\r\n\r\n**Version sync: local repo aligned with ClawHub v2.2.2 release.**\r\n\r\n### Changed\r\n- `SKILL.md`: version field updated to `2.2.2`\r\n- `README.md` / `README_zh.md`: version badges updated to `2.2.2`\r\n\r\n### Notes\r\n- ClawHub listing had advanced to v2.2.2; this commit brings the GitHub repo in sync\r\n- Submitted false-positive appeal to openclaw/clawhub for suspicious flag on this skill\r\n\r\n---\r\n\r\n## [2.2.1] — 2026-04-21\r\n\r\n### Summary\r\n\r\n**ClawHub distribution ready + clean publish structure.**\r\n\r\n### Added\r\n- `README.md`: ClawHub installation instructions (`claw skill install skillfactory`)\r\n- `README_zh.md`: 中文安装说明\r\n- `README.md` & `README_zh.md`: Tags section for discoverability\r\n- `CLAWHUB.md`: Dedicated ClawHub listing page with one-line pitch\r\n- `PUBLISH.md`: Release command reference for future updates\r\n\r\n### Changed\r\n- Slug finalized: `skillfactory` (GitHub: PandaBro666/skillfactory)\r\n- `.gitignore` updated: excludes `inbox/`, `wip/`, `promo/` from public repo\r\n\r\n### Notes\r\n- Minimum ClawHub requirement: `SKILL.md` only\r\n- Recommended: `SKILL.md` + `README.md` + `LICENSE` for professional presentation\r\n- Clean publish workflow: copy core files to separate directory to avoid uploading WIP content\r\n\r\n---\r\n\r\n## [2.2.0] — 2026-04-20\r\n\r\n### Summary\r\n\r\n**Bilingual README split + clean publish structure.**\r\n\r\n### Added\r\n- `README_zh.md` — dedicated Chinese README with bilingual badge linking between versions\r\n- `.gitignore` — excludes `inbox/` and `wip/` from public repo (personal work area)\r\n\r\n### Changed\r\n- `README.md` (English): completely purged of Chinese text; \"Skills Built With This Factory\" section replaced with a concrete end-to-end example using the `harness` skill\r\n- `README.md` now includes badge linking to `README_zh.md`\r\n- `README_zh.md` likewise links back to English version via badge\r\n\r\n### Fixed\r\n- SKILL.md Phase 3 bilingual spec updated: README is now two separate files, not two sections in one\r\n\r\n---\r\n\r\n## [2.1.0] — 2026-04-20\r\n\r\n### Summary\r\n\r\n**GitHub release ready.** Full bilingual README, version management SOP, and LICENSE added.\r\n\r\n### Added\r\n- `LICENSE` (MIT) — required for ClawHub distribution\r\n- Semantic versioning guide in `SKILL.md`: MAJOR / MINOR / PATCH semantics with decision criteria\r\n- Commit message convention (`feat:` / `fix:` / `refactor:` / `release:`)\r\n- Changelog discipline rules (every release must update CHANGELOG)\r\n\r\n### Changed\r\n- `README.md` rewritten as bilingual (EN + ZH), \"industrial revolution\" analogy as lead hook\r\n- `SKILL.md` v2.1: extended version management section, bilingual README spec in Phase 3\r\n- Trigger words expanded: added `skill版本管理`, `skill如何发行`, `skill生产`, `skill自动化`\r\n\r\n---\r\n\r\n## [2.0.0] — 2026-04-20\r\n\r\n### Summary\r\n\r\n**From SOP document to meta-skill.**\r\n\r\nSkill Factory is now itself a publishable WorkBuddy skill. v2.0 restructures the project so it can be distributed via GitHub/ClawHub and loaded by any Claw instance, just like any other skill.\r\n\r\n### Changed\r\n- `SKILL.md` completely rewritten as a proper skill entry point with YAML frontmatter, trigger words, and self-contained SOP\r\n- Added Phase 3 publishing specs: README format, ClawHub distribution checklist, version semantics\r\n- Added skill iteration workflow (1→N upgrades)\r\n- `README.md` rewritten as human-facing project page with selling points\r\n\r\n### Added\r\n- `CHANGELOG.md` (this file)\r\n- ClawHub distribution spec in Phase 3\r\n- Skill upgrade triggers and process\r\n- Workspace layout reference\r\n\r\n---\r\n\r\n## [1.0.0] — 2026-04-18\r\n\r\n### Summary\r\n\r\n**Initial creation.**\r\n\r\nBuilt during the harness skill development cycle as a response to 4 accumulated learnings (LRN-001 through LRN-004). Established the four-phase SOP and workspace directory structure.\r\n\r\n### Added\r\n- `SKILL-SOP.md` — four-phase workflow (Phase 0-3)\r\n- `inbox/` directory — idea drop zone\r\n- `wip/` directory — active skill workspace\r\n- `D:/WorkBuddy/.workspace-index.md` — master skill status board\r\n- 4 lessons from harness creation embedded into SOP\n\nFile v2.4.0:CLAWHUB.md\n\n# Skill Factory — ClawHub Listing\r\n\r\n**Slug:** `skillfactory`  \r\n**Display Name:** Skill Factory  \r\n**Version:** 2.3.0  \r\n**License:** MIT  \r\n**Author:** PandaBro666\r\n\r\n---\r\n\r\n## One-Line Pitch\r\n\r\nThe machine that builds skills — because making a skill from scratch shouldn't feel like reinventing the wheel every time.\r\n\r\n---\r\n\r\n## What It Does\r\n\r\nSkill Factory is your skill-making buddy. You bring an idea (or a URL), it handles the rest:\r\n\r\n- **Lock the scope** — 3 quick questions to make sure you're building the right thing\r\n- **Gather the goods** — fetches source material automatically\r\n- **Distill the signal** — turns noise into structured SKILL.md + references\r\n- **Ship it** — packages everything into a versioned, GitHub-ready repo\r\n- **Keep it fresh** — structured upgrade workflow so your skills don't rot at v1.0\r\n\r\nNo boilerplate templates. No \"what now?\" moments. Just say the word and it works.\r\n\r\n---\r\n\r\n## When to Use\r\n\r\n- You have a skill idea but don't know how to start\r\n- You want to turn scattered notes or bookmarks into a proper skill\r\n- You need to bring an existing skill up to date with new sources\r\n- You're preparing something for GitHub or ClawHub\r\n- You have a skill sitting at v1.0 and want to grow it without messing up\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust tell your Claw:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nExample:\r\n```\r\nNew skill: prompt-engineering, best practices from Anthropic and OpenAI\r\n```\r\n\r\nOr to upgrade an existing one:\r\n```\r\nUpgrade skill: [name], [what to add], [new source URL (optional)]\r\n```\r\n\r\n---\r\n\r\n## Tags\r\n\r\n`meta-skill` `skill-authoring` `openclaw` `agent-engineering` `workflow-automation` `knowledge-distillation`\r\n\r\n---\r\n\r\n## Links\r\n\r\n- **Repository:** https://github.com/zhelunSun/skill-factory\r\n- **English README:** [README.md](README.md)\r\n- **中文说明:** [README_zh.md](README_zh.md)\r\n- **Changelog:** [CHANGELOG.md](CHANGELOG.md)\n\nFile v2.4.0:README_zh.md\n\n# Skill Factory\r\n\r\n> **\"第一次工业革命结束的标志，是用机器来制造机器。**\r\n> **Skill Factory，就是那台制造skill的机器。\"**\r\n\r\n这是一个用于 OpenClaw 的**元技能（meta-skill）**，将 skill 的创作过程——从一句模糊的想法，到打磨完毕、版本清晰、可直接发行的成品——变成一套可重复执行的标准化流程。\r\n\r\n[![Version](https://img.shields.io/badge/version-2.4.0-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![English README](https://img.shields.io/badge/README-English-blue.svg)](README.md)\r\n\r\n---\r\n\r\n## 它解决什么问题？\r\n\r\n没有工作流直接上手制作 skill，常见结局：\r\n\r\n- 需求没说清楚就开始干，做到一半发现方向不对\r\n- 蒸馏完文章，发现漏了关键内容，还得回头重看\r\n- 文件散落各处，想发布到 GitHub 才发现结构一团糟\r\n- v1.0 做完了，不知道什么时候该升级、如何管理版本\r\n\r\nSkill Factory 用**四阶段 SOP** 系统性地解决以上全部问题。\r\n\r\n---\r\n\r\n## 核心差异化\r\n\r\n市面上的 skill 制作多是随兴而为。Skill Factory 的不同之处：\r\n\r\n**基础层** — 开工前锁定范围：\r\n- **Phase 0 三问锁定**：三个问题锁死需求，防止过度工程化\r\n\r\n**质量层** — 确保知识完整：\r\n- **强制原文二次核对**：蒸馏完必须回到原始来源比对，防止知识遗漏\r\n\r\n**结构层** — 发行级从第一天开始：\r\n- **每个 skill 独立 repo**：从第一天起就是发行级结构，随时可 push 到 GitHub\r\n- **语义化版本管理**：清楚区分 MAJOR（范式重构）/ MINOR（增量添加）/ PATCH（修小问题）\r\n\r\n**演进层** — 不只是 0→1，更是 1→N：\r\n- **持续迭代机制**：有明确的升级路径和人机协作改进流程\r\n\r\n关键在于：**这不是关于 Claw 能做什么，而是关于如何把无边界的能力，变成高质量、可重复的流水线。流程本身就是产品。**\r\n\r\n---\r\n\r\n## 快速上手\r\n\r\n发给 Claw 一个想法即可：\r\n\r\n```\r\n新 skill：[名字]，[1-2句描述]，[来源链接（可选）]\r\n```\r\n\r\n或升级已有 skill：\r\n\r\n```\r\nskill升级：[名字]，[要加什么]，[新来源链接（可选）]\r\n```\r\n\r\nClaw 会立刻进入 Phase 0，回答 3 个问题后，流水线自动运转。\r\n\r\n---\r\n\r\n## 实际案例：制作 `harness` skill\r\n\r\n以下是 Skill Factory 处理一次真实需求的完整过程：\r\n\r\n**用户输入**（30秒）：\r\n```\r\n新 skill：harness，蒸馏 OpenAI 的智能体工程文章，\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — 三问一轮解决：\r\n- 目标用户：任何在做智能体工程的 Claw 实例\r\n- 来源：OpenAI Harness Engineering 博客\r\n- 发行形式：GitHub + 本地 workspace 同步\r\n\r\n**Phase 1** — `web_fetch` 抓取原文，存入 `wip/harness/raw/`\r\n\r\n**Phase 2** — 蒸馏为 `SKILL.md`（10 大原则）+ `references/`（两份文档）。强制二次核对步骤发现了 4 处遗漏，包括\"Ralph Wiggum 自我审查循环\"。\r\n\r\n**Phase 3** — 独立 repo，MIT 协议，双语 README，git 打标签 `v1.2.0`，同步到 workspace。\r\n\r\n**耗时**：约 10 分钟。没有这套工厂，同样的工作之前需要一整天迭代，且仍有知识盲区。\r\n\r\n---\r\n\r\n## 四阶段 SOP 概览\r\n\r\n| 阶段 | 名称 | 产出 |\r\n|------|------|------|\r\n| 0 | 快速摄入 | `BRIEF.md`：锁定需求 |\r\n| 1 | 资料收集 | `raw/`：原始资料 |\r\n| 2 | 蒸馏 | `SKILL.md` + `references/` |\r\n| 3 | 封装发行 | 带版本标签的独立 repo |\r\n\r\n完整 SOP 见 [SKILL.md](SKILL.md)。\r\n\r\n---\r\n\r\n## 版本管理逻辑\r\n\r\n借用软件工程的语义化版本，专为 skill 定制：\r\n\r\n| 版本变动 | 何时触发 |\r\n|----------|---------|\r\n| `PATCH`（x.x.1）| 修错别字、调整触发词描述 |\r\n| `MINOR`（x.1.0）| 新增来源、补充章节、扩展触发词 |\r\n| `MAJOR`（2.0.0）| 核心结构重构、范式转变、激活方式改变 |\r\n\r\n**MAJOR 不等于内容更多**——如果翻倍了 references 但结构不变，仍然是 MINOR。\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # 完整 SOP 文档（触发词 + 四阶段 + 版本管理 + 发行规范）\r\n├── README.md        # 英文版说明\r\n├── README_zh.md     # 本文件（中文说明）\r\n├── CHANGELOG.md     # 版本历史\r\n├── LICENSE          # MIT 开源协议\r\n├── inbox/           # 想法投递区（随时丢，不会丢）\r\n└── wip/             # 进行中的 skill 工作区\r\n    └── <skill名>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## 安装方法\r\n\r\n### 通过 ClawHub 安装（推荐）\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\n或使用完整标识符：\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### 手动安装\r\n\r\n1. 克隆仓库到技能目录：\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.workbuddy/skills/skillfactory\r\n```\r\n\r\n2. 重启 Claw 会话 —— 技能将自动加载。\r\n\r\n---\r\n\r\n## 开源协议\r\n\r\nMIT — 欢迎 fork、改造，用这个工厂造你自己的工厂。\n\nFile v2.4.0:skill-card.md\n\n## Description:\n\nSkill Factory helps OpenClaw agents turn ideas or source material into structured, versioned, publishable skills and upgrade existing skills through a repeatable workflow.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[zhelunsun](https://clawhub.ai/user/zhelunsun)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and skill authors use Skill Factory to capture requirements, collect source material, draft skill files, manage versions, and prepare releases for GitHub or ClawHub. It is intended for creating new OpenClaw skills and maintaining existing ones through structured upgrade plans.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can guide an agent to create and modify skill repositories, which can introduce incorrect instructions or unwanted file changes.\n\nMitigation: Require an explicit plan, review exact target paths and proposed files, and inspect diffs before applying or publishing changes.\n\nRisk: Publishing and upgrade workflows can expose unintended content if repository remotes, visibility, changelog text, or generated files are not reviewed.\n\nMitigation: Verify Git remotes and visibility, scan for secrets, confirm the publish command and changelog, and pin the ClawHub CLI version before release.\n\nRisk: Recurring sync automation can alter the active workspace without enough final review.\n\nMitigation: Avoid enabling recurring sync automation unless the workspace is fully controlled and approvals are required for release-impacting changes.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/zhelunsun/skills/skillfactory)\n- [README](README.md)\n- [Skill SOP](SKILL-SOP.md)\n- [Changelog](CHANGELOG.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with inline code blocks and generated repository files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May create or update skill files, changelog entries, release plans, and publish or sync commands when the user approves those workflows.]\n\n## Skill Version(s):\n\n2.4.0 (source: frontmatter, CHANGELOG, server release metadata)\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\nFile v2.4.0:SKILL-SOP.md\n\n# Skill 快速创建 SOP\r\n\r\n> 这是 Claw 和用户协作制造 skill 的标准操作程序。\r\n> 每次创建新 skill 时，直接按阶段执行。\r\n>\r\n> **版本**：v1.0  \r\n> **维护人**：Claw（AI）  \r\n> **最后更新**：2026-04-18\r\n\r\n---\r\n\r\n## 工作目录结构\r\n\r\n```\r\nD:/WorkBuddy/\r\n├── skill-factory/           # ← 你现在在这里\r\n│   ├── SKILL-SOP.md         # 本文件：标准操作程序\r\n│   ├── inbox/               # 用户丢想法的地方（任何形式：URL/关键词/草稿）\r\n│   └── wip/                 # Work-in-progress：每个 skill 一个子目录\r\n│       └── <skill-name>/\r\n│           ├── BRIEF.md     # 需求简报（Phase 0 产出）\r\n│           ├── raw/         # 收集的原始资料（web_fetch 抓取结果、PDF等）\r\n│           └── draft/       # 蒸馏草稿\r\n│\r\n├── harness/                 # 已完成的 skill repo（独立发行）\r\n├── <skill-name>/            # 其他已完成的 skill repo\r\n│   ├── SKILL.md\r\n│   ├── README.md\r\n│   └── references/\r\n│\r\n└── .workspace-index.md      # 所有 skill 状态总览（Claw 自我管理用）\r\n```\r\n\r\n---\r\n\r\n## 四阶段工作流\r\n\r\n### Phase 0：快速摄入（≤5分钟）\r\n\r\n**触发方式**：用户随时丢来想法，格式不限：\r\n- 一句话：`做一个 X 的 skill`\r\n- URL：`https://...`\r\n- 关键词：`X + Y + Z`\r\n\r\n**Claw 的工作**：\r\n1. 在 `inbox/` 记录原始想法（防止丢失）\r\n2. **立刻**提出 3 个快速确认问题（不超过 3 个）：\r\n   - 目标用户/场景是什么？\r\n   - 有没有参考资料来源？（如果没有，Claw 自行搜索）\r\n   - 发行形式：仅本地用 / 发布 GitHub / 分享给他人？\r\n3. 生成 `wip/<skill-name>/BRIEF.md`（标准格式，见下）\r\n\r\n**BRIEF.md 模板**：\r\n```markdown\r\n# BRIEF: <skill-name>\r\n\r\n**状态**: Phase 0 - 需求确认\r\n**创建时间**: YYYY-MM-DD\r\n\r\n## 用户原始想法\r\n（原话或摘要）\r\n\r\n## 确认结果\r\n- 目标场景：\r\n- 参考来源：\r\n- 发行形式：local / github / distribute\r\n- 特殊要求：\r\n\r\n## 初步规划\r\n- 知识核心：\r\n- 预计文件结构：\r\n- 参考优先级：\r\n```\r\n\r\n---\r\n\r\n### Phase 1：资料收集（自动执行）\r\n\r\n**Claw 的工作**：\r\n1. 对每个来源执行 `web_fetch`，结果存入 `wip/<skill-name>/raw/`\r\n2. 如无来源，使用 `web_search` 找 2-3 个高质量来源\r\n3. 记录来源 URL、获取时间、可信度评估\r\n\r\n**原则**：\r\n- 宁可多收不漏，Phase 2 再筛\r\n- 必须包含至少 1 个一手来源（官方文档/原文博客）\r\n- 原始内容不做处理，直接保存\r\n\r\n---\r\n\r\n### Phase 2：蒸馏（核心工作）\r\n\r\n**Claw 的工作**：\r\n1. 读取 `raw/` 中所有资料\r\n2. 按 skill-creator 规范提取：\r\n   - **SKILL.md**：触发词 + 核心流程（≤200行）\r\n   - **references/**：详细知识（按主题拆分）\r\n   - **scripts/**（如需）：可复用脚本\r\n3. **原文二次核对**（LRN-001 教训）：蒸馏完成后，再 `web_fetch` 原文对比，检查遗漏\r\n\r\n**质量检查清单**：\r\n- [ ] 触发词够宽，覆盖所有可能的用户问法\r\n- [ ] SKILL.md 有清晰的\"何时用\"说明\r\n- [ ] references/ 包含足够的背景知识\r\n- [ ] 不在 SKILL.md 里塞太多细节（≤200行）\r\n- [ ] 至少做了一次原文二次核对\r\n\r\n---\r\n\r\n### Phase 3：封装发行\r\n\r\n**Claw 的工作**：\r\n1. 在 `D:/WorkBuddy/<skill-name>/` 创建独立 repo\r\n2. 最小化文件结构：\r\n   ```\r\n   <skill-name>/\r\n   ├── SKILL.md\r\n   ├── README.md       # 包含卖点、用法、安装方式\r\n   ├── .gitignore\r\n   └── references/\r\n   ```\r\n3. `git init` + 初始 commit\r\n4. 同步到 `~/.workbuddy/skills/<skill-name>/`（本地立即可用）\r\n5. 更新 `.workspace-index.md` 状态\r\n\r\n**发行版本规范**：\r\n- `v1.0.0`：初始可用版本\r\n- `v1.x.0`：新增来源或内容补充\r\n- `v2.0.0`：结构重构或方向调整\r\n\r\n---\r\n\r\n## 用户传达想法的最快方式\r\n\r\n直接说：\r\n> `新 skill：[名字或主题]，[1-2句说明]，[来源URL（可选）]`\r\n\r\n示例：\r\n- `新 skill：arxiv-reader，帮我快速读论文，https://arxiv.org/...`\r\n- `新 skill：prompt-engineering，整合 Anthropic 和 OpenAI 的提示词最佳实践`\r\n- `新 skill：git-workflow，规范我的 git commit 和 PR 流程`\r\n\r\nClaw 接到后，进入 Phase 0，直接开始，不需要更多信息就能启动。\r\n\r\n---\r\n\r\n## 当前 Skill 状态总览\r\n\r\n详见 `.workspace-index.md`\r\n\r\n---\r\n\r\n## 已沉淀的经验（来自 .learnings）\r\n\r\n| ID | 教训 | 应对方式 |\r\n|----|------|---------|\r\n| LRN-001 | 蒸馏后未原文核对，遗漏关键内容 | Phase 2 强制二次核对步骤 |\r\n| LRN-002 | skill 应在独立 repo 迭代，成熟再同步 | Phase 3 标准流程 |\r\n| LRN-003 | 过度工程化，偏离用户真实需求 | Phase 0 3问确认，先问再建 |\r\n| LRN-004 | research 资料与 skill 文档混在一起 | raw/ 和 references/ 分离 |\n\nFile v2.4.0:LICENSE\n\nMIT License\r\n\r\nCopyright (c) 2026 PandaBro666\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction, including without limitation the rights\r\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\ncopies of the Software, and to permit persons to whom the Software is\r\nfurnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all\r\ncopies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\nSOFTWARE.\n\nArchive v2.3.0: 8 files, 19689 bytes\n\nFiles: CHANGELOG.md (6189b), CLAWHUB.md (1957b), LICENSE (1089b), README_zh.md (5270b), README.md (5560b), SKILL-SOP.md (5041b), SKILL.md (14049b), _meta.json (131b)\n\nFile v2.3.0:SKILL.md\n\n---\r\nname: skill-factory\r\nversion: \"2.3.0\"\r\ndescription: >\r\n  Turn any idea into a polished, versioned, publishable OpenClaw skill — no\r\n  scaffolding, no guesswork. Just say \"新 skill\" or \"build a skill\" and Skill\r\n  Factory handles the rest: captures the spec, collects sources, distills\r\n  knowledge, and packages it into a GitHub-ready repo. Also supports upgrading\r\n  existing skills with \"升级 skill\" or \"upgrade skill\". Built for makers who\r\n  want quality without reinventing the process. Triggers: \"新 skill\", \"做一个skill\",\r\n  \"build a skill\", \"create skill\", \"skill制作\", \"把这个做成skill\", \"帮我把...打包成skill\",\r\n  \"skill升级\", \"skill发行\", \"skill factory\", \"制造skill\", \"skill工厂\", \"skill from scratch\",\r\n  \"我有个skill想法\", \"skill迭代\", \"skill打磨\", \"做一个关于...的skill\",\r\n  \"skill版本管理\", \"skill如何发行\", \"skill如何升级\", \"skill生产\", \"skill自动化\",\r\n  \"更新skill\", \"升级skill\", \"维护skill\", \"升级已有skill\", \"upgrade skill\",\r\n  \"update skill\", \"维护现有skill\", \"skill版本升级\", \"skill生命周期\".\r\n---\r\n\r\n# Skill Factory — The Meta-Skill for Making Skills\r\n\r\n> \"The first industrial revolution was marked by using machines to make machines.\r\n> Skill Factory is the machine that makes skills.\"\r\n\r\n## Purpose\r\n\r\nSkill Factory provides a **repeatable, human-AI collaborative SOP** for going from a raw idea to a polished, publishable OpenClaw skill. It handles:\r\n\r\n- **0→1**: Rapid capture of fuzzy ideas → structured BRIEF → distilled skill\r\n- **1→N**: Iterating an existing skill with new sources or structural improvements\r\n- **N→∞**: Publishing, versioning, ClawHub distribution, and ongoing maintenance\r\n\r\nThe key insight: **this is not about capability, it's about workflow.** Any Claw instance with this skill loaded can build production-quality skills — the process is the product.\r\n\r\n---\r\n\r\n## How to Trigger This Skill\r\n\r\nJust say something like:\r\n\r\n> `New skill: [name], [1-2 sentences], [source URL (optional)]`\r\n> `Upgrade skill: [skill name/path], [change request], [new source URL (optional)]`\r\n\r\n### New skill examples:\r\n- `New skill: prompt-engineering, best practices from Anthropic and OpenAI`\r\n- `New skill: git-workflow, standardize my branching and PR flow, https://...`\r\n- `新 skill：简历筛选，用关键词匹配和语义分析筛选简历`\r\n\r\n### Upgrade skill examples:\r\n- `Upgrade skill: nova-reader, add Semantic Scholar data source`\r\n- `Upgrade skill: harness, strengthen governance rules from Phase 3.5 lessons`\r\n- `升级 skill：skill-factory，增加显式升级模式`\r\n\r\nClaw will enter **Phase 0** for new skills or the **Upgrade Workflow** for existing skills — no more information needed to start.\r\n\r\n**中文用户**: `新 skill：[名字]，[1-2句说明]，[来源URL（可选）]` for new; `升级 skill：[skill名字/路径]，[变更要求]，[新来源URL（可选）]` for upgrades.\r\n\r\n---\r\n\r\n## Four-Phase SOP\r\n\r\n### Phase 0 · Capture（≤5 min）\r\n\r\n**Goal**: Lock down the spec before any work begins.\r\n\r\n1. Save raw idea to `inbox/<skill-name>.md` (防止遗失)\r\n2. Ask exactly **3 questions** — no more:\r\n   - What is the target scenario / user?\r\n   - Are there reference sources? (If not, Claw will search)\r\n   - Publish scope: local-only / GitHub / ClawHub distribution?\r\n3. Generate `wip/<skill-name>/BRIEF.md`\r\n\r\n**Key principle**: Phase 0 prevents over-engineering (LRN-003). Don't start building until the 3 questions are answered.\r\n\r\n---\r\n\r\n### Phase 1 · Collect（automated）\r\n\r\n**Goal**: Gather raw material without processing.\r\n\r\n1. `web_fetch` each source → save to `wip/<skill-name>/raw/`\r\n2. If no sources provided, `web_search` for 2–3 high-quality references\r\n3. Prioritize: official docs > primary blog posts > secondary analysis\r\n\r\n**Rule**: At least 1 first-party source (official docs / original author's post). Raw content is saved as-is — no processing yet.\r\n\r\n---\r\n\r\n### Phase 2 · Distill（core work）\r\n\r\n**Goal**: Extract signal, discard noise.\r\n\r\n1. Read all `raw/` files\r\n2. Write per skill-creator spec:\r\n   - `SKILL.md` — triggers + workflow (≤200 lines)\r\n   - `references/` — detailed knowledge, split by topic\r\n   - `scripts/` — reusable code, only if needed\r\n3. **Mandatory verification** (LRN-001): Re-fetch original source, diff against draft, check for gaps\r\n\r\n**Quality checklist**:\r\n- [ ] Trigger words are broad enough to cover all user phrasings\r\n- [ ] SKILL.md has a clear \"when to use\" section\r\n- [ ] Detail lives in `references/`, not bloating `SKILL.md`\r\n- [ ] At least one mandatory re-read of primary source after distillation\r\n\r\n---\r\n\r\n### Phase 3 · Publish\r\n\r\n**Goal**: Clean, versioned, standalone repo ready for GitHub/ClawHub.\r\n\r\n#### Repo Structure (Minimal)\r\n\r\n```\r\n<skill-name>/\r\n├── SKILL.md          # Entry point (triggers + workflow)\r\n├── README.md         # Human-facing intro — bilingual (EN + ZH)\r\n├── CHANGELOG.md      # Version history\r\n├── LICENSE           # MIT recommended\r\n├── .gitignore\r\n└── references/       # Knowledge base\r\n    └── *.md\r\n```\r\n\r\nFor script-heavy skills, add:\r\n```\r\n└── scripts/\r\n    └── *.py\r\n```\r\n\r\n#### README Spec\r\n\r\nA skill README must answer 3 questions in ≤60 seconds of reading:\r\n1. **What problem does it solve?** (1-2 sentences, no jargon)\r\n2. **What makes it better than asking without it?** (key differentiator)\r\n3. **How do I use it?** (one concrete example)\r\n\r\n**Bilingual (EN + ZH)**: Use two separate files for maximum clarity.\r\n\r\n```\r\nREADME.md       # English only — no Chinese text anywhere\r\nREADME_zh.md    # Chinese only — full detail, selling points, usage\r\n```\r\n\r\nEach file includes a badge linking to the other version. This allows GitHub to render clean language-specific views and enables future ClawHub to surface the right version per locale.\r\n\r\n#### ClawHub Distribution\r\n\r\nWhen the user wants to publish to ClawHub:\r\n1. Ensure `SKILL.md` frontmatter has: `name`, `version`, `description`\r\n2. `description` must contain broad trigger phrases covering multiple phrasings\r\n3. `LICENSE` file present (MIT recommended)\r\n4. Tag the release: `git tag v1.0.0 && git push --tags`\r\n\r\n#### Sync to Local Workspace\r\n\r\nAfter publishing, sync to `~/.workbuddy/skills/<skill-name>/` so Claw can use it immediately:\r\n\r\n```powershell\r\nCopy-Item -Recurse -Force \"D:\\Agent\\WorkBuddy\\skills\\<skill-name>\\*\" \"$env:USERPROFILE\\.workbuddy\\skills\\<skill-name>\\\"\r\n```\r\n\r\n---\r\n\r\n## Upgrade Workflow (1→N Maintenance)\r\n\r\n**Goal**: Update an existing skill without starting from scratch.\r\n\r\nThis is a **first-class workflow**, distinct from creating a new skill. When the user invokes `Upgrade skill:`, follow these steps:\r\n\r\n### Step 1 · Inspect (read existing state)\r\n\r\n1. Read the existing skill repo:\r\n   - `SKILL.md` — current version, triggers, workflow\r\n   - `CHANGELOG.md` — version history (especially recent entries)\r\n   - `README.md` — public description\r\n   - `references/` — existing knowledge base\r\n   - Git log — recent changes and commit history\r\n2. Identify the current version (from `SKILL.md` frontmatter or git tag)\r\n\r\n### Step 2 · Classify the change\r\n\r\nCompare the requested change against the skill's **public API** — its documented behavior:\r\n\r\n| Public API element | Examples |\r\n|-------------------|----------|\r\n| Use cases | What scenarios the skill serves |\r\n| Input format | What the user says to trigger the skill |\r\n| Output format | What files/code the skill produces |\r\n| Workflow phases | The SOP structure |\r\n| Safety boundaries | What the agent must not do |\r\n| File structure | Repo layout conventions |\r\n| Publishing behavior | How the skill is distributed |\r\n\r\nDetermine the version bump:\r\n\r\n| Bump | When | Examples |\r\n|------|------|----------|\r\n| **PATCH** `x.x.1` | Fixes that don't change behavior | Typo fix, clarification, trigger word tweak |\r\n| **MINOR** `x.1.0` | Backward-compatible additions | New workflow mode, new reference source, optional publishing path |\r\n| **MAJOR** `x.0.0` | Breaking changes | Changed triggering format, restructured SOP, removed phase, changed safety assumptions |\r\n\r\n### Step 3 · Propose (generate upgrade plan)\r\n\r\nBefore making any changes, produce an upgrade plan:\r\n\r\n```markdown\r\n## Upgrade Plan\r\n\r\nCurrent version: <version from SKILL.md>\r\nProposed version: <computed bump>\r\nChange type: PATCH / MINOR / MAJOR\r\n\r\nReason:\r\n<why this change belongs in this category>\r\n\r\nFiles to modify:\r\n<list of files that need changes>\r\n\r\nRisk level: low / medium / high\r\nBackward compatibility: yes / no\r\n\r\nProposed changelog entry:\r\n### Added\r\n- <new features>\r\n\r\n### Changed\r\n- <behavior changes>\r\n\r\n### Fixed\r\n- <bug fixes>\r\n\r\nSuggested commit message:\r\n<semantic commit message>\r\n\r\nSuggested tag:\r\nv<new version>\r\n```\r\n\r\nPresent this plan to the user. Do not apply changes until the user confirms.\r\n\r\n### Step 4 · Apply\r\n\r\nAfter user confirmation:\r\n\r\n1. Update files (SKILL.md, README, CHANGELOG, references)\r\n2. Bump version in SKILL.md frontmatter and README badges\r\n3. Update `CHANGELOG.md` with proper format (see below)\r\n4. Commit with semantic message\r\n5. Tag the release: `git tag v<new-version> && git push --tags`\r\n6. Re-sync to local workspace\r\n\r\n### Step 5 · Upgrade Summary\r\n\r\nAfter applying, produce a summary:\r\n\r\n```\r\n## Upgrade Complete\r\n\r\n<old version> → <new version>\r\nFiles changed: <list>\r\nChangelog: <link or excerpt>\r\nNext steps: <optional>\r\n```\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nVersion semantics follow **Semantic Versioning** adapted for skills:\r\n\r\n```\r\nMAJOR.MINOR.PATCH\r\n```\r\n\r\n| Version bump | When | Example trigger |\r\n|---|---|---|\r\n| **PATCH** `x.x.1` | Typo fix, trigger word tweak, minor clarification | \"修复了一个例子描述不准\" |\r\n| **MINOR** `x.1.0` | New reference source, new phase step, extended trigger coverage | \"加入 Anthropic 最新文档\" |\r\n| **MAJOR** `2.0.0` | Scope change, structural refactor, paradigm shift | \"从单文档改为多 reference 结构\" |\r\n\r\n### What warrants a MAJOR bump?\r\n\r\nA MAJOR version (e.g. 1.x → 2.0) signals a **breaking change in the skill's mental model**:\r\n- The core SOP phases are restructured\r\n- The skill's scope is fundamentally redefined\r\n- Files are reorganized in ways that break the previous structure\r\n- The activation paradigm changes (e.g. from \"ask anything\" to \"four-phase SOP\")\r\n\r\n**MAJOR ≠ more content**. A skill that doubles its references but keeps the same structure is still a MINOR bump.\r\n\r\n### What warrants a MINOR bump?\r\n\r\nA MINOR version (e.g. 1.0 → 1.1 → 1.2) signals **additive improvements** that don't break the existing pattern:\r\n- New knowledge source added to `references/`\r\n- New trigger words added to frontmatter\r\n- New section added to SOP without restructuring existing phases\r\n- README improvements, badge updates\r\n\r\n### Commit message convention\r\n\r\n```\r\nfeat: add [source] to references        → MINOR\r\nfix: correct [description]              → PATCH\r\nrefactor: restructure [component]       → could be MAJOR\r\nrelease: v2.0.0 - [summary]            → tag release commits\r\n```\r\n\r\n### Changelog discipline\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\nEvery release must update `CHANGELOG.md` with:\r\n- `[Unreleased]` section at the top (collects next-version changes)\r\n- Version section for each release: `[X.Y.Z] — YYYY-MM-DD`\r\n- Grouped changes under: **Added**, **Changed**, **Fixed**, **Deprecated**, **Removed**, **Security**\r\n- User-readable summaries, not raw git diffs\r\n- A single-line **Summary** at the top of each version\r\n\r\nThe `[Unreleased]` section captures changes that will go into the next release. Before cutting a new version, review `[Unreleased]`, classify entries, and move them into the version section.\r\n\r\n**Distinction**: git history = developer log; CHANGELOG = user-facing narrative. Do not substitute one for the other.\r\n\r\n---\r\n\r\n## Skill Iteration (Legacy — use Upgrade Workflow above)\r\n\r\nThe legacy iteration path is preserved for quick edits. For structured upgrades, use the **Upgrade Workflow** (produces planned changes and version bump).\r\n\r\nWhen doing a quick upgrade:\r\n\r\n1. Create a new branch or directly update `D:/Agent/WorkBuddy/skills/<skill-name>/`\r\n2. Add new source to `references/` with dated filename (`source-YYYYMMDD.md`)\r\n3. Update `SKILL.md` version field and trigger words if needed\r\n4. Update `CHANGELOG.md`\r\n5. Bump version (MAJOR / MINOR / PATCH per rules above)\r\n6. Commit with semantic message\r\n7. Re-sync to local workspace\r\n\r\n**Upgrade triggers**: User sends new URL, user says \"skill has a gap\", Claw detects missing knowledge during a task execution.\r\n\r\n---\r\n\r\n## Workspace Layout\r\n\r\n```\r\nD:/WorkBuddy/\r\n└── .workspace-index.md      # Master skill status board\r\n\r\nD:/Agent/WorkBuddy/skills/\r\n├── skill-factory/           # This meta-skill repo\r\n│   ├── SKILL.md             # This file\r\n│   ├── README.md\r\n│   ├── CHANGELOG.md\r\n│   ├── LICENSE\r\n│   ├── .gitignore\r\n│   ├── CLAWHUB.md\r\n│   ├── inbox/               # Raw ideas drop zone\r\n│   └── wip/                 # Active work-in-progress\r\n│       └── <skill-name>/\r\n│           ├── BRIEF.md\r\n│           ├── raw/\r\n│           └── draft/\r\n│\r\n├── harness/                 # ✅ v1.2.0 — ready for GitHub\r\n├── nova-reader/             # ✅ v1.1.0 — ready for GitHub\r\n└── <future-skills>/\r\n```\r\n\r\n---\r\n\r\n## Lessons Learned (from .learnings)\r\n\r\n| ID | Lesson | Fix in SOP |\r\n|----|--------|-----------|\r\n| LRN-001 | Missed content after distillation without re-reading source | Phase 2 mandatory re-fetch |\r\n| LRN-002 | Skill evolved in workspace, hard to publish as standalone | Phase 3 independent repo |\r\n| LRN-003 | Over-engineered before confirming real need | Phase 0 three-question lock |\r\n| LRN-004 | Research notes mixed with skill docs | `raw/` vs `references/` separation |\n\nFile v2.3.0:README.md\n\n# Skill Factory\r\n\r\n> **\"The first industrial revolution ended when machines began building machines.\"**\r\n> **Skill Factory is the machine that builds skills.**\r\n\r\nA **meta-skill** for OpenClaw that automates the full lifecycle of skill creation — from a fuzzy idea to a polished, versioned, distributable package.\r\n\r\n[![Version](https://img.shields.io/badge/version-2.3.0-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![中文说明](https://img.shields.io/badge/README-中文版-orange.svg)](README_zh.md)\r\n\r\n---\r\n\r\n## What Problem Does It Solve?\r\n\r\nCreating an OpenClaw skill without a workflow leads to: fuzzy specs, missed knowledge during distillation, scattered files impossible to publish, and skills that stagnate at v1.0 with no clear upgrade path.\r\n\r\n**Skill Factory solves all of this** by treating skill creation as a repeatable, improvable process — not a one-off creative act.\r\n\r\n## What Makes It Different?\r\n\r\nMost skill-making is ad hoc. Skill Factory is an **end-to-end automated SOP** that any Claw instance can follow:\r\n\r\n**Foundation** — lock scope before work begins:\r\n- **Phase 0 three-question lock** — prevents scope creep and over-engineering\r\n\r\n**Quality** — ensure nothing is missed:\r\n- **Mandatory source re-verification** — catches missed content after distillation\r\n\r\n**Structure** — ship-ready from day one:\r\n- **Independent repo per skill** — every skill is GitHub/ClawHub-ready from day one\r\n- **Semantic versioning for skills** — clear rules for MAJOR vs MINOR vs PATCH\r\n\r\n**Evolution** — not just 0→1, but 1→N:\r\n- **Human-AI collaborative iteration** — ongoing improvement with versioned upgrades\r\n\r\nIt is not about what Claw *can* do — it is about turning an unbounded capability into a **reliable, high-quality pipeline**. The process is the product.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust send Claw an idea:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nClaw enters **Phase 0** immediately — no setup required.\r\n\r\n---\r\n\r\n## Example: Building the `harness` Skill\r\n\r\nHere is how Skill Factory handled a real request end-to-end:\r\n\r\n**Input** (30 seconds):\r\n```\r\nNew skill: harness, distill OpenAI's agent engineering article,\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — Three questions answered in one message:\r\n- Target: any Claw working on agent-first engineering\r\n- Source: OpenAI Harness Engineering blog post\r\n- Scope: GitHub + local workspace\r\n\r\n**Phase 1** — `web_fetch` the source, saved to `wip/harness/raw/`\r\n\r\n**Phase 2** — Distilled into `SKILL.md` (10 principles) + `references/` (two documents). Mandatory re-read caught 4 missed concepts including the \"Ralph Wiggum loop\".\r\n\r\n**Phase 3** — Independent repo, MIT license, bilingual README, git-tagged `v1.2.0`, synced to workspace.\r\n\r\n**Total time**: ~10 minutes. Without the factory, the same work took a full day of iteration and still had gaps.\r\n\r\n---\r\n\r\n## Four-Phase SOP Overview\r\n\r\n| Phase | Name | Output |\r\n|-------|------|--------|\r\n| 0 | Capture | `BRIEF.md` — locked spec |\r\n| 1 | Collect | `raw/` — raw source material |\r\n| 2 | Distill | `SKILL.md` + `references/` |\r\n| 3 | Publish | versioned repo, synced to workspace |\r\n\r\nFull SOP details are in [SKILL.md](SKILL.md).\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nSkills use **Semantic Versioning** adapted for this format:\r\n\r\n| Bump | When |\r\n|------|------|\r\n| `PATCH` (x.x.1) | Typo fix, trigger word tweak |\r\n| `MINOR` (x.1.0) | New source, new section, extended triggers |\r\n| `MAJOR` (2.0.0) | Paradigm shift, structural refactor |\r\n\r\n**MAJOR does not mean more content** — a skill that doubles its references but keeps the same structure is still MINOR.\r\n\r\n---\r\n\r\n## Maintaining Existing Skills (1→N)\r\n\r\nSkill Factory is not only a 0→1 generator. It also supports **structured upgrades** to existing skills:\r\n\r\n```\r\nUpgrade skill: [skill name/path], [change request], [new source URL (optional)]\r\n```\r\n\r\nThe upgrade workflow:\r\n1. **Inspect** — reads the existing repo state\r\n2. **Classify** — determines a PATCH/MINOR/MAJOR bump\r\n3. **Propose** — generates an upgrade plan before making changes\r\n4. **Apply** — updates files, CHANGELOG, version\r\n5. **Summary** — reports what changed\r\n\r\nThis ensures v2, v3, and v4 are as disciplined as v1. Git versioning, semantic versioning, CHANGELOG discipline, and the upgrade plan work together to prevent skill degradation over time.\r\n\r\n---\r\n\r\n## Repo Structure\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # Full SOP — four phases, version management, publishing spec\r\n├── README.md        # This file (English)\r\n├── README_zh.md     # Chinese version\r\n├── CHANGELOG.md     # Version history\r\n├── LICENSE          # MIT\r\n├── inbox/           # Drop zone for raw ideas\r\n└── wip/             # Active work-in-progress\r\n    └── <skill>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### From ClawHub (Recommended)\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\nOr use the full identifier:\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### Manual Installation\r\n\r\n1. Clone this repo to your skills directory:\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.workbuddy/skills/skillfactory\r\n```\r\n\r\n2. Restart your Claw session — the skill will auto-load.\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — fork it, adapt it, build your own factory.\n\nFile v2.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn75mmeqmz6rt3hwpt8qy83cj1858fnw\",\n  \"slug\": \"skillfactory\",\n  \"version\": \"2.3.0\",\n  \"publishedAt\": 1778579924913\n}\n\nFile v2.3.0:CHANGELOG.md\n\n# Changelog — skill-factory\r\n\r\nAll notable changes to skill-factory will be documented in this file.\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\n---\r\n\r\n## [Unreleased]\r\n\r\n### Fixed\r\n- CLAWHUB.md version updated from v2.1.0 to v2.3.0 (was out of sync)\r\n- SKILL.md Workspace Layout: corrected `D:/WorkBuddy/` → `D:/Agent/WorkBuddy/skills/` for skill repo paths\r\n- SKILL.md Legacy section: `D:/WorkBuddy/<skill-name>/` → `D:/Agent/WorkBuddy/skills/<skill-name>/`\r\n- README_zh.md: OpenAI URL changed from Chinese-localized to canonical English URL\r\n- README.md / README_zh.md: manual install path from `~/.claw/skills/` → `~/.workbuddy/skills/`\r\n- .workspace-index.md: directory structure comment updated from v2.2.0 to v2.3.0\r\n\r\n---\r\n\r\n## [2.3.0] — 2026-05-12\r\n\r\n### Summary\r\n\r\n**First-class upgrade workflow for existing skills.** Skill Factory now explicitly supports 1→N maintenance alongside 0→1 creation.\r\n\r\n### Added\r\n- `Upgrade skill:` as a first-class entry point alongside `New skill:`\r\n- Upgrade Workflow section in SKILL.md: Inspect → Classify → Propose → Apply → Summary\r\n- Version bump decision framework: skill's \"public API\" defined (use cases, input/output, workflow phases, safety boundaries, file structure)\r\n- Upgrade plan template: current version, proposed version, change type, files to modify, risk level, changelog entry, commit message, tag\r\n- Enhanced trigger words covering upgrade and maintenance scenarios\r\n\r\n### Changed\r\n- SKILL.md: `[Unreleased]` section added to CHANGELOG guidance per Keep a Changelog standard\r\n- CHANGELOG discipline: now requires grouped changes (Added / Changed / Fixed / Deprecated / Removed / Security) and user-readable summaries\r\n- README.md: added \"Maintaining Existing Skills (1→N)\" section\r\n- README_zh.md: updated quick start with skill upgrade example\r\n- Legacy \"Skill Iteration\" section renamed to \"Skill Iteration (Legacy)\" with redirect to Upgrade Workflow\r\n\r\n### Fixed\r\n- Workspace layout path in SKILL.md now consistent with actual directory structure\r\n\r\n---\r\n\r\n## [2.2.2] — 2026-04-27\r\n\r\n### Summary\r\n\r\n**Version sync: local repo aligned with ClawHub v2.2.2 release.**\r\n\r\n### Changed\r\n- `SKILL.md`: version field updated to `2.2.2`\r\n- `README.md` / `README_zh.md`: version badges updated to `2.2.2`\r\n\r\n### Notes\r\n- ClawHub listing had advanced to v2.2.2; this commit brings the GitHub repo in sync\r\n- Submitted false-positive appeal to openclaw/clawhub for suspicious flag on this skill\r\n\r\n---\r\n\r\n## [2.2.1] — 2026-04-21\r\n\r\n### Summary\r\n\r\n**ClawHub distribution ready + clean publish structure.**\r\n\r\n### Added\r\n- `README.md`: ClawHub installation instructions (`claw skill install skillfactory`)\r\n- `README_zh.md`: 中文安装说明\r\n- `README.md` & `README_zh.md`: Tags section for discoverability\r\n- `CLAWHUB.md`: Dedicated ClawHub listing page with one-line pitch\r\n- `PUBLISH.md`: Release command reference for future updates\r\n\r\n### Changed\r\n- Slug finalized: `skillfactory` (GitHub: PandaBro666/skillfactory)\r\n- `.gitignore` updated: excludes `inbox/`, `wip/`, `promo/` from public repo\r\n\r\n### Notes\r\n- Minimum ClawHub requirement: `SKILL.md` only\r\n- Recommended: `SKILL.md` + `README.md` + `LICENSE` for professional presentation\r\n- Clean publish workflow: copy core files to separate directory to avoid uploading WIP content\r\n\r\n---\r\n\r\n## [2.2.0] — 2026-04-20\r\n\r\n### Summary\r\n\r\n**Bilingual README split + clean publish structure.**\r\n\r\n### Added\r\n- `README_zh.md` — dedicated Chinese README with bilingual badge linking between versions\r\n- `.gitignore` — excludes `inbox/` and `wip/` from public repo (personal work area)\r\n\r\n### Changed\r\n- `README.md` (English): completely purged of Chinese text; \"Skills Built With This Factory\" section replaced with a concrete end-to-end example using the `harness` skill\r\n- `README.md` now includes badge linking to `README_zh.md`\r\n- `README_zh.md` likewise links back to English version via badge\r\n\r\n### Fixed\r\n- SKILL.md Phase 3 bilingual spec updated: README is now two separate files, not two sections in one\r\n\r\n---\r\n\r\n## [2.1.0] — 2026-04-20\r\n\r\n### Summary\r\n\r\n**GitHub release ready.** Full bilingual README, version management SOP, and LICENSE added.\r\n\r\n### Added\r\n- `LICENSE` (MIT) — required for ClawHub distribution\r\n- Semantic versioning guide in `SKILL.md`: MAJOR / MINOR / PATCH semantics with decision criteria\r\n- Commit message convention (`feat:` / `fix:` / `refactor:` / `release:`)\r\n- Changelog discipline rules (every release must update CHANGELOG)\r\n\r\n### Changed\r\n- `README.md` rewritten as bilingual (EN + ZH), \"industrial revolution\" analogy as lead hook\r\n- `SKILL.md` v2.1: extended version management section, bilingual README spec in Phase 3\r\n- Trigger words expanded: added `skill版本管理`, `skill如何发行`, `skill生产`, `skill自动化`\r\n\r\n---\r\n\r\n## [2.0.0] — 2026-04-20\r\n\r\n### Summary\r\n\r\n**From SOP document to meta-skill.**\r\n\r\nSkill Factory is now itself a publishable WorkBuddy skill. v2.0 restructures the project so it can be distributed via GitHub/ClawHub and loaded by any Claw instance, just like any other skill.\r\n\r\n### Changed\r\n- `SKILL.md` completely rewritten as a proper skill entry point with YAML frontmatter, trigger words, and self-contained SOP\r\n- Added Phase 3 publishing specs: README format, ClawHub distribution checklist, version semantics\r\n- Added skill iteration workflow (1→N upgrades)\r\n- `README.md` rewritten as human-facing project page with selling points\r\n\r\n### Added\r\n- `CHANGELOG.md` (this file)\r\n- ClawHub distribution spec in Phase 3\r\n- Skill upgrade triggers and process\r\n- Workspace layout reference\r\n\r\n---\r\n\r\n## [1.0.0] — 2026-04-18\r\n\r\n### Summary\r\n\r\n**Initial creation.**\r\n\r\nBuilt during the harness skill development cycle as a response to 4 accumulated learnings (LRN-001 through LRN-004). Established the four-phase SOP and workspace directory structure.\r\n\r\n### Added\r\n- `SKILL-SOP.md` — four-phase workflow (Phase 0-3)\r\n- `inbox/` directory — idea drop zone\r\n- `wip/` directory — active skill workspace\r\n- `D:/WorkBuddy/.workspace-index.md` — master skill status board\r\n- 4 lessons from harness creation embedded into SOP\n\nFile v2.3.0:CLAWHUB.md\n\n# Skill Factory — ClawHub Listing\r\n\r\n**Slug:** `skillfactory`  \r\n**Display Name:** Skill Factory  \r\n**Version:** 2.3.0  \r\n**License:** MIT  \r\n**Author:** PandaBro666\r\n\r\n---\r\n\r\n## One-Line Pitch\r\n\r\nThe machine that builds skills — because making a skill from scratch shouldn't feel like reinventing the wheel every time.\r\n\r\n---\r\n\r\n## What It Does\r\n\r\nSkill Factory is your skill-making buddy. You bring an idea (or a URL), it handles the rest:\r\n\r\n- **Lock the scope** — 3 quick questions to make sure you're building the right thing\r\n- **Gather the goods** — fetches source material automatically\r\n- **Distill the signal** — turns noise into structured SKILL.md + references\r\n- **Ship it** — packages everything into a versioned, GitHub-ready repo\r\n- **Keep it fresh** — structured upgrade workflow so your skills don't rot at v1.0\r\n\r\nNo boilerplate templates. No \"what now?\" moments. Just say the word and it works.\r\n\r\n---\r\n\r\n## When to Use\r\n\r\n- You have a skill idea but don't know how to start\r\n- You want to turn scattered notes or bookmarks into a proper skill\r\n- You need to bring an existing skill up to date with new sources\r\n- You're preparing something for GitHub or ClawHub\r\n- You have a skill sitting at v1.0 and want to grow it without messing up\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust tell your Claw:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nExample:\r\n```\r\nNew skill: prompt-engineering, best practices from Anthropic and OpenAI\r\n```\r\n\r\nOr to upgrade an existing one:\r\n```\r\nUpgrade skill: [name], [what to add], [new source URL (optional)]\r\n```\r\n\r\n---\r\n\r\n## Tags\r\n\r\n`meta-skill` `skill-authoring` `openclaw` `agent-engineering` `workflow-automation` `knowledge-distillation`\r\n\r\n---\r\n\r\n## Links\r\n\r\n- **Repository:** https://github.com/zhelunSun/skill-factory\r\n- **English README:** [README.md](README.md)\r\n- **中文说明:** [README_zh.md](README_zh.md)\r\n- **Changelog:** [CHANGELOG.md](CHANGELOG.md)\n\nFile v2.3.0:README_zh.md\n\n# Skill Factory\r\n\r\n> **\"第一次工业革命结束的标志，是用机器来制造机器。**\r\n> **Skill Factory，就是那台制造skill的机器。\"**\r\n\r\n这是一个用于 OpenClaw 的**元技能（meta-skill）**，将 skill 的创作过程——从一句模糊的想法，到打磨完毕、版本清晰、可直接发行的成品——变成一套可重复执行的标准化流程。\r\n\r\n[![Version](https://img.shields.io/badge/version-2.3.0-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![English README](https://img.shields.io/badge/README-English-blue.svg)](README.md)\r\n\r\n---\r\n\r\n## 它解决什么问题？\r\n\r\n没有工作流直接上手制作 skill，常见结局：\r\n\r\n- 需求没说清楚就开始干，做到一半发现方向不对\r\n- 蒸馏完文章，发现漏了关键内容，还得回头重看\r\n- 文件散落各处，想发布到 GitHub 才发现结构一团糟\r\n- v1.0 做完了，不知道什么时候该升级、如何管理版本\r\n\r\nSkill Factory 用**四阶段 SOP** 系统性地解决以上全部问题。\r\n\r\n---\r\n\r\n## 核心差异化\r\n\r\n市面上的 skill 制作多是随兴而为。Skill Factory 的不同之处：\r\n\r\n**基础层** — 开工前锁定范围：\r\n- **Phase 0 三问锁定**：三个问题锁死需求，防止过度工程化\r\n\r\n**质量层** — 确保知识完整：\r\n- **强制原文二次核对**：蒸馏完必须回到原始来源比对，防止知识遗漏\r\n\r\n**结构层** — 发行级从第一天开始：\r\n- **每个 skill 独立 repo**：从第一天起就是发行级结构，随时可 push 到 GitHub\r\n- **语义化版本管理**：清楚区分 MAJOR（范式重构）/ MINOR（增量添加）/ PATCH（修小问题）\r\n\r\n**演进层** — 不只是 0→1，更是 1→N：\r\n- **持续迭代机制**：有明确的升级路径和人机协作改进流程\r\n\r\n关键在于：**这不是关于 Claw 能做什么，而是关于如何把无边界的能力，变成高质量、可重复的流水线。流程本身就是产品。**\r\n\r\n---\r\n\r\n## 快速上手\r\n\r\n发给 Claw 一个想法即可：\r\n\r\n```\r\n新 skill：[名字]，[1-2句描述]，[来源链接（可选）]\r\n```\r\n\r\n或升级已有 skill：\r\n\r\n```\r\nskill升级：[名字]，[要加什么]，[新来源链接（可选）]\r\n```\r\n\r\nClaw 会立刻进入 Phase 0，回答 3 个问题后，流水线自动运转。\r\n\r\n---\r\n\r\n## 实际案例：制作 `harness` skill\r\n\r\n以下是 Skill Factory 处理一次真实需求的完整过程：\r\n\r\n**用户输入**（30秒）：\r\n```\r\n新 skill：harness，蒸馏 OpenAI 的智能体工程文章，\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — 三问一轮解决：\r\n- 目标用户：任何在做智能体工程的 Claw 实例\r\n- 来源：OpenAI Harness Engineering 博客\r\n- 发行形式：GitHub + 本地 workspace 同步\r\n\r\n**Phase 1** — `web_fetch` 抓取原文，存入 `wip/harness/raw/`\r\n\r\n**Phase 2** — 蒸馏为 `SKILL.md`（10 大原则）+ `references/`（两份文档）。强制二次核对步骤发现了 4 处遗漏，包括\"Ralph Wiggum 自我审查循环\"。\r\n\r\n**Phase 3** — 独立 repo，MIT 协议，双语 README，git 打标签 `v1.2.0`，同步到 workspace。\r\n\r\n**耗时**：约 10 分钟。没有这套工厂，同样的工作之前需要一整天迭代，且仍有知识盲区。\r\n\r\n---\r\n\r\n## 四阶段 SOP 概览\r\n\r\n| 阶段 | 名称 | 产出 |\r\n|------|------|------|\r\n| 0 | 快速摄入 | `BRIEF.md`：锁定需求 |\r\n| 1 | 资料收集 | `raw/`：原始资料 |\r\n| 2 | 蒸馏 | `SKILL.md` + `references/` |\r\n| 3 | 封装发行 | 带版本标签的独立 repo |\r\n\r\n完整 SOP 见 [SKILL.md](SKILL.md)。\r\n\r\n---\r\n\r\n## 版本管理逻辑\r\n\r\n借用软件工程的语义化版本，专为 skill 定制：\r\n\r\n| 版本变动 | 何时触发 |\r\n|----------|---------|\r\n| `PATCH`（x.x.1）| 修错别字、调整触发词描述 |\r\n| `MINOR`（x.1.0）| 新增来源、补充章节、扩展触发词 |\r\n| `MAJOR`（2.0.0）| 核心结构重构、范式转变、激活方式改变 |\r\n\r\n**MAJOR 不等于内容更多**——如果翻倍了 references 但结构不变，仍然是 MINOR。\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # 完整 SOP 文档（触发词 + 四阶段 + 版本管理 + 发行规范）\r\n├── README.md        # 英文版说明\r\n├── README_zh.md     # 本文件（中文说明）\r\n├── CHANGELOG.md     # 版本历史\r\n├── LICENSE          # MIT 开源协议\r\n├── inbox/           # 想法投递区（随时丢，不会丢）\r\n└── wip/             # 进行中的 skill 工作区\r\n    └── <skill名>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## 安装方法\r\n\r\n### 通过 ClawHub 安装（推荐）\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\n或使用完整标识符：\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### 手动安装\r\n\r\n1. 克隆仓库到技能目录：\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.workbuddy/skills/skillfactory\r\n```\r\n\r\n2. 重启 Claw 会话 —— 技能将自动加载。\r\n\r\n---\r\n\r\n## 开源协议\r\n\r\nMIT — 欢迎 fork、改造，用这个工厂造你自己的工厂。\n\nFile v2.3.0:SKILL-SOP.md\n\n# Skill 快速创建 SOP\r\n\r\n> 这是 Claw 和用户协作制造 skill 的标准操作程序。\r\n> 每次创建新 skill 时，直接按阶段执行。\r\n>\r\n> **版本**：v1.0  \r\n> **维护人**：Claw（AI）  \r\n> **最后更新**：2026-04-18\r\n\r\n---\r\n\r\n## 工作目录结构\r\n\r\n```\r\nD:/WorkBuddy/\r\n├── skill-factory/           # ← 你现在在这里\r\n│   ├── SKILL-SOP.md         # 本文件：标准操作程序\r\n│   ├── inbox/               # 用户丢想法的地方（任何形式：URL/关键词/草稿）\r\n│   └── wip/                 # Work-in-progress：每个 skill 一个子目录\r\n│       └── <skill-name>/\r\n│           ├── BRIEF.md     # 需求简报（Phase 0 产出）\r\n│           ├── raw/         # 收集的原始资料（web_fetch 抓取结果、PDF等）\r\n│           └── draft/       # 蒸馏草稿\r\n│\r\n├── harness/                 # 已完成的 skill repo（独立发行）\r\n├── <skill-name>/            # 其他已完成的 skill repo\r\n│   ├── SKILL.md\r\n│   ├── README.md\r\n│   └── references/\r\n│\r\n└── .workspace-index.md      # 所有 skill 状态总览（Claw 自我管理用）\r\n```\r\n\r\n---\r\n\r\n## 四阶段工作流\r\n\r\n### Phase 0：快速摄入（≤5分钟）\r\n\r\n**触发方式**：用户随时丢来想法，格式不限：\r\n- 一句话：`做一个 X 的 skill`\r\n- URL：`https://...`\r\n- 关键词：`X + Y + Z`\r\n\r\n**Claw 的工作**：\r\n1. 在 `inbox/` 记录原始想法（防止丢失）\r\n2. **立刻**提出 3 个快速确认问题（不超过 3 个）：\r\n   - 目标用户/场景是什么？\r\n   - 有没有参考资料来源？（如果没有，Claw 自行搜索）\r\n   - 发行形式：仅本地用 / 发布 GitHub / 分享给他人？\r\n3. 生成 `wip/<skill-name>/BRIEF.md`（标准格式，见下）\r\n\r\n**BRIEF.md 模板**：\r\n```markdown\r\n# BRIEF: <skill-name>\r\n\r\n**状态**: Phase 0 - 需求确认\r\n**创建时间**: YYYY-MM-DD\r\n\r\n## 用户原始想法\r\n（原话或摘要）\r\n\r\n## 确认结果\r\n- 目标场景：\r\n- 参考来源：\r\n- 发行形式：local / github / distribute\r\n- 特殊要求：\r\n\r\n## 初步规划\r\n- 知识核心：\r\n- 预计文件结构：\r\n- 参考优先级：\r\n```\r\n\r\n---\r\n\r\n### Phase 1：资料收集（自动执行）\r\n\r\n**Claw 的工作**：\r\n1. 对每个来源执行 `web_fetch`，结果存入 `wip/<skill-name>/raw/`\r\n2. 如无来源，使用 `web_search` 找 2-3 个高质量来源\r\n3. 记录来源 URL、获取时间、可信度评估\r\n\r\n**原则**：\r\n- 宁可多收不漏，Phase 2 再筛\r\n- 必须包含至少 1 个一手来源（官方文档/原文博客）\r\n- 原始内容不做处理，直接保存\r\n\r\n---\r\n\r\n### Phase 2：蒸馏（核心工作）\r\n\r\n**Claw 的工作**：\r\n1. 读取 `raw/` 中所有资料\r\n2. 按 skill-creator 规范提取：\r\n   - **SKILL.md**：触发词 + 核心流程（≤200行）\r\n   - **references/**：详细知识（按主题拆分）\r\n   - **scripts/**（如需）：可复用脚本\r\n3. **原文二次核对**（LRN-001 教训）：蒸馏完成后，再 `web_fetch` 原文对比，检查遗漏\r\n\r\n**质量检查清单**：\r\n- [ ] 触发词够宽，覆盖所有可能的用户问法\r\n- [ ] SKILL.md 有清晰的\"何时用\"说明\r\n- [ ] references/ 包含足够的背景知识\r\n- [ ] 不在 SKILL.md 里塞太多细节（≤200行）\r\n- [ ] 至少做了一次原文二次核对\r\n\r\n---\r\n\r\n### Phase 3：封装发行\r\n\r\n**Claw 的工作**：\r\n1. 在 `D:/WorkBuddy/<skill-name>/` 创建独立 repo\r\n2. 最小化文件结构：\r\n   ```\r\n   <skill-name>/\r\n   ├── SKILL.md\r\n   ├── README.md       # 包含卖点、用法、安装方式\r\n   ├── .gitignore\r\n   └── references/\r\n   ```\r\n3. `git init` + 初始 commit\r\n4. 同步到 `~/.workbuddy/skills/<skill-name>/`（本地立即可用）\r\n5. 更新 `.workspace-index.md` 状态\r\n\r\n**发行版本规范**：\r\n- `v1.0.0`：初始可用版本\r\n- `v1.x.0`：新增来源或内容补充\r\n- `v2.0.0`：结构重构或方向调整\r\n\r\n---\r\n\r\n## 用户传达想法的最快方式\r\n\r\n直接说：\r\n> `新 skill：[名字或主题]，[1-2句说明]，[来源URL（可选）]`\r\n\r\n示例：\r\n- `新 skill：arxiv-reader，帮我快速读论文，https://arxiv.org/...`\r\n- `新 skill：prompt-engineering，整合 Anthropic 和 OpenAI 的提示词最佳实践`\r\n- `新 skill：git-workflow，规范我的 git commit 和 PR 流程`\r\n\r\nClaw 接到后，进入 Phase 0，直接开始，不需要更多信息就能启动。\r\n\r\n---\r\n\r\n## 当前 Skill 状态总览\r\n\r\n详见 `.workspace-index.md`\r\n\r\n---\r\n\r\n## 已沉淀的经验（来自 .learnings）\r\n\r\n| ID | 教训 | 应对方式 |\r\n|----|------|---------|\r\n| LRN-001 | 蒸馏后未原文核对，遗漏关键内容 | Phase 2 强制二次核对步骤 |\r\n| LRN-002 | skill 应在独立 repo 迭代，成熟再同步 | Phase 3 标准流程 |\r\n| LRN-003 | 过度工程化，偏离用户真实需求 | Phase 0 3问确认，先问再建 |\r\n| LRN-004 | research 资料与 skill 文档混在一起 | raw/ 和 references/ 分离 |\n\nFile v2.3.0:LICENSE\n\nMIT License\r\n\r\nCopyright (c) 2026 PandaBro666\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction, including without limitation the rights\r\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\ncopies of the Software, and to permit persons to whom the Software is\r\nfurnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all\r\ncopies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\nSOFTWARE.\n\nArchive v2.2.2: 5 files, 12052 bytes\n\nFiles: CHANGELOG.md (3845b), README_zh.md (5276b), README.md (4820b), SKILL.md (9330b), _meta.json (131b)\n\nFile v2.2.2:SKILL.md\n\n---\r\nname: skill-factory\r\nversion: \"2.2.1\"\r\ndescription: >\r\n  A meta-skill for creating, iterating, and publishing OpenClaw skills from scratch.\r\n  Use this skill when the user wants to: build a new skill from an idea or URL, upgrade\r\n  an existing skill with new sources, prepare a skill for GitHub publishing, or design\r\n  a skill's repo structure. Triggers include: \"新 skill\", \"做一个skill\", \"build a skill\",\r\n  \"create skill\", \"skill制作\", \"把这个做成skill\", \"帮我把...打包成skill\", \"skill升级\",\r\n  \"skill发行\", \"skill factory\", \"制造skill\", \"skill工厂\", \"skill from scratch\",\r\n  \"我有个skill想法\", \"skill迭代\", \"skill打磨\", \"做一个关于...的skill\",\r\n  \"skill版本管理\", \"skill如何发行\", \"skill如何升级\", \"skill生产\", \"skill自动化\".\r\n---\r\n\r\n# Skill Factory — The Meta-Skill for Making Skills\r\n\r\n> \"The first industrial revolution was marked by using machines to make machines.\r\n> Skill Factory is the machine that makes skills.\"\r\n\r\n## Purpose\r\n\r\nSkill Factory provides a **repeatable, human-AI collaborative SOP** for going from a raw idea to a polished, publishable OpenClaw skill. It handles:\r\n\r\n- **0→1**: Rapid capture of fuzzy ideas → structured BRIEF → distilled skill\r\n- **1→N**: Iterating an existing skill with new sources or structural improvements\r\n- **N→∞**: Publishing, versioning, ClawHub distribution, and ongoing maintenance\r\n\r\nThe key insight: **this is not about capability, it's about workflow.** Any Claw instance with this skill loaded can build production-quality skills — the process is the product.\r\n\r\n---\r\n\r\n## How to Trigger This Skill\r\n\r\nJust say something like:\r\n\r\n> `New skill: [name], [1-2 sentences], [source URL (optional)]`\r\n\r\nExamples:\r\n- `New skill: prompt-engineering, best practices from Anthropic and OpenAI`\r\n- `New skill: git-workflow, standardize my branching and PR flow, https://...`\r\n- `Skill upgrade: nova-reader, add Semantic Scholar data source`\r\n\r\nClaw will immediately enter **Phase 0** — no more information needed to start.\r\n\r\n**中文用户**: `新 skill：[名字]，[1-2句说明]，[来源URL（可选）]`\r\n\r\n---\r\n\r\n## Four-Phase SOP\r\n\r\n### Phase 0 · Capture（≤5 min）\r\n\r\n**Goal**: Lock down the spec before any work begins.\r\n\r\n1. Save raw idea to `inbox/<skill-name>.md` \r\n2. Ask exactly **3 questions** — no more:\r\n   - What is the target scenario / user?\r\n   - Are there reference sources? (If not, Claw will search)\r\n   - Publish scope: local-only / GitHub / ClawHub distribution?\r\n3. Generate `wip/<skill-name>/BRIEF.md`\r\n\r\n**Key principle**: Phase 0 prevents over-engineering (LRN-003). Don't start building until the 3 questions are answered.\r\n\r\n---\r\n\r\n### Phase 1 · Collect（automated）\r\n\r\n**Goal**: Gather raw material without processing.\r\n\r\n1. `web_fetch` each source → save to `wip/<skill-name>/raw/`\r\n2. If no sources provided, `web_search` for 2–3 high-quality references\r\n3. Prioritize: official docs > primary blog posts > secondary analysis\r\n\r\n**Rule**: At least 1 first-party source (official docs / original author's post). Raw content is saved as-is — no processing yet.\r\n\r\n---\r\n\r\n### Phase 2 · Distill（core work）\r\n\r\n**Goal**: Extract signal, discard noise.\r\n\r\n1. Read all `raw/` files\r\n2. Write per skill-creator spec:\r\n   - `SKILL.md` — triggers + workflow (≤200 lines)\r\n   - `references/` — detailed knowledge, split by topic\r\n   - `scripts/` — reusable code, only if needed\r\n3. **Mandatory verification** (LRN-001): Re-fetch original source, diff against draft, check for gaps\r\n\r\n**Quality checklist**:\r\n- [ ] Trigger words are broad enough to cover all user phrasings\r\n- [ ] SKILL.md has a clear \"when to use\" section\r\n- [ ] Detail lives in `references/`, not bloating `SKILL.md`\r\n- [ ] At least one mandatory re-read of primary source after distillation\r\n\r\n---\r\n\r\n### Phase 3 · Publish\r\n\r\n**Goal**: Clean, versioned, standalone repo ready for GitHub/ClawHub.\r\n\r\n#### Repo Structure (Minimal)\r\n\r\n```\r\n<skill-name>/\r\n├── SKILL.md          # Entry point (triggers + workflow)\r\n├── README.md         # Human-facing intro — bilingual (EN + ZH)\r\n├── CHANGELOG.md      # Version history\r\n├── LICENSE           # MIT recommended\r\n├── .gitignore\r\n└── references/       # Knowledge base\r\n    └── *.md\r\n```\r\n\r\nFor script-heavy skills, add:\r\n```\r\n└── scripts/\r\n    └── *.py\r\n```\r\n\r\n#### README Spec\r\n\r\nA skill README must answer 3 questions in ≤60 seconds of reading:\r\n1. **What problem does it solve?** (1-2 sentences, no jargon)\r\n2. **What makes it better than asking without it?** (key differentiator)\r\n3. **How do I use it?** (one concrete example)\r\n\r\n**Bilingual (EN + ZH)**: Use two separate files for maximum clarity.\r\n\r\n```\r\nREADME.md       # English only — no Chinese text anywhere\r\nREADME_zh.md    # Chinese only — full detail, selling points, usage\r\n```\r\n\r\nEach file includes a badge linking to the other version. This allows GitHub to render clean language-specific views and enables future ClawHub to surface the right version per locale.\r\n\r\n#### ClawHub Distribution\r\n\r\nWhen the user wants to publish to ClawHub:\r\n1. Ensure `SKILL.md` frontmatter has: `name`, `version`, `description`\r\n2. `description` must contain broad trigger phrases covering multiple phrasings\r\n3. `LICENSE` file present (MIT recommended)\r\n4. Tag the release: `git tag v1.0.0 && git push --tags`\r\n\r\n#### Sync to Local Workspace\r\n\r\nAfter publishing, sync to `~/.workbuddy/skills/<skill-name>/` so Claw can use it immediately:\r\n\r\n```powershell\r\nCopy-Item -Recurse -Force \"D:\\WorkBuddy\\<skill-name>\\*\" \"$env:USERPROFILE\\.workbuddy\\skills\\<skill-name>\\\"\r\n```\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nVersion semantics follow **Semantic Versioning** adapted for skills:\r\n\r\n```\r\nMAJOR.MINOR.PATCH\r\n```\r\n\r\n| Version bump | When | Example trigger |\r\n|---|---|---|\r\n| **PATCH** `x.x.1` | Typo fix, trigger word tweak, minor clarification | \"修复了一个例子描述不准\" |\r\n| **MINOR** `x.1.0` | New reference source, new phase step, extended trigger coverage | \"加入 Anthropic 最新文档\" |\r\n| **MAJOR** `2.0.0` | Scope change, structural refactor, paradigm shift | \"从单文档改为多 reference 结构\" |\r\n\r\n### What warrants a MAJOR bump?\r\n\r\nA MAJOR version (e.g. 1.x → 2.0) signals a **breaking change in the skill's mental model**:\r\n- The core SOP phases are restructured\r\n- The skill's scope is fundamentally redefined\r\n- Files are reorganized in ways that break the previous structure\r\n- The activation paradigm changes (e.g. from \"ask anything\" to \"four-phase SOP\")\r\n\r\n**MAJOR ≠ more content**. A skill that doubles its references but keeps the same structure is still a MINOR bump.\r\n\r\n### What warrants a MINOR bump?\r\n\r\nA MINOR version (e.g. 1.0 → 1.1 → 1.2) signals **additive improvements** that don't break the existing pattern:\r\n- New knowledge source added to `references/`\r\n- New trigger words added to frontmatter\r\n- New section added to SOP without restructuring existing phases\r\n- README improvements, badge updates\r\n\r\n### Commit message convention\r\n\r\n```\r\nfeat: add [source] to references        → MINOR\r\nfix: correct [description]              → PATCH\r\nrefactor: restructure [component]       → could be MAJOR\r\nrelease: v2.0.0 - [summary]            → tag release commits\r\n```\r\n\r\n### Changelog discipline\r\n\r\nEvery release must update `CHANGELOG.md` with:\r\n- Version number + date\r\n- Summary sentence (1 line)\r\n- Added / Changed / Fixed sections\r\n\r\n---\r\n\r\n## Skill Iteration (1→N)\r\n\r\nWhen upgrading an existing skill:\r\n\r\n1. Create a new branch or directly update `D:/WorkBuddy/<skill-name>/`\r\n2. Add new source to `references/` with dated filename (`source-YYYYMMDD.md`)\r\n3. Update `SKILL.md` version field and trigger words if needed\r\n4. Update `CHANGELOG.md`\r\n5. Bump version (MAJOR / MINOR / PATCH per rules above)\r\n6. Commit with semantic message\r\n7. Re-sync to local workspace\r\n\r\n**Upgrade triggers**: User sends new URL, user says \"skill has a gap\", Claw detects missing knowledge during a task execution.\r\n\r\n---\r\n\r\n## Workspace Layout\r\n\r\n```\r\nD:/WorkBuddy/\r\n├── .workspace-index.md      # Master skill status board\r\n├── skill-factory/           # This meta-skill repo\r\n│   ├── SKILL.md             # This file\r\n│   ├── README.md\r\n│   ├── CHANGELOG.md\r\n│   ├── LICENSE\r\n│   ├── .gitignore\r\n│   ├── inbox/               # Raw ideas drop zone\r\n│   └── wip/                 # Active work-in-progress\r\n│       └── <skill-name>/\r\n│           ├── BRIEF.md\r\n│           ├── raw/\r\n│           └── draft/\r\n│\r\n├── harness/                 # ✅ v1.2.0 — ready for GitHub\r\n├── nova-reader/             # ✅ v1.1.0 — ready for GitHub\r\n└── <future-skills>/\r\n```\r\n\r\n---\r\n\r\n## Lessons Learned (from .learnings)\r\n\r\n| ID | Lesson | Fix in SOP |\r\n|----|--------|-----------|\r\n| LRN-001 | Missed content after distillation without re-reading source | Phase 2 mandatory re-fetch |\r\n| LRN-002 | Skill evolved in workspace, hard to publish as standalone | Phase 3 independent repo |\r\n| LRN-003 | Over-engineered before confirming real need | Phase 0 three-question lock |\r\n| LRN-004 | Research notes mixed with skill docs | `raw/` vs `references/` separation |\n\nFile v2.2.2:README.md\n\n# Skill Factory\r\n\r\n> **\"The first industrial revolution ended when machines began building machines.\"**\r\n> **Skill Factory is the machine that builds skills.**\r\n\r\nA **meta-skill** for OpenClaw that automates the full lifecycle of skill creation — from a fuzzy idea to a polished, versioned, distributable package.\r\n\r\n[![Version](https://img.shields.io/badge/version-2.2.1-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![中文说明](https://img.shields.io/badge/README-中文版-orange.svg)](README_zh.md)\r\n\r\n---\r\n\r\n## What Problem Does It Solve?\r\n\r\nCreating an OpenClaw skill without a workflow leads to: fuzzy specs, missed knowledge during distillation, scattered files impossible to publish, and skills that stagnate at v1.0 with no clear upgrade path.\r\n\r\n**Skill Factory solves all of this** by treating skill creation as a repeatable, improvable process — not a one-off creative act.\r\n\r\n## What Makes It Different?\r\n\r\nMost skill-making is ad hoc. Skill Factory is an **end-to-end automated SOP** that any Claw instance can follow:\r\n\r\n**Foundation** — lock scope before work begins:\r\n- **Phase 0 three-question lock** — prevents scope creep and over-engineering\r\n\r\n**Quality** — ensure nothing is missed:\r\n- **Mandatory source re-verification** — catches missed content after distillation\r\n\r\n**Structure** — ship-ready from day one:\r\n- **Independent repo per skill** — every skill is GitHub/ClawHub-ready from day one\r\n- **Semantic versioning for skills** — clear rules for MAJOR vs MINOR vs PATCH\r\n\r\n**Evolution** — not just 0→1, but 1→N:\r\n- **Human-AI collaborative iteration** — ongoing improvement with versioned upgrades\r\n\r\nIt is not about what Claw *can* do — it is about turning an unbounded capability into a **reliable, high-quality pipeline**. The process is the product.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust send Claw an idea:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nClaw enters **Phase 0** immediately — no setup required.\r\n\r\n---\r\n\r\n## Example: Building the `harness` Skill\r\n\r\nHere is how Skill Factory handled a real request end-to-end:\r\n\r\n**Input** (30 seconds):\r\n```\r\nNew skill: harness, distill OpenAI's agent engineering article,\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — Three questions answered in one message:\r\n- Target: any Claw working on agent-first engineering\r\n- Source: OpenAI Harness Engineering blog post\r\n- Scope: GitHub + local workspace\r\n\r\n**Phase 1** — `web_fetch` the source, saved to `wip/harness/raw/`\r\n\r\n**Phase 2** — Distilled into `SKILL.md` (10 principles) + `references/` (two documents). Mandatory re-read caught 4 missed concepts including the \"Ralph Wiggum loop\".\r\n\r\n**Phase 3** — Independent repo, MIT license, bilingual README, git-tagged `v1.2.0`, synced to workspace.\r\n\r\n**Total time**: ~10 minutes. Without the factory, the same work took a full day of iteration and still had gaps.\r\n\r\n---\r\n\r\n## Four-Phase SOP Overview\r\n\r\n| Phase | Name | Output |\r\n|-------|------|--------|\r\n| 0 | Capture | `BRIEF.md` — locked spec |\r\n| 1 | Collect | `raw/` — raw source material |\r\n| 2 | Distill | `SKILL.md` + `references/` |\r\n| 3 | Publish | versioned repo, synced to workspace |\r\n\r\nFull SOP details are in [SKILL.md](SKILL.md).\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nSkills use **Semantic Versioning** adapted for this format:\r\n\r\n| Bump | When |\r\n|------|------|\r\n| `PATCH` (x.x.1) | Typo fix, trigger word tweak |\r\n| `MINOR` (x.1.0) | New source, new section, extended triggers |\r\n| `MAJOR` (2.0.0) | Paradigm shift, structural refactor |\r\n\r\n**MAJOR does not mean more content** — a skill that doubles its references but keeps the same structure is still MINOR.\r\n\r\n---\r\n\r\n## Repo Structure\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # Full SOP — four phases, version management, publishing spec\r\n├── README.md        # This file (English)\r\n├── README_zh.md     # Chinese version\r\n├── CHANGELOG.md     # Version history\r\n├── LICENSE          # MIT\r\n├── inbox/           # Drop zone for raw ideas\r\n└── wip/             # Active work-in-progress\r\n    └── <skill>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### From ClawHub (Recommended)\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\nOr use the full identifier:\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### Manual Installation\r\n\r\n1. Clone this repo to your skills directory:\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.claw/skills/skillfactory\r\n```\r\n\r\n2. Restart your Claw session — the skill will auto-load.\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — fork it, adapt it, build your own factory.\n\nFile v2.2.2:_meta.json\n\n{\n  \"ownerId\": \"kn75mmeqmz6rt3hwpt8qy83cj1858fnw\",\n  \"slug\": \"skillfactory\",\n  \"version\": \"2.2.2\",\n  \"publishedAt\": 1776777377359\n}\n\nFile v2.2.2:CHANGELOG.md\n\n# Changelog — skill-factory\r\n\r\nAll notable changes to skill-factory will be documented in this file.\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\n---\r\n\r\n## [2.2.1] - 2026-04-21\r\n\r\n### Summary\r\n\r\n**ClawHub distribution ready + clean publish structure.**\r\n\r\n### Added\r\n- `README.md`: ClawHub installation instructions (`claw skill install skillfactory`)\r\n- `README_zh.md`: 中文安装说明\r\n- `README.md` & `README_zh.md`: Tags section for discoverability\r\n- `CLAWHUB.md`: Dedicated ClawHub listing page with one-line pitch\r\n- `PUBLISH.md`: Release command reference for future updates\r\n\r\n### Changed\r\n- Slug finalized: `skillfactory` (GitHub: PandaBro666/skillfactory)\r\n- `.gitignore` updated: excludes `inbox/`, `wip/`, `promo/` from public repo\r\n\r\n### Notes\r\n- Minimum ClawHub requirement: `SKILL.md` only\r\n- Recommended: `SKILL.md` + `README.md` + `LICENSE` for professional presentation\r\n- Clean publish workflow: copy core files to separate directory to avoid uploading WIP content\r\n\r\n---\r\n\r\n## [2.2.0] - 2026-04-20\r\n\r\n### Summary\r\n\r\n**Bilingual README split + clean publish structure.**\r\n\r\n### Added\r\n- `README_zh.md` — dedicated Chinese README with bilingual badge linking between versions\r\n- `.gitignore` — excludes `inbox/` and `wip/` from public repo (personal work area)\r\n\r\n### Changed\r\n- `README.md` (English): completely purged of Chinese text; \"Skills Built With This Factory\" section replaced with a concrete end-to-end example using the `harness` skill\r\n- `README.md` now includes badge linking to `README_zh.md`\r\n- `README_zh.md` likewise links back to English version via badge\r\n\r\n### Fixed\r\n- SKILL.md Phase 3 bilingual spec updated: README is now two separate files, not two sections in one\r\n\r\n---\r\n\r\n## [2.1.0] - 2026-04-20\r\n\r\n### Summary\r\n\r\n**GitHub release ready.** Full bilingual README, version management SOP, and LICENSE added.\r\n\r\n### Added\r\n- `LICENSE` (MIT) — required for ClawHub distribution\r\n- Semantic versioning guide in `SKILL.md`: MAJOR / MINOR / PATCH semantics with decision criteria\r\n- Commit message convention (`feat:` / `fix:` / `refactor:` / `release:`)\r\n- Changelog discipline rules (every release must update CHANGELOG)\r\n\r\n### Changed\r\n- `README.md` rewritten as bilingual (EN + ZH), \"industrial revolution\" analogy as lead hook\r\n- `SKILL.md` v2.1: extended version management section, bilingual README spec in Phase 3\r\n- Trigger words expanded: added `skill版本管理`, `skill如何发行`, `skill生产`, `skill自动化`\r\n\r\n---\r\n\r\n## [2.0.0] - 2026-04-20\r\n\r\n### Summary\r\n\r\n**From SOP document to meta-skill.**\r\n\r\nSkill Factory is now itself a publishable WorkBuddy skill. v2.0 restructures the project so it can be distributed via GitHub/ClawHub and loaded by any Claw instance, just like any other skill.\r\n\r\n### Changed\r\n- `SKILL.md` completely rewritten as a proper skill entry point with YAML frontmatter, trigger words, and self-contained SOP\r\n- Added Phase 3 publishing specs: README format, ClawHub distribution checklist, version semantics\r\n- Added skill iteration workflow (1→N upgrades)\r\n- `README.md` rewritten as human-facing project page with selling points\r\n\r\n### Added\r\n- `CHANGELOG.md` (this file)\r\n- ClawHub distribution spec in Phase 3\r\n- Skill upgrade triggers and process\r\n- Workspace layout reference\r\n\r\n---\r\n\r\n## [1.0.0] - 2026-04-18\r\n\r\n### Summary\r\n\r\n**Initial creation.**\r\n\r\nBuilt during the harness skill development cycle as a response to 4 accumulated learnings (LRN-001 through LRN-004). Established the four-phase SOP and workspace directory structure.\r\n\r\n### Added\r\n- `SKILL-SOP.md` — four-phase workflow (Phase 0-3)\r\n- `inbox/` directory — idea drop zone\r\n- `wip/` directory — active skill workspace\r\n- `D:/WorkBuddy/.workspace-index.md` — master skill status board\r\n- 4 lessons from harness creation embedded into SOP\n\nFile v2.2.2:README_zh.md\n\n# Skill Factory\r\n\r\n> **\"第一次工业革命结束的标志，是用机器来制造机器。**\r\n> **Skill Factory，就是那台制造skill的机器。\"**\r\n\r\n这是一个用于 OpenClaw 的**元技能（meta-skill）**，将 skill 的创作过程——从一句模糊的想法，到打磨完毕、版本清晰、可直接发行的成品——变成一套可重复执行的标准化流程。\r\n\r\n[![Version](https://img.shields.io/badge/version-2.2.1-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![English README](https://img.shields.io/badge/README-English-blue.svg)](README.md)\r\n\r\n---\r\n\r\n## 它解决什么问题？\r\n\r\n没有工作流直接上手制作 skill，常见结局：\r\n\r\n- 需求没说清楚就开始干，做到一半发现方向不对\r\n- 蒸馏完文章，发现漏了关键内容，还得回头重看\r\n- 文件散落各处，想发布到 GitHub 才发现结构一团糟\r\n- v1.0 做完了，不知道什么时候该升级、如何管理版本\r\n\r\nSkill Factory 用**四阶段 SOP** 系统性地解决以上全部问题。\r\n\r\n---\r\n\r\n## 核心差异化\r\n\r\n市面上的 skill 制作多是随兴而为。Skill Factory 的不同之处：\r\n\r\n**基础层** — 开工前锁定范围：\r\n- **Phase 0 三问锁定**：三个问题锁死需求，防止过度工程化\r\n\r\n**质量层** — 确保知识完整：\r\n- **强制原文二次核对**：蒸馏完必须回到原始来源比对，防止知识遗漏\r\n\r\n**结构层** — 发行级从第一天开始：\r\n- **每个 skill 独立 repo**：从第一天起就是发行级结构，随时可 push 到 GitHub\r\n- **语义化版本管理**：清楚区分 MAJOR（范式重构）/ MINOR（增量添加）/ PATCH（修小问题）\r\n\r\n**演进层** — 不只是 0→1，更是 1→N：\r\n- **持续迭代机制**：有明确的升级路径和人机协作改进流程\r\n\r\n关键在于：**这不是关于 Claw 能做什么，而是关于如何把无边界的能力，变成高质量、可重复的流水线。流程本身就是产品。**\r\n\r\n---\r\n\r\n## 快速上手\r\n\r\n发给 Claw 一个想法即可：\r\n\r\n```\r\n新 skill：[名字]，[1-2句描述]，[来源链接（可选）]\r\n```\r\n\r\n或升级已有 skill：\r\n\r\n```\r\nskill升级：[名字]，[要加什么]，[新来源链接（可选）]\r\n```\r\n\r\nClaw 会立刻进入 Phase 0，回答 3 个问题后，流水线自动运转。\r\n\r\n---\r\n\r\n## 实际案例：制作 `harness` skill\r\n\r\n以下是 Skill Factory 处理一次真实需求的完整过程：\r\n\r\n**用户输入**（30秒）：\r\n```\r\n新 skill：harness，蒸馏 OpenAI 的智能体工程文章，\r\nhttps://openai.com/zh-Hans-CN/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — 三问一轮解决：\r\n- 目标用户：任何在做智能体工程的 Claw 实例\r\n- 来源：OpenAI Harness Engineering 博客\r\n- 发行形式：GitHub + 本地 workspace 同步\r\n\r\n**Phase 1** — `web_fetch` 抓取原文，存入 `wip/harness/raw/`\r\n\r\n**Phase 2** — 蒸馏为 `SKILL.md`（10 大原则）+ `references/`（两份文档）。强制二次核对步骤发现了 4 处遗漏，包括\"Ralph Wiggum 自我审查循环\"。\r\n\r\n**Phase 3** — 独立 repo，MIT 协议，双语 README，git 打标签 `v1.2.0`，同步到 workspace。\r\n\r\n**耗时**：约 10 分钟。没有这套工厂，同样的工作之前需要一整天迭代，且仍有知识盲区。\r\n\r\n---\r\n\r\n## 四阶段 SOP 概览\r\n\r\n| 阶段 | 名称 | 产出 |\r\n|------|------|------|\r\n| 0 | 快速摄入 | `BRIEF.md`：锁定需求 |\r\n| 1 | 资料收集 | `raw/`：原始资料 |\r\n| 2 | 蒸馏 | `SKILL.md` + `references/` |\r\n| 3 | 封装发行 | 带版本标签的独立 repo |\r\n\r\n完整 SOP 见 [SKILL.md](SKILL.md)。\r\n\r\n---\r\n\r\n## 版本管理逻辑\r\n\r\n借用软件工程的语义化版本，专为 skill 定制：\r\n\r\n| 版本变动 | 何时触发 |\r\n|----------|---------|\r\n| `PATCH`（x.x.1）| 修错别字、调整触发词描述 |\r\n| `MINOR`（x.1.0）| 新增来源、补充章节、扩展触发词 |\r\n| `MAJOR`（2.0.0）| 核心结构重构、范式转变、激活方式改变 |\r\n\r\n**MAJOR 不等于内容更多**——如果翻倍了 references 但结构不变，仍然是 MINOR。\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # 完整 SOP 文档（触发词 + 四阶段 + 版本管理 + 发行规范）\r\n├── README.md        # 英文版说明\r\n├── README_zh.md     # 本文件（中文说明）\r\n├── CHANGELOG.md     # 版本历史\r\n├── LICENSE          # MIT 开源协议\r\n├── inbox/           # 想法投递区（随时丢，不会丢）\r\n└── wip/             # 进行中的 skill 工作区\r\n    └── <skill名>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## 安装方法\r\n\r\n### 通过 ClawHub 安装（推荐）\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\n或使用完整标识符：\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### 手动安装\r\n\r\n1. 克隆仓库到技能目录：\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.claw/skills/skillfactory\r\n```\r\n\r\n2. 重启 Claw 会话 —— 技能将自动加载。\r\n\r\n---\r\n\r\n## 开源协议\r\n\r\nMIT — 欢迎 fork、改造，用这个工厂造你自己的工厂。\n\nArchive v2.2.1: 5 files, 12066 bytes\n\nFiles: CHANGELOG.md (3845b), README_zh.md (5276b), README.md (4820b), SKILL.md (9282b), _meta.json (131b)\n\nFile v2.2.1:SKILL.md\n\n---\r\nname: skill-factory\r\nversion: \"2.2.1\"\r\ndescription: >\r\n  A meta-skill for creating, iterating, and publishing OpenClaw skills from scratch.\r\n  Use this skill when the user wants to: build a new skill from an idea or URL, upgrade\r\n  an existing skill with new sources, prepare a skill for GitHub publishing, or design\r\n  a skill's repo structure. Triggers include: \"新 skill\", \"做一个skill\", \"build a skill\",\r\n  \"create skill\", \"skill制作\", \"把这个做成skill\", \"帮我把...打包成skill\", \"skill升级\",\r\n  \"skill发行\", \"skill factory\", \"制造skill\", \"skill工厂\", \"skill from scratch\",\r\n  \"我有个skill想法\", \"skill迭代\", \"skill打磨\", \"做一个关于...的skill\",\r\n  \"skill版本管理\", \"skill如何发行\", \"skill如何升级\", \"skill生产\", \"skill自动化\".\r\n---\r\n\r\n# Skill Factory — The Meta-Skill for Making Skills\r\n\r\n> \"The first industrial revolution was marked by using machines to make machines.\r\n> Skill Factory is the machine that makes skills.\"\r\n\r\n## Purpose\r\n\r\nSkill Factory provides a **repeatable, human-AI collaborative SOP** for going from a raw idea to a polished, publishable OpenClaw skill. It handles:\r\n\r\n- **0→1**: Rapid capture of fuzzy ideas → structured BRIEF → distilled skill\r\n- **1→N**: Iterating an existing skill with new sources or structural improvements\r\n- **N→∞**: Publishing, versioning, ClawHub distribution, and ongoing maintenance\r\n\r\nThe key insight: **this is not about capability, it's about workflow.** Any Claw instance with this skill loaded can build production-quality skills — the process is the product.\r\n\r\n---\r\n\r\n## How to Trigger This Skill\r\n\r\nJust say something like:\r\n\r\n> `新 skill：[名字或主题]，[1-2句说明]，[来源URL（可选）]`\r\n\r\nExamples:\r\n- `新 skill：prompt-engineering，整合 Anthropic 和 OpenAI 的提示词实践`\r\n- `新 skill：git-workflow，规范我的 git 分支和 PR 流程，https://...`\r\n- `skill升级：nova-reader，加入 Semantic Scholar 数据源`\r\n\r\nClaw will immediately enter **Phase 0** — no more information needed to start.\r\n\r\n---\r\n\r\n## Four-Phase SOP\r\n\r\n### Phase 0 · Capture（≤5 min）\r\n\r\n**Goal**: Lock down the spec before any work begins.\r\n\r\n1. Save raw idea to `inbox/<skill-name>.md` (防止遗失)\r\n2. Ask exactly **3 questions** — no more:\r\n   - What is the target scenario / user?\r\n   - Are there reference sources? (If not, Claw will search)\r\n   - Publish scope: local-only / GitHub / ClawHub distribution?\r\n3. Generate `wip/<skill-name>/BRIEF.md`\r\n\r\n**Key principle**: Phase 0 prevents over-engineering (LRN-003). Don't start building until the 3 questions are answered.\r\n\r\n---\r\n\r\n### Phase 1 · Collect（automated）\r\n\r\n**Goal**: Gather raw material without processing.\r\n\r\n1. `web_fetch` each source → save to `wip/<skill-name>/raw/`\r\n2. If no sources provided, `web_search` for 2–3 high-quality references\r\n3. Prioritize: official docs > primary blog posts > secondary analysis\r\n\r\n**Rule**: At least 1 first-party source (official docs / original author's post). Raw content is saved as-is — no processing yet.\r\n\r\n---\r\n\r\n### Phase 2 · Distill（core work）\r\n\r\n**Goal**: Extract signal, discard noise.\r\n\r\n1. Read all `raw/` files\r\n2. Write per skill-creator spec:\r\n   - `SKILL.md` — triggers + workflow (≤200 lines)\r\n   - `references/` — detailed knowledge, split by topic\r\n   - `scripts/` — reusable code, only if needed\r\n3. **Mandatory verification** (LRN-001): Re-fetch original source, diff against draft, check for gaps\r\n\r\n**Quality checklist**:\r\n- [ ] Trigger words are broad enough to cover all user phrasings\r\n- [ ] SKILL.md has a clear \"when to use\" section\r\n- [ ] Detail lives in `references/`, not bloating `SKILL.md`\r\n- [ ] At least one mandatory re-read of primary source after distillation\r\n\r\n---\r\n\r\n### Phase 3 · Publish\r\n\r\n**Goal**: Clean, versioned, standalone repo ready for GitHub/ClawHub.\r\n\r\n#### Repo Structure (Minimal)\r\n\r\n```\r\n<skill-name>/\r\n├── SKILL.md          # Entry point (triggers + workflow)\r\n├── README.md         # Human-facing intro — bilingual (EN + ZH)\r\n├── CHANGELOG.md      # Version history\r\n├── LICENSE           # MIT recommended\r\n├── .gitignore\r\n└── references/       # Knowledge base\r\n    └── *.md\r\n```\r\n\r\nFor script-heavy skills, add:\r\n```\r\n└── scripts/\r\n    └── *.py\r\n```\r\n\r\n#### README Spec\r\n\r\nA skill README must answer 3 questions in ≤60 seconds of reading:\r\n1. **What problem does it solve?** (1-2 sentences, no jargon)\r\n2. **What makes it better than asking without it?** (key differentiator)\r\n3. **How do I use it?** (one concrete example)\r\n\r\n**Bilingual (EN + ZH)**: Use two separate files for maximum clarity.\r\n\r\n```\r\nREADME.md       # English only — no Chinese text anywhere\r\nREADME_zh.md    # Chinese only — full detail, selling points, usage\r\n```\r\n\r\nEach file includes a badge linking to the other version. This allows GitHub to render clean language-specific views and enables future ClawHub to surface the right version per locale.\r\n\r\n#### ClawHub Distribution\r\n\r\nWhen the user wants to publish to ClawHub:\r\n1. Ensure `SKILL.md` frontmatter has: `name`, `version`, `description`\r\n2. `description` must contain broad trigger phrases covering multiple phrasings\r\n3. `LICENSE` file present (MIT recommended)\r\n4. Tag the release: `git tag v1.0.0 && git push --tags`\r\n\r\n#### Sync to Local Workspace\r\n\r\nAfter publishing, sync to `~/.workbuddy/skills/<skill-name>/` so Claw can use it immediately:\r\n\r\n```powershell\r\nCopy-Item -Recurse -Force \"D:\\WorkBuddy\\<skill-name>\\*\" \"$env:USERPROFILE\\.workbuddy\\skills\\<skill-name>\\\"\r\n```\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nVersion semantics follow **Semantic Versioning** adapted for skills:\r\n\r\n```\r\nMAJOR.MINOR.PATCH\r\n```\r\n\r\n| Version bump | When | Example trigger |\r\n|---|---|---|\r\n| **PATCH** `x.x.1` | Typo fix, trigger word tweak, minor clarification | \"修复了一个例子描述不准\" |\r\n| **MINOR** `x.1.0` | New reference source, new phase step, extended trigger coverage | \"加入 Anthropic 最新文档\" |\r\n| **MAJOR** `2.0.0` | Scope change, structural refactor, paradigm shift | \"从单文档改为多 reference 结构\" |\r\n\r\n### What warrants a MAJOR bump?\r\n\r\nA MAJOR version (e.g. 1.x → 2.0) signals a **breaking change in the skill's mental model**:\r\n- The core SOP phases are restructured\r\n- The skill's scope is fundamentally redefined\r\n- Files are reorganized in ways that break the previous structure\r\n- The activation paradigm changes (e.g. from \"ask anything\" to \"four-phase SOP\")\r\n\r\n**MAJOR ≠ more content**. A skill that doubles its references but keeps the same structure is still a MINOR bump.\r\n\r\n### What warrants a MINOR bump?\r\n\r\nA MINOR version (e.g. 1.0 → 1.1 → 1.2) signals **additive improvements** that don't break the existing pattern:\r\n- New knowledge source added to `references/`\r\n- New trigger words added to frontmatter\r\n- New section added to SOP without restructuring existing phases\r\n- README improvements, badge updates\r\n\r\n### Commit message convention\r\n\r\n```\r\nfeat: add [source] to references        → MINOR\r\nfix: correct [description]              → PATCH\r\nrefactor: restructure [component]       → could be MAJOR\r\nrelease: v2.0.0 - [summary]            → tag release commits\r\n```\r\n\r\n### Changelog discipline\r\n\r\nEvery release must update `CHANGELOG.md` with:\r\n- Version number + date\r\n- Summary sentence (1 line)\r\n- Added / Changed / Fixed sections\r\n\r\n---\r\n\r\n## Skill Iteration (1→N)\r\n\r\nWhen upgrading an existing skill:\r\n\r\n1. Create a new branch or directly update `D:/WorkBuddy/<skill-name>/`\r\n2. Add new source to `references/` with dated filename (`source-YYYYMMDD.md`)\r\n3. Update `SKILL.md` version field and trigger words if needed\r\n4. Update `CHANGELOG.md`\r\n5. Bump version (MAJOR / MINOR / PATCH per rules above)\r\n6. Commit with semantic message\r\n7. Re-sync to local workspace\r\n\r\n**Upgrade triggers**: User sends new URL, user says \"skill has a gap\", Claw detects missing knowledge during a task execution.\r\n\r\n---\r\n\r\n## Workspace Layout\r\n\r\n```\r\nD:/WorkBuddy/\r\n├── .workspace-index.md      # Master skill status board\r\n├── skill-factory/           # This meta-skill repo\r\n│   ├── SKILL.md             # This file\r\n│   ├── README.md\r\n│   ├── CHANGELOG.md\r\n│   ├── LICENSE\r\n│   ├── .gitignore\r\n│   ├── inbox/               # Raw ideas drop zone\r\n│   └── wip/                 # Active work-in-progress\r\n│       └── <skill-name>/\r\n│           ├── BRIEF.md\r\n│           ├── raw/\r\n│           └── draft/\r\n│\r\n├── harness/                 # ✅ v1.2.0 — ready for GitHub\r\n├── nova-reader/             # ✅ v1.1.0 — ready for GitHub\r\n└── <future-skills>/\r\n```\r\n\r\n---\r\n\r\n## Lessons Learned (from .learnings)\r\n\r\n| ID | Lesson | Fix in SOP |\r\n|----|--------|-----------|\r\n| LRN-001 | Missed content after distillation without re-reading source | Phase 2 mandatory re-fetch |\r\n| LRN-002 | Skill evolved in workspace, hard to publish as standalone | Phase 3 independent repo |\r\n| LRN-003 | Over-engineered before confirming real need | Phase 0 three-question lock |\r\n| LRN-004 | Research notes mixed with skill docs | `raw/` vs `references/` separation |\n\nFile v2.2.1:README.md\n\n# Skill Factory\r\n\r\n> **\"The first industrial revolution ended when machines began building machines.\"**\r\n> **Skill Factory is the machine that builds skills.**\r\n\r\nA **meta-skill** for OpenClaw that automates the full lifecycle of skill creation — from a fuzzy idea to a polished, versioned, distributable package.\r\n\r\n[![Version](https://img.shields.io/badge/version-2.2.1-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![中文说明](https://img.shields.io/badge/README-中文版-orange.svg)](README_zh.md)\r\n\r\n---\r\n\r\n## What Problem Does It Solve?\r\n\r\nCreating an OpenClaw skill without a workflow leads to: fuzzy specs, missed knowledge during distillation, scattered files impossible to publish, and skills that stagnate at v1.0 with no clear upgrade path.\r\n\r\n**Skill Factory solves all of this** by treating skill creation as a repeatable, improvable process — not a one-off creative act.\r\n\r\n## What Makes It Different?\r\n\r\nMost skill-making is ad hoc. Skill Factory is an **end-to-end automated SOP** that any Claw instance can follow:\r\n\r\n**Foundation** — lock scope before work begins:\r\n- **Phase 0 three-question lock** — prevents scope creep and over-engineering\r\n\r\n**Quality** — ensure nothing is missed:\r\n- **Mandatory source re-verification** — catches missed content after distillation\r\n\r\n**Structure** — ship-ready from day one:\r\n- **Independent repo per skill** — every skill is GitHub/ClawHub-ready from day one\r\n- **Semantic versioning for skills** — clear rules for MAJOR vs MINOR vs PATCH\r\n\r\n**Evolution** — not just 0→1, but 1→N:\r\n- **Human-AI collaborative iteration** — ongoing improvement with versioned upgrades\r\n\r\nIt is not about what Claw *can* do — it is about turning an unbounded capability into a **reliable, high-quality pipeline**. The process is the product.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust send Claw an idea:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nClaw enters **Phase 0** immediately — no setup required.\r\n\r\n---\r\n\r\n## Example: Building the `harness` Skill\r\n\r\nHere is how Skill Factory handled a real request end-to-end:\r\n\r\n**Input** (30 seconds):\r\n```\r\nNew skill: harness, distill OpenAI's agent engineering article,\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — Three questions answered in one message:\r\n- Target: any Claw working on agent-first engineering\r\n- Source: OpenAI Harness Engineering blog post\r\n- Scope: GitHub + local workspace\r\n\r\n**Phase 1** — `web_fetch` the source, saved to `wip/harness/raw/`\r\n\r\n**Phase 2** — Distilled into `SKILL.md` (10 principles) + `references/` (two documents). Mandatory re-read caught 4 missed concepts including the \"Ralph Wiggum loop\".\r\n\r\n**Phase 3** — Independent repo, MIT license, bilingual README, git-tagged `v1.2.0`, synced to workspace.\r\n\r\n**Total time**: ~10 minutes. Without the factory, the same work took a full day of iteration and still had gaps.\r\n\r\n---\r\n\r\n## Four-Phase SOP Overview\r\n\r\n| Phase | Name | Output |\r\n|-------|------|--------|\r\n| 0 | Capture | `BRIEF.md` — locked spec |\r\n| 1 | Collect | `raw/` — raw source material |\r\n| 2 | Distill | `SKILL.md` + `references/` |\r\n| 3 | Publish | versioned repo, synced to workspace |\r\n\r\nFull SOP details are in [SKILL.md](SKILL.md).\r\n\r\n---\r\n\r\n## Version Management\r\n\r\nSkills use **Semantic Versioning** adapted for this format:\r\n\r\n| Bump | When |\r\n|------|------|\r\n| `PATCH` (x.x.1) | Typo fix, trigger word tweak |\r\n| `MINOR` (x.1.0) | New source, new section, extended triggers |\r\n| `MAJOR` (2.0.0) | Paradigm shift, structural refactor |\r\n\r\n**MAJOR does not mean more content** — a skill that doubles its references but keeps the same structure is still MINOR.\r\n\r\n---\r\n\r\n## Repo Structure\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # Full SOP — four phases, version management, publishing spec\r\n├── README.md        # This file (English)\r\n├── README_zh.md     # Chinese version\r\n├── CHANGELOG.md     # Version history\r\n├── LICENSE          # MIT\r\n├── inbox/           # Drop zone for raw ideas\r\n└── wip/             # Active work-in-progress\r\n    └── <skill>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### From ClawHub (Recommended)\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\nOr use the full identifier:\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### Manual Installation\r\n\r\n1. Clone this repo to your skills directory:\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.claw/skills/skillfactory\r\n```\r\n\r\n2. Restart your Claw session — the skill will auto-load.\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — fork it, adapt it, build your own factory.\n\nFile v2.2.1:_meta.json\n\n{\n  \"ownerId\": \"kn75mmeqmz6rt3hwpt8qy83cj1858fnw\",\n  \"slug\": \"skillfactory\",\n  \"version\": \"2.2.1\",\n  \"publishedAt\": 1776777079199\n}\n\nFile v2.2.1:CHANGELOG.md\n\n# Changelog — skill-factory\r\n\r\nAll notable changes to skill-factory will be documented in this file.\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\n---\r\n\r\n## [2.2.1] - 2026-04-21\r\n\r\n### Summary\r\n\r\n**ClawHub distribution ready + clean publish structure.**\r\n\r\n### Added\r\n- `README.md`: ClawHub installation instructions (`claw skill install skillfactory`)\r\n- `README_zh.md`: 中文安装说明\r\n- `README.md` & `README_zh.md`: Tags section for discoverability\r\n- `CLAWHUB.md`: Dedicated ClawHub listing page with one-line pitch\r\n- `PUBLISH.md`: Release command reference for future updates\r\n\r\n### Changed\r\n- Slug finalized: `skillfactory` (GitHub: PandaBro666/skillfactory)\r\n- `.gitignore` updated: excludes `inbox/`, `wip/`, `promo/` from public repo\r\n\r\n### Notes\r\n- Minimum ClawHub requirement: `SKILL.md` only\r\n- Recommended: `SKILL.md` + `README.md` + `LICENSE` for professional presentation\r\n- Clean publish workflow: copy core files to separate directory to avoid uploading WIP content\r\n\r\n---\r\n\r\n## [2.2.0] - 2026-04-20\r\n\r\n### Summary\r\n\r\n**Bilingual README split + clean publish structure.**\r\n\r\n### Added\r\n- `README_zh.md` — dedicated Chinese README with bilingual badge linking between versions\r\n- `.gitignore` — excludes `inbox/` and `wip/` from public repo (personal work area)\r\n\r\n### Changed\r\n- `README.md` (English): completely purged of Chinese text; \"Skills Built With This Factory\" section replaced with a concrete end-to-end example using the `harness` skill\r\n- `README.md` now includes badge linking to `README_zh.md`\r\n- `README_zh.md` likewise links back to English version via badge\r\n\r\n### Fixed\r\n- SKILL.md Phase 3 bilingual spec updated: README is now two separate files, not two sections in one\r\n\r\n---\r\n\r\n## [2.1.0] - 2026-04-20\r\n\r\n### Summary\r\n\r\n**GitHub release ready.** Full bilingual README, version management SOP, and LICENSE added.\r\n\r\n### Added\r\n- `LICENSE` (MIT) — required for ClawHub distribution\r\n- Semantic versioning guide in `SKILL.md`: MAJOR / MINOR / PATCH semantics with decision criteria\r\n- Commit message convention (`feat:` / `fix:` / `refactor:` / `release:`)\r\n- Changelog discipline rules (every release must update CHANGELOG)\r\n\r\n### Changed\r\n- `README.md` rewritten as bilingual (EN + ZH), \"industrial revolution\" analogy as lead hook\r\n- `SKILL.md` v2.1: extended version management section, bilingual README spec in Phase 3\r\n- Trigger words expanded: added `skill版本管理`, `skill如何发行`, `skill生产`, `skill自动化`\r\n\r\n---\r\n\r\n## [2.0.0] - 2026-04-20\r\n\r\n### Summary\r\n\r\n**From SOP document to meta-skill.**\r\n\r\nSkill Factory is now itself a publishable WorkBuddy skill. v2.0 restructures the project so it can be distributed via GitHub/ClawHub and loaded by any Claw instance, just like any other skill.\r\n\r\n### Changed\r\n- `SKILL.md` completely rewritten as a proper skill entry point with YAML frontmatter, trigger words, and self-contained SOP\r\n- Added Phase 3 publishing specs: README format, ClawHub distribution checklist, version semantics\r\n- Added skill iteration workflow (1→N upgrades)\r\n- `README.md` rewritten as human-facing project page with selling points\r\n\r\n### Added\r\n- `CHANGELOG.md` (this file)\r\n- ClawHub distribution spec in Phase 3\r\n- Skill upgrade triggers and process\r\n- Workspace layout reference\r\n\r\n---\r\n\r\n## [1.0.0] - 2026-04-18\r\n\r\n### Summary\r\n\r\n**Initial creation.**\r\n\r\nBuilt during the harness skill development cycle as a response to 4 accumulated learnings (LRN-001 through LRN-004). Established the four-phase SOP and workspace directory structure.\r\n\r\n### Added\r\n- `SKILL-SOP.md` — four-phase workflow (Phase 0-3)\r\n- `inbox/` directory — idea drop zone\r\n- `wip/` directory — active skill workspace\r\n- `D:/WorkBuddy/.workspace-index.md` — master skill status board\r\n- 4 lessons from harness creation embedded into SOP\n\nFile v2.2.1:README_zh.md\n\n# Skill Factory\r\n\r\n> **\"第一次工业革命结束的标志，是用机器来制造机器。**\r\n> **Skill Factory，就是那台制造skill的机器。\"**\r\n\r\n这是一个用于 OpenClaw 的**元技能（meta-skill）**，将 skill 的创作过程——从一句模糊的想法，到打磨完毕、版本清晰、可直接发行的成品——变成一套可重复执行的标准化流程。\r\n\r\n[![Version](https://img.shields.io/badge/version-2.2.1-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![English README](https://img.shields.io/badge/README-English-blue.svg)](README.md)\r\n\r\n---\r\n\r\n## 它解决什么问题？\r\n\r\n没有工作流直接上手制作 skill，常见结局：\r\n\r\n- 需求没说清楚就开始干，做到一半发现方向不对\r\n- 蒸馏完文章，发现漏了关键内容，还得回头重看\r\n- 文件散落各处，想发布到 GitHub 才发现结构一团糟\r\n- v1.0 做完了，不知道什么时候该升级、如何管理版本\r\n\r\nSkill Factory 用**四阶段 SOP** 系统性地解决以上全部问题。\r\n\r\n---\r\n\r\n## 核心差异化\r\n\r\n市面上的 skill 制作多是随兴而为。Skill Factory 的不同之处：\r\n\r\n**基础层** — 开工前锁定范围：\r\n- **Phase 0 三问锁定**：三个问题锁死需求，防止过度工程化\r\n\r\n**质量层** — 确保知识完整：\r\n- **强制原文二次核对**：蒸馏完必须回到原始来源比对，防止知识遗漏\r\n\r\n**结构层** — 发行级从第一天开始：\r\n- **每个 skill 独立 repo**：从第一天起就是发行级结构，随时可 push 到 GitHub\r\n- **语义化版本管理**：清楚区分 MAJOR（范式重构）/ MINOR（增量添加）/ PATCH（修小问题）\r\n\r\n**演进层** — 不只是 0→1，更是 1→N：\r\n- **持续迭代机制**：有明确的升级路径和人机协作改进流程\r\n\r\n关键在于：**这不是关于 Claw 能做什么，而是关于如何把无边界的能力，变成高质量、可重复的流水线。流程本身就是产品。**\r\n\r\n---\r\n\r\n## 快速上手\r\n\r\n发给 Claw 一个想法即可：\r\n\r\n```\r\n新 skill：[名字]，[1-2句描述]，[来源链接（可选）]\r\n```\r\n\r\n或升级已有 skill：\r\n\r\n```\r\nskill升级：[名字]，[要加什么]，[新来源链接（可选）]\r\n```\r\n\r\nClaw 会立刻进入 Phase 0，回答 3 个问题后，流水线自动运转。\r\n\r\n---\r\n\r\n## 实际案例：制作 `harness` skill\r\n\r\n以下是 Skill Factory 处理一次真实需求的完整过程：\r\n\r\n**用户输入**（30秒）：\r\n```\r\n新 skill：harness，蒸馏 OpenAI 的智能体工程文章，\r\nhttps://openai.com/zh-Hans-CN/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — 三问一轮解决：\r\n- 目标用户：任何在做智能体工程的 Claw 实例\r\n- 来源：OpenAI Harness Engineering 博客\r\n- 发行形式：GitHub + 本地 workspace 同步\r\n\r\n**Phase 1** — `web_fetch` 抓取原文，存入 `wip/harness/raw/`\r\n\r\n**Phase 2** — 蒸馏为 `SKILL.md`（10 大原则）+ `references/`（两份文档）。强制二次核对步骤发现了 4 处遗漏，包括\"Ralph Wiggum 自我审查循环\"。\r\n\r\n**Phase 3** — 独立 repo，MIT 协议，双语 README，git 打标签 `v1.2.0`，同步到 workspace。\r\n\r\n**耗时**：约 10 分钟。没有这套工厂，同样的工作之前需要一整天迭代，且仍有知识盲区。\r\n\r\n---\r\n\r\n## 四阶段 SOP 概览\r\n\r\n| 阶段 | 名称 | 产出 |\r\n|------|------|------|\r\n| 0 | 快速摄入 | `BRIEF.md`：锁定需求 |\r\n| 1 | 资料收集 | `raw/`：原始资料 |\r\n| 2 | 蒸馏 | `SKILL.md` + `references/` |\r\n| 3 | 封装发行 | 带版本标签的独立 repo |\r\n\r\n完整 SOP 见 [SKILL.md](SKILL.md)。\r\n\r\n---\r\n\r\n## 版本管理逻辑\r\n\r\n借用软件工程的语义化版本，专为 skill 定制：\r\n\r\n| 版本变动 | 何时触发 |\r\n|----------|---------|\r\n| `PATCH`（x.x.1）| 修错别字、调整触发词描述 |\r\n| `MINOR`（x.1.0）| 新增来源、补充章节、扩展触发词 |\r\n| `MAJOR`（2.0.0）| 核心结构重构、范式转变、激活方式改变 |\r\n\r\n**MAJOR 不等于内容更多**——如果翻倍了 references 但结构不变，仍然是 MINOR。\r\n\r\n---\r\n\r\n## 目录结构\r\n\r\n```\r\nskill-factory/\r\n├── SKILL.md         # 完整 SOP 文档（触发词 + 四阶段 + 版本管理 + 发行规范）\r\n├── README.md        # 英文版说明\r\n├── README_zh.md     # 本文件（中文说明）\r\n├── CHANGELOG.md     # 版本历史\r\n├── LICENSE          # MIT 开源协议\r\n├── inbox/           # 想法投递区（随时丢，不会丢）\r\n└── wip/             # 进行中的 skill 工作区\r\n    └── <skill名>/\r\n        ├── BRIEF.md\r\n        ├── raw/\r\n        └── draft/\r\n```\r\n\r\n---\r\n\r\n## 安装方法\r\n\r\n### 通过 ClawHub 安装（推荐）\r\n\r\n```bash\r\nclaw skill install skillfactory\r\n```\r\n\r\n或使用完整标识符：\r\n\r\n```bash\r\nclaw skill install github.com/zhelunSun/skill-factory\r\n```\r\n\r\n### 手动安装\r\n\r\n1. 克隆仓库到技能目录：\r\n```bash\r\ngit clone https://github.com/zhelunSun/skill-factory.git ~/.claw/skills/skillfactory\r\n```\r\n\r\n2. 重启 Claw 会话 —— 技能将自动加载。\r\n\r\n---\r\n\r\n## 开源协议\r\n\r\nMIT — 欢迎 fork、改造，用这个工厂造你自己的工厂。","readmeExcerpt":"Skill: Skill Factory Owner: zhelunsun Summary: Turn any idea into a polished, versioned, publishable OpenClaw skill — no scaffolding, no guesswork. Just say \"新 skill\" or \"build a skill\" and Skill Factory... Tags: latest:2.4.0 Version history: v2.4.0 | 2026-05-13T11:02:49.661Z | user Added ClawHub CLI publishing workflow (login via device flow, publish, verify, sync). Captured proxy/SSH and requirement-creep lessons. ","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: skill-factory\r\nversion: \"2.4.0\"\r\ndescription: >\r\n  Turn any idea into a polished, versioned, publishable OpenClaw skill — no\r\n  scaffolding, no guesswork. Just say \"新 skill\" or \"build a skill\" and Skill\r\n  Factory handles the rest: captures the spec, collects sources, distills\r\n  knowledge, and packages it into a GitHub-ready repo. Also supports upgrading\r\n  existing skills with \"升级 skill\" or \"upgrade skill\". Built for makers who\r\n  want quality without reinventing the process. Triggers: \"新 skill\", \"做一个skill\",\r\n  \"build a skill\", \"create skill\", \"skill制作\", \"把这个做成skill\", \"帮我把...打包成skill\",\r\n  \"skill升级\", \"skill发行\", \"skill factory\", \"制造skill\", \"skill工厂\", \"skill from scratch\",\r\n  \"我有个skill想法\", \"skill迭代\", \"skill打磨\", \"做一个关于...的skill\",\r\n  \"skill版本管理\", \"skill如何发行\", \"skill如何升级\", \"skill生产\", \"skill自动化\",\r\n  \"更新skill\", \"升级skill\", \"维护skill\", \"升级已有skill\", \"upgrade skill\",\r\n  \"update skill\", \"维护现有skill\", \"skill版本升级\", \"skill生命周期\".\r\n---\r\n\r\n# Skill Factory — The Meta-Skill for Making Skills\r\n\r\n> \"The first industrial revolution was marked by using machines to make machines.\r\n> Skill Factory is the machine that makes skills.\"\r\n\r\n## Purpose\r\n\r\nSkill Factory provides a **repeatable, human-AI collaborative SOP** for going from a raw idea to a polished, publishable OpenClaw skill. It handles:\r\n\r\n- **0→1**: Rapid capture of fuzzy ideas → structured BRIEF → distilled skill\r\n- **1→N**: Iterating an existing skill with new sources or structural improvements\r\n- **N→∞**: Publishing, versioning, ClawHub distribution, and ongoing maintenance\r\n\r\nThe key insight: **this is not about capability, it's about workflow.** Any Claw instance with this skill loaded can build production-quality skills — the process is the product.\r\n\r\n---\r\n\r\n## How to Trigger This Skill\r\n\r\nJust say something like:\r\n\r\n> `New skill: [name], [1-2 sentences], [source URL (optional)]`\r\n> `Upgrade skill: [skill name/path], [change request], [new source URL (optional)]`\r\n\r\n### New skill examples:\r\n- `New skill: prompt-engineering, best practices from Anthropic and OpenAI`\r\n- `New skill: git-workflow, standardize my branching and PR flow, https://...`\r\n- `新 skill：简历筛选，用关键词匹配和语义分析筛选简历`\r\n\r\n### Upgrade skill examples:\r\n- `Upgrade skill: nova-reader, add Semantic Scholar data source`\r\n- `Upgrade skill: harness, strengthen governance rules from Phase 3.5 lessons`\r\n- `升级 skill：skill-factory，增加显式升级模式`\r\n\r\nClaw will enter **Phase 0** for new skills or the **Upgrade Workflow** for existing skills — no more information needed to start.\r\n\r\n**中文用户**: `新 skill：[名字]，[1-2句说明]，[来源URL（可选）]` for new; `升级 skill：[skill名字/路径]，[变更要求]，[新来源URL（可选）]` for upgrades.\r\n\r\n---\r\n\r\n## Four-Phase SOP\r\n\r\n### Phase 0 · Capture（≤5 min）\r\n\r\n**Goal**: Lock down the spec before any work begins.\r\n\r\n1. Save raw idea to `inbox/<skill-name>.md` (防止遗失)\r\n2. Ask exactly **3 questions** — no more:\r\n   - What is the target scenario / user?\r\n   - Are there reference sources? (If not, Claw will search)\r\n   - Publish scope: local-only / GitHub / ClawHub dis"},{"path":"README.md","content":"# Skill Factory\r\n\r\n> **\"The first industrial revolution ended when machines began building machines.\"**\r\n> **Skill Factory is the machine that builds skills.**\r\n\r\nA **meta-skill** for OpenClaw that automates the full lifecycle of skill creation — from a fuzzy idea to a polished, versioned, distributable package.\r\n\r\n[![Version](https://img.shields.io/badge/version-2.4.0-blue.svg)](CHANGELOG.md)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\r\n[![中文说明](https://img.shields.io/badge/README-中文版-orange.svg)](README_zh.md)\r\n\r\n---\r\n\r\n## What Problem Does It Solve?\r\n\r\nCreating an OpenClaw skill without a workflow leads to: fuzzy specs, missed knowledge during distillation, scattered files impossible to publish, and skills that stagnate at v1.0 with no clear upgrade path.\r\n\r\n**Skill Factory solves all of this** by treating skill creation as a repeatable, improvable process — not a one-off creative act.\r\n\r\n## What Makes It Different?\r\n\r\nMost skill-making is ad hoc. Skill Factory is an **end-to-end automated SOP** that any Claw instance can follow:\r\n\r\n**Foundation** — lock scope before work begins:\r\n- **Phase 0 three-question lock** — prevents scope creep and over-engineering\r\n\r\n**Quality** — ensure nothing is missed:\r\n- **Mandatory source re-verification** — catches missed content after distillation\r\n\r\n**Structure** — ship-ready from day one:\r\n- **Independent repo per skill** — every skill is GitHub/ClawHub-ready from day one\r\n- **Semantic versioning for skills** — clear rules for MAJOR vs MINOR vs PATCH\r\n\r\n**Evolution** — not just 0→1, but 1→N:\r\n- **Human-AI collaborative iteration** — ongoing improvement with versioned upgrades\r\n\r\nIt is not about what Claw *can* do — it is about turning an unbounded capability into a **reliable, high-quality pipeline**. The process is the product.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust send Claw an idea:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nClaw enters **Phase 0** immediately — no setup required.\r\n\r\n---\r\n\r\n## Example: Building the `harness` Skill\r\n\r\nHere is how Skill Factory handled a real request end-to-end:\r\n\r\n**Input** (30 seconds):\r\n```\r\nNew skill: harness, distill OpenAI's agent engineering article,\r\nhttps://openai.com/index/harness-engineering/\r\n```\r\n\r\n**Phase 0** — Three questions answered in one message:\r\n- Target: any Claw working on agent-first engineering\r\n- Source: OpenAI Harness Engineering blog post\r\n- Scope: GitHub + local workspace\r\n\r\n**Phase 1** — `web_fetch` the source, saved to `wip/harness/raw/`\r\n\r\n**Phase 2** — Distilled into `SKILL.md` (10 principles) + `references/` (two documents). Mandatory re-read caught 4 missed concepts including the \"Ralph Wiggum loop\".\r\n\r\n**Phase 3** — Independent repo, MIT license, bilingual README, git-tagged `v1.2.0`, synced to workspace.\r\n\r\n**Total time**: ~10 minutes. Without the factory, the same work took a full day of iteration and still had gaps.\r\n\r\n---\r\n\r\n## Four-Phase SOP Overview\r\n\r\n| Phase | Name | Outpu"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn75mmeqmz6rt3hwpt8qy83cj1858fnw\",\n  \"slug\": \"skillfactory\",\n  \"version\": \"2.4.0\",\n  \"publishedAt\": 1778670169661\n}"},{"path":"CHANGELOG.md","content":"# Changelog — skill-factory\r\n\r\nAll notable changes to skill-factory will be documented in this file.\r\n\r\nFormat: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)\r\n\r\n---\r\n\r\n## [Unreleased]\r\n\r\nNo unreleased changes yet.\r\n\r\n---\r\n\r\n## [2.4.0] — 2026-05-13\r\n\r\n### Summary\r\n\r\n**End-to-end ClawHub CLI publishing workflow.** Phase 3 now includes a full, battle-tested SOP for publishing skill updates to ClawHub via CLI — covering login, publish, verify, and local sync. Lessons from earlier failures (proxy issues, requirement creep, device flow) are captured.\r\n\r\n### Added\r\n- Phase 3 → ClawHub CLI Publishing: device flow login, publish command, verify, local sync steps\r\n- Phase 3 → Windows proxy notes: HTTPS vs SSH guidance\r\n- Lessons Learned table: LRN-005 (ClawHub device flow background), LRN-006 (SSH/proxy), LRN-007 (requirement creep)\r\n\r\n### Changed\r\n- SKILL.md version bumped from v2.3.0 to v2.4.0\r\n- README.md / README_zh.md version badges updated to v2.4.0\r\n\r\n### Fixed\r\n- CLAWHUB.md version updated from v2.1.0 to v2.3.0 (was out of sync)\r\n- SKILL.md Workspace Layout: corrected `D:/WorkBuddy/` → `D:/Agent/WorkBuddy/skills/` for skill repo paths\r\n- SKILL.md Legacy section: `D:/WorkBuddy/<skill-name>/` → `D:/Agent/WorkBuddy/skills/<skill-name>/`\r\n- README_zh.md: OpenAI URL changed from Chinese-localized to canonical English URL\r\n- README.md / README_zh.md: manual install path from `~/.claw/skills/` → `~/.workbuddy/skills/`\r\n- .workspace-index.md: directory structure comment updated from v2.2.0 to v2.3.0\r\n\r\n## [2.3.0] — 2026-05-12\r\n\r\n### Summary\r\n\r\n**First-class upgrade workflow for existing skills.** Skill Factory now explicitly supports 1→N maintenance alongside 0→1 creation.\r\n\r\n### Added\r\n- `Upgrade skill:` as a first-class entry point alongside `New skill:`\r\n- Upgrade Workflow section in SKILL.md: Inspect → Classify → Propose → Apply → Summary\r\n- Version bump decision framework: skill's \"public API\" defined (use cases, input/output, workflow phases, safety boundaries, file structure)\r\n- Upgrade plan template: current version, proposed version, change type, files to modify, risk level, changelog entry, commit message, tag\r\n- Enhanced trigger words covering upgrade and maintenance scenarios\r\n\r\n### Changed\r\n- SKILL.md: `[Unreleased]` section added to CHANGELOG guidance per Keep a Changelog standard\r\n- CHANGELOG discipline: now requires grouped changes (Added / Changed / Fixed / Deprecated / Removed / Security) and user-readable summaries\r\n- README.md: added \"Maintaining Existing Skills (1→N)\" section\r\n- README_zh.md: updated quick start with skill upgrade example\r\n- Legacy \"Skill Iteration\" section renamed to \"Skill Iteration (Legacy)\" with redirect to Upgrade Workflow\r\n\r\n### Fixed\r\n- Workspace layout path in SKILL.md now consistent with actual directory structure\r\n\r\n---\r\n\r\n## [2.2.2] — 2026-04-27\r\n\r\n### Summary\r\n\r\n**Version sync: local repo aligned with ClawHub v2.2.2 release.**\r\n\r\n### Changed\r\n- `SKILL.md`: version field updated to `2.2.2`\r\n- `REA"},{"path":"CLAWHUB.md","content":"# Skill Factory — ClawHub Listing\r\n\r\n**Slug:** `skillfactory`  \r\n**Display Name:** Skill Factory  \r\n**Version:** 2.3.0  \r\n**License:** MIT  \r\n**Author:** PandaBro666\r\n\r\n---\r\n\r\n## One-Line Pitch\r\n\r\nThe machine that builds skills — because making a skill from scratch shouldn't feel like reinventing the wheel every time.\r\n\r\n---\r\n\r\n## What It Does\r\n\r\nSkill Factory is your skill-making buddy. You bring an idea (or a URL), it handles the rest:\r\n\r\n- **Lock the scope** — 3 quick questions to make sure you're building the right thing\r\n- **Gather the goods** — fetches source material automatically\r\n- **Distill the signal** — turns noise into structured SKILL.md + references\r\n- **Ship it** — packages everything into a versioned, GitHub-ready repo\r\n- **Keep it fresh** — structured upgrade workflow so your skills don't rot at v1.0\r\n\r\nNo boilerplate templates. No \"what now?\" moments. Just say the word and it works.\r\n\r\n---\r\n\r\n## When to Use\r\n\r\n- You have a skill idea but don't know how to start\r\n- You want to turn scattered notes or bookmarks into a proper skill\r\n- You need to bring an existing skill up to date with new sources\r\n- You're preparing something for GitHub or ClawHub\r\n- You have a skill sitting at v1.0 and want to grow it without messing up\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\nJust tell your Claw:\r\n\r\n```\r\nNew skill: [name], [1-2 sentences], [source URL (optional)]\r\n```\r\n\r\nExample:\r\n```\r\nNew skill: prompt-engineering, best practices from Anthropic and OpenAI\r\n```\r\n\r\nOr to upgrade an existing one:\r\n```\r\nUpgrade skill: [name], [what to add], [new source URL (optional)]\r\n```\r\n\r\n---\r\n\r\n## Tags\r\n\r\n`meta-skill` `skill-authoring` `openclaw` `agent-engineering` `workflow-automation` `knowledge-distillation`\r\n\r\n---\r\n\r\n## Links\r\n\r\n- **Repository:** https://github.com/zhelunSun/skill-factory\r\n- **English README:** [README.md](README.md)\r\n- **中文说明:** [README_zh.md](README_zh.md)\r\n- **Changelog:** [CHANGELOG.md](CHANGELOG.md)"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1825,"uniquenessScore":43,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T11:54:42.859Z","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-11T11:54:42.859Z","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-11T15:16:15.702Z","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"}]}}}