npm - skill-family-engineering-kit - Versions diffs - 0.2.0 → 0.2.1 - Mend

skill-family-engineering-kit 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (70) hide show

package/CHANGELOG.md +21 -0
package/CHANGELOG.zh-CN.md +21 -0
package/NOTICE +10 -0
package/README.md +157 -55
package/README.zh-CN.md +207 -0
package/candidate/index.mjs +4 -0
package/candidate/profile-bundle.mjs +268 -0
package/candidate/projection-bundle-cli.mjs +22 -0
package/docs/404.html +1434 -408
package/docs/agents/architecture-routing/index.html +1944 -0
package/docs/agents/capability-catalog.en.json +1561 -0
package/docs/agents/capability-catalog.json +934 -0
package/docs/agents/capability-catalog.schema.json +179 -0
package/docs/agents/capability-catalog.zh-CN.json +1561 -0
package/docs/agents/index.html +1914 -0
package/docs/architecture/index.html +1706 -497
package/docs/assets/javascripts/lunr/tinyseg.js +2 -2
package/docs/assets/javascripts/lunr/wordcut.js +37 -37
package/docs/en/agents/architecture-routing/index.html +1944 -0
package/docs/en/agents/index.html +1925 -0
package/docs/en/architecture/index.html +2187 -0
package/docs/en/examples-and-fixtures/index.html +1888 -0
package/docs/en/help/index.html +2035 -0
package/docs/en/index.html +1895 -0
package/docs/en/licensing/index.html +1917 -0
package/docs/en/migration/index.html +2334 -0
package/docs/en/quickstart/index.html +1919 -0
package/docs/en/recipes/adapter-text-closure/index.html +2000 -0
package/docs/en/recipes/adopt-existing-repository/index.html +1986 -0
package/docs/en/recipes/deterministic-human-report/index.html +1998 -0
package/docs/en/recipes/domain-schema-validation/index.html +2007 -0
package/docs/en/recipes/durable-local-state/index.html +2009 -0
package/docs/en/recipes/host-profile-integration/index.html +2001 -0
package/docs/en/recipes/index.html +1876 -0
package/docs/en/recipes/safe-filesystem-and-atomic-write/index.html +1994 -0
package/docs/en/reference/api/index.html +1917 -0
package/docs/en/reference/compatibility/index.html +1990 -0
package/docs/en/reference/failure-and-side-effect-matrix/index.html +2216 -0
package/docs/examples-and-fixtures/index.html +1871 -0
package/docs/git-lifecycle/index.html +1508 -482
package/docs/help/index.html +1655 -554
package/docs/index.html +1479 -450
package/docs/integration/audit/failure-evidence/index.html +1488 -462
package/docs/integration/audit/independence/index.html +1513 -487
package/docs/integration/audit/index.html +1514 -488
package/docs/integration/audit/mutation-taxonomy/index.html +1548 -522
package/docs/integration/audit/version-compatibility/index.html +1489 -463
package/docs/licensing/index.html +1917 -0
package/docs/migration/index.html +1678 -586
package/docs/public/status/index.html +1542 -516
package/docs/quickstart/index.html +1589 -539
package/docs/recipes/adapter-text-closure/index.html +2000 -0
package/docs/recipes/adopt-existing-repository/index.html +1986 -0
package/docs/recipes/deterministic-human-report/index.html +1998 -0
package/docs/recipes/domain-schema-validation/index.html +2007 -0
package/docs/recipes/durable-local-state/index.html +2009 -0
package/docs/recipes/host-profile-integration/index.html +2001 -0
package/docs/recipes/index.html +1876 -0
package/docs/recipes/safe-filesystem-and-atomic-write/index.html +1994 -0
package/docs/reference/api/contracts/index.html +2532 -0
package/docs/reference/api/engineering-kit/index.html +2551 -0
package/docs/reference/api/harness/index.html +2608 -0
package/docs/reference/api/index.html +1857 -0
package/docs/reference/compatibility/index.html +1990 -0
package/docs/reference/failure-and-side-effect-matrix/index.html +2216 -0
package/docs/search/search_index.json +1 -1
package/docs/setup/index.html +1494 -468
package/docs/sitemap.xml +152 -0
package/package.json +14 -4
package/release-notes/0.2.1.yaml +23 -0

package/docs/recipes/adopt-existing-repository/index.html ADDED Viewed

@@ -0,0 +1,1986 @@
+<!doctype html>
+<html lang="zh" class="no-js">
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+        <meta name="description" content="Skill Family 生命周期公共工程基础设施父工作区">
+        <link rel="canonical" href="https://ifoohoo.github.io/skill-family-engineering-kit/recipes/adopt-existing-repository/">
+        <link rel="prev" href="../">
+        <link rel="next" href="../safe-filesystem-and-atomic-write/">
+      <link rel="icon" href="../../assets/images/favicon.png">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
+        <title>中文 · 采用存量仓库 - Skill Family Foundation</title>
+      <link rel="stylesheet" href="../../assets/stylesheets/main.ec1eaa64.min.css">
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+  </head>
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+        <a href="#Recipe存量仓只读采用盘点" class="md-skip">
+          跳转至
+        </a>
+    </div>
+    <div data-md-component="announce">
+    </div>
+<header class="md-header md-header--shadow" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="页眉">
+    <a href="../.." title="Skill Family Foundation" class="md-header__button md-logo" aria-label="Skill Family Foundation" data-md-component="logo">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            Skill Family Foundation
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+              中文 · 采用存量仓库
+          </span>
+        </div>
+      </div>
+    </div>
+        <form class="md-header__option" data-md-component="palette">
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="切换到深色模式"  type="radio" name="__palette" id="__palette_0">
+      <label class="md-header__button md-icon" title="切换到深色模式" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
+      </label>
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo"  aria-label="切换到浅色模式"  type="radio" name="__palette" id="__palette_1">
+      <label class="md-header__button md-icon" title="切换到浅色模式" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
+      </label>
+</form>
+      <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+        <label class="md-header__button md-icon" for="__search">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
+        </label>
+        <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="搜索" placeholder="搜索" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="查找">
+        <button type="reset" class="md-search__icon md-icon" title="清空当前内容" aria-label="清空当前内容" tabindex="-1">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
+        </button>
+      </nav>
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            正在初始化搜索引擎
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+  </nav>
+</header>
+    <div class="md-container" data-md-component="container">
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--primary" aria-label="导航栏" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="Skill Family Foundation" class="md-nav__button md-logo" aria-label="Skill Family Foundation" data-md-component="logo">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
+    </a>
+    Skill Family Foundation
+  </label>
+  <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 首页
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../setup/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 安装与环境
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../quickstart/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 快速开始
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../git-lifecycle/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Git 生命周期指南
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../help/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 能力与诊断
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../architecture/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 架构边界
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../public/status/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 公开状态
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../migration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 存量采用与迁移
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../licensing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 许可与署名
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../agents/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 智能体入口
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../agents/architecture-routing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 架构路由
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../reference/compatibility/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 兼容性
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../reference/failure-and-side-effect-matrix/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 失败与副作用
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../reference/api/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · API 参考
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../reference/api/contracts/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Contracts API
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../reference/api/harness/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Harness API
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../reference/api/engineering-kit/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Engineering Kit API
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../examples-and-fixtures/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 样例与 Fixture
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Recipes
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item md-nav__item--active">
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+  <span class="md-ellipsis">
+    中文 · 采用存量仓库
+  </span>
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <a href="./" class="md-nav__link md-nav__link--active">
+  <span class="md-ellipsis">
+    中文 · 采用存量仓库
+  </span>
+      </a>
+<nav class="md-nav md-nav--secondary" aria-label="目录">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      目录
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#1-场景与非场景" class="md-nav__link">
+    <span class="md-ellipsis">
+        1. 场景与非场景
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#2-架构选择及能力-ID" class="md-nav__link">
+    <span class="md-ellipsis">
+        2. 架构选择及能力 ID
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#3-前置条件与信任边界" class="md-nav__link">
+    <span class="md-ellipsis">
+        3. 前置条件与信任边界
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#4-最小命令" class="md-nav__link">
+    <span class="md-ellipsis">
+        4. 最小命令
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#5-预期输出与证据" class="md-nav__link">
+    <span class="md-ellipsis">
+        5. 预期输出与证据
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#6-安全失败负例" class="md-nav__link">
+    <span class="md-ellipsis">
+        6. 安全/失败负例
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#7-可复制验证命令" class="md-nav__link">
+    <span class="md-ellipsis">
+        7. 可复制验证命令
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#8-调用方继续拥有的业务逻辑" class="md-nav__link">
+    <span class="md-ellipsis">
+        8. 调用方继续拥有的业务逻辑
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#9-升级与回滚注意事项" class="md-nav__link">
+    <span class="md-ellipsis">
+        9. 升级与回滚注意事项
+    </span>
+  </a>
+</li>
+    </ul>
+</nav>
+    </li>
+    <li class="md-nav__item">
+      <a href="../safe-filesystem-and-atomic-write/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 安全文件系统与原子写
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../adapter-text-closure/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Adapter 文本闭包
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../deterministic-human-report/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 确定性人类报告
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../durable-local-state/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 持久本地状态
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../host-profile-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 宿主 Profile 集成
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../domain-schema-validation/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 领域 Schema 校验
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Home
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/quickstart/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Quickstart
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/help/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Capabilities and diagnostics
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/architecture/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Architecture
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/migration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Migration
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/licensing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Licensing
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/agents/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Agent entry
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/agents/architecture-routing/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Architecture routing
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/reference/compatibility/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Compatibility
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/reference/failure-and-side-effect-matrix/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Failures and side effects
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/reference/api/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · API reference
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/examples-and-fixtures/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Examples and fixtures
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Recipes
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/adopt-existing-repository/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Adopt an existing repository
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/safe-filesystem-and-atomic-write/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Safe filesystem and atomic write
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/adapter-text-closure/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Adapter text closure
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/deterministic-human-report/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Deterministic human report
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/durable-local-state/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Durable local state
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/host-profile-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Host Profile integration
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../en/recipes/domain-schema-validation/" class="md-nav__link">
+  <span class="md-ellipsis">
+    English · Domain Schema validation
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 入口
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/mutation-taxonomy/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 变异分类学
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/independence/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 独立性证明
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/version-compatibility/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 版本兼容
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../integration/audit/failure-evidence/" class="md-nav__link">
+  <span class="md-ellipsis">
+    审计集成 · 失败证据与 AUD 码
+  </span>
+      </a>
+    </li>
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+<nav class="md-nav md-nav--secondary" aria-label="目录">
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      目录
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+        <li class="md-nav__item">
+  <a href="#1-场景与非场景" class="md-nav__link">
+    <span class="md-ellipsis">
+        1. 场景与非场景
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#2-架构选择及能力-ID" class="md-nav__link">
+    <span class="md-ellipsis">
+        2. 架构选择及能力 ID
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#3-前置条件与信任边界" class="md-nav__link">
+    <span class="md-ellipsis">
+        3. 前置条件与信任边界
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#4-最小命令" class="md-nav__link">
+    <span class="md-ellipsis">
+        4. 最小命令
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#5-预期输出与证据" class="md-nav__link">
+    <span class="md-ellipsis">
+        5. 预期输出与证据
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#6-安全失败负例" class="md-nav__link">
+    <span class="md-ellipsis">
+        6. 安全/失败负例
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#7-可复制验证命令" class="md-nav__link">
+    <span class="md-ellipsis">
+        7. 可复制验证命令
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#8-调用方继续拥有的业务逻辑" class="md-nav__link">
+    <span class="md-ellipsis">
+        8. 调用方继续拥有的业务逻辑
+    </span>
+  </a>
+</li>
+        <li class="md-nav__item">
+  <a href="#9-升级与回滚注意事项" class="md-nav__link">
+    <span class="md-ellipsis">
+        9. 升级与回滚注意事项
+    </span>
+  </a>
+</li>
+    </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+<blockquote>
+<p><a href="../../en/recipes/adopt-existing-repository/">English</a></p>
+</blockquote>
+<h1 id="Recipe存量仓只读采用盘点">Recipe：存量仓只读采用盘点<a class="headerlink" href="#Recipe存量仓只读采用盘点" title="Permanent link">&para;</a></h1>
+<h2 id="1-场景与非场景">1. 场景与非场景<a class="headerlink" href="#1-场景与非场景" title="Permanent link">&para;</a></h2>
+<p>适用：需要对一个已存在的存量仓判断是否可采用 Foundation，并拿到精确写集、冲突与旧实现退出清单，且不改动任何字节。</p>
+<p>不适用：需要自动改写存量仓（禁止写文件、禁止自动迁移）；需要发布到远端（归 release-skill）。</p>
+<h2 id="2-架构选择及能力-ID">2. 架构选择及能力 ID<a class="headerlink" href="#2-架构选择及能力-ID" title="Permanent link">&para;</a></h2>
+<p>首选能力：<code>foundation.kit.adopt-plan</code>（严格只读盘点与完成判定）。它只输出，不写文件、不运行 git 写命令。</p>
+<h2 id="3-前置条件与信任边界">3. 前置条件与信任边界<a class="headerlink" href="#3-前置条件与信任边界" title="Permanent link">&para;</a></h2>
+<ul>
+<li>目标仓存在且可被只读访问。</li>
+<li>信任边界：<code>adopt-plan</code> 对输入仓字节零变化；旧实现删除由调用方负责，工具绝不代为删除。</li>
+</ul>
+<h2 id="4-最小命令">4. 最小命令<a class="headerlink" href="#4-最小命令" title="Permanent link">&para;</a></h2>
+<pre><code class="language-sh">npm install --save-dev skill-family-engineering-kit@0.2.1
+npm exec -- skill-family-kit adopt-plan --root &lt;repo&gt;
+</code></pre>
+<h2 id="5-预期输出与证据">5. 预期输出与证据<a class="headerlink" href="#5-预期输出与证据" title="Permanent link">&para;</a></h2>
+<p>输出包含现状（<code>target</code>）、目标 Profile 与追溯（<code>project</code>/<code>traceability</code>）、只读 Git 前置状态（<code>git</code>）、精确写集（<code>writeSet</code>）、冲突（<code>conflicts</code>）、风险（<code>risks</code>）、迁移状态机（<code>migration</code>）与验收命令序列（<code>verificationPlan</code>）。证据来自 <code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code> 与 <code>test/migration.test.mjs</code>。</p>
+<h2 id="6-安全失败负例">6. 安全/失败负例<a class="headerlink" href="#6-安全失败负例" title="Permanent link">&para;</a></h2>
+<p>dirty 仓运行 <code>adopt-plan</code> 前后，输入仓字节必须完全一致（哈希走查可证）；工具不写临时文件、不触碰远端。若迁移清单缺 <code>exceptions</code> 必填字段，计划直接失败（完成判定 false），工具不续期。</p>
+<h2 id="7-可复制验证命令">7. 可复制验证命令<a class="headerlink" href="#7-可复制验证命令" title="Permanent link">&para;</a></h2>
+<pre><code class="language-sh"># 正例：对公开 fixture 存量仓做只读盘点
+npm exec -- skill-family-kit adopt-plan --root fixtures/m0-consumer
+# 只读诊断，不修复
+npm exec -- skill-family-kit check --root fixtures/m0-consumer
+</code></pre>
+<h2 id="8-调用方继续拥有的业务逻辑">8. 调用方继续拥有的业务逻辑<a class="headerlink" href="#8-调用方继续拥有的业务逻辑" title="Permanent link">&para;</a></h2>
+<ul>
+<li>旧实现是否退出、何时删除（工具只评估存在性并列出退出清单）。</li>
+<li><code>business-logic-to-keep</code> 与 <code>legacy-removal-recovery</code> 恒为 INCOMPLETE，必须由人类负责人给出。</li>
+</ul>
+<h2 id="9-升级与回滚注意事项">9. 升级与回滚注意事项<a class="headerlink" href="#9-升级与回滚注意事项" title="Permanent link">&para;</a></h2>
+<ul>
+<li><code>adopt-plan</code> 只读，无写风险，无需回滚。</li>
+<li>真正落盘由 <code>scaffold</code>/<code>projection</code> 执行，回滚以 <code>adoptionProof</code> 与 <code>foundationPlanDigest</code> 双摘要绑定为准；未声明 <code>expect.sha256</code> 前置状态的覆盖动作在 <code>projection</code> 阶段即拒绝。</li>
+</ul>
+              </article>
+            </div>
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+      </main>
+        <footer class="md-footer">
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+</div>
+    </div>
+  </div>
+</footer>
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+      <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": [], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "\u5df2\u590d\u5236", "clipboard.copy": "\u590d\u5236", "search.result.more.one": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.more.other": "\u5728\u8be5\u9875\u4e0a\u8fd8\u6709 # \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.none": "\u6ca1\u6709\u627e\u5230\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.one": "\u627e\u5230 1 \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.other": "# \u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u7ed3\u679c", "search.result.placeholder": "\u952e\u5165\u4ee5\u5f00\u59cb\u641c\u7d22", "search.result.term.missing": "\u7f3a\u5c11", "select.version": "\u9009\u62e9\u5f53\u524d\u7248\u672c"}, "version": null}</script>
+      <script src="../../assets/javascripts/bundle.d7400e89.min.js"></script>
+  </body>
+</html>