skill-family-engineering-kit 0.24.1 → 0.26.0

package/data/hosts/workbuddy/host-descriptor.json

@@ -18,6 +18,13 @@
       "scope": "project",
       "anchor": "project-root",
       "relPath": "skills"
+    },
+    {
+      "id": "workbuddy-project-skills",
+      "role": "skill-root",
+      "scope": "project",
+      "anchor": "project-root",
+      "relPath": ".workbuddy/skills"
     }
   ],
   "probeCapabilities": [

package/docs/agents/capability-catalog.en.json

@@ -1459,6 +1459,54 @@
     "Auto-remediation: the caller"
    ]
   },
+  {
+   "id": "foundation.kit.host-loading-check",
+   "intent": "Statically check whether Skill files under a project .agents/skills tree would load under calibrated Codex CLI 0.154.0 rules",
+   "useWhen": [
+    "Need to inspect project .agents/skills load format, ignored optional metadata, product filtering, implicit invocation, disablement, and uncovered cases before handing Skills to Codex",
+    "Need to reuse Foundation's central calibration instead of launching a real host per family"
+   ],
+   "doNotUseWhen": [
+    "Need to inspect user, system, admin, or ancestor plugin skill roots",
+    "Need to prove real install, session selection, or business execution",
+    "Need to run a target Skill, hook, script, model, or network call"
+   ],
+   "prerequisites": [
+    "Caller supplies an absolute project working directory",
+    "hostId resolves to codex, hostVersion is 0.154.0, and pathCategory is codex-project-skills"
+   ],
+   "inputs": [
+    "Absolute project working directory root",
+    "hostId, hostVersion, and pathCategory",
+    "Optional ordered activationRules (name XOR path plus enabled)"
+   ],
+   "outputs": [
+    "host-loading-check report (kind skill-family.host-loading-check-report)",
+    "Exit 0 means the requested scope completed with no blocking findings; 1 means proven blocking or missing entries; 2 means input, mechanism, or coverage is incomplete"
+   ],
+   "sideEffects": [
+    "None (read-only: no file or temp writes, no process spawn, no network)"
+   ],
+   "failureSemantics": [
+    "Missing discovery root or no SKILL.md returns 1",
+    "Unknown version, unknown pathCategory, illegal selectors, rewritten .agents/skills mapping, directory-symlink mechanism limits, and uncovered interface asset paths return 2",
+    "Bad optional agents/openai.yaml is recorded as ignored for the whole document and does not fail skill loading",
+    "policy.products [chatgpt] is filtered from the Codex discoverable set; [codex] is kept; allow_implicit_invocation=false may still be enabled"
+   ],
+   "invariants": [
+    "Adds no fifth top-level command; it runs as the check host-loading sub-action",
+    "Same-name different paths are all retained",
+    "enabled is unknown when the caller omits activationRules"
+   ],
+   "ownedByCaller": [
+    "Remediation of blocking findings",
+    "Consumer verification on a published package"
+   ],
+   "routeElsewhere": [
+    "Real-host qualification: check qualification",
+    "Foundation entry contract: check entries"
+   ]
+  },
   {
    "id": "foundation.kit.relock",
    "intent": "Run the controlled relock transaction: register new handwritten files by default, or persistent tool-lock paths with explicit trackedToolLocks selection; update the registry and managed-file lock in the existing transaction without hashing tool-lock contents.",

package/docs/agents/capability-catalog.json

@@ -968,6 +968,34 @@
     "packages/skill-family-engineering-kit/test/entry-check.test.mjs"
    ]
   },
+  {
+   "id": "foundation.kit.host-loading-check",
+   "package": "skill-family-engineering-kit",
+   "layer": "engineering-kit",
+   "since": "0.25.0",
+   "stability": "candidate",
+   "migration": "none",
+   "promotionPolicy": "consumer-transparent",
+   "adoptionScopes": ["engineering-kit"],
+   "entrypoints": [
+    "runHostLoadingCheck (packages/skill-family-engineering-kit/src/host-loading-check.mjs)",
+    "checkHostLoadingAction (packages/skill-family-engineering-kit/src/host-loading-check.mjs)",
+    "HOST_LOADING_CHECK_REPORT_KIND (packages/skill-family-engineering-kit/src/host-loading-check.mjs)"
+   ],
+   "sourceRefs": [
+    "packages/skill-family-engineering-kit/src/host-loading-check.mjs",
+    "packages/skill-family-engineering-kit/src/cli.mjs",
+    "packages/skill-family-engineering-kit/src/index.mjs"
+   ],
+   "positiveTestRefs": [
+    "packages/skill-family-engineering-kit/test/host-loading-check.test.mjs",
+    "packages/skill-family-engineering-kit/test/cli.test.mjs"
+   ],
+   "negativeTestRefs": [
+    "packages/skill-family-engineering-kit/test/host-loading-check.test.mjs",
+    "packages/skill-family-engineering-kit/test/cli.test.mjs"
+   ]
+  },
   {
    "id": "foundation.kit.relock",
    "package": "skill-family-engineering-kit",

package/docs/agents/capability-catalog.zh-CN.json

@@ -1458,6 +1458,54 @@
     "自动整改：调用方"
    ]
   },
+  {
+   "id": "foundation.kit.host-loading-check",
+   "intent": "按 Codex CLI 0.154.0 已校准规则，只读检查项目根 .agents/skills 内 Skill 是否会被宿主当作可加载条目",
+   "useWhen": [
+    "需要在把 Skill 交给 Codex 之前核对项目 .agents/skills 的加载格式、忽略、过滤、隐式调用、禁用和未覆盖项",
+    "需要复用 Foundation 集中校准，而不是每个技能族各自启动真实宿主"
+   ],
+   "doNotUseWhen": [
+    "需要检查用户全局、系统、管理员或祖先插件技能根",
+    "需要证明真实安装、会话选择或业务执行已经成功",
+    "需要运行目标 Skill、hook、脚本、模型或联网"
+   ],
+   "prerequisites": [
+    "调用方给出绝对项目工作目录",
+    "hostId 可解析为 codex，hostVersion 为 0.154.0，pathCategory 为 codex-project-skills"
+   ],
+   "inputs": [
+    "绝对项目工作目录 root",
+    "hostId、hostVersion、pathCategory",
+    "可选有序 activationRules（name 或 path 与 enabled）"
+   ],
+   "outputs": [
+    "host-loading-check 报告（kind skill-family.host-loading-check-report）",
+    "退出码 0 表示请求范围完整且无阻断发现；1 表示已证实阻断或缺少入口；2 表示输入、机制或覆盖未完成"
+   ],
+   "sideEffects": [
+    "无（只读：不写文件或临时文件，不启动进程，不联网）"
+   ],
+   "failureSemantics": [
+    "缺发现根或没有 SKILL.md 返回 1",
+    "未知版本、未知 pathCategory、非法选择器、.agents/skills 映射被改写、目录符号链接机制边界、界面资产路径未覆盖返回 2",
+    "坏的可选 agents/openai.yaml 记为 ignored，整份元信息忽略，不作为技能加载失败",
+    "policy.products [chatgpt] 从 Codex 可发现集合过滤；[codex] 保留；allow_implicit_invocation=false 仍可 enabled"
+   ],
+   "invariants": [
+    "不新增第五个顶层命令，落在 check host-loading 子动作",
+    "同名不同路径全部保留",
+    "缺省启用规则时 enabled 未知"
+   ],
+   "ownedByCaller": [
+    "对阻断发现的整改",
+    "正式发布包上的消费者验收"
+   ],
+   "routeElsewhere": [
+    "真实宿主资格：check qualification",
+    "Foundation 入口契约：check entries"
+   ]
+  },
   {
    "id": "foundation.kit.relock",
    "intent": "运行受控 relock 事务：默认登记新增手写文件；显式选择 trackedToolLocks 时登记持久工具锁路径，并在原事务中同步 registry 与受管文件锁。工具锁内容不纳入受管摘要。",

package/docs/public/status/index.html

@@ -1814,24 +1814,24 @@
 <tbody>
 <tr>
 <td><code>skill-family-contracts</code></td>
-<td>0.24.1</td>
+<td>0.26.0</td>
 <td><a href="https://github.com/ifoohoo/skill-family-contracts">ifoohoo/skill-family-contracts</a></td>
 </tr>
 <tr>
 <td><code>skill-family-harness-node</code></td>
-<td>0.24.1</td>
+<td>0.26.0</td>
 <td><a href="https://github.com/ifoohoo/skill-family-harness-node">ifoohoo/skill-family-harness-node</a></td>
 </tr>
 <tr>
 <td><code>skill-family-engineering-kit</code></td>
-<td>0.24.1</td>
+<td>0.26.0</td>
 <td><a href="https://github.com/ifoohoo/skill-family-engineering-kit">ifoohoo/skill-family-engineering-kit</a></td>
 </tr>
 </tbody>
 </table>
 <h2 id="独立-Plugin">独立 Plugin<a class="headerlink" href="#独立-Plugin" title="Permanent link">&para;</a></h2>
 <ul>
-<li><code>foundation-adoption-review</code>：0.24.1，公开镜像 <a href="https://github.com/ifoohoo/foundation-adoption-review">ifoohoo/foundation-adoption-review</a></li>
+<li><code>foundation-adoption-review</code>：0.26.0，公开镜像 <a href="https://github.com/ifoohoo/foundation-adoption-review">ifoohoo/foundation-adoption-review</a></li>
 <li><code>foundation-adoption-review</code>：只读采用诊断</li>
 <li><code>foundation-engineering-check</code>：只读静态工程审阅与证明读取</li>
 <li><code>foundation-initialize</code>：在明确授权下初始化目标工程，保留业务和人工判断</li>