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/quickstart/index.html CHANGED Viewed

@@ -2,100 +2,100 @@
 <!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/quickstart/">
         <link rel="prev" href="../setup/">
         <link rel="next" href="../git-lifecycle/">
       <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>
+        <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="#快速开始" 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">
@@ -107,49 +107,49 @@
         </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">
@@ -158,19 +158,19 @@
     <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>
@@ -184,632 +184,1683 @@
     </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 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="#第一次本地验证" class="md-nav__link">
+  <a href="#新项目生成骨架" class="md-nav__link">
     <span class="md-ellipsis">
-        第一次本地验证
+        新项目：生成骨架
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#接手开发" class="md-nav__link">
+  <a href="#存量项目只读盘点" class="md-nav__link">
     <span class="md-ellipsis">
-        接手开发
+        存量项目：只读盘点
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#试运行-Kit-四命令" class="md-nav__link">
+  <a href="#架构设计者判定归属" class="md-nav__link">
     <span class="md-ellipsis">
-        试运行 Kit 四命令
+        架构设计者：判定归属
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#消费坐标" class="md-nav__link">
+  <a href="#权威事实与规范" class="md-nav__link">
     <span class="md-ellipsis">
-        消费坐标
+        权威事实与规范
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#文档自检" class="md-nav__link">
+  <a href="#路径对照" class="md-nav__link">
     <span class="md-ellipsis">
-        文档自检
+        路径对照
     </span>
   </a>
 </li>
     </ul>
 </nav>
     </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>
+    中文 · Git 生命周期指南
-    <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="../integration/audit/" class="md-nav__link">
-  <span class="md-ellipsis">
-    独立审计集成
+      <a href="../help/" class="md-nav__link">
-  </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>
+    中文 · 能力与诊断
+  </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="../recipes/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Recipes
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/adopt-existing-repository/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 采用存量仓库
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/safe-filesystem-and-atomic-write/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 安全文件系统与原子写
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/adapter-text-closure/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · Adapter 文本闭包
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/deterministic-human-report/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 确定性人类报告
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/durable-local-state/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 持久本地状态
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/host-profile-integration/" class="md-nav__link">
+  <span class="md-ellipsis">
+    中文 · 宿主 Profile 集成
+  </span>
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../recipes/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 码
+    审计集成 · 失败证据与 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="#第一次本地验证" class="md-nav__link">
+  <a href="#新项目生成骨架" class="md-nav__link">
     <span class="md-ellipsis">
-        第一次本地验证
+        新项目：生成骨架
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#接手开发" class="md-nav__link">
+  <a href="#存量项目只读盘点" class="md-nav__link">
     <span class="md-ellipsis">
-        接手开发
+        存量项目：只读盘点
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#试运行-Kit-四命令" class="md-nav__link">
+  <a href="#架构设计者判定归属" class="md-nav__link">
     <span class="md-ellipsis">
-        试运行 Kit 四命令
+        架构设计者：判定归属
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#消费坐标" class="md-nav__link">
+  <a href="#权威事实与规范" class="md-nav__link">
     <span class="md-ellipsis">
-        消费坐标
+        权威事实与规范
     </span>
   </a>
 </li>
         <li class="md-nav__item">
-  <a href="#文档自检" class="md-nav__link">
+  <a href="#路径对照" class="md-nav__link">
     <span class="md-ellipsis">
-        文档自检
+        路径对照
     </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/quickstart/">English</a></p>
+</blockquote>
 <h1 id="快速开始">快速开始<a class="headerlink" href="#快速开始" title="Permanent link">&para;</a></h1>
-<h2 id="第一次本地验证">第一次本地验证<a class="headerlink" href="#第一次本地验证" title="Permanent link">&para;</a></h2>
-<pre><code class="language-bash">pnpm install
-pnpm synth
-pnpm check
+<p>本页给三类读者各给一条最短成功路径：新项目、存量项目、架构设计者。每条路径只列必做动作与验证命令，深入细节转到对应文档。</p>
+<h2 id="新项目生成骨架">新项目：生成骨架<a class="headerlink" href="#新项目生成骨架" title="Permanent link">&para;</a></h2>
+<p>目标是从零拿到一个符合 Foundation 契约的项目骨架。</p>
+<pre><code class="language-sh">npm install --save-dev skill-family-engineering-kit
+npm exec -- skill-family-kit scaffold --root ./my-project --project-id my-project
+npm exec -- skill-family-kit check --root ./my-project
+</code></pre>
+<p>以上命令先生成骨架，再对生成结果做工程诊断。<code>scaffold</code> 只写空目标目录，非空或冲突目标会被拒绝且不被触碰；<code>check</code> 只诊断不修复。验证以 <code>check</code> 退出码 0 为通过。</p>
+<h2 id="存量项目只读盘点">存量项目：只读盘点<a class="headerlink" href="#存量项目只读盘点" title="Permanent link">&para;</a></h2>
+<p>目标是先看清存量仓能否采用，不改动任何字节。</p>
+<pre><code class="language-sh">npm exec -- skill-family-kit adopt-plan --root ./existing-repo
+npm exec -- skill-family-kit check --root ./existing-repo
 </code></pre>
-<p><code>pnpm check</code> 退出码 0 即统一根门禁全部通过：稳定门禁 ID 按固定顺序串联执行。逐 ID 清单与产品级当前状态见 当前产品状态。</p>
-<h2 id="接手开发">接手开发<a class="headerlink" href="#接手开发" title="Permanent link">&para;</a></h2>
+<p><code>adopt-plan</code> 输出现状、目标 Profile、精确写集、冲突与旧实现退出清单，且对输入仓字节零变化。<code>check</code> 只做只读诊断。确认盘点结果后再决定是否执行写入。</p>
+<h2 id="架构设计者判定归属">架构设计者：判定归属<a class="headerlink" href="#架构设计者判定归属" title="Permanent link">&para;</a></h2>
+<p>目标是判断一个架构需求该落在 Foundation 哪一层，还是留在消费者。</p>
 <ol>
-<li>完整读取根级 <code>AGENTS.md</code>（工程约定）与 <a href="../git-lifecycle/">Git 生命周期指南</a>（Git 写操作的授权边界）；</li>
-<li>只修改当前任务授权的写集，不顺手修改无关文件；</li>
-<li>运行任务指定的验收命令和根 <code>pnpm check</code>，记录退出码；</li>
-<li>汇报证据、剩余风险和未执行的外部动作（commit、push、发布等默认全部不执行）。</li>
+<li>读 <code>docs/agents/architecture-routing.md</code> 的八步决策顺序。</li>
+<li>在 <code>docs/agents/capability-catalog.json</code> 按 <code>layer</code> 与 <code>intent</code> 找到能力，读它的 <code>entrypoints</code>、<code>sideEffects</code>、<code>failureSemantics</code>、<code>ownedByCaller</code>。</li>
+<li>需要发布、任务生命周期或制品关系时，分别转 release-skill、loop-agent、artifact-graph。</li>
 </ol>
-<p>不要把当前的种子 JSON 当作正式 Contracts，也不要在一个任务里同时实现 Contracts、Harness、Kit、审计和迁移。</p>
-<h2 id="试运行-Kit-四命令">试运行 Kit 四命令<a class="headerlink" href="#试运行-Kit-四命令" title="Permanent link">&para;</a></h2>
-<p>安装 Kit 包（<code>skill-family-engineering-kit</code> 的发布包或本地打包产出的 tarball）后，稳定入口是该包登记的 bin（指向 <code>src/cli.mjs</code>）；默认许可证 Profile 随包闭包解析，无需 <code>--profiles-root</code>：</p>
-<pre><code class="language-bash"># 在空目录生成完整项目骨架（目标必须为空，写入全部原子且受路径收容）
-npx skill-family-engineering-kit scaffold --root ./demo-project --project-id demo-project
+<blockquote>
+<p>路由的硬边界：Foundation 不拥有远端写入、业务状态机、模型编排与领域审计语义。落入 <code>keep-business</code> 或 <code>foundation-gap</code> 的能力不强行扩张 Foundation。</p>
+</blockquote>
+<h2 id="权威事实与规范">权威事实与规范<a class="headerlink" href="#权威事实与规范" title="Permanent link">&para;</a></h2>
+<ul>
+<li>当前产品状态（版本、包集合、镜像坐标、门禁）：当前产品状态（唯一状态页，本页不复制）。</li>
+<li>开发与提交规范：<a href="../git-lifecycle/">Git 生命周期指南</a>。</li>
+</ul>
+<h2 id="路径对照">路径对照<a class="headerlink" href="#路径对照" title="Permanent link">&para;</a></h2>
+<table>
+<thead>
+<tr>
+<th>读者</th>
+<th>起点</th>
+<th>下一步</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>新项目</td>
+<td><code>scaffold</code></td>
+<td><code>check</code> → 接入 Profile</td>
+</tr>
+<tr>
+<td>存量项目</td>
+<td><code>adopt-plan</code></td>
+<td>分类（direct-adoption / compatibility-layer / keep-business / foundation-gap）→ 采用</td>
+</tr>
+<tr>
+<td>架构设计者</td>
+<td>路由决策</td>
+<td>能力目录 → 真实导出与测试</td>
+</tr>
+</tbody>
+</table>
-# 对骨架目标做诊断（退出码 0 = 无发现）
-npx skill-family-engineering-kit check --root ./demo-project
-# 对存量仓做严格只读的采用规划（不写任何文件，计划输出到 stdout）
-npx skill-family-engineering-kit adopt-plan --root .
-</code></pre>
-<p>本 monorepo 内也可等价使用 <code>node packages/skill-family-engineering-kit/src/cli.mjs &lt;command&gt;</code>；总帮助（恰好四个顶层命令及各自的副作用声明）用 <code>--help</code> 查看。</p>
-<p>退出码约定：0 成功或无发现；1 <code>check</code> 有发现；2 拒绝、用法或机制错误。错误消息携带已注册的 SFC 错误码。命令副作用与诊断分类详见 <a href="../help/">能力与诊断</a>。</p>
-<h2 id="消费坐标">消费坐标<a class="headerlink" href="#消费坐标" title="Permanent link">&para;</a></h2>
-<p>三个叶子包（<code>skill-family-contracts</code>、<code>skill-family-harness-node</code>、<code>skill-family-engineering-kit</code>）经 npm 与对应的 public 发布镜像分发。发布镜像不承载完整开发历史与测试，也不接受直接 PR；钉住的消费坐标与当前发布状态唯一记录在 当前产品状态。</p>
-<h2 id="文档自检">文档自检<a class="headerlink" href="#文档自检" title="Permanent link">&para;</a></h2>
-<p>修改文档后运行：</p>
-<pre><code class="language-bash">node scripts/docs/fact-check.mjs
-node scripts/docs/link-check.mjs
-</code></pre>
-<p>事实检查对照机器真源（manifest、package.json、Contracts 登记、版本锁与工作流），链接检查解析全部站内相对链接与锚点。</p>
@@ -822,48 +1873,47 @@ node scripts/docs/link-check.mjs
               </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>