{"id":"741af3a4-fd16-41b9-b1ca-a666e98d78c8","entityType":"agent","slug":"clawhub-iichaner-harness-skill-generator","name":"harness-skill-generator","canonicalUrl":"https://www.xpersona.co/agent/clawhub-iichaner-harness-skill-generator","canonicalPath":"/agent/clawhub-iichaner-harness-skill-generator","generatedAt":"2026-10-10T17:35:30.288Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T14:38:11.050Z","emptyReason":null},"description":"引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。 Skill: harness-skill-generator Owner: iichaner Summary: 引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-18T10:45:43.269Z | auto Initial release — guides users to create complex Harness-based Skills from scratch. - Provides a step-by-ste","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17evhyc3z1a82bvpm10c418p9849pg7:harness-skill-generator","sourceUrl":"https://clawhub.ai/iichaner/harness-skill-generator","homepage":"https://clawhub.ai/iichaner/skills/harness-skill-generator","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/iichaner/harness-skill-generator","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/iichaner/skills/harness-skill-generator","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:38:11.050Z","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-10T14:38:11.050Z","emptyReason":null},"stars":null,"forks":null,"downloads":1382,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T14:38:11.050Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T14:38:11.050Z","lastCrawledAt":"2026-10-10T14:38:11.050Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T14:38:11.050Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-18T10:45:43.269Z","changelog":"Initial release — guides users to create complex Harness-based Skills from scratch. - Provides a step-by-step workflow: Problem Scan → Architecture → Scaffold → Fill → Test Run → Delivery. - Strictly defines boundaries: supports only multi-stage, multi-branch, quality-checked, stateful task Skills. - Includes detailed phase-by-phase checkpoints and quality protocols to ensure rigor and minimize error. - Automates generation of complete Skill structure (SKILL.md, references/, templates/) with user guidance. - Enforces incremental user confirmations at key stages to avoid logic gaps or misaligned deliverables.","fileCount":14,"zipByteSize":20544}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17evhyc3z1a82bvpm10c418p9849pg7:harness-skill-generator","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/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-10T17:35:30.288Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iichaner-harness-skill-generator/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T14:38:11.050Z","emptyReason":null},"readme":"Skill: harness-skill-generator\n\nOwner: iichaner\n\nSummary: 引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-18T10:45:43.269Z | auto\n\nInitial release — guides users to create complex Harness-based Skills from scratch.\n\n- Provides a step-by-step workflow: Problem Scan → Architecture → Scaffold → Fill → Test Run → Delivery.\n- Strictly defines boundaries: supports only multi-stage, multi-branch, quality-checked, stateful task Skills.\n- Includes detailed phase-by-phase checkpoints and quality protocols to ensure rigor and minimize error.\n- Automates generation of complete Skill structure (SKILL.md, references/, templates/) with user guidance.\n- Enforces incremental user confirmations at key stages to avoid logic gaps or misaligned deliverables.\n\nArchive index:\n\nArchive v0.1.0: 14 files, 20544 bytes\n\nFiles: manifest.json (563b), references (0b), references/architecture-guide.md (3011b), references/branch-routing.md (1614b), references/problem-scan-guide.md (3680b), references/quality-checklist.md (1429b), references/quality-matrix.md (1962b), references/reference-writing-guide.md (1428b), references/scaffold-template.md (2114b), references/style-contract.md (1401b), references/test-run-guide.md (1772b), skill-card.md (2770b), SKILL.md (16861b), _meta.json (142b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: harness-skill-generator\ndescription: \"引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。\"\n---\n\n# Harness Skill Generator\n\n## 边界\n\n### 做\n- 引导用户从 0 创建一个**基于 Harness 工程**的新 Skill\n- 适用于**有复杂度的任务**:多阶段、多分支、需要质检、需要状态持久化\n- 输出完整的 Skill 文件结构(SKILL.md + references/ + templates/)\n- 引导用户走完 Problem Scan → Architecture → Scaffold → Fill → Test Run → Delivery 全流程\n\n### 不做\n- 不修改/升级已有 Skill(那是另一个流程)\n- 不执行 Skill(创建完交给 Agent 用)\n- 不做简单的 prompt 优化(没有阶段/质检/状态需求的任务不需要 harness)\n- 不做 Skill 的市场推广/发布\n\n### 判断规则\n- 如果任务是**单步完成**(如:翻译一段话、回答一个问题)→ 不需要 harness,建议直接写 prompt\n- 如果任务是**多步但无分支**(如:固定的 3 步流程)→ 可以用简化版 harness(无 Checkpoint)\n- 如果任务是**多步 + 多分支 + 需要质检 + 需要状态**→ 进入本 Skill\n\n---\n\n## 工作流\n\n```\nPhase 0  Trigger            用户说\"创建/新建一个 Skill\" → 判断是否需要 harness\n   ▼\nPhase 1  Problem Scan       收集痛点 + 边界定义 + 人类工作流拆解 + 步骤归属审查\n   └ ★Checkpoint 1         确认:痛点 / 边界 / 人类工作流 / 步骤归属\n   ▼\nPhase 2  Agent Architecture 方案调研 → 总体方案概览 → 逐项细化每个阶段\n   └ ★Checkpoint 2         分两步:先确认总体方案,再逐项确认每个阶段\n   ▼\nPhase 3  Scaffold           生成文件结构 + SKILL.md 骨架\n   ▼\nPhase 4  Fill               逐个填写 references/,逐个与用户确认\n   └ ★Checkpoint 3         验收:用一个小样本跑通,人类确认方向对\n   ▼\nPhase 5  Test Run           用真实任务试运行完整流程 + 修复\n   ▼\nPhase 6  Delivery           交付 + 交付确认 + 项目复盘\n```\n\n---\n\n## 质检协议\n\n| 节点 | 方式 | 产物 | 为什么 |\n|---|---|---|---|\n| Phase 1-2 各阶段 | 主 Agent 内联自查（上下文矛盾排查） | 无 | 主 Agent 热上下文，自己检查关联性 |\n| Phase 3 骨架 | 主 Agent 内联自查 | 无 | 文件少，结构简单 |\n| Phase 4 每个 reference | 用户逐个确认 | 无 | 逐个确认方向对 |\n| Phase 4 整体审查 | SubAgent + 消息返回 | 无 | 交付前一致性审查 |\n| Phase 4 Checkpoint 3 | 用户跑小样本验收 | checkpoint-3-review.md | 定调，防止方向错 |\n| Phase 5 试运行 | 用户 + Agent 联合验收 | test-run-report.md | 最终验收 |\n\n---\n\n## Phase 0 - Trigger\n\n**做什么:** 判断用户需求是否需要 harness 工程。\n\n| 用户说的话 | 该做的 |\n|---|---|\n| \"创建/新建一个 Skill\" | 进入 Phase 1 |\n| \"帮我做一个 XX 的自动化流程\" | 进入 Phase 1(可能是 harness 场景) |\n| \"帮我写一个 prompt\" | 问清楚:是单步任务还是多步?如果是多步 → 推荐进入本 Skill |\n| \"修改/升级已有的 Skill\" | 停下来:不在本 Skill 范围内 |\n\n**自检:** 用户的任务是否有以下特征?\n- 多阶段(>2 步)?\n- 多分支(不同情况走不同路径)?\n- 需要质检(产出质量不稳定)?\n- 需要状态持久化(中断后要恢复)?\n\n如果有 2 个以上 → 推荐用 harness 工程。\n如果只有 1 个或没有 → 建议用简化方案。\n\n---\n\n## Phase 1 - Problem Scan\n\n**做什么:** 定义问题 → 收集痛点 → 拆解人类工作流 → 步骤归属审查。\n\n### 1.1 问题定义(★先定义问题,再谈痛点)\n\n问用户两个问题:\n\n**问题 1:** \"你想利用这个 Skill 解决什么问题?\"\n- 不是\"你让 AI 做什么\",而是\"你面临什么问题\"\n\n**问题 2:** \"你在自己处理这个问题的过程中,想要解决的痛点是什么?\"\n- 痛点是问题解决方案的延伸思考\n\n**记录为 `plan/problem-definition.md`。**\n\n### 1.2 边界定义\n\n基于问题和痛点,定义 Skill 的边界:\n- **做什么:** 3-5 种明确的任务类型\n- **不做什么:** 容易混淆但不属于本 Skill 的场景\n- **判断规则:** 什么情况下不进本 Skill\n\n### 1.3 人类工作流拆解\n\n问用户:**\"如果是你人工来做这件事,你的步骤是什么?\"**\n\n要求用户按步骤列出,每步包括:做什么 / 输入 / 输出 / 最容易出错的地方。\n\n**记录为 `plan/human-workflow.md`。**\n\n### 1.4 步骤归属审查\n\n对人类描述的每个步骤,判断:这一步是解决当前问题所必需的,还是属于另一个独立任务?\n- 去掉这一步,核心问题仍能被解决 → 属于另一个任务,拆出去\n- 这一步的产出是另一步的\"预设前提\" → 本 Skill 接收其产出作为输入\n\n### ★Checkpoint 1 - Problem & Boundary\n\n确认项:\n1. **痛点是否准确?** - 有没有遗漏?有没有不是真正痛点的?\n2. **边界是否合理?** - 做什么/不做什么是否清晰?\n3. **人类工作流是否完整?** - 有没有跳步?有没有隐含步骤?\n4. **★ 步骤归属是否正确?** - 有没有把另一个独立任务的内容混进来?\n\n铁律:每项独立确认,禁止打包。\n\n---\n\n## Phase 2 - Agent Architecture(★核心阶段)\n\n**做什么:** 基于人类工作流,设计 Agent 工作流。\n\n### 2.1 方案调研(★必须先于方案设计)\n\n**在设计 Agent 方案之前,先调研市场上的成熟解决方案。**\n\n**调研优先级(从高到低):**\n\n| 优先级 | 方案来源 | 适用场景 | 举例 |\n|---|---|---|---|\n| **P0 · 市场成熟方案** | 权威 SaaS 软件 / 行业标准工具 / 官方 API | 通用任务,市场上已有成熟方案 | 数据采集用 Apify/八爪鱼;内容生成用 Jasper/Copy.ai |\n| **P1 · Agent 原生能力** | Agent 自身能力(脚本/API/推理)替代人类操作 | 市场方案不适用,但 Agent 有更高效的方式 | 人类逐个复制 → Agent 批量提取;人类手动分析 → Agent 结构化推理 |\n| **P2 · 模拟人类行为** | 浏览器自动化 / RPA / 模拟点击 | 平台限制严格,无法用 API 或脚本绕过 | 小红书/BOSS直聘等有反爬机制的平台 |\n\n**★ 特殊情况:平台限制场景**\n\n当任务涉及小红书、BOSS 直聘等有反爬虫/反 AI 政策的平台时,优先级反转:\n- **P0:模拟人类行为**(合理操作间隔 + 时间波动 + 人机行为模拟)\n- P1:官方 API(如有)\n- P2:批量脚本(高风险,易被封)\n\n**调研输出 `plan/solution-research.md`,包含:**\n- 调研了哪些方案\n- 各方案的优劣对比\n- 最终选择的方案及理由\n\n### 2.2 总体方案概览(★先给整体,再逐项细化)\n\n**不能一步生成所有工作阶段方案。** 必须分两步:\n\n**第一步:给用户看总体方案概览**\n\n```markdown\n## 总体方案\n\n### 工作阶段概览\n| 阶段 | 名称 | 一句话描述 | 依赖 |\n|---|---|---|---|\n| Phase 0 | [名称] | [做什么] | - |\n| Phase 1 | [名称] | [做什么] | Phase 0 |\n| ... | ... | ... | ... |\n\n### 分支路由概览\n[如有分支,列出条件和路径]\n\n### 关键决策点\n[列出需要人类确认的节点]\n```\n\n**等用户确认总体方案后,进入第二步。**\n\n**第二步:逐项细化每个阶段**\n\n对每个阶段,逐一与用户确认:\n1. **阶段名称**\n2. **方法**(具体怎么做)\n3. **步骤**(拆成子步骤)\n4. **输入/产出**(格式和存放位置)\n5. **质检方案**(内联自查/SubAgent/写文件)\n6. **状态文件**(哪些决策需要持久化)\n7. **是否需要 Checkpoint**\n\n**每个阶段确认完毕后,才能进入下一个阶段的细化。**\n\n**输出 `plan/agent-workflow.md`,包含所有阶段的完整定义。**\n\n### 2.3 分支路由设计\n\n**如果任务有多条路径,设计路由规则:**\n\n```markdown\n## 分支路由\n\n| 条件 | 路径 | 优先级 |\n|---|---|---|\n| [条件1] | 方案A | P0 |\n| [条件2] | 方案B | P1 |\n| [条件3] | 方案C | P2 |\n| 无法判断 | ★停下来问用户 | - |\n```\n\n**铁律:无法判断时必须停下来问用户,不能猜。**\n\n### 2.4 质检矩阵设计\n\n对每个阶段设计质检方式:\n\n| 阶段 | 产出 | 风险 | 质检方式 | 产物 |\n|---|---|---|---|---|\n| [阶段名] | [文件] | 低/中/高/最高 | 内联自查/SubAgent+消息/SubAgent+文件 | [无/review/xxx.md] |\n\n### 2.5 状态文件设计\n\n定义项目工作区结构:\n\n```\n<project>/\n├── [状态文件1]     [作用]\n├── [状态文件2]     [作用]\n├── [产出目录]/\n│   └── [产出文件]\n└── review/\n    └── [审查文件](按需)\n```\n\n### ★Checkpoint 2 - Architecture\n\n**分两步确认:**\n\n**第一步:确认总体方案**\n1. **方案调研是否充分?** - 有没有遗漏更优的市场方案?\n2. **总体阶段划分是否合理?** - 有没有多余/缺失的阶段?\n3. **分支路由是否完整?** - 有没有未覆盖的情况?\n\n**第二步:逐项确认每个阶段**\n\n对每个阶段,独立确认:\n1. **方法是否最优?** - 是否有更好的 Agent 方案?\n2. **产出是否明确?** - 格式、存放位置、命名规范\n3. **质检是否匹配?** - 风险和质检力度是否对应\n4. **状态文件是否最少化?** - 有没有可以合并的文件\n\n铁律:每个阶段独立确认,不能一次性全部确认。Agent 必须解释每个设计决策的理由。\n\n---\n\n## Phase 3 - Scaffold\n\n**做什么:** 生成 Skill 文件结构 + SKILL.md 骨架。\n\n### 3.1 创建目录结构\n\n```bash\nmkdir -p <skill-name>/{references,templates}\n```\n\n### 3.2 生成 SKILL.md 骨架\n\n按以下模板生成,只填骨架不填细节:\n\n```markdown\n---\nname: <skill-name>\ndescription: \"<一句话描述> + 触发词:<触发词列表>\"\n---\n\n# <Skill 名称>\n\n## 边界\n[从 Phase 1.2 填入]\n\n## 工作流\n[从 Phase 2.2 填入阶段名和箭头]\n\n## 质检协议\n[从 Phase 2.4 填入表格]\n\n## Phase 0 - [名称]\n做什么(2-3行)\n必读:references/xxx.md\n\n## Phase 1 - [名称]\n...\n\n## ★Checkpoint N - [名称] ★硬节点\n确认项:[清单]\n铁律:[约束]\n\n## 铁律\n[从 Phase 2 提取最重要的 3-7 条约束]\n```\n\n### 3.3 生成 references/ 目录\n\n为每个阶段创建一个 reference 文件骨架:\n\n```\nreferences/\n├── [阶段1]-rules.md      Phase 1 的详细规则\n├── [阶段2]-template.md   Phase 2 的模板\n├── quality-checklist.md   质检清单\n├── style-contract.md      风格契约(如有输出格式要求)\n├── branch-routing.md      分支路由规则(如有多分支)\n└── repair-rules.md        修复规则\n```\n\n---\n\n## Phase 4 - Fill\n\n**做什么:** 逐个填写 references/ 的内容,**逐个与用户确认**。\n\n### 填写顺序\n\n```\n1. quality-checklist.md    质检清单(先定义标准,再写规则)\n2. style-contract.md       风格契约(如有)\n3. [阶段1]-rules.md       第一个阶段的详细规则\n4. [阶段2]-template.md    第二个阶段的模板\n5. ...                     按阶段顺序逐个填写\n6. branch-routing.md       分支路由规则(最后写,因为需要全局视角)\n7. repair-rules.md         修复规则(最后写)\n```\n\n### 每个 reference 的内容要求\n\n每个 reference 文件必须包含:\n1. **做什么**(3-5 行)\n2. **怎么做**(详细步骤)\n3. **输入/产出**(明确格式)\n4. **反模式**(❌ 不能做什么)\n5. **自检清单**(Agent 完成后自查的 3-5 条)\n\n### ★ 每个 reference 完成后 - 逐个与用户确认\n\n**不能一次性全部写完让用户自己看。必须逐个确认:**\n\n1. 写完一个 reference\n2. 展示给用户,说明这个 reference 覆盖的内容\n3. **等用户确认通过后,再写下一个**\n\n### ★ 整体审查(★所有 reference 完成后,交付前)\n\n**所有 reference 写完 + 用户逐个确认通过后,交付前进行一次整体审查:**\n\n1. 用 SubAgent 对整个 Skill 进行一致性审查(以消息返回 pass/fail)\n2. 审查要点:reference 之间是否矛盾、SKILL.md 与 references 是否一致、质检协议是否完整\n3. fail 项直接修\n4. 修复后进入 Checkpoint 3\n\n### ★Checkpoint 3 - Sample Test(★硬节点 · 必须停)\n\n**在填写完所有 reference 后,用一个小样本跑通 Phase 0-2(至少到第一个 Checkpoint)。**\n\n确认项:\n1. **触发是否正确?** - Skill 能否被正确识别和进入?\n2. **第一个阶段的产出是否符合预期?** - 格式/内容/结构是否对?\n3. **reference 是否够用?** - Agent 读了 reference 后能否正确执行?\n\n铁律:人类必须验收小样本后才能进入 Phase 5 全量测试。\n\n---\n\n## Phase 5 - Test Run\n\n**做什么:** 用一个**真实的、中等复杂度**的任务试运行完整 Skill 流程。\n\n### 试运行清单\n\n- [ ] Phase 0:触发是否正确?\n- [ ] Phase 1:输入标准化是否完整?\n- [ ] Checkpoint 1:确认项是否完整?有没有遗漏?\n- [ ] Phase 2:构建是否顺利?\n- [ ] Phase 2+:质检是否发现了真问题?\n- [ ] Checkpoint 3:交付流程是否完整?\n- [ ] 状态文件:中断后能否恢复?\n- [ ] 文件结构:是否清晰有序?\n\n### 迭代原则\n\n1. 每次试运行**只修一个问题**\n2. 修 bug 而不是重设计(除非发现根本性设计缺陷)\n3. 问题记录到 `test-run-report.md`\n\n---\n\n## Phase 6 - Delivery\n\n**做什么:** 交付完整 Skill + 使用说明 + 项目复盘。\n\n### 6.1 交付物\n\n1. **完整的 Skill 目录**(SKILL.md + references/ + templates/)\n2. **使用说明**(README.md:怎么安装、怎么触发、注意事项)\n3. **test-run-report.md**(试运行结果 + 修复记录)\n4. **project-summary.md**(项目总结 + 复盘)\n\n### 6.2 安装\n\n- Skill 安装到 `/Users/ii/.agents/skills/<skill-name>/`(所有 Agent 共享)\n- 更新 AGENTS.md 的 Skill 列表(如需要)\n- 记录到 MEMORY.md 的 Skill 创建记录\n\n### 6.3 交付确认(★必须与用户确认)\n\n**交付后不能直接结束。必须与用户确认:**\n\n1. **交付是否完整?** - 用户是否收到了所有需要的文件?\n2. **任务是否结束?** - 用户是否还有未完成的需求?\n\n**只有用户确认\"任务完成\"后,才能进入复盘。**\n\n### 6.4 项目复盘(★任务结束后的必做步骤)\n\n**生成 `project-summary.md`,包含:**\n\n```markdown\n# 项目总结 - [Skill 名称]\n\n## 1. 任务目标\n[简要描述最初的任务目标]\n\n## 2. 交付评估\n- [ ] 交付物是否完整?\n- [ ] 是否满足任务目标?\n- [ ] 用户是否确认完成?\n\n## 3. 过程记录\n\n### 3.1 是否有返工/中断/调整?\n| # | 阶段 | 调整内容 | 原因分析 |\n|---|---|---|---|\n| 1 | [阶段] | [改了什么] | [为什么] |\n\n### 3.2 调整原因分类\n\n对每个调整,分析根因:\n- **A. 任务目标不清晰** - 当初需求细化不够,导致中途改方向\n- **B. 用户预期调整** - 用户在过程中改变了想法(合理调整)\n- **C. Skill 能力不足** - Skill 的设计有缺陷,无法处理某种情况\n\n### 3.3 Skill 优化建议\n\n如果调整原因属于 C(Skill 能力不足),记录优化建议:\n| # | 问题 | 优化建议 | 优先级 |\n|---|---|---|---|\n| 1 | [问题] | [怎么改 Skill] | P0/P1/P2 |\n\n## 4. 总结\n[一句话总结本次项目的关键收获]\n```\n\n**复盘的目的:** 把本次项目的经验变成下次可以复用的资产。如果发现 Skill 的缺陷,记录优化建议,方便后续迭代。\n\n---\n\n## 铁律\n\n1. **人类方案是起点,不是终点** - Agent 必须基于人类方案提出更优的 Agent 方案,不能照搬\n2. **方案调研优先** - 先看市场成熟方案,再想 Agent 原生能力,最后才考虑模拟人类行为\n3. **无法判断时必须停下来问** - 分支路由不确定时,禁止猜测\n4. **先小后大** - Checkpoint 3 必须用小样本验收,不能跳过直接全量\n5. **文件分层** - 状态文件 / 产出文件 / 脚本必须分开放,禁止散落根目录\n6. **状态持久化** - 关键决策必须落盘到文件,不能只存在聊天上下文\n7. **禁止静默替用户选择** - Checkpoint 的每项决策必须独立确认\n8. **逐项细化,不一次性铺开** - Phase 2 先给总体方案,再逐阶段细化;Phase 4 逐个写 reference 并确认\n9. **交付后必须复盘** - 不能交付就结束,必须确认交付完整性 + 生成项目总结\n\n---\n\n## 文件读取指南(渐进加载)\n\n| 阶段 | 必读 | 按需查 |\n|---|---|---|\n| Phase 0 Trigger | -- | -- |\n| Phase 1 Problem Scan | references/problem-scan-guide.md | -- |\n| Phase 2 Architecture | references/architecture-guide.md, references/branch-routing.md | references/quality-matrix.md |\n| Phase 3 Scaffold | references/scaffold-template.md | -- |\n| Phase 4 Fill | references/reference-writing-guide.md, references/style-contract.md | references/quality-checklist.md |\n| Phase 5 Test Run | references/test-run-guide.md | -- |\n| Phase 6 Delivery | -- | -- |\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn76dgfmrcmcfw91f0m92tj4rd84805k\",\n  \"slug\": \"harness-skill-generator\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1787049943269\n}\n\nFile v0.1.0:references/architecture-guide.md\n\n# Phase 2 Architecture — Agent 方案设计指南\n\n## 核心原则\n\n**人类的方案是起点，不是终点。**\n\n人类描述的是\"人类怎么做这件事\"。Agent 有不同于人类的能力，应该用不同的方式解决问题。\n\n## 方案调研优先级（★设计 Agent 方案之前必须先做）\n\n| 优先级 | 方案来源 | 适用场景 | 举例 |\n|---|---|---|---|\n| **P0 · 市场成熟方案** | 权威 SaaS / 行业标准 / 官方 API | 通用任务 | 数据采集用 Apify/八爪鱼 |\n| **P1 · Agent 原生能力** | 脚本/API/推理 | 市场方案不适用 | 批量提取、结构化推理 |\n| **P2 · 模拟人类行为** | 浏览器自动化/RPA | 平台限制严格 | 小红书/BOSS直聘 |\n\n**★ 平台限制场景优先级反转：** 小红书/BOSS直聘等有反爬机制 → P0=模拟人类行为（合理间隔+波动）\n\n## 三问法（对人类工作流的每一步）\n\n| 问题 | 目的 | 判断标准 |\n|---|---|---|\n| **这一步 Agent 能直接做吗？** | 判断可替代性 | 如果有工具/API/脚本能完成 → Agent 直接做 |\n| **这一步有更好的 Agent 方案吗？** | 寻找效率更高的路径 | 人类手动 → Agent 自动；人类串行 → Agent 并行 |\n| **这一步需要人类确认吗？** | 判断是否需要 Checkpoint | 方向性决策/不可逆操作/用户偏好 → 需要确认 |\n\n## 常见的人类→Agent 转换模式\n\n| 人类方案 | Agent 方案 | 适用场景 |\n|---|---|---|\n| 手动逐个处理 | 脚本批量处理 | 数据采集、格式转换、批量操作 |\n| 复制粘贴到表格 | 结构化提取 + 自动生成 | 信息收集、数据整理 |\n| 凭经验判断 | 规则匹配 + 分支路由 | 分类、优先级判断、方案选择 |\n| 开会讨论确认 | Checkpoint + 交互式确认 | 决策收集、方案对齐 |\n| 写文档记录 | 状态文件自动维护 | 进度跟踪、决策记录 |\n| 人工检查质量 | SubAgent 质检 + checklist | 质量控制、格式校验 |\n| 试做一份给领导看 | First Spread + Checkpoint | 方向确认、风格对齐 |\n\n## 阶段设计原则\n\n1. **每个阶段有明确的输入和产出** — 不能模糊\n2. **阶段之间有明确的进入条件** — 不能跳步\n3. **关键节点有强制停顿** — 不能自动跑过\n4. **阶段粒度适中** — 4-8 个 Phase + 2-3 个 Checkpoint\n5. **每个阶段产出一个文件** — 文件是跨阶段的唯一桥梁\n\n## Checkpoint的设计原则\n方向性决策 — 选错了后面全白做（如文章类型、技术方案选型、交付结果格式）\n不可逆操作 — 做了就回不去（如开始构建、提交代码、发送信息、发布文章）\n用户偏好 — 只有用户知道答案（如风格、范围、优先级）\n\n## 反模式\n\n- ❌ 照搬人类方案，不思考 Agent 优化空间\n- ❌ 阶段太多（>10）→ 过度工程\n- ❌ 阶段太少（<3）→ 控制不住\n- ❌ 没有 Checkpoint → Agent 一路跑到交付\n- ❌ 每个阶段都写 review 文件 → N 份文件无人再读\n\nFile v0.1.0:references/branch-routing.md\n\n# 分支路由设计指南\n\n## 什么时候需要分支路由\n\n当一个任务有**多种处理方式**，且选择哪种取决于**输入的性质**时，需要分支路由。\n\n## 设计模板\n\n```markdown\n## 分支路由\n\n### 判断流程\n\n1. 读取输入，判断性质\n2. 对照路由表，选择路径\n3. 如果无法判断 → ★停下来问用户\n\n### 路由表\n\n| 条件 | 路径 | 优先级 | 说明 |\n|---|---|---|---|\n| [条件1：具体描述] | 方案A | P0 | [为什么这是最优方案] |\n| [条件2：具体描述] | 方案B | P1 | [为什么这是次优方案] |\n| [条件3：具体描述] | 方案C | P2 | [适用场景] |\n| 无法判断 | ★停下来问用户 | — | [列出需要用户确认的信息] |\n\n### 优先级说明\n\n- P0：默认首选，大多数情况走这条路\n- P1：特定条件下使用\n- P2：边缘情况\n- ★：必须人工确认\n```\n\n## 路由设计原则\n\n1. **条件必须是可判断的** — Agent 能从输入中直接获取，不需要额外询问\n2. **优先级必须明确** — 不能\"看情况\"，要有默认首选\n3. **无法判断时必须停下来** — 这是铁律，禁止猜测\n4. **每条路径的产出格式必须一致** — 不同路径的最终产出应该可以合并\n5. **路由表要覆盖所有情况** — 不能有\"漏网之鱼\"\n\n## 反模式\n\n- ❌ 只有一条路径（不需要路由，直接做）\n- ❌ 条件模糊（\"如果数据量大\" → 多大算大？）\n- ❌ 没有\"无法判断\"的出口 → Agent 猜测\n- ❌ 不同路径的产出格式不同 → 无法合并\n- ❌ 优先级不明确 → Agent 不知道默认走哪条\n\nFile v0.1.0:references/problem-scan-guide.md\n\n# Phase 1 Problem Scan — 问题定义与痛点收集指南\n\n## 1.1 问题定义（★先定义问题，再谈痛点）\n\n**问用户两个问题：**\n\n**问题 1：** **\"你想利用这个 Skill 解决什么问题？\"**\n\n这是根本性问题。不是\"你让 AI 做什么\"，而是\"你面临什么问题\"。\n\n- ❌ \"我想让 AI 帮我爬取 BOSS 直聘的数据\"（这是任务描述，不是问题）\n- ✅ \"我找工作时需要快速筛选出匹配度高的岗位，手动逐个看太慢了\"（这是问题）\n\n**问题 2：** **\"你在自己处理这个问题的过程中，想要解决的痛点是什么？\"**\n\n痛点是问题解决方案的延伸思考。先有了问题，才能识别出痛点。\n\n### 问题 → 痛点的思考路径\n\n```\n你面临什么问题？\n    ↓\n你尝试过什么方法？\n    ↓\n这些方法哪里不好用？（= 痛点）\n    ↓\n你希望 Skill 帮你解决哪个环节？\n```\n\n### 问题定义模板\n\n```markdown\n## 问题定义\n\n### 核心问题\n[一句话描述：你面临什么问题？]\n\n### 当前方法\n[你目前怎么处理这个问题？]\n\n### 痛点\n| # | 痛点 | 具体表现 | 影响 |\n|---|---|---|---|\n| 1 | [一句话] | [具体场景] | [后果] |\n| 2 | [一句话] | [具体场景] | [后果] |\n| 3 | [一句话] | [具体场景] | [后果] |\n```\n\n## 1.2 边界定义\n\n### 边界模板\n\n```markdown\n## 边界\n\n### 做\n- [任务类型1]：[一句话描述]\n- [任务类型2]：[一句话描述]\n- [任务类型3]：[一句话描述]\n\n### 不做\n- [容易混淆的场景1]：[为什么不属于本 Skill]\n- [容易混淆的场景2]：[为什么不属于本 Skill]\n\n### 判断规则\n- 如果用户要的是 [不做范围内的东西] → 停下来澄清，不进入本 Skill\n- 如果用户没有提供 [必要输入] → 反问，不凭空创作\n```\n\n## 1.3 人类工作流拆解\n\n**问用户：** \"如果是你人工来做这件事，你的步骤是什么？\"\n\n### 工作流拆解模板\n\n```markdown\n## 人类工作流\n\n| 步骤 | 做什么 | 输入 | 输出 | 最容易出错的地方 |\n|---|---|---|---|---|\n| 1 | [动作] | [输入] | [输出] | [风险点] |\n| 2 | [动作] | [输入] | [输出] | [风险点] |\n| 3 | [动作] | [输入] | [输出] | [风险点] |\n```\n\n### 拆解原则\n\n1. **按时间顺序** — 先做什么、后做什么\n2. **每步有明确的输入输出** — 不能模糊\n3. **记录隐含步骤** — 人类可能跳过的\"理所当然\"的步骤\n4. **记录决策点** — 哪些步骤需要判断、选择、确认\n\n## 1.4 步骤归属审查\n\n**对人类描述的每个步骤，判断：这一步是解决当前问题所必需的，还是属于另一个独立任务？**\n\n### 判断标准\n\n| 情况 | 判断 | 处理 |\n|---|---|---|\n| 去掉这一步，核心问题仍能被解决 | 属于另一个任务 | 拆出去 |\n| 这一步的产出是另一步的\"预设前提\" | 属于前置任务 | 本 Skill 接收其产出作为输入 |\n| 这一步是核心问题的必要组成部分 | 属于本任务 | 保留在工作流中 |\n\n### 举例\n\n| 问题 | 步骤 | 归属 |\n|---|---|---|\n| 爬取岗位 + 匹配分析 | 建立候选人画像 | ❌ 另一个任务，不应混入 |\n| 爬取岗位 + 匹配分析 | 提取 JD 关键要求 | ✅ 本任务必要步骤 |\n| 写小红书笔记 | 研究竞品笔记 | ⚠️ 可以是前置输入，不应在写作流程中做 |\n\n## 反模式\n\n- ❌ 先谈任务不谈问题 — 问题定义不清，后续所有设计都是空中楼阁\n- ❌ 边界太宽 — Skill 什么都能做但什么都做不好\n- ❌ 工作流跳步 — Agent 执行时会遗漏\n- ❌ 把多个独立任务混在一个 Skill 里 — 流程复杂、边界模糊、产出不可控\n\nFile v0.1.0:references/quality-checklist.md\n\n# 质检清单模板 — Phase 4 Fill 使用\n\n## 适用场景\n\n每个 reference 文件的\"自检清单\"部分，以及 SKILL.md 的质检协议表。\n\n## 自检清单设计原则\n\n1. **每条必须是 Agent 能自行判断的** — 不要用\"写得好\"这种主观标准\n2. **每条必须是可验证的** — 要么通过检查文件，要么通过对比标准\n3. **3-5 条足够** — 太多 Agent 会跳过，太少检查不到位\n\n## 自检清单模板\n\n```markdown\n## 自检清单\n\n- [ ] [检查项1：具体、可验证]\n- [ ] [检查项2：具体、可验证]\n- [ ] [检查项3：具体、可验证]\n```\n\n## 好的 vs 坏的检查项\n\n| ❌ 坏的（主观/不可验证） | ✅ 好的（客观/可验证） |\n|---|---|\n| 内容质量好 | 信息保留比例符合 plan.md 中的约定 |\n| 格式正确 | 标题层级不超过 H3，每节不超过 500 字 |\n| 代码能跑 | npm run build 零错误零警告 |\n| 风格统一 | 全文使用同一套 --ra-* token |\n| 没有遗漏 | checklist 中的每条信息都能在 source.md 找到对应段落 |\n\n## SubAgent prompt 模板\n\n当质检方式是\"SubAgent + 消息返回\"时，使用以下 prompt：\n\n```markdown\n你是 [角色]。审查以下文件：[文件路径]\n审查标准是：\n1. [标准1]\n2. [标准2]\n3. [标准3]\n\n检查清单：\n1. [检查项1]\n2. [检查项2]\n3. [检查项3]\n\n返回格式：\n- PASS：[理由]\n- 或 FAIL：[具体问题 + 修复建议]\n```\n\nFile v0.1.0:references/quality-matrix.md\n\n# 质检矩阵设计指南\n\n## 质检力度与风险匹配\n\n| 风险级别 | 判断标准 | 质检方式 | 成本 |\n|---|---|---|---|\n| **低** | 热上下文 + 简单决策 + 低影响 | 主 Agent 内联自查 | 最低 |\n| **中** | 热上下文 + 复杂决策 + 中影响 | 内联自查 + 用户确认 | 低 |\n| **高** | 冷上下文 + 独立产出 + 定调性质 | SubAgent + 消息返回 | 中 |\n| **最高** | 最终交付物 + 不可逆 | SubAgent + 写文件 | 高 |\n\n## 质检协议表模板\n\n```markdown\n## 质检协议\n\n| 节点 | 产出 | 风险 | 方式 | 产物 | 为什么 |\n|---|---|---|---|---|---|\n| [阶段名] | [文件名] | 低/中/高/最高 | [方式] | [无/review/xxx.md] | [一句话理由] |\n```\n\n## 三种质检方式详解\n\n### 1. 内联自查（不写文件）\n\n**适用：** 主 Agent 热上下文 + 简单校验\n\n**做法：** 主 Agent 对照 checklist 逐条检查，pass 继续，fail 直接修。\n\n**checklist 模板：**\n```markdown\n## 自检清单\n- [ ] [检查项1]\n- [ ] [检查项2]\n- [ ] [检查项3]\n```\n\n### 2. SubAgent + 消息返回（不写文件）\n\n**适用：** 高频重复产出 + 同类检查\n\n**做法：** spawn SubAgent 审查，以消息返回 pass/fail + 修复点。主 Agent 收到 fail 后直接修。\n\n**SubAgent prompt 模板：**\n```markdown\n你是 [角色]。审查以下文件：[文件路径]\n\n检查清单：\n1. [检查项1]\n2. [检查项2]\n3. [检查项3]\n\n返回格式：\n- PASS：[理由]\n- 或 FAIL：[具体问题 + 修复建议]\n```\n\n### 3. SubAgent + 写文件（留档）\n\n**适用：** 最终交付物 + 需要留档的审查\n\n**做法：** spawn SubAgent 审查，结果写入 `review/xxx.md`。这是交付物的一部分。\n\n## 反模式\n\n- ❌ 所有节点都开 SubAgent → 浪费 token 和时间\n- ❌ 所有节点都内联自查 → 关键节点缺少独立视角\n- ❌ 质检结论不修就汇报 → 违规\n- ❌ 每个节点都写 review 文件 → N 份文件无人再读\n\nFile v0.1.0:references/reference-writing-guide.md\n\n# Reference 文件写作指南\n\n## 每个 reference 必须包含的 5 个部分\n\n```markdown\n# [阶段名] 详细规则\n\n## 做什么\n3-5 行描述这个阶段的目标。\n\n## 怎么做\n详细步骤，每步包括：\n1. [步骤1] — 输入：xxx → 输出：xxx\n2. [步骤2] — 输入：xxx → 输出：xxx\n3. ...\n\n## 输入/产出\n\n| 项目 | 格式 | 说明 |\n|---|---|---|\n| 输入 | [格式] | [来源] |\n| 产出 | [格式] | [存放位置] |\n\n## 反模式\n- ❌ [反例1] — 为什么错：[理由]\n- ❌ [反例2] — 为什么错：[理由]\n- ❌ [反例3] — 为什么错：[理由]\n\n## 自检清单\n- [ ] [检查项1]\n- [ ] [检查项2]\n- [ ] [检查项3]\n```\n\n## 写作原则\n\n1. **具体，不抽象** — ❌\"处理数据\" ✅\"从 CSV 第 2 行开始逐行读取，提取第 3 列的 URL\"\n2. **有示例** — 每个规则至少一个正面示例\n3. **有反模式** — 只告诉 Agent\"做什么\"不够，还要告诉它\"不能做什么\"\n4. **可检查** — 自检清单的每条都必须是 Agent 能自行判断的\n5. **独立完整** — 每个 reference 应该独立可读，不依赖其他文件的上下文\n\n## 反模式\n\n- ❌ 写成散文，没有结构 → Agent 找不到关键信息\n- ❌ 只有正面规则，没有反模式 → Agent 不知道边界在哪\n- ❌ 自检清单用主观标准（\"写得好\"）→ Agent 无法判断\n- ❌ 一个 reference 覆盖多个阶段 → 关注点不分离\n\nFile v0.1.0:references/scaffold-template.md\n\n# 脚手架模板 — Phase 3 使用\n\n## SKILL.md 骨架模板\n\n```markdown\n---\nname: <skill-name>\ndescription: \"<一句话描述做什么 + 不做什么 + 触发词>\"\n---\n\n# <Skill 名称>\n\n## 边界\n\n### 做\n- [明确列出 3-5 种任务类型]\n\n### 不做\n- [明确列出容易混淆的场景]\n\n### 判断规则\n- 如果用户要的是 [不做范围内的东西] → 停下来澄清，不进入本 Skill\n- 如果用户没有提供 [必要输入] → 反问，不凭空创作\n\n## 工作流\n\nPhase 0  [名称]    [一句话]\n   ▼\nPhase 1  [名称]    [一句话]\n   └ ★Checkpoint 1  确认：[清单]\n   ▼\nPhase 2  [名称]    [一句话]\n   └ ★Checkpoint 2  确认：[清单]\n   ▼\nPhase 3  [名称]    [一句话]\n   ▼\nPhase 4  Delivery  交付\n\n## 质检协议\n\n| 节点 | 方式 | 产物 | 为什么 |\n|---|---|---|---|\n| [阶段] | [方式] | [产物] | [理由] |\n\n## Phase 0 — [名称]\n做什么（2-3行）\n必读：references/xxx.md\n自检：[检查项]\n\n## Phase 1 — [名称]\n做什么（2-3行）\n必读：references/xxx.md\n产出：[文件]\n\n## ★Checkpoint 1 — [名称] ★硬节点\n确认项：\n1. [决策A] — 选项：X / Y / Z（推荐 X，因为...）\n2. [决策B] — 选项：A / B（推荐 A，因为...）\n铁律：每项独立确认，禁止打包\n\n...\n\n## 铁律\n1. [最重要的约束]\n2. [第二重要的约束]\n3. ...\n```\n\n## manifest.json 模板\n\n```json\n{\n  \"name\": \"<skill-name>\",\n  \"version\": \"0.1.0\",\n  \"category\": \"<分类>\",\n  \"description\": \"<一句话描述>\",\n  \"compat\": [\"openclaw\"]\n}\n```\n\n## 项目工作区模板\n\n```\n<project>/\n├── input/               输入文件（标准化后的）\n├── plan/                方案文件\n│   ├── human-workflow.md  人类工作流（Phase 1 产出）\n│   ├── agent-workflow.md  Agent 工作流（Phase 2 产出）\n│   └── plan.md            最终方案\n├── output/              产出文件\n├── review/              审查记录（按需）\n├── scripts/             脚本（按需）\n└── test-run-report.md   试运行报告（Phase 5 产出）\n```\n\nFile v0.1.0:references/style-contract.md\n\n# 风格契约模板 — Phase 4 Fill 使用\n\n## 适用场景\n\n当 Skill 有**格式化输出要求**时（如：报告、文章、表格、代码），需要风格契约。\n如果 Skill 的输出是纯数据（如：CSV、JSON），不需要风格契约。\n\n## 风格契约模板\n\n```markdown\n# [输出类型] 风格契约\n\n## 适用场景\n什么情况下用这个风格。\n\n## 结构规范\n- [必须包含的部分 1]\n- [必须包含的部分 2]\n- [可选部分]\n- [禁止的部分]\n\n## 语言规范\n- [用词风格：正式/口语/技术/简洁]\n- [句式要求：短句/长句/列表/段落]\n- [禁用表达：❌ 不要说\"好的\"、\"明白了\"等]\n\n## 格式规范\n- [排版要求：标题层级、缩进、空行]\n- [数据呈现：表格/列表/段落]\n- [引用/标注规范]\n\n## 正面示例\n[1-2 个好的例子，让 Agent 知道\"对的样子\"]\n\n## 反模式\n- ❌ [反例1] — 为什么错：[理由]\n- ❌ [反例2] — 为什么错：[理由]\n- ❌ [反例3] — 为什么错：[理由]\n\n## 检查标准\n- [ ] [可量化的检查项1]\n- [ ] [可量化的检查项2]\n- [ ] [可量化的检查项3]\n```\n\n## 写作原则\n\n1. **具体，不抽象** — ❌\"写得好\" ✅\"标题用 H2，每节不超过 300 字\"\n2. **有正面示例** — Agent 需要看到\"对的样子\"\n3. **有反模式** — 比正面规范更有效\n4. **可检查** — 检查标准必须是 Agent 能自行判断的\n\nFile v0.1.0:references/test-run-guide.md\n\n# 试运行指南\n\n## 试运行的目的\n\n不是\"测试 Skill 能不能跑\"，而是\"测试 Skill 跑出来的东西对不对\"。\n\n## 试运行样本选择\n\n**选择标准：**\n- **真实任务** — 不是编造的测试用例，是用户真正要做的事\n- **中等复杂度** — 不是最简单的（测不出问题），也不是最复杂的（太慢）\n- **覆盖主要分支** — 至少走到一条主要路径\n\n**反模式：**\n- ❌ 用最简单的用例试运行 → 测不出边界问题\n- ❌ 用编造的数据试运行 → 和真实场景脱节\n- ❌ 一次测所有分支 → 太慢，且问题难以定位\n\n## 试运行清单\n\n```markdown\n## 试运行报告 — [Skill 名称]\n\n**样本：** [描述使用的测试样本]\n\n### 阶段检查\n\n- [ ] Phase 0：触发是否正确？\n- [ ] Phase 1：输入标准化是否完整？有无信息丢失？\n- [ ] Checkpoint 1：确认项是否完整？人类是否能理解？\n- [ ] Phase 2：构建是否顺利？产出是否符合预期？\n- [ ] Phase 2+：质检是否发现了真问题？\n- [ ] Checkpoint 3：交付流程是否完整？\n- [ ] 状态文件：中断后能否恢复？\n- [ ] 文件结构：是否清晰有序？\n\n### 发现的问题\n\n| # | 阶段 | 问题 | 严重程度 | 修复方案 |\n|---|---|---|---|---|\n| 1 | [阶段] | [问题描述] | 高/中/低 | [方案] |\n\n### 修复记录\n\n| # | 问题 | 修复内容 | 验证结果 |\n|---|---|---|---|\n| 1 | [问题] | [改了什么] | PASS/FAIL |\n```\n\n## 迭代原则\n\n1. **每次只修一个问题** — 不要一次性改所有东西\n2. **修 bug 而不是重设计** — 除非发现根本性设计缺陷\n3. **修完必须重新跑** — 验证修复是否生效\n4. **记录所有问题** — 即使已修复，也要记录到试运行报告\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nHarness Skill Generator guides agents and users through designing, scaffolding, testing, and delivering complex Harness-based skills with checkpoints and quality controls.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[iichaner](https://clawhub.ai/user/iichaner)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent builders use this skill to turn complex, multi-stage work into a structured Harness-based skill with defined boundaries, branch routing, checkpoints, reference files, test runs, and delivery artifacts.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Generated skills may include incorrect, incomplete, or misleading guidance.\n\nMitigation: Review and scan generated files before deployment, then validate the skill with a representative test run.\n\nRisk: Persistent shared-agent changes can affect other agents or users.\n\nMitigation: Stage generated skills locally first and require an explicit diff and approval before writing to shared skill directories, AGENTS.md, or MEMORY.md.\n\nRisk: The artifact includes guidance that can encourage anti-bot evasion.\n\nMitigation: Replace anti-scraping or anti-bot evasion patterns with official APIs or platform-approved automation before use.\n\n## Reference(s):\n\n- [Server-resolved GitHub repository](https://github.com/iichaner/harness-skill-generator)\n- [ClawHub skill page](https://clawhub.ai/iichaner/skills/harness-skill-generator)\n- [Phase 1 Problem Scan Guide](references/problem-scan-guide.md)\n- [Phase 2 Architecture Guide](references/architecture-guide.md)\n- [Branch Routing Design Guide](references/branch-routing.md)\n- [Quality Matrix Guide](references/quality-matrix.md)\n- [Quality Checklist Template](references/quality-checklist.md)\n- [Reference Writing Guide](references/reference-writing-guide.md)\n- [Scaffold Template](references/scaffold-template.md)\n- [Style Contract Template](references/style-contract.md)\n- [Test Run Guide](references/test-run-guide.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown files, JSON manifests, and inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Produces a complete skill directory structure such as SKILL.md, references/, templates/, plan files, review artifacts, and test-run reports.]\n\n## Skill Version(s):\n\n0.1.0 (source: server release metadata and manifest.json)\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.","readmeExcerpt":"Skill: harness-skill-generator Owner: iichaner Summary: 引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-18T10:45:43.269Z | auto Initial release — guides users to create complex Harness-based Skills from scratch. - Provides a step-by-ste","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"Phase 0  Trigger            用户说\"创建/新建一个 Skill\" → 判断是否需要 harness\n   ▼\nPhase 1  Problem Scan       收集痛点 + 边界定义 + 人类工作流拆解 + 步骤归属审查\n   └ ★Checkpoint 1         确认:痛点 / 边界 / 人类工作流 / 步骤归属\n   ▼\nPhase 2  Agent Architecture 方案调研 → 总体方案概览 → 逐项细化每个阶段\n   └ ★Checkpoint 2         分两步:先确认总体方案,再逐项确认每个阶段\n   ▼\nPhase 3  Scaffold           生成文件结构 + SKILL.md 骨架\n   ▼\nPhase 4  Fill               逐个填写 references/,逐个与用户确认\n   └ ★Checkpoint 3         验收:用一个小样本跑通,人类确认方向对\n   ▼\nPhase 5  Test Run           用真实任务试运行完整流程 + 修复\n   ▼\nPhase 6  Delivery           交付 + 交付确认 + 项目复盘"},{"language":"markdown","snippet":"## 总体方案\n\n### 工作阶段概览\n| 阶段 | 名称 | 一句话描述 | 依赖 |\n|---|---|---|---|\n| Phase 0 | [名称] | [做什么] | - |\n| Phase 1 | [名称] | [做什么] | Phase 0 |\n| ... | ... | ... | ... |\n\n### 分支路由概览\n[如有分支,列出条件和路径]\n\n### 关键决策点\n[列出需要人类确认的节点]"},{"language":"markdown","snippet":"## 分支路由\n\n| 条件 | 路径 | 优先级 |\n|---|---|---|\n| [条件1] | 方案A | P0 |\n| [条件2] | 方案B | P1 |\n| [条件3] | 方案C | P2 |\n| 无法判断 | ★停下来问用户 | - |"},{"language":"text","snippet":"<project>/\n├── [状态文件1]     [作用]\n├── [状态文件2]     [作用]\n├── [产出目录]/\n│   └── [产出文件]\n└── review/\n    └── [审查文件](按需)"},{"language":"bash","snippet":"mkdir -p <skill-name>/{references,templates}"},{"language":"markdown","snippet":"---\nname: <skill-name>\ndescription: \"<一句话描述> + 触发词:<触发词列表>\"\n---\n\n# <Skill 名称>\n\n## 边界\n[从 Phase 1.2 填入]\n\n## 工作流\n[从 Phase 2.2 填入阶段名和箭头]\n\n## 质检协议\n[从 Phase 2.4 填入表格]\n\n## Phase 0 - [名称]\n做什么(2-3行)\n必读:references/xxx.md\n\n## Phase 1 - [名称]\n...\n\n## ★Checkpoint N - [名称] ★硬节点\n确认项:[清单]\n铁律:[约束]\n\n## 铁律\n[从 Phase 2 提取最重要的 3-7 条约束]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: harness-skill-generator\ndescription: \"引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。\"\n---\n\n# Harness Skill Generator\n\n## 边界\n\n### 做\n- 引导用户从 0 创建一个**基于 Harness 工程**的新 Skill\n- 适用于**有复杂度的任务**:多阶段、多分支、需要质检、需要状态持久化\n- 输出完整的 Skill 文件结构(SKILL.md + references/ + templates/)\n- 引导用户走完 Problem Scan → Architecture → Scaffold → Fill → Test Run → Delivery 全流程\n\n### 不做\n- 不修改/升级已有 Skill(那是另一个流程)\n- 不执行 Skill(创建完交给 Agent 用)\n- 不做简单的 prompt 优化(没有阶段/质检/状态需求的任务不需要 harness)\n- 不做 Skill 的市场推广/发布\n\n### 判断规则\n- 如果任务是**单步完成**(如:翻译一段话、回答一个问题)→ 不需要 harness,建议直接写 prompt\n- 如果任务是**多步但无分支**(如:固定的 3 步流程)→ 可以用简化版 harness(无 Checkpoint)\n- 如果任务是**多步 + 多分支 + 需要质检 + 需要状态**→ 进入本 Skill\n\n---\n\n## 工作流\n\n```\nPhase 0  Trigger            用户说\"创建/新建一个 Skill\" → 判断是否需要 harness\n   ▼\nPhase 1  Problem Scan       收集痛点 + 边界定义 + 人类工作流拆解 + 步骤归属审查\n   └ ★Checkpoint 1         确认:痛点 / 边界 / 人类工作流 / 步骤归属\n   ▼\nPhase 2  Agent Architecture 方案调研 → 总体方案概览 → 逐项细化每个阶段\n   └ ★Checkpoint 2         分两步:先确认总体方案,再逐项确认每个阶段\n   ▼\nPhase 3  Scaffold           生成文件结构 + SKILL.md 骨架\n   ▼\nPhase 4  Fill               逐个填写 references/,逐个与用户确认\n   └ ★Checkpoint 3         验收:用一个小样本跑通,人类确认方向对\n   ▼\nPhase 5  Test Run           用真实任务试运行完整流程 + 修复\n   ▼\nPhase 6  Delivery           交付 + 交付确认 + 项目复盘\n```\n\n---\n\n## 质检协议\n\n| 节点 | 方式 | 产物 | 为什么 |\n|---|---|---|---|\n| Phase 1-2 各阶段 | 主 Agent 内联自查（上下文矛盾排查） | 无 | 主 Agent 热上下文，自己检查关联性 |\n| Phase 3 骨架 | 主 Agent 内联自查 | 无 | 文件少，结构简单 |\n| Phase 4 每个 reference | 用户逐个确认 | 无 | 逐个确认方向对 |\n| Phase 4 整体审查 | SubAgent + 消息返回 | 无 | 交付前一致性审查 |\n| Phase 4 Checkpoint 3 | 用户跑小样本验收 | checkpoint-3-review.md | 定调，防止方向错 |\n| Phase 5 试运行 | 用户 + Agent 联合验收 | test-run-report.md | 最终验收 |\n\n---\n\n## Phase 0 - Trigger\n\n**做什么:** 判断用户需求是否需要 harness 工程。\n\n| 用户说的话 | 该做的 |\n|---|---|\n| \"创建/新建一个 Skill\" | 进入 Phase 1 |\n| \"帮我做一个 XX 的自动化流程\" | 进入 Phase 1(可能是 harness 场景) |\n| \"帮我写一个 prompt\" | 问清楚:是单步任务还是多步?如果是多步 → 推荐进入本 Skill |\n| \"修改/升级已有的 Skill\" | 停下来:不在本 Skill 范围内 |\n\n**自检:** 用户的任务是否有以下特征?\n- 多阶段(>2 步)?\n- 多分支(不同情况走不同路径)?\n- 需要质检(产出质量不稳定)?\n- 需要状态持久化(中断后要恢复)?\n\n如果有 2 个以上 → 推荐用 harness 工程。\n如果只有 1 个或没有 → 建议用简化方案。\n\n---\n\n## Phase 1 - Problem Scan\n\n**做什么:** 定义问题 → 收集痛点 → 拆解人类工作流 → 步骤归属审查。\n\n### 1.1 问题定义(★先定义问题,再谈痛点)\n\n问用户两个问题:\n\n**问题 1:** \"你想利用这个 Skill 解决什么问题?\"\n- 不是\"你让 AI 做什么\",而是\"你面临什么问题\"\n\n**问题 2:** \"你在自己处理这个问题的过程中,想要解决的痛点是什么?\"\n- 痛点是问题解决方案的延伸思考\n\n**记录为 `plan/problem-definition.md`。**\n\n### 1.2 边界定义\n\n基于问题和痛点,定义 Skill 的边界:\n- **做什么:** 3-5 种明确的任务类型\n- **不做什么:** 容易混淆但不属于本 Skill 的场景\n- **判断规则:** 什么情况下不进本 Skill\n\n### 1.3 人类工作流拆解\n\n问用户:**\"如果是你人工来做这件事,你的步骤是什么?\"**\n\n要求用户按步骤列出,每步包括:做什么 / 输入 / 输出 / 最容易出错的地方。\n\n**记录为 `plan/human-workflow.md`。**\n\n### 1.4 步骤归属审查\n\n对人类描述的每个步骤,判断:这一步是解决当前问题所必需的,还是属于另一个独立任务?\n- 去掉这一步,核心问题仍能被解决 → 属于另一个任务,拆出去\n- 这一步的产出是另一步的\"预设前提\" → 本 Skill 接收其产出作为输入\n\n### ★Checkpoint 1 - Problem & Boundary\n\n确认项:\n1. **痛点是否准确?** - 有没有遗漏?有没有不是真正痛点的?\n2. **边界是否合理?** - 做什么/不做什么是否清晰?\n3. **人类工作流是否完整?** - 有没有跳步?有没有隐含步骤?\n4. **★ 步骤归属是否正确?** - 有没有把另一个独立任务的内容混进"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn76dgfmrcmcfw91f0m92tj4rd84805k\",\n  \"slug\": \"harness-skill-generator\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1787049943269\n}"},{"path":"references/architecture-guide.md","content":"# Phase 2 Architecture — Agent 方案设计指南\n\n## 核心原则\n\n**人类的方案是起点，不是终点。**\n\n人类描述的是\"人类怎么做这件事\"。Agent 有不同于人类的能力，应该用不同的方式解决问题。\n\n## 方案调研优先级（★设计 Agent 方案之前必须先做）\n\n| 优先级 | 方案来源 | 适用场景 | 举例 |\n|---|---|---|---|\n| **P0 · 市场成熟方案** | 权威 SaaS / 行业标准 / 官方 API | 通用任务 | 数据采集用 Apify/八爪鱼 |\n| **P1 · Agent 原生能力** | 脚本/API/推理 | 市场方案不适用 | 批量提取、结构化推理 |\n| **P2 · 模拟人类行为** | 浏览器自动化/RPA | 平台限制严格 | 小红书/BOSS直聘 |\n\n**★ 平台限制场景优先级反转：** 小红书/BOSS直聘等有反爬机制 → P0=模拟人类行为（合理间隔+波动）\n\n## 三问法（对人类工作流的每一步）\n\n| 问题 | 目的 | 判断标准 |\n|---|---|---|\n| **这一步 Agent 能直接做吗？** | 判断可替代性 | 如果有工具/API/脚本能完成 → Agent 直接做 |\n| **这一步有更好的 Agent 方案吗？** | 寻找效率更高的路径 | 人类手动 → Agent 自动；人类串行 → Agent 并行 |\n| **这一步需要人类确认吗？** | 判断是否需要 Checkpoint | 方向性决策/不可逆操作/用户偏好 → 需要确认 |\n\n## 常见的人类→Agent 转换模式\n\n| 人类方案 | Agent 方案 | 适用场景 |\n|---|---|---|\n| 手动逐个处理 | 脚本批量处理 | 数据采集、格式转换、批量操作 |\n| 复制粘贴到表格 | 结构化提取 + 自动生成 | 信息收集、数据整理 |\n| 凭经验判断 | 规则匹配 + 分支路由 | 分类、优先级判断、方案选择 |\n| 开会讨论确认 | Checkpoint + 交互式确认 | 决策收集、方案对齐 |\n| 写文档记录 | 状态文件自动维护 | 进度跟踪、决策记录 |\n| 人工检查质量 | SubAgent 质检 + checklist | 质量控制、格式校验 |\n| 试做一份给领导看 | First Spread + Checkpoint | 方向确认、风格对齐 |\n\n## 阶段设计原则\n\n1. **每个阶段有明确的输入和产出** — 不能模糊\n2. **阶段之间有明确的进入条件** — 不能跳步\n3. **关键节点有强制停顿** — 不能自动跑过\n4. **阶段粒度适中** — 4-8 个 Phase + 2-3 个 Checkpoint\n5. **每个阶段产出一个文件** — 文件是跨阶段的唯一桥梁\n\n## Checkpoint的设计原则\n方向性决策 — 选错了后面全白做（如文章类型、技术方案选型、交付结果格式）\n不可逆操作 — 做了就回不去（如开始构建、提交代码、发送信息、发布文章）\n用户偏好 — 只有用户知道答案（如风格、范围、优先级）\n\n## 反模式\n\n- ❌ 照搬人类方案，不思考 Agent 优化空间\n- ❌ 阶段太多（>10）→ 过度工程\n- ❌ 阶段太少（<3）→ 控制不住\n- ❌ 没有 Checkpoint → Agent 一路跑到交付\n- ❌ 每个阶段都写 review 文件 → N 份文件无人再读"},{"path":"references/branch-routing.md","content":"# 分支路由设计指南\n\n## 什么时候需要分支路由\n\n当一个任务有**多种处理方式**，且选择哪种取决于**输入的性质**时，需要分支路由。\n\n## 设计模板\n\n```markdown\n## 分支路由\n\n### 判断流程\n\n1. 读取输入，判断性质\n2. 对照路由表，选择路径\n3. 如果无法判断 → ★停下来问用户\n\n### 路由表\n\n| 条件 | 路径 | 优先级 | 说明 |\n|---|---|---|---|\n| [条件1：具体描述] | 方案A | P0 | [为什么这是最优方案] |\n| [条件2：具体描述] | 方案B | P1 | [为什么这是次优方案] |\n| [条件3：具体描述] | 方案C | P2 | [适用场景] |\n| 无法判断 | ★停下来问用户 | — | [列出需要用户确认的信息] |\n\n### 优先级说明\n\n- P0：默认首选，大多数情况走这条路\n- P1：特定条件下使用\n- P2：边缘情况\n- ★：必须人工确认\n```\n\n## 路由设计原则\n\n1. **条件必须是可判断的** — Agent 能从输入中直接获取，不需要额外询问\n2. **优先级必须明确** — 不能\"看情况\"，要有默认首选\n3. **无法判断时必须停下来** — 这是铁律，禁止猜测\n4. **每条路径的产出格式必须一致** — 不同路径的最终产出应该可以合并\n5. **路由表要覆盖所有情况** — 不能有\"漏网之鱼\"\n\n## 反模式\n\n- ❌ 只有一条路径（不需要路由，直接做）\n- ❌ 条件模糊（\"如果数据量大\" → 多大算大？）\n- ❌ 没有\"无法判断\"的出口 → Agent 猜测\n- ❌ 不同路径的产出格式不同 → 无法合并\n- ❌ 优先级不明确 → Agent 不知道默认走哪条"},{"path":"references/problem-scan-guide.md","content":"# Phase 1 Problem Scan — 问题定义与痛点收集指南\n\n## 1.1 问题定义（★先定义问题，再谈痛点）\n\n**问用户两个问题：**\n\n**问题 1：** **\"你想利用这个 Skill 解决什么问题？\"**\n\n这是根本性问题。不是\"你让 AI 做什么\"，而是\"你面临什么问题\"。\n\n- ❌ \"我想让 AI 帮我爬取 BOSS 直聘的数据\"（这是任务描述，不是问题）\n- ✅ \"我找工作时需要快速筛选出匹配度高的岗位，手动逐个看太慢了\"（这是问题）\n\n**问题 2：** **\"你在自己处理这个问题的过程中，想要解决的痛点是什么？\"**\n\n痛点是问题解决方案的延伸思考。先有了问题，才能识别出痛点。\n\n### 问题 → 痛点的思考路径\n\n```\n你面临什么问题？\n    ↓\n你尝试过什么方法？\n    ↓\n这些方法哪里不好用？（= 痛点）\n    ↓\n你希望 Skill 帮你解决哪个环节？\n```\n\n### 问题定义模板\n\n```markdown\n## 问题定义\n\n### 核心问题\n[一句话描述：你面临什么问题？]\n\n### 当前方法\n[你目前怎么处理这个问题？]\n\n### 痛点\n| # | 痛点 | 具体表现 | 影响 |\n|---|---|---|---|\n| 1 | [一句话] | [具体场景] | [后果] |\n| 2 | [一句话] | [具体场景] | [后果] |\n| 3 | [一句话] | [具体场景] | [后果] |\n```\n\n## 1.2 边界定义\n\n### 边界模板\n\n```markdown\n## 边界\n\n### 做\n- [任务类型1]：[一句话描述]\n- [任务类型2]：[一句话描述]\n- [任务类型3]：[一句话描述]\n\n### 不做\n- [容易混淆的场景1]：[为什么不属于本 Skill]\n- [容易混淆的场景2]：[为什么不属于本 Skill]\n\n### 判断规则\n- 如果用户要的是 [不做范围内的东西] → 停下来澄清，不进入本 Skill\n- 如果用户没有提供 [必要输入] → 反问，不凭空创作\n```\n\n## 1.3 人类工作流拆解\n\n**问用户：** \"如果是你人工来做这件事，你的步骤是什么？\"\n\n### 工作流拆解模板\n\n```markdown\n## 人类工作流\n\n| 步骤 | 做什么 | 输入 | 输出 | 最容易出错的地方 |\n|---|---|---|---|---|\n| 1 | [动作] | [输入] | [输出] | [风险点] |\n| 2 | [动作] | [输入] | [输出] | [风险点] |\n| 3 | [动作] | [输入] | [输出] | [风险点] |\n```\n\n### 拆解原则\n\n1. **按时间顺序** — 先做什么、后做什么\n2. **每步有明确的输入输出** — 不能模糊\n3. **记录隐含步骤** — 人类可能跳过的\"理所当然\"的步骤\n4. **记录决策点** — 哪些步骤需要判断、选择、确认\n\n## 1.4 步骤归属审查\n\n**对人类描述的每个步骤，判断：这一步是解决当前问题所必需的，还是属于另一个独立任务？**\n\n### 判断标准\n\n| 情况 | 判断 | 处理 |\n|---|---|---|\n| 去掉这一步，核心问题仍能被解决 | 属于另一个任务 | 拆出去 |\n| 这一步的产出是另一步的\"预设前提\" | 属于前置任务 | 本 Skill 接收其产出作为输入 |\n| 这一步是核心问题的必要组成部分 | 属于本任务 | 保留在工作流中 |\n\n### 举例\n\n| 问题 | 步骤 | 归属 |\n|---|---|---|\n| 爬取岗位 + 匹配分析 | 建立候选人画像 | ❌ 另一个任务，不应混入 |\n| 爬取岗位 + 匹配分析 | 提取 JD 关键要求 | ✅ 本任务必要步骤 |\n| 写小红书笔记 | 研究竞品笔记 | ⚠️ 可以是前置输入，不应在写作流程中做 |\n\n## 反模式\n\n- ❌ 先谈任务不谈问题 — 问题定义不清，后续所有设计都是空中楼阁\n- ❌ 边界太宽 — Skill 什么都能做但什么都做不好\n- ❌ 工作流跳步 — Agent 执行时会遗漏\n- ❌ 把多个独立任务混在一个 Skill 里 — 流程复杂、边界模糊、产出不可控"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。 Skill: harness-skill-generator Owner: iichaner Summary: 引导用户从 0 构建一个基于 Harness 工程的 Skill。适用于具有一定复杂度的任务场景(多阶段、多分支、需要质检、需要状态持久化)。不适用于简单的单步任务或纯 prompt 优化。触发词:'创建 Skill'、'新建 Skill'、'做一个 Skill'、'构建 Skill'、'skill generator'、'harness skill'。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-18T10:45:43.269Z | auto Initial release — guides users to create complex Harness-based Skills from scratch. - Provides a step-by-ste","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":615,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T14:38:11.050Z","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-10T14:38:11.050Z","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-10T17:35:30.288Z","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"}]}}}