docs: move comparison snapshot near architecture
This commit is contained in:
yaojingang
@@ -46,6 +46,32 @@ Read it in 10 seconds:
|
||||
- **Run**: use the unified CLI to build, validate, optimize, and promote.
|
||||
- **Outputs**: ship a reusable skill plus evidence, governance signals, and portability artifacts.
|
||||
|
||||
## Comparison Snapshot
|
||||
|
||||
This is a scenario-oriented benchmark shared with the project. It is most useful when deciding which system fits a workflow, not as a universal claim that one approach beats every other approach in every context.
|
||||
|
||||
| Dimension | skill-creator | yao-meta-skill | What it means |
|
||||
| --- | ---: | ---: | --- |
|
||||
| Onboarding friction | 9 | 6 | `skill-creator` is friendlier and more conversational; `yao-meta-skill` has more concepts and a steeper learning curve. |
|
||||
| Flexibility | 9 | 7 | `skill-creator` is more free-form; `yao-meta-skill` uses a more explicit process. |
|
||||
| Method depth | 5 | 9.5 | `yao-meta-skill` has a fuller engineering doctrine with archetypes, gate selection, governance, and resource boundaries. |
|
||||
| Evaluation rigor | 7 | 9.5 | `yao-meta-skill` emphasizes layered holdouts, route confusion, adversarial checks, and promotion gates. |
|
||||
| Human review experience | 9 | 5 | `skill-creator` has the more intuitive review UX; `yao-meta-skill` is still mostly report-driven. |
|
||||
| Governance and lifecycle | 2 | 9.5 | `yao-meta-skill` treats important skills as managed assets with maturity, review cadence, and promotion evidence. |
|
||||
| Cross-environment portability | 4 | 9 | `yao-meta-skill` is built around neutral metadata, adapters, degradation rules, and portability checks. |
|
||||
| Toolchain completeness | 6 | 9.5 | `yao-meta-skill` ships with a much broader toolchain, unified CLI, CI, and report generation. |
|
||||
| Iteration speed | 8 | 7 | `skill-creator` can feel faster for quick cycles; `yao-meta-skill` spends more effort on gates and evidence. |
|
||||
| Documentation quality | 7 | 9 | `yao-meta-skill` offers multi-language docs, examples, failure cases, and method doctrine. |
|
||||
| Best for solo use | 9 | 6 | `skill-creator` is easier for fast personal iteration. |
|
||||
| Best for teams and organizations | 5 | 9.5 | `yao-meta-skill` fits team reuse, governance, CI, and long-term maintenance better. |
|
||||
| Overall | 6.7 | 8.0 | The tradeoff is straightforward: lighter conversation flow versus stronger engineering and governance. |
|
||||
|
||||
## Best-Fit Scenarios
|
||||
|
||||
- Choose **skill-creator** when the main goal is fast solo ideation, flexible interaction, and quick iteration with a lighter process.
|
||||
- Choose **yao-meta-skill** when the goal is to build a reusable asset with explicit boundaries, evaluation gates, governance, portability, and long-term maintainability.
|
||||
- A practical hybrid pattern is: use a conversational creator to get a first draft, then use `yao-meta-skill` to harden the package, add evidence, and make it team-ready.
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. Describe the workflow, prompt set, or repeated task you want to turn into a skill.
|
||||
@@ -181,32 +207,6 @@ In the latest weighted review shared with the project, Yao scored strongest in t
|
||||
|
||||
The overall direction is deliberate: keep the entrypoint light, make the evaluation loop strict, and treat governance as a first-class part of skill quality.
|
||||
|
||||
## Comparison Snapshot
|
||||
|
||||
This is a scenario-oriented benchmark shared with the project. It is most useful when deciding which system fits a workflow, not as a universal claim that one approach beats every other approach in every context.
|
||||
|
||||
| Dimension | skill-creator | yao-meta-skill | What it means |
|
||||
| --- | ---: | ---: | --- |
|
||||
| Onboarding friction | 9 | 6 | `skill-creator` is friendlier and more conversational; `yao-meta-skill` has more concepts and a steeper learning curve. |
|
||||
| Flexibility | 9 | 7 | `skill-creator` is more free-form; `yao-meta-skill` uses a more explicit process. |
|
||||
| Method depth | 5 | 9.5 | `yao-meta-skill` has a fuller engineering doctrine with archetypes, gate selection, governance, and resource boundaries. |
|
||||
| Evaluation rigor | 7 | 9.5 | `yao-meta-skill` emphasizes layered holdouts, route confusion, adversarial checks, and promotion gates. |
|
||||
| Human review experience | 9 | 5 | `skill-creator` has the more intuitive review UX; `yao-meta-skill` is still mostly report-driven. |
|
||||
| Governance and lifecycle | 2 | 9.5 | `yao-meta-skill` treats important skills as managed assets with maturity, review cadence, and promotion evidence. |
|
||||
| Cross-environment portability | 4 | 9 | `yao-meta-skill` is built around neutral metadata, adapters, degradation rules, and portability checks. |
|
||||
| Toolchain completeness | 6 | 9.5 | `yao-meta-skill` ships with a much broader toolchain, unified CLI, CI, and report generation. |
|
||||
| Iteration speed | 8 | 7 | `skill-creator` can feel faster for quick cycles; `yao-meta-skill` spends more effort on gates and evidence. |
|
||||
| Documentation quality | 7 | 9 | `yao-meta-skill` offers multi-language docs, examples, failure cases, and method doctrine. |
|
||||
| Best for solo use | 9 | 6 | `skill-creator` is easier for fast personal iteration. |
|
||||
| Best for teams and organizations | 5 | 9.5 | `yao-meta-skill` fits team reuse, governance, CI, and long-term maintenance better. |
|
||||
| Overall | 6.7 | 8.0 | The tradeoff is straightforward: lighter conversation flow versus stronger engineering and governance. |
|
||||
|
||||
## Best-Fit Scenarios
|
||||
|
||||
- Choose **skill-creator** when the main goal is fast solo ideation, flexible interaction, and quick iteration with a lighter process.
|
||||
- Choose **yao-meta-skill** when the goal is to build a reusable asset with explicit boundaries, evaluation gates, governance, portability, and long-term maintainability.
|
||||
- A practical hybrid pattern is: use a conversational creator to get a first draft, then use `yao-meta-skill` to harden the package, add evidence, and make it team-ready.
|
||||
|
||||
## Why Yao
|
||||
|
||||
- **Lightweight**: the entrypoint stays compact, context budgets are explicit, and extra structure is added only when it pays for itself.
|
||||
|
||||
+26
-26
@@ -36,6 +36,32 @@ Lecture en 10 secondes :
|
||||
- **Exécution** : la CLI unifiée construit, valide, optimise et promeut le skill.
|
||||
- **Sorties** : on obtient un skill package réutilisable avec ses preuves d'évaluation, de gouvernance et de portabilité.
|
||||
|
||||
## Comparatif rapide
|
||||
|
||||
Le tableau ci-dessous est un benchmark orienté scénario. Il aide à choisir le bon système selon le contexte, plutôt qu'à prétendre qu'une approche domine toutes les autres dans tous les cas.
|
||||
|
||||
| Dimension | skill-creator | yao-meta-skill | Ce que cela signifie |
|
||||
| --- | ---: | ---: | --- |
|
||||
| Facilité de prise en main | 9 | 6 | `skill-creator` est plus conversationnel et intuitif ; `yao-meta-skill` demande plus d'apprentissage. |
|
||||
| Flexibilité | 9 | 7 | `skill-creator` est plus libre ; `yao-meta-skill` suit un processus plus explicite. |
|
||||
| Profondeur méthodologique | 5 | 9.5 | `yao-meta-skill` possède une doctrine plus complète : archetypes, gates, governance et resource boundaries. |
|
||||
| Rigueur d'évaluation | 7 | 9.5 | `yao-meta-skill` insiste sur les holdouts multiples, la route confusion, l'adversarial et les promotion gates. |
|
||||
| Expérience de revue humaine | 9 | 5 | `skill-creator` offre une expérience de revue plus directe ; `yao-meta-skill` reste surtout piloté par des rapports. |
|
||||
| Gouvernance et cycle de vie | 2 | 9.5 | `yao-meta-skill` traite les skills importantes comme des actifs gérés avec maturité, cadence de revue et preuves de promotion. |
|
||||
| Portabilité inter-environnements | 4 | 9 | `yao-meta-skill` repose sur des métadonnées neutres, des adaptateurs, des règles de dégradation et des contrôles de portabilité. |
|
||||
| Complétude de la toolchain | 6 | 9.5 | `yao-meta-skill` apporte une toolchain plus large avec CLI unifiée, CI et génération de rapports. |
|
||||
| Vitesse d'itération | 8 | 7 | `skill-creator` paraît plus rapide pour les petites boucles ; `yao-meta-skill` accepte plus de friction pour gagner en preuves. |
|
||||
| Qualité de la documentation | 7 | 9 | `yao-meta-skill` fournit docs multilingues, exemples, failure library et méthode formalisée. |
|
||||
| Pertinence pour un usage individuel | 9 | 6 | `skill-creator` est plus naturel pour un usage personnel rapide. |
|
||||
| Pertinence pour une équipe / organisation | 5 | 9.5 | `yao-meta-skill` est mieux adapté à la réutilisation en équipe, à la CI, à la gouvernance et à la maintenance longue. |
|
||||
| Global | 6.7 | 8.0 | Le compromis est clair : flux conversationnel léger d'un côté, ingénierie et gouvernance plus fortes de l'autre. |
|
||||
|
||||
## Scénarios recommandés
|
||||
|
||||
- Choisissez **skill-creator** si votre besoin principal est l'idéation rapide en solo, l'interaction souple et un processus léger.
|
||||
- Choisissez **yao-meta-skill** si vous voulez un actif réutilisable avec frontières explicites, gates d'évaluation, gouvernance, portabilité et maintenance à long terme.
|
||||
- Un schéma hybride utile consiste à produire un premier jet avec un creator conversationnel, puis à utiliser `yao-meta-skill` pour durcir le package et le rendre prêt pour une équipe.
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. Décrivez le workflow, l'ensemble de prompts ou la tâche répétée que vous voulez transformer en skill.
|
||||
@@ -65,32 +91,6 @@ Dans la dernière revue pondérée partagée pour le projet, Yao se distingue su
|
||||
|
||||
La direction est volontaire : garder une entrée légère, rendre l'évaluation stricte, et traiter la gouvernance comme une partie de la qualité d'une skill.
|
||||
|
||||
## Comparatif rapide
|
||||
|
||||
Le tableau ci-dessous est un benchmark orienté scénario. Il aide à choisir le bon système selon le contexte, plutôt qu'à prétendre qu'une approche domine toutes les autres dans tous les cas.
|
||||
|
||||
| Dimension | skill-creator | yao-meta-skill | Ce que cela signifie |
|
||||
| --- | ---: | ---: | --- |
|
||||
| Facilité de prise en main | 9 | 6 | `skill-creator` est plus conversationnel et intuitif ; `yao-meta-skill` demande plus d'apprentissage. |
|
||||
| Flexibilité | 9 | 7 | `skill-creator` est plus libre ; `yao-meta-skill` suit un processus plus explicite. |
|
||||
| Profondeur méthodologique | 5 | 9.5 | `yao-meta-skill` possède une doctrine plus complète : archetypes, gates, governance et resource boundaries. |
|
||||
| Rigueur d'évaluation | 7 | 9.5 | `yao-meta-skill` insiste sur les holdouts multiples, la route confusion, l'adversarial et les promotion gates. |
|
||||
| Expérience de revue humaine | 9 | 5 | `skill-creator` offre une expérience de revue plus directe ; `yao-meta-skill` reste surtout piloté par des rapports. |
|
||||
| Gouvernance et cycle de vie | 2 | 9.5 | `yao-meta-skill` traite les skills importantes comme des actifs gérés avec maturité, cadence de revue et preuves de promotion. |
|
||||
| Portabilité inter-environnements | 4 | 9 | `yao-meta-skill` repose sur des métadonnées neutres, des adaptateurs, des règles de dégradation et des contrôles de portabilité. |
|
||||
| Complétude de la toolchain | 6 | 9.5 | `yao-meta-skill` apporte une toolchain plus large avec CLI unifiée, CI et génération de rapports. |
|
||||
| Vitesse d'itération | 8 | 7 | `skill-creator` paraît plus rapide pour les petites boucles ; `yao-meta-skill` accepte plus de friction pour gagner en preuves. |
|
||||
| Qualité de la documentation | 7 | 9 | `yao-meta-skill` fournit docs multilingues, exemples, failure library et méthode formalisée. |
|
||||
| Pertinence pour un usage individuel | 9 | 6 | `skill-creator` est plus naturel pour un usage personnel rapide. |
|
||||
| Pertinence pour une équipe / organisation | 5 | 9.5 | `yao-meta-skill` est mieux adapté à la réutilisation en équipe, à la CI, à la gouvernance et à la maintenance longue. |
|
||||
| Global | 6.7 | 8.0 | Le compromis est clair : flux conversationnel léger d'un côté, ingénierie et gouvernance plus fortes de l'autre. |
|
||||
|
||||
## Scénarios recommandés
|
||||
|
||||
- Choisissez **skill-creator** si votre besoin principal est l'idéation rapide en solo, l'interaction souple et un processus léger.
|
||||
- Choisissez **yao-meta-skill** si vous voulez un actif réutilisable avec frontières explicites, gates d'évaluation, gouvernance, portabilité et maintenance à long terme.
|
||||
- Un schéma hybride utile consiste à produire un premier jet avec un creator conversationnel, puis à utiliser `yao-meta-skill` pour durcir le package et le rendre prêt pour une équipe.
|
||||
|
||||
## Pourquoi Yao
|
||||
|
||||
- **Léger** : le point d'entrée reste compact, les budgets de contexte sont explicites, et la structure supplémentaire n'est ajoutée que lorsqu'elle apporte une vraie valeur.
|
||||
|
||||
+26
-26
@@ -36,6 +36,32 @@ flowchart LR
|
||||
- **実行**: 統一 CLI で作成、検証、最適化、昇格を進めます。
|
||||
- **出力**: 最終的に skill package と、評価・ガバナンス・移植性の証拠が残ります。
|
||||
|
||||
## 比較スナップショット
|
||||
|
||||
この表は「どちらが今の目的に合っているか」を判断するための scenario-oriented benchmark です。あらゆる場面で一方が絶対的に優れていると主張するものではありません。
|
||||
|
||||
| 評価軸 | skill-creator | yao-meta-skill | 意味 |
|
||||
| --- | ---: | ---: | --- |
|
||||
| 立ち上がりやすさ | 9 | 6 | `skill-creator` は会話的で直感的。`yao-meta-skill` は概念が多く学習コストが高めです。 |
|
||||
| 柔軟性 | 9 | 7 | `skill-creator` の方が自由度が高く、`yao-meta-skill` は手順がより明示的です。 |
|
||||
| 方法論の深さ | 5 | 9.5 | `yao-meta-skill` は doctrine、archetypes、gate selection、governance、resource boundaries がより揃っています。 |
|
||||
| 評価の厳密さ | 7 | 9.5 | `yao-meta-skill` は layered holdout、route confusion、adversarial checks、promotion gates を重視します。 |
|
||||
| 人間によるレビュー体験 | 9 | 5 | `skill-creator` の方がレビュー UX は直感的で、`yao-meta-skill` はまだ report 中心です。 |
|
||||
| ガバナンスとライフサイクル | 2 | 9.5 | `yao-meta-skill` は重要な skill を maturity、review cadence、promotion evidence を持つ管理対象として扱います。 |
|
||||
| クロス環境の移植性 | 4 | 9 | `yao-meta-skill` は neutral metadata、adapter、degradation rule、portability checks を備えています。 |
|
||||
| ツールチェーンの完成度 | 6 | 9.5 | `yao-meta-skill` は統一 CLI、CI、レポート生成まで含む広い toolchain を持ちます。 |
|
||||
| 反復の速さ | 8 | 7 | `skill-creator` は軽い反復が速く、`yao-meta-skill` は品質ゲートの分だけ少し重くなります。 |
|
||||
| 文書品質 | 7 | 9 | `yao-meta-skill` は多言語 docs、examples、failure library、method doctrine を持ちます。 |
|
||||
| 個人利用への適性 | 9 | 6 | `skill-creator` は個人の素早い試作に向いています。 |
|
||||
| チーム / 組織への適性 | 5 | 9.5 | `yao-meta-skill` はチーム再利用、CI、ガバナンス、長期保守に向いています。 |
|
||||
| 総合 | 6.7 | 8.0 | トレードオフは明快です。軽い会話フローか、より強い engineering と governance か、の違いです。 |
|
||||
|
||||
## 適したシナリオ
|
||||
|
||||
- **個人で素早く試作したい、会話しながら固めたい、軽く始めたい**なら `skill-creator` が向いています。
|
||||
- **チーム再利用、明確な境界、評価ゲート、ガバナンス、移植性、長期保守**を重視するなら `yao-meta-skill` が向いています。
|
||||
- 実務的な組み合わせとしては、会話的な creator で初稿を作り、その後 `yao-meta-skill` で harden して team-ready な asset にする、という流れが有効です。
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. skill 化したい workflow、prompt 集合、または反復タスクを説明します。
|
||||
@@ -65,32 +91,6 @@ flowchart LR
|
||||
|
||||
全体の方向性は明確です。入口は軽く、評価は厳しく、ガバナンスは skill 品質の一部として扱います。
|
||||
|
||||
## 比較スナップショット
|
||||
|
||||
この表は「どちらが今の目的に合っているか」を判断するための scenario-oriented benchmark です。あらゆる場面で一方が絶対的に優れていると主張するものではありません。
|
||||
|
||||
| 評価軸 | skill-creator | yao-meta-skill | 意味 |
|
||||
| --- | ---: | ---: | --- |
|
||||
| 立ち上がりやすさ | 9 | 6 | `skill-creator` は会話的で直感的。`yao-meta-skill` は概念が多く学習コストが高めです。 |
|
||||
| 柔軟性 | 9 | 7 | `skill-creator` の方が自由度が高く、`yao-meta-skill` は手順がより明示的です。 |
|
||||
| 方法論の深さ | 5 | 9.5 | `yao-meta-skill` は doctrine、archetypes、gate selection、governance、resource boundaries がより揃っています。 |
|
||||
| 評価の厳密さ | 7 | 9.5 | `yao-meta-skill` は layered holdout、route confusion、adversarial checks、promotion gates を重視します。 |
|
||||
| 人間によるレビュー体験 | 9 | 5 | `skill-creator` の方がレビュー UX は直感的で、`yao-meta-skill` はまだ report 中心です。 |
|
||||
| ガバナンスとライフサイクル | 2 | 9.5 | `yao-meta-skill` は重要な skill を maturity、review cadence、promotion evidence を持つ管理対象として扱います。 |
|
||||
| クロス環境の移植性 | 4 | 9 | `yao-meta-skill` は neutral metadata、adapter、degradation rule、portability checks を備えています。 |
|
||||
| ツールチェーンの完成度 | 6 | 9.5 | `yao-meta-skill` は統一 CLI、CI、レポート生成まで含む広い toolchain を持ちます。 |
|
||||
| 反復の速さ | 8 | 7 | `skill-creator` は軽い反復が速く、`yao-meta-skill` は品質ゲートの分だけ少し重くなります。 |
|
||||
| 文書品質 | 7 | 9 | `yao-meta-skill` は多言語 docs、examples、failure library、method doctrine を持ちます。 |
|
||||
| 個人利用への適性 | 9 | 6 | `skill-creator` は個人の素早い試作に向いています。 |
|
||||
| チーム / 組織への適性 | 5 | 9.5 | `yao-meta-skill` はチーム再利用、CI、ガバナンス、長期保守に向いています。 |
|
||||
| 総合 | 6.7 | 8.0 | トレードオフは明快です。軽い会話フローか、より強い engineering と governance か、の違いです。 |
|
||||
|
||||
## 適したシナリオ
|
||||
|
||||
- **個人で素早く試作したい、会話しながら固めたい、軽く始めたい**なら `skill-creator` が向いています。
|
||||
- **チーム再利用、明確な境界、評価ゲート、ガバナンス、移植性、長期保守**を重視するなら `yao-meta-skill` が向いています。
|
||||
- 実務的な組み合わせとしては、会話的な creator で初稿を作り、その後 `yao-meta-skill` で harden して team-ready な asset にする、という流れが有効です。
|
||||
|
||||
## なぜ Yao なのか
|
||||
|
||||
- **軽量**: エントリポイントは小さく保たれ、context budget は明示され、追加構造は本当に価値がある場合にだけ導入されます。
|
||||
|
||||
+26
-26
@@ -36,6 +36,32 @@ flowchart LR
|
||||
- **Исполнение**: единый CLI создает, проверяет, оптимизирует и продвигает skill.
|
||||
- **Выходы**: результатом становится skill package плюс доказательства оценки, governance и portability.
|
||||
|
||||
## Сравнительный снимок
|
||||
|
||||
Ниже — scenario-oriented benchmark. Он полезен для выбора подходящего инструмента под конкретный контекст, а не как универсальное заявление о том, что один подход лучше другого всегда и везде.
|
||||
|
||||
| Измерение | skill-creator | yao-meta-skill | Что это означает |
|
||||
| --- | ---: | ---: | --- |
|
||||
| Порог входа | 9 | 6 | `skill-creator` более дружелюбен и разговорен; `yao-meta-skill` содержит больше концепций и требует большего входного усилия. |
|
||||
| Гибкость | 9 | 7 | `skill-creator` более свободный по стилю; `yao-meta-skill` опирается на более явный процесс. |
|
||||
| Глубина методологии | 5 | 9.5 | `yao-meta-skill` имеет более полную doctrine: archetypes, gate selection, governance и resource boundaries. |
|
||||
| Строгость оценки | 7 | 9.5 | `yao-meta-skill` делает акцент на layered holdout, route confusion, adversarial checks и promotion gates. |
|
||||
| Опыт ручного ревью | 9 | 5 | У `skill-creator` более удобный review UX; `yao-meta-skill` пока в основном опирается на отчеты. |
|
||||
| Governance и lifecycle | 2 | 9.5 | `yao-meta-skill` рассматривает важные skills как управляемые активы с maturity, review cadence и promotion evidence. |
|
||||
| Переносимость между средами | 4 | 9 | `yao-meta-skill` строится вокруг neutral metadata, adapters, degradation rules и portability checks. |
|
||||
| Полнота toolchain | 6 | 9.5 | `yao-meta-skill` дает более широкую toolchain с unified CLI, CI и системой отчетов. |
|
||||
| Скорость итераций | 8 | 7 | `skill-creator` может быть быстрее в коротких циклах; `yao-meta-skill` сознательно тяжелее ради quality gates и evidence. |
|
||||
| Качество документации | 7 | 9 | `yao-meta-skill` уже имеет многоязычную документацию, examples, failure library и formal method docs. |
|
||||
| Лучше для индивидуального использования | 9 | 6 | `skill-creator` лучше подходит для быстрого личного прототипирования. |
|
||||
| Лучше для команд / организаций | 5 | 9.5 | `yao-meta-skill` лучше подходит для командного reuse, CI, governance и долгосрочной поддержки. |
|
||||
| Итог | 6.7 | 8.0 | Компромисс прямой: более легкий conversational flow против более сильной engineering и governance системы. |
|
||||
|
||||
## Подходящие сценарии
|
||||
|
||||
- Выбирайте **skill-creator**, если вам важнее быстрое solo-идеирование, гибкий диалог и легкий процесс.
|
||||
- Выбирайте **yao-meta-skill**, если нужен переиспользуемый актив с явными границами, evaluation gates, governance, portability и долгосрочной поддержкой.
|
||||
- Практичный гибридный вариант: сначала получить первый черновик через conversation-driven creator, а затем использовать `yao-meta-skill`, чтобы усилить пакет и сделать его team-ready.
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. Опишите workflow, набор prompts или повторяющуюся задачу, которую хотите превратить в skill.
|
||||
@@ -65,32 +91,6 @@ flowchart LR
|
||||
|
||||
Общий вектор здесь осознанный: легкий вход, строгий evaluation loop и governance как часть качества skill.
|
||||
|
||||
## Сравнительный снимок
|
||||
|
||||
Ниже — scenario-oriented benchmark. Он полезен для выбора подходящего инструмента под конкретный контекст, а не как универсальное заявление о том, что один подход лучше другого всегда и везде.
|
||||
|
||||
| Измерение | skill-creator | yao-meta-skill | Что это означает |
|
||||
| --- | ---: | ---: | --- |
|
||||
| Порог входа | 9 | 6 | `skill-creator` более дружелюбен и разговорен; `yao-meta-skill` содержит больше концепций и требует большего входного усилия. |
|
||||
| Гибкость | 9 | 7 | `skill-creator` более свободный по стилю; `yao-meta-skill` опирается на более явный процесс. |
|
||||
| Глубина методологии | 5 | 9.5 | `yao-meta-skill` имеет более полную doctrine: archetypes, gate selection, governance и resource boundaries. |
|
||||
| Строгость оценки | 7 | 9.5 | `yao-meta-skill` делает акцент на layered holdout, route confusion, adversarial checks и promotion gates. |
|
||||
| Опыт ручного ревью | 9 | 5 | У `skill-creator` более удобный review UX; `yao-meta-skill` пока в основном опирается на отчеты. |
|
||||
| Governance и lifecycle | 2 | 9.5 | `yao-meta-skill` рассматривает важные skills как управляемые активы с maturity, review cadence и promotion evidence. |
|
||||
| Переносимость между средами | 4 | 9 | `yao-meta-skill` строится вокруг neutral metadata, adapters, degradation rules и portability checks. |
|
||||
| Полнота toolchain | 6 | 9.5 | `yao-meta-skill` дает более широкую toolchain с unified CLI, CI и системой отчетов. |
|
||||
| Скорость итераций | 8 | 7 | `skill-creator` может быть быстрее в коротких циклах; `yao-meta-skill` сознательно тяжелее ради quality gates и evidence. |
|
||||
| Качество документации | 7 | 9 | `yao-meta-skill` уже имеет многоязычную документацию, examples, failure library и formal method docs. |
|
||||
| Лучше для индивидуального использования | 9 | 6 | `skill-creator` лучше подходит для быстрого личного прототипирования. |
|
||||
| Лучше для команд / организаций | 5 | 9.5 | `yao-meta-skill` лучше подходит для командного reuse, CI, governance и долгосрочной поддержки. |
|
||||
| Итог | 6.7 | 8.0 | Компромисс прямой: более легкий conversational flow против более сильной engineering и governance системы. |
|
||||
|
||||
## Подходящие сценарии
|
||||
|
||||
- Выбирайте **skill-creator**, если вам важнее быстрое solo-идеирование, гибкий диалог и легкий процесс.
|
||||
- Выбирайте **yao-meta-skill**, если нужен переиспользуемый актив с явными границами, evaluation gates, governance, portability и долгосрочной поддержкой.
|
||||
- Практичный гибридный вариант: сначала получить первый черновик через conversation-driven creator, а затем использовать `yao-meta-skill`, чтобы усилить пакет и сделать его team-ready.
|
||||
|
||||
## Почему Yao
|
||||
|
||||
- **Легкий**: entrypoint остается компактным, context budgets заданы явно, а дополнительная структура добавляется только тогда, когда она действительно окупается.
|
||||
|
||||
+26
-26
@@ -36,6 +36,32 @@ flowchart LR
|
||||
- **执行**：通过统一 CLI 完成创建、校验、优化和晋升。
|
||||
- **产出**：最终得到 skill 包，以及评测、治理和 portability 证据。
|
||||
|
||||
## 对比快照
|
||||
|
||||
下面这个表更适合拿来判断“哪种系统更适合当前场景”，而不是把它理解成适用于所有场景的绝对结论。
|
||||
|
||||
| 评分维度 | skill-creator | yao-meta-skill | 说明 |
|
||||
| --- | ---: | ---: | --- |
|
||||
| 上手门槛 | 9 | 6 | `skill-creator` 语言更亲切、对话更直觉；`yao-meta-skill` 概念更多，学习曲线更陡。 |
|
||||
| 灵活性 | 9 | 7 | `skill-creator` 更自由；`yao-meta-skill` 的流程更明确、更结构化。 |
|
||||
| 方法论深度 | 5 | 9.5 | `yao-meta-skill` 有更完整的 skill engineering doctrine、archetypes、gate selection、governance 和 resource boundaries。 |
|
||||
| 评估严谨度 | 7 | 9.5 | `yao-meta-skill` 更强调 layered holdout、route confusion、adversarial checks 和 promotion gates。 |
|
||||
| 人工评审体验 | 9 | 5 | `skill-creator` 的人工评审体验更直观；`yao-meta-skill` 目前仍以报告驱动为主。 |
|
||||
| 治理与生命周期 | 2 | 9.5 | `yao-meta-skill` 把重要 skill 当成可治理资产，具备 maturity、review cadence 和 promotion evidence。 |
|
||||
| 跨环境复用 | 4 | 9 | `yao-meta-skill` 采用中性元数据、adapter、degradation rule 和 portability checks。 |
|
||||
| 工具链完整度 | 6 | 9.5 | `yao-meta-skill` 提供更完整的工具链、统一 CLI、CI 和报告系统。 |
|
||||
| 迭代效率 | 8 | 7 | `skill-creator` 在快速小循环上更轻；`yao-meta-skill` 会为了质量门和证据多付出一些流程成本。 |
|
||||
| 文档质量 | 7 | 9 | `yao-meta-skill` 现在提供多语言文档、案例、失败案例库和方法论文档。 |
|
||||
| 适合个人使用 | 9 | 6 | `skill-creator` 更适合个人快速试作。 |
|
||||
| 适合团队/组织 | 5 | 9.5 | `yao-meta-skill` 更适合团队复用、治理、CI 和长期维护。 |
|
||||
| 综合 | 6.7 | 8.0 | 核心取舍很清楚：一个偏轻量对话流，一个偏工程化和治理化。 |
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 如果你要的是**个人快速试作、边聊边做、轻量起稿**，更适合 `skill-creator`。
|
||||
- 如果你要的是**团队复用、显式边界、质量门、治理、可移植性和长期维护**，更适合 `yao-meta-skill`。
|
||||
- 一个很实用的组合方式是：先用更对话式的系统做第一版，再用 `yao-meta-skill` 把它加固成团队可复用的正式资产。
|
||||
|
||||
## Quick Start
|
||||
|
||||
1. 先描述你想沉淀成 skill 的 workflow、prompt 集合或重复任务。
|
||||
@@ -65,32 +91,6 @@ flowchart LR
|
||||
|
||||
整体方向很明确：入口尽量轻，评测尽量硬，治理成为 skill 质量的一部分。
|
||||
|
||||
## 对比快照
|
||||
|
||||
下面这个表更适合拿来判断“哪种系统更适合当前场景”，而不是把它理解成适用于所有场景的绝对结论。
|
||||
|
||||
| 评分维度 | skill-creator | yao-meta-skill | 说明 |
|
||||
| --- | ---: | ---: | --- |
|
||||
| 上手门槛 | 9 | 6 | `skill-creator` 语言更亲切、对话更直觉；`yao-meta-skill` 概念更多，学习曲线更陡。 |
|
||||
| 灵活性 | 9 | 7 | `skill-creator` 更自由；`yao-meta-skill` 的流程更明确、更结构化。 |
|
||||
| 方法论深度 | 5 | 9.5 | `yao-meta-skill` 有更完整的 skill engineering doctrine、archetypes、gate selection、governance 和 resource boundaries。 |
|
||||
| 评估严谨度 | 7 | 9.5 | `yao-meta-skill` 更强调 layered holdout、route confusion、adversarial checks 和 promotion gates。 |
|
||||
| 人工评审体验 | 9 | 5 | `skill-creator` 的人工评审体验更直观；`yao-meta-skill` 目前仍以报告驱动为主。 |
|
||||
| 治理与生命周期 | 2 | 9.5 | `yao-meta-skill` 把重要 skill 当成可治理资产，具备 maturity、review cadence 和 promotion evidence。 |
|
||||
| 跨环境复用 | 4 | 9 | `yao-meta-skill` 采用中性元数据、adapter、degradation rule 和 portability checks。 |
|
||||
| 工具链完整度 | 6 | 9.5 | `yao-meta-skill` 提供更完整的工具链、统一 CLI、CI 和报告系统。 |
|
||||
| 迭代效率 | 8 | 7 | `skill-creator` 在快速小循环上更轻；`yao-meta-skill` 会为了质量门和证据多付出一些流程成本。 |
|
||||
| 文档质量 | 7 | 9 | `yao-meta-skill` 现在提供多语言文档、案例、失败案例库和方法论文档。 |
|
||||
| 适合个人使用 | 9 | 6 | `skill-creator` 更适合个人快速试作。 |
|
||||
| 适合团队/组织 | 5 | 9.5 | `yao-meta-skill` 更适合团队复用、治理、CI 和长期维护。 |
|
||||
| 综合 | 6.7 | 8.0 | 核心取舍很清楚：一个偏轻量对话流，一个偏工程化和治理化。 |
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 如果你要的是**个人快速试作、边聊边做、轻量起稿**，更适合 `skill-creator`。
|
||||
- 如果你要的是**团队复用、显式边界、质量门、治理、可移植性和长期维护**，更适合 `yao-meta-skill`。
|
||||
- 一个很实用的组合方式是：先用更对话式的系统做第一版，再用 `yao-meta-skill` 把它加固成团队可复用的正式资产。
|
||||
|
||||
## 为什么是 Yao
|
||||
|
||||
- **轻量**：入口保持紧凑，context budget 明确分层，只有在真正值得时才增加额外结构。
|
||||
|
||||
Reference in New Issue
Block a user