mirror of
https://github.com/alchaincyf/darwin-skill.git
synced 2026-09-18 10:31:04 +08:00
alchain
5bfc6b48dd
Major changes (validated by 6 independent judge agents, 86.05 → 92.7, +6.65): * Rubric: 8 → 9 dimensions, based on SkillLens paper (arXiv 2605.23899) - dim3 失败模式编码 (10→12 weight): require explicit "if X fails → Y" branches - dim5 可执行具体性 (15→17 weight): ban softening words (建议/可选/根据情况) - dim9 反例与黑名单 (NEW, 6 weight): require "what NOT to do" lists * Phase 1/2/2.5 checkpoints now have visible 🔴 CHECKPOINT · 🛑 STOP markers (HL-1 lesson: LLM parsers scan visual markers, not 必须 prose) * New auto-break rule: stop hill climbing after 2 consecutive rounds Δ<2 (HL-4 lesson: marginal gains signal over-engineering) * New "darwin 操作反例黑名单" section: 8 anti-patterns from real踩坑 - same-context self-eval, git reset --hard, padding for scores, skipping test-prompts, multi-dim per round, dry_run > 30%, silent error skipping, ignoring dimension correlation cluster * New HL speedrun: 4 high-leverage operations from results.tsv (huashu-gpt-image +10.85 / huashu-weread-advisor +14.9 / claude-design +16.5) * References split: empirical evidence + runtime neutrality moved to references/ to keep SKILL.md under skill-creator's 500-line guideline * SkillLens controlled study: 5 independent judges blind-tested V1 vs degraded V2 huashu-research → 5/5 V1>V2 high confidence, Δ +46.5 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
69 lines
3.9 KiB
Markdown
69 lines
3.9 KiB
Markdown
# Runtime 适配性审查（详细对照表 + 扫描命令）
|
||
|
||
> SKILL.md 在「Runtime 适配性审查」章节会引用本文件。Phase 1 基线评估时跑红灯扫描需要查这里。
|
||
|
||
---
|
||
|
||
## 背景
|
||
|
||
花叔的 skills 基于 Anthropic 开放的 [Agent Skills](https://agentskills.io) 协议，应当能在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等 50+ skills-compatible runtime 上通用。
|
||
|
||
这是 skill 分发力的根本——一个被误判为「单一 runtime 绑定」的 skill，会被其他 agent 直接拒绝安装（实例：nuwa-skill 因 README 写「在 Claude Code 里使用」被 Marvis agent 拒绝）。
|
||
|
||
**适用范围**：除非 skill 名字明确声明绑定单一 runtime（如 `huashu-slides-codex`、`xxx-for-claude-code`），所有 skill 必须通过本审查。
|
||
|
||
---
|
||
|
||
## 红灯信号（出现即扣分，必须在 P0 优化轮修复）
|
||
|
||
| 红灯类型 | 典型表现 | 危害 |
|
||
|---|---|---|
|
||
| Badge 钉死 | `[![Claude Code Skill]]`、`[![Cursor Only]]` 之类的单一 runtime badge | 视觉上首屏定调，其他 runtime 用户直接退出 |
|
||
| 措辞钉死 | 「在 Claude Code 里」「Cursor 用户可以」「Codex 中使用」「Claude Code skill」 | 让 agent 解析时误判为"不是给我用的" |
|
||
| 安装命令钉死 | 只给 `~/.claude/skills/` 路径、只给 `/plugin install`、只给某 runtime 私有 CLI | 不知道这是 Claude Code 命令的 agent 会拒绝 |
|
||
| 工具调用钉死 | 工作流里硬编码 `mcp__claude-in-chrome__*`、`PostToolUse hook` 等单 runtime 能力，且不给替代方案 | 其他 runtime 没这些工具 → 流程跑不通 |
|
||
| 路径硬编码 | `~/.claude/skills/xxx/`、`.claude/agents/yyy` 作为唯一路径 | 其他 runtime 用 `~/.cursor/skills/` `~/.codex/skills/` |
|
||
|
||
---
|
||
|
||
## 绿灯措辞（推荐改写）
|
||
|
||
| 红灯 | 绿灯 |
|
||
|---|---|
|
||
| "在 Claude Code 里" | "在你的 agent 里" / "在任何 skills-compatible runtime 中" |
|
||
| "Claude Code skill" | "Agent Skill" |
|
||
| "Claude Code 用户" | "skills-aware agent 用户" |
|
||
| 单一 badge 钉死 | `Agent Skills Standard` + `skills.sh Compatible` + `Multi-Runtime` 三个中立 badge |
|
||
| 只给 `npx skills add ...` 一行 | 三层结构：① 自动检测的一行命令 ② 折叠展开的各 runtime 手动路径 ③ 「作为参考资料 cat 进 context」fallback |
|
||
| 工具名硬编码 | "用一个 browser automation 工具（例如 Claude 的 chrome MCP、Playwright 等）" |
|
||
|
||
---
|
||
|
||
## 例外清单（允许的「Claude Code 痕迹」）
|
||
|
||
不是所有 Claude-Code 相关字符都要清除。下面这些是**正当出现**的，不算红灯：
|
||
|
||
1. **Frontmatter `description` 里的中英文触发词**——这是 skill 入口，其他 runtime 解析 frontmatter 时同样能匹配
|
||
2. **花叔生态内部联动的 skill 名引用**——如「调用 huashu-design」「跟 darwin-skill 配套」
|
||
3. **明确标注的 runtime-specific 章节**——如「### 仅 Claude Code 优化（按需触发）」+ 解释清楚是 nice-to-have
|
||
4. **commit message、changelog、内部脚本**——不属于用户读到的 skill 内容
|
||
|
||
---
|
||
|
||
## 审查时机
|
||
|
||
- **Phase 1 基线评估时**：每个 skill 跑一次红灯扫描，命中项以 `runtime_warn=N` 形式写入 results.tsv 的 `note` 列（不新增列、保持向后兼容）
|
||
- **Phase 2 优化循环时**：红灯命中数 ≥ 1 的 skill，强制把第一轮优化方向定为 P0「runtime drift 修复」（详见 SKILL.md 优化策略库的 P0 章节），优先于其他维度
|
||
- **Phase 3 汇总报告时**：单独一栏「runtime 中立度」展示修复进度（命中数从 X → 0）
|
||
|
||
---
|
||
|
||
## 红灯扫描快速命令
|
||
|
||
```bash
|
||
# 在 skill 目录跑这个 grep，输出即红灯命中
|
||
grep -nE "(在 Claude Code|Claude Code skill|Claude Code 用户|Cursor only|Codex 中|^\[!\[Claude Code|~/\.claude/skills/[a-z]|/plugin install\b)" SKILL.md README.md 2>/dev/null
|
||
```
|
||
|
||
输出非空 = 该 skill 未通过 gate，必须在优化循环里修复。
|