npm - skill-family-engineering-kit - Versions diffs - 0.4.0 → 0.5.0 - Mend

skill-family-engineering-kit 0.4.0 → 0.5.0

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 (14) hide show

package/CHANGELOG.md +20 -0
package/CHANGELOG.zh-CN.md +20 -0
package/README.md +8 -9
package/README.zh-CN.md +8 -9
package/docs/agents/capability-catalog.en.json +74 -1
package/docs/agents/capability-catalog.json +39 -0
package/docs/agents/capability-catalog.zh-CN.json +74 -1
package/docs/architecture/index.html +3 -3
package/docs/integration/audit/index.html +1 -1
package/docs/integration/audit/version-compatibility/index.html +4 -3
package/docs/public/status/index.html +3 -3
package/docs/search/search_index.json +1 -1
package/package.json +3 -3
package/release-notes/0.5.0.yaml +21 -0

package/docs/search/search_index.json CHANGED Viewed

	@@ -1 +1 @@
1	- {"config":{"lang":["en"],"separator":"[\\s\\u200b\\u3000\\-\u3001\u3002\uff0c\uff0e\uff1f\uff01\uff1b]+","pipeline":["stemmer"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"\u4e2d\u6587 \u00b7 \u9996\u9875","text":"<p>English</p>"},{"location":"#Skill-Family-Foundation-Workspace","title":"Skill Family Foundation Workspace","text":"<p>Skill Family \u751f\u547d\u5468\u671f\u7684\u516c\u5171\u5de5\u7a0b\u57fa\u7840\u8bbe\u65bd\u7236\u5de5\u4f5c\u533a\u3002\u672c\u4ed3\u63d0\u4f9b\u673a\u5668\u5951\u7ea6\uff08Contracts\uff09\u3001Node \u8584\u8fd0\u884c\u65f6\uff08Harness\uff09\u3001\u5de5\u7a0b\u5de5\u5177\u5305\uff08Engineering Kit\uff09\u3001Profile SPI\u3001\u5b8c\u5168\u865a\u6784\u7684\u901a\u7528\u6837\u4f8b\uff08fixture\uff09\u548c\u5de5\u7a0b\u6587\u6863\u9aa8\u67b6\u3002</p>"},{"location":"#\u5f53\u524d\u72b6\u6001","title":"\u5f53\u524d\u72b6\u6001","text":"<p>\u672c\u4ed3\u662f\u4e00\u5957\u5f00\u53d1\u4e2d\u7684\u9996\u7248\u9aa8\u67b6\u3002\u7248\u672c\u3001\u53d1\u5e03\u3001Pages \u4e0e Git \u7b49\u52a8\u6001\u72b6\u6001\u552f\u4e00\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff1b\u8bb8\u53ef\u8bc1\u5df2\u6279\u51c6\u4e3a Apache License 2.0\uff0c\u7248\u6743\u4e3b\u4f53\u4e3a\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8\uff0c\u89c4\u8303\u5168\u6587\u89c1\u6839\u7ea7 <code>LICENSE</code>\u3002</p> <p>\u672c\u5de5\u4f5c\u533a\u6c38\u4e45 private\uff0c\u662f\u552f\u4e00\u5f00\u53d1\u771f\u6e90\uff1b\u516c\u5f00\u8fb9\u754c\u53ea\u6709\u4e09\u4e2a\u7248\u672c\u5316\u53d1\u5e03\u955c\u50cf\u4e0e npm tarball\uff0c\u9489\u4f4f\u7684\u6d88\u8d39\u5750\u6807\u4e0e\u53d1\u5e03\u72b6\u6001\u552f\u4e00\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u3002</p> <p>\u4ea7\u54c1\u7ea7\u7684\u552f\u4e00\u72b6\u6001\u9875\u662f \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff0c\u7531 <code>node scripts/docs/fact-check.mjs</code> \u5bf9\u7167\u673a\u5668\u771f\u6e90\u673a\u68b0\u6821\u9a8c\uff1b\u5176\u4ed6\u9875\u9762\u4e0d\u627f\u8f7d\u7b2c\u4e8c\u5957\u72b6\u6001\u53e3\u5f84\u3002</p>"},{"location":"#\u9996\u7248\u7ec4\u6210","title":"\u9996\u7248\u7ec4\u6210","text":"\u7ec4\u6210 \u8def\u5f84 \u804c\u8d23 Contracts <code>packages/skill-family-contracts</code> \u673a\u5668\u53ef\u6267\u884c\u5de5\u7a0b\u7ed3\u6784\u548c\u673a\u5236\u534f\u8bae\u7684\u552f\u4e00\u6743\u5a01 Harness <code>packages/skill-family-harness-node</code> \u53ea\u5b9e\u73b0 Contracts \u5b9a\u4e49\u7684\u673a\u5236\u534f\u8bae\uff0c\u4e0d\u62e5\u6709\u4e1a\u52a1\u8bed\u4e49 Engineering Kit <code>packages/skill-family-engineering-kit</code> \u53ea\u63d0\u4f9b <code>scaffold</code>\u3001<code>adopt-plan</code>\u3001<code>projection</code>\u3001<code>check</code> \u56db\u4e2a\u9876\u5c42\u547d\u4ee4 Profile \u79cd\u5b50 <code>profiles/public-plugin</code> \u516c\u5f00\u63d2\u4ef6\u5f62\u6001\u7684 Profile \u79cd\u5b50 \u865a\u6784\u6837\u4f8b <code>fixtures/generic-profile-extension-conformance</code> \u5b8c\u5168\u865a\u6784\u7684\u6269\u5c55\u4e00\u81f4\u6027\u6837\u4f8b <p>\u5305\u6e05\u5355\u3001Profile\u3001fixture \u4e0e\u9876\u5c42\u547d\u4ee4\u4ee5 <code>.foundation/skeleton-manifest.json</code> \u4e3a\u673a\u5668\u771f\u6e90\uff1b\u5de5\u5177\u7248\u672c\u9501\u5b9a\u89c1 <code>.foundation/version-lock.json</code>\u3002</p>"},{"location":"#\u6587\u6863\u5730\u56fe","title":"\u6587\u6863\u5730\u56fe","text":"<ul> <li>\u5b89\u88c5\u4e0e\u73af\u5883\u2014\u2014\u5de5\u5177\u7248\u672c pin\u3001\u5b89\u88c5\u4e0e\u6587\u6863\u7ad9\u70b9\u6784\u5efa</li> <li>\u5feb\u901f\u5f00\u59cb\u2014\u2014\u4ece\u672c\u5730\u9a8c\u8bc1\u5230\u8bd5\u8fd0\u884c\u7684\u6700\u77ed\u8def\u5f84</li> <li>\u80fd\u529b\u4e0e\u8bca\u65ad\u2014\u2014Kit \u56db\u547d\u4ee4\u3001\u9000\u51fa\u7801\u4e0e\u6545\u969c\u6392\u67e5</li> <li>\u67b6\u6784\u8fb9\u754c\u2014\u2014\u5206\u5c42\u3001\u552f\u4e00\u6743\u5a01\u3001\u9884\u7b97\u4e0e\u6587\u6863\u4e8b\u5b9e\u68c0\u67e5</li> <li>\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u2014\u2014\u552f\u4e00\u4ea7\u54c1\u72b6\u6001\u9875</li> <li>Git \u751f\u547d\u5468\u671f\u6307\u5357\u2014\u2014\u5206\u652f\u3001\u63d0\u4ea4\u3001\u63a8\u9001\u4e0e\u53d1\u5e03\u7684\u6388\u6743\u8fb9\u754c</li> </ul>"},{"location":"#\u5199\u4f5c\u8fb9\u754c","title":"\u5199\u4f5c\u8fb9\u754c","text":"<p>\u6587\u6863\u53ea\u6d88\u8d39\u673a\u5668\u771f\u6e90\u6784\u6210\u7684\u51bb\u7ed3\u4e8b\u5b9e\u5305\uff08manifest\u3001package.json\u3001Contracts \u767b\u8bb0\u7b49\uff09\uff0c\u7531 <code>node scripts/docs/fact-check.mjs</code> \u673a\u68b0\u6821\u9a8c\u3002\u6a21\u578b\u540d\u3001\u51ed\u636e\u548c\u8c03\u5ea6\u4fe1\u606f\u4e0d\u8fdb\u5165\u6587\u6863\uff0c\u4e5f\u4e0d\u8fdb\u5165 Contracts\uff1b\u8be6\u89c1 \u67b6\u6784\u8fb9\u754c\u3002</p>"},{"location":"architecture/","title":"\u4e2d\u6587 \u00b7 \u67b6\u6784\u8fb9\u754c","text":"<p>English</p>"},{"location":"architecture/#\u67b6\u6784\u8fb9\u754c","title":"\u67b6\u6784\u8fb9\u754c","text":"<p>\u672c\u9875\u662f Skill Family Foundation \u9762\u5411\u4f7f\u7528\u8005\u7684\u7a33\u5b9a\u67b6\u6784\u6295\u5f71\u3002\u5b83\u53ea\u89e3\u91ca\u7ed3\u6784\u3001\u804c\u8d23\u3001\u8fb9\u754c\u4e0e\u8def\u7531\uff0c\u4e0d\u627f\u8f7d\u52a8\u6001\u53d1\u5e03\u72b6\u6001\uff08\u53d1\u5e03\u72b6\u6001\u53ea\u7531 <code>docs/status/current.md</code> \u8bb0\u5f55\uff0c\u4e14\u7ecf <code>scripts/docs/fact-check.mjs</code> \u673a\u68b0\u6821\u9a8c\uff09\u3002\u6240\u6709\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\u3001\u652f\u6301\u72b6\u6001\u90fd\u4ece\u673a\u5668\u771f\u6e90\u590d\u7b97\u3002</p>"},{"location":"architecture/#\u5206\u5c42","title":"\u5206\u5c42","text":"<p>2026-08-09 \u67b6\u6784 hand-off\uff08FND-ADR-001\uff5e007\uff0cactive\uff0c\u89c1 <code>artifacts/decisions/</code>\uff09\u786e\u7acb\u7684\u5206\u5c42\uff1a\u7eb5\u5411\u4f9d\u8d56\u94fe\u56db\u5c42\uff0c\u6a2a\u5411\u80fd\u529b\u6302\u63a5\uff0c\u4e0d\u65b0\u589e\u7eb5\u5c42\u3002</p> <pre><code>\u6280\u80fd\u65cf\u4e1a\u52a1\uff08\u5404\u4ea7\u54c1\u4ed3\uff1arelease-skill\u3001loop-agent\u3001skill-eval \u7b49\uff09\n \u2502 \u4f9d\u8d56\n \u25bc\nEngineering Kit\uff08scaffold / adopt-plan / projection / check\uff09\n \u2502 \u4f9d\u8d56\n \u25bc\nHarness Node\uff08Contracts \u673a\u5236\u534f\u8bae\u5b9e\u73b0\uff09\n \u2502 \u4f9d\u8d56\n \u25bc\nContracts\uff08\u7ed3\u6784\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001\u534f\u8bae\u540d\u767b\u8bb0\uff09\n \u25b2\n \u2514---------------- independent Audit consumer\n\n\u6a2a\u5411\uff08\u6302\u63a5\u9762\uff0c\u4e0d\u65b0\u589e\u7eb5\u5c42\uff09\uff1a\n- profiles/ \u5bbf\u4e3b\u4e0e\u9879\u76ee\u5f62\u6001\u5dee\u5f02\u58f0\u660e\uff0c\u53ea\u5b9e\u73b0\u7a33\u5b9a SPI\n- \u5bbf\u4e3b \u5916\u90e8 AI \u7f16\u7801\u8fd0\u884c\u73af\u5883\uff1a\u62e5\u6709\u8bed\u4e49\uff0cFoundation \u7edf\u4e00\u7ed3\u6784\u6027\u5dee\u5f02\n- release-skill \u53d1\u5e03\u72b6\u6001\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165\uff0c\u4e0d\u8fdb\u5165 Foundation\n- Artifact Graph `artifacts/` \u67b6\u6784\u5236\u54c1\u4f53\u7cfb\uff0c\u95e8\u7981\u4e3a check:artifacts\n</code></pre> <p>\u7bad\u5934\u6307\u5411\u88ab\u4f9d\u8d56\u65b9\u3002\u516c\u5171\u6838\u5fc3\u4e0d\u5f97\u53cd\u5411\u4f9d\u8d56\u5177\u4f53 Profile \u6216\u5177\u4f53\u6280\u80fd\u65cf\uff1b\u65b0\u80fd\u529b\u7684\u4f9d\u8d56\u65b9\u5411\u843d\u4f4d\u89c1 <code>artifacts/design/FND-DES-001.md</code>\uff0c\u9010\u8d44\u4ea7\u5f52\u5c5e\u89c1 FND-ADR-002\u3002</p>"},{"location":"architecture/#\u804c\u8d23\u77e9\u9635","title":"\u804c\u8d23\u77e9\u9635","text":"<p>\u6bcf\u4e2a\u5206\u5c42\u53ea\u627f\u62c5\u4e0b\u8868\u5217\u51fa\u7684\u804c\u8d23\uff0c\u8d8a\u754c\u80fd\u529b\u4e00\u5f8b\u7531\u5916\u90e8\u9879\u76ee\u6216\u6d88\u8d39\u8005\u62e5\u6709\u3002</p> \u5206\u5c42 \u62e5\u6709 \u4e0d\u62e5\u6709\uff08\u843d\u5728\u522b\u5904\uff09 Contracts \u7ed3\u6784\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001\u534f\u8bae\u540d\u767b\u8bb0\uff1b20 \u7c7b\u9876\u5c42\u5bf9\u8c61\uff1b9 \u6761 mandatory rule \u4e1a\u52a1\u5b57\u6bb5\u8bed\u4e49\u3001\u9886\u57df\u5ba1\u8ba1\u3001\u8fdc\u7aef\u5199\u5165\u3001\u6a21\u578b\u751f\u6210 Harness Contracts \u7684 Node \u673a\u5236\u5b9e\u73b0\uff1b\u8def\u5f84\u6536\u5bb9\u3001\u539f\u5b50\u5199\u3001\u95ed\u5305\u3001\u8bf7\u6c42\u5904\u7406\u3001\u62a5\u544a\u6e32\u67d3\u3001\u5bbf\u4e3b\u63a5\u5165\u673a\u5236\u3001\u72b6\u6001\u5e95\u5ea7 \u4e1a\u52a1\u8bed\u4e49\u3001workflow \u7f16\u6392\u3001\u6a21\u578b\u8c03\u7528\u3001git \u5199\u3001\u7f51\u7edc\u8fdc\u7aef Engineering Kit \u56db\u4e2a\u5de5\u7a0b\u547d\u4ee4\u53ca\u5176\u53ea\u8bfb/\u53d7\u9650\u5199\u5165\u8fb9\u754c\uff1bhost \u5b50\u52a8\u4f5c\u6ce8\u5165\u5177\u4f53 Profile \u81ea\u52a8\u4fee\u590d\u3001\u81ea\u52a8\u8fc1\u79fb\u3001\u8fdc\u7aef\u53d1\u5e03\u3001\u7b2c 5 \u4e2a\u547d\u4ee4 Profile \u5bbf\u4e3b\u4e0e\u9879\u76ee\u5f62\u6001\u5dee\u5f02\u7684\u58f0\u660e\u5f0f SPI\uff1b\u53ea\u5b9e\u73b0\u7a33\u5b9a SPI \u4e1a\u52a1\u8bed\u4e49\u3001\u53ef\u6267\u884c\u811a\u672c\u5165\u53e3\u3001\u516c\u5171\u6838\u5fc3\u53d8\u66f4 release-skill \u53d1\u5e03\u72b6\u6001\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165 Foundation \u4e0d\u542b\u4efb\u4f55 publish/remote-write \u5165\u53e3 loop-agent \u4efb\u52a1\u3001\u91cd\u8bd5\u3001\u8fd4\u5de5\u3001\u9a8c\u6536\u3001\u81ea\u8fed\u4ee3 Foundation \u4e0d\u5b9a\u4e49 workflow \u72b6\u6001\u673a Artifact Graph \u5236\u54c1\u5173\u7cfb\u3001context\u3001packet\u3001version-lock Foundation \u4e0d\u62e5\u6709\u5236\u54c1\u56fe Audit \u72ec\u7acb fixture\u3001\u9884\u671f\u503c\u3001\u88c1\u51b3 \u9886\u57df\u8bed\u4e49\u7ed3\u8bba\u7531\u5916\u90e8\u5ba1\u9605\u62e5\u6709"},{"location":"architecture/#\u80fd\u529b\u5f52\u5c5e\u7b97\u6cd5","title":"\u80fd\u529b\u5f52\u5c5e\u7b97\u6cd5","text":"<p>\u7ed9\u4e00\u4e2a\u67b6\u6784\u9700\u6c42\uff0c\u6309\u4e0b\u9762\u987a\u5e8f\u5224\u5b9a\u5f52\u5c5e\uff0c\u547d\u4e2d\u5373\u505c\uff1a</p> <ol> <li>\u542b\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1 oracle \u2192 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u53ea\u63a5\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\u3002</li> <li>\u662f\u7ed3\u6784\u3001\u534f\u8bae\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u6216\u5bf9\u8c61 Schema \u2192 Contracts\u3002</li> <li>\u662f\u8de8\u6280\u80fd\u65cf\u53ef\u590d\u7528\u7684 Node \u673a\u5236 \u2192 Harness\u3002</li> <li>\u662f scaffold/adopt-plan/projection/check \u6216\u5177\u4f53 host Profile \u6ce8\u5165 \u2192 Kit / Profile\u3002</li> <li>\u6d89\u53ca\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001 \u2192 release-skill\u3002</li> <li>\u6d89\u53ca\u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5/\u9a8c\u6536 \u2192 loop-agent\u3002</li> <li>\u6d89\u53ca\u5236\u54c1\u5173\u7cfb/\u7248\u672c\u9501 \u2192 artifact-graph\u3002</li> <li>\u53ea\u6709\u4e00\u4e2a\u6d88\u8d39\u8005\u6216\u5c1a\u672a\u8bc1\u660e\u8de8\u4e24\u4e2a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d \u2192 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u6269\u5f20 Foundation\u3002</li> </ol> <p>\u7b2c 8 \u6b65\u662f\u6269\u5f20\u95f8\u95e8\uff1a\u65b0\u589e\u7ec4\u4ef6\u5fc5\u987b\u8bf4\u660e\u5220\u9664\u5b83\u4f1a\u8ba9\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\uff0c\u5e76\u7ecf\u72ec\u7acb fixture \u9a8c\u8bc1\uff1b\u8fdb\u5165\u95e8 1 \u53e6\u8981\u6c42\u81f3\u5c11\u4e00\u4e2a\u73b0\u6709\u771f\u5b9e\u6d88\u8d39\u8005\u52a0\u4e00\u4e2a\u7ed3\u6784\u540c\u578b\u7684\u53ef\u9884\u89c1\u6d88\u8d39\u8005\uff08\u7b2c\u4e8c\u6d88\u8d39\u8005\u4e0d\u8981\u6c42\u5df2\u4e0a\u7ebf\uff0c\u4f46\u9700\u6c42\u5fc5\u987b\u80fd\u7528\u540c\u4e00\u7ed3\u6784\u8868\u8fbe\uff0c\u8c03\u6574\u8bb0\u5f55\u89c1 FND-ADR-009\uff09\u3002\u7b2c 9 \u6b65\u662f\u6709\u9650\u5c01\u95ed\u8bed\u4e49\u95f8\u95e8\uff08\u5bf9\u5e94 FND-ADR-001 \u95e8 8\uff09\uff1a\u80fd\u529b\u82e5\u643a\u5e26\u5c11\u91cf\u9886\u57df\u8bed\u4e49\uff0c\u5fc5\u987b\u6ee1\u8db3\u8bed\u4e49\u80fd\u88ab\u5c11\u6570\u7a33\u5b9a\u5c01\u95ed\u679a\u4e3e\u8986\u76d6\uff0c\u6216\u4e3a\u786e\u5b9a\u6027\u4f30\u7b97\u539f\u8bed\u2014\u2014\u7b97\u6cd5\u3001\u9002\u7528\u8303\u56f4\u4e0e\u504f\u5dee\u65b9\u5411\u5df2\u5728\u5951\u7ea6\u4e2d\u58f0\u660e\uff1b\u672c\u95f8\u95e8\u4e0d\u53d6\u6d88\u95e8 2\u300c\u8bed\u4e49\u65e0\u5173\u300d\u4e00\u7968\u5426\u51b3\u3002\u673a\u5668\u53ef\u8bfb\u7248\u89c1 <code>docs/agents/architecture-routing.md</code>\u3002</p>"},{"location":"architecture/#\u4fe1\u4efb\u4e0e\u526f\u4f5c\u7528\u8fb9\u754c","title":"\u4fe1\u4efb\u4e0e\u526f\u4f5c\u7528\u8fb9\u754c","text":"<p>Foundation \u7684\u4fe1\u4efb\u524d\u63d0\u4e0e\u526f\u4f5c\u7528\u7ea6\u5b9a\u6309\u5c42\u56fa\u5316\uff0c\u8c03\u7528\u65b9\u636e\u6b64\u5224\u65ad\u98ce\u9669\uff1a</p> <ul> <li>Contracts\uff1a\u7eaf\u51fd\u6570\uff0c\u65e0\u6587\u4ef6/Git/\u7f51\u7edc/\u8fdb\u7a0b\u526f\u4f5c\u7528\uff1b\u9519\u8bef\u7801\u51bb\u7ed3\u4e0d\u6f02\u79fb\uff08<code>foundation.contracts.error-codes</code>\uff09\u3002</li> <li>Harness\uff1a\u673a\u5236\u5c42\u53ea\u5728\u53d7\u6536\u5bb9\u8def\u5f84\u5185\u8bfb\u5199\uff1b<code>HARNESS_EXCLUSIONS</code> \u6392\u9664 release-state\u3001remote-network-access\u3001business-semantics\u3001workflow-orchestration\u3001model-calls\u3001git-writes\uff08<code>foundation.harness.errors</code>\uff09\u3002</li> <li>Engineering Kit\uff1a<code>FORBIDDEN_SIDE_EFFECTS</code> \u542b git-init/commit/push/tag\u3001publish\u3001remote-write\uff1b<code>REFUSED_MUTATION_FLAGS</code> \u5728 CLI \u5165\u53e3\u5373\u62d2\uff08<code>foundation.kit.cli</code>\uff09\u3002</li> <li>Profile\uff1a\u58f0\u660e\u5f0f\u5dee\u5f02\uff0c\u5165\u53e3\u5fc5\u987b\u4e3a JSON \u6570\u636e\u8d44\u6e90\uff1b<code>coreOwned</code>\uff08packages/commands/namespacePrefixes\uff09\u4e3a\u7981\u5165\u76ee\u6807\uff08<code>foundation.profile.extension-spi</code>\uff09\u3002</li> <li>\u72b6\u6001\u5e95\u5ea7\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u662f\u552f\u4e00\u6743\u5a01\uff0csnapshot \u662f\u6d3e\u751f\u7f13\u5b58\uff1b<code>confirmOwnerTerminated</code> \u662f\u8c03\u7528\u65b9\u63d0\u4f9b\u7684\u5916\u90e8\u4fe1\u4efb\u951a\uff0c\u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\uff08<code>foundation.harness.state-store</code>\uff09\u3002</li> </ul>"},{"location":"architecture/#\u67b6\u6784\u51b3\u7b56\u6811","title":"\u67b6\u6784\u51b3\u7b56\u6811","text":"<pre><code>\u9700\u6c42\u542b\u9886\u57df\u8bed\u4e49/\u72b6\u6001\u673a/\u5ba1\u8ba1? \u2500\u2500\u662f\u2500\u2500\u25b6 \u7559\u5728\u6d88\u8d39\u8005\n \u2502\u5426\n\u662f\u7ed3\u6784/\u534f\u8bae/\u9519\u8bef\u7801/Schema? \u2500\u2500\u662f\u2500\u2500\u25b6 Contracts\n \u2502\u5426\n\u662f\u8de8\u6280\u80fd\u65cf Node \u673a\u5236? \u2500\u2500\u662f\u2500\u2500\u25b6 Harness\n \u2502\u5426\n\u662f scaffold/adopt/projection/check \u6216 Profile \u6ce8\u5165? \u2500\u2500\u662f\u2500\u2500\u25b6 Kit / Profile\n \u2502\u5426\n\u6d89\u53ca\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001? \u2500\u2500\u662f\u2500\u2500\u25b6 release-skill\n \u2502\u5426\n\u6d89\u53ca\u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5/\u9a8c\u6536? \u2500\u2500\u662f\u2500\u2500\u25b6 loop-agent\n \u2502\u5426\n\u6d89\u53ca\u5236\u54c1\u5173\u7cfb/\u7248\u672c\u9501? \u2500\u2500\u662f\u2500\u2500\u25b6 artifact-graph\n \u2502\u5426\n\u53ea\u6709\u4e00\u4e2a\u6d88\u8d39\u8005/\u672a\u8bc1\u660e\u8de8\u4e24\u4e2a\u771f\u5b9e\u6d88\u8d39\u8005? \u2500\u2500\u662f\u2500\u2500\u25b6 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u6269\u5f20\n \u2502\u5426\n\u643a\u5e26\u5c11\u91cf\u9886\u57df\u8bed\u4e49? \u2500\u2500\u662f\u2500\u2500\u25b6 \u6709\u9650\u5c01\u95ed\u8bed\u4e49\uff1a\u7a33\u5b9a\u95ed\u679a\u4e3e\u53ef\u8986\u76d6\uff0c\u6216\u4e3a\u786e\u5b9a\u6027\n \u2502 \u4f30\u7b97\u539f\u8bed\uff08\u7b97\u6cd5/\u9002\u7528\u8303\u56f4/\u504f\u5dee\u65b9\u5411\u5df2\u5951\u7ea6\u58f0\u660e\uff09\u2192 \u53ef\u7eb3\u5165\uff1b\n \u2502 \u5426\u5219\u7559\u5728\u6d88\u8d39\u8005\uff08FND-ADR-001 \u95e8 8\uff0c\u4e0d\u53d6\u6d88\u95e8 2 \u4e00\u7968\u5426\u51b3\uff09\n \u2502\u5426\n \u2500\u2500\u25b6 \u53ef\u7eb3\u5165\n</code></pre>"},{"location":"architecture/#\u4e0e\u5916\u90e8\u9879\u76ee\u7684\u8def\u7531\u5173\u7cfb","title":"\u4e0e\u5916\u90e8\u9879\u76ee\u7684\u8def\u7531\u5173\u7cfb","text":"<p>Foundation \u4e0d\u662f\u5168\u80fd\u5e95\u5ea7\u3002\u4e0b\u5217\u804c\u8d23\u660e\u786e\u5728 Foundation \u4e4b\u5916\uff1a</p> <ul> <li>\u53d1\u5e03\u4e0e\u8fdc\u7aef\u5199\u5165\uff1arelease-skill \u62e5\u6709\uff1bFoundation \u4e0d\u63d0\u4f9b\u4efb\u4f55 publish/remote-write \u5165\u53e3\uff08<code>foundation.unsupported.remote-publish</code>\uff09\u3002</li> <li>\u4efb\u52a1\u751f\u547d\u5468\u671f\uff1aloop-agent \u62e5\u6709\u4efb\u52a1\u3001\u91cd\u8bd5\u3001\u8fd4\u5de5\u3001\u9a8c\u6536\uff1bFoundation \u4e0d\u542b workflow \u72b6\u6001\u673a\uff08<code>foundation.unsupported.business-state-machine</code>\uff09\u3002</li> <li>\u5236\u54c1\u6cbb\u7406\uff1aartifact-graph \u62e5\u6709 <code>artifacts/</code> \u5173\u7cfb\u5408\u540c\u4e0e\u7248\u672c\u9501\uff0c\u95e8\u7981\u4e3a <code>check:artifacts</code>\u3002</li> <li>\u9886\u57df\u5ba1\u8ba1\uff1a\u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\u62e5\u6709\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\uff1bFoundation \u53ea\u63d0\u4f9b\u786e\u5b9a\u6027\u5ba1\u8ba1\u8868\u9762\uff08<code>foundation.unsupported.domain-audit-semantics</code>\uff09\u3002</li> <li>\u5bbf\u4e3b\u5e94\u7528\u4e0e\u751f\u547d\u5468\u671f\uff1ahost apply \u7a33\u5b9a\u62d2\u7edd\uff0cinstall/update/uninstall \u672a\u5b9e\u73b0\uff0cQoder \u5b8c\u6574 driver \u4e3a unsupported\uff08<code>foundation.unsupported.host-apply</code>\u3001<code>foundation.unsupported.host-install-update-uninstall</code>\u3001<code>foundation.unsupported.qoder-driver</code>\uff09\u3002</li> </ul>"},{"location":"architecture/#\u4e0b\u4e00\u9636\u6bb5\u80fd\u529b\u7ebf\u67b6\u6784-hand-off","title":"\u4e0b\u4e00\u9636\u6bb5\u80fd\u529b\u7ebf\uff08\u67b6\u6784 hand-off\uff09","text":"<p>\u4e09\u6761\u80fd\u529b\u7ebf\u5747\u7ecf FND-ADR-001 \u80fd\u529b\u7eb3\u5165\u95e8\u88c1\u51b3\u7eb3\u5165\uff0c\u5168\u90e8\u5728\u65e2\u6709\u5206\u5c42\u5185\u843d\u4f4d\uff1a</p> <ul> <li>\u5bbf\u4e3b\u63a5\u5165\u7ebf\uff08FND-FR-001/FND-FR-002\uff0cFND-ADR-003\uff09\uff1aContracts \u767b\u8bb0 descriptor/source/manifest/probe/plan/receipt\uff1bHarness \u5b9e\u73b0\u901a\u7528 source closure\u3001\u539f\u5b50 build/materialize \u548c probe \u5206\u7c7b\uff1bKit \u6ce8\u5165\u5177\u4f53 Profile \u4e0e\u53d7\u4fe1 driver\u3002\u5f53\u524d\u53ea\u652f\u6301 describe/build/probe/plan\uff0c<code>apply</code> \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u5747\u672a\u5b9e\u73b0\u3002</li> <li>\u6301\u4e45\u72b6\u6001\u5e95\u5ea7\u7ebf\uff08FND-FR-003\uff0cFND-ADR-004\uff09\uff1aappend-only \u4e8b\u4ef6\u3001hash chain\u3001\u5feb\u7167\u4e0e\u6821\u9a8c\u6062\u590d\uff1b\u53ea\u63d0\u4f9b\u72b6\u6001\u5e95\u5ea7\uff0c\u72b6\u6001\u673a\u3001\u4efb\u52a1\u8282\u70b9\u3001\u91cd\u8bd5\u3001\u7ec8\u6001\u3001\u8bb0\u5fc6\u7b49\u4e1a\u52a1\u8bed\u4e49\u4e0d\u7eb3\u5165 Foundation\u3002</li> <li>\u4eba\u7c7b\u62a5\u544a\u7ebf\uff08FND-FR-004\uff0cFND-ADR-005\uff09\uff1a\u53cc\u5c42\u5408\u540c\u2014\u2014\u673a\u5668\u7ed3\u679c\u662f\u552f\u4e00\u771f\u6e90\uff0c\u4eba\u7c7b\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\uff08Markdown + digest \u7ed1\u5b9a + \u5206\u7ea7\u68c0\u67e5\uff09\uff0c\u4e0d\u81ea\u7531\u64b0\u5199\u3002</li> <li>\u6709\u9650\u5c01\u95ed\u8bed\u4e49\u5de5\u5177\u7ebf\uff08FND-ADR-009\uff09\uff1a\u57fa\u7ebf\u7269\u5316 + contentGuard\uff08\u6458\u8981\u4e0d\u7b26\u3001\u7269\u5316\u4e2d\u9014\u53d8\u5316\u3001\u5b88\u536b\u68c0\u51fa\u5747\u5931\u8d25\u5173\u95ed\uff09\u3001\u901a\u7528\u53ea\u8bfb chokepoint\uff08\u5141\u8bb8\u6839\u96c6\u5408 + \u53ef\u9009\u8eab\u4efd\u8c13\u8bcd\uff09\u3001\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf\uff08\u7b56\u7565\u5951\u7ea6 + \u6ce8\u5165\u5f0f\u81ea\u6d4b\uff09\u3001token \u4e0a\u754c\u4f30\u7b97\uff08\u786e\u5b9a\u6027\u9886\u57df\u4f30\u7b97\u539f\u8bed\uff0c\u65e0\u6a21\u578b/\u7f51\u7edc/tokenizer \u4f9d\u8d56\uff09\u3001\u901a\u7528\u4e0a\u9650\u5b88\u536b\uff08\u590d\u7528 state-store \u4e8b\u4ef6\u8d26\u4e0e token-lock\uff0c\u4e0a\u9650\u4e0e\u8d85\u9650\u7b56\u7565\u7531\u6d88\u8d39\u8005\u914d\u7f6e\uff09\u3002</li> </ul> <p>\u4e09\u5305\u7ed3\u6784\u4fdd\u6301\u3001\u4e0d\u62c6\u7b2c\u56db\u5305\uff08FND-ADR-007\uff09\uff1b\u5236\u54c1\u6cbb\u7406\u91c7\u7528 artifact-graph CLI \u4e0e\u7248\u672c\u9501\uff08FND-ADR-006\uff09\u3002</p>"},{"location":"architecture/#\u9996\u7248\u9884\u7b97","title":"\u9996\u7248\u9884\u7b97","text":"<ul> <li>\u9876\u5c42 Contracts \u5bf9\u8c61\uff1a20 \u7c7b\uff08\u5b8c\u6574\u6e05\u5355\u4ee5 <code>packages/skill-family-contracts/src/registry.json</code> \u4e3a\u552f\u4e00\u771f\u6e90\uff09\uff1aproject-manifest\u3001profile-descriptor\u3001managed-file-lock\u3001operation-request\u3001operation-result\u3001migration-manifest\u3001adapter-source\u3001report-model\u3001report-binding\u3001host-descriptor\u3001host-registry\u3001host-capability-fact\u3001host-probe-result\u3001adapter-build-manifest\u3001host-operation-plan\u3001host-operation-receipt\u3001state-event-envelope\u3001state-snapshot-metadata\u3001token-estimate-result\u3001surface-scan-policy\uff1b</li> <li>Kit \u9876\u5c42\u547d\u4ee4\uff1a4 \u4e2a\uff08scaffold\u3001adopt-plan\u3001projection\u3001check\uff09\uff1b</li> <li>\u5f3a\u5236\u673a\u68b0\u89c4\u5219\uff1a\u5f53\u524d 9 \u6761\uff0c\u9884\u7b97\u4e0d\u8d85\u8fc7 20 \u6761\uff0c\u7edd\u5bf9\u4e0a\u9650 30 \u6761\uff1bCR-001 \u5bf9\u767b\u8bb0\u8868\u5185\u5168\u90e8 Schema \u505a\u7edf\u4e00\u7f16\u8bd1\uff1b</li> <li>\u53f6\u5b50\u5305\uff1a3 \u4e2a\uff08skill-family-contracts\u3001skill-family-harness-node\u3001skill-family-engineering-kit\uff09\uff1b</li> <li>Schema \u6821\u9a8c\u5668\uff1aAjv 8.20.0\uff08\u7cbe\u786e\u7248\u672c pin\uff09\uff0c\u652f\u6301 draft-07 \u4e0e 2020-12 \u53cc\u65b9\u8a00\uff1b</li> <li>kernel \u534f\u8bae\uff1askill-family.kernel.operation\uff08stable\uff09\uff0cContracts \u7248\u672c 1.4.0\uff1b</li> <li>\u9ed8\u8ba4\u8fd0\u884c\u65f6\u8bed\u8a00\uff1aNode\uff1b\u7b2c\u4e8c\u8bed\u8a00\u5b9e\u73b0\u9996\u7248\u4e3a 0\u3002</li> </ul> <p>\u4efb\u4f55\u65b0\u589e\u7ec4\u4ef6\u5fc5\u987b\u8bf4\u660e\u5220\u9664\u5b83\u4f1a\u5bfc\u81f4\u7684\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\uff0c\u5e76\u901a\u8fc7\u72ec\u7acb fixture \u9a8c\u8bc1\u3002</p>"},{"location":"architecture/#\u673a\u5668\u771f\u6e90\u4e0e\u6587\u4ef6\u5206\u7c7b","title":"\u673a\u5668\u771f\u6e90\u4e0e\u6587\u4ef6\u5206\u7c7b","text":"\u771f\u6e90 \u5185\u5bb9 <code>.foundation/skeleton-manifest.json</code> \u5305\u6e05\u5355\u3001Profile\u3001fixture\u3001\u9876\u5c42\u547d\u4ee4 <code>.foundation/version-lock.json</code> projen\u3001pnpm\u3001Node \u7684\u7cbe\u786e\u7248\u672c\u4e0e\u9501\u5b9a\u70b9 <code>.foundation/file-registry.json</code> managed / handwritten / artifact \u4e09\u7c7b\u6587\u4ef6\u767b\u8bb0 <code>package.json</code> \u4e0e <code>packages//package.json</code> \u7248\u672c\u3001\u547d\u4ee4\u3001\u4f9d\u8d56\uff08\u5168\u90e8 projen \u53d7\u7ba1\uff09 <code>packages/skill-family-contracts/src/registry.json</code> \u534f\u8bae\u540d\u4e0e Schema $id \u767b\u8bb0 <code>scripts/release-artifact-contract.json</code> \u56fa\u5b9a\u4e09\u5305\u53d1\u5e03\u5b57\u8282\u5408\u540c\uff08\u6210\u5458\u3001\u5fc5\u9700\u9879\u4e0e\u5185\u5bb9\u6458\u8981\u89c4\u5219\uff09 <p>\u53d7\u7ba1\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7 <code>.projenrc.js</code> \u4fee\u6539\u5e76\u8fd0\u884c <code>pnpm synth</code> \u518d\u751f\u6210\uff1b\u624b\u5199\u6587\u4ef6\uff08\u542b\u5168\u90e8\u6587\u6863\uff09\u4e0d\u4f1a\u88ab synth \u8986\u76d6\u3002\u5206\u7c7b\u6743\u5a01\u89c1 <code>.foundation/file-registry.json</code>\u3002</p>"},{"location":"architecture/#\u6587\u6863\u7cfb\u7edf\u4e0e\u4e8b\u5b9e\u68c0\u67e5","title":"\u6587\u6863\u7cfb\u7edf\u4e0e\u4e8b\u5b9e\u68c0\u67e5","text":"<p>\u6587\u6863\u4f53\u7cfb\u7684\u76ee\u6807\u662f\u7528\u786e\u5b9a\u6027\u68c0\u67e5\u6d88\u9664\u624b\u5de5\u6f02\u79fb\uff1a</p> <ol> <li>\u51bb\u7ed3\u4e8b\u5b9e\u5305\uff1a\u6587\u6863\u5199\u4f5c\u53ea\u6d88\u8d39\u4e0a\u8868\u6240\u5217\u673a\u5668\u771f\u6e90\u3002\u6a21\u578b\u6216\u4f5c\u8005\u4e0d\u5f97\u51ed\u8bb0\u5fc6\u5199\u5165\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\uff1b\u6a21\u578b\u540d\u3001\u51ed\u636e\u548c\u8c03\u5ea6\u4fe1\u606f\u4e0d\u8fdb\u5165\u6587\u6863\uff0c\u4e5f\u4e0d\u8fdb\u5165 Contracts\u3002</li> <li>\u4e8b\u5b9e\u68c0\u67e5\uff1a<code>node scripts/docs/fact-check.mjs</code> \u5bf9\u7167\u771f\u6e90\u6821\u9a8c\u6587\u6863\u4e2d\u7684\u5305\u540d\u3001\u547d\u4ee4\u3001\u95e8\u7981\u4e8b\u5b9e\u3001\u7248\u672c pin \u4e0e\u5173\u952e\u6570\u5b57\uff0c\u5e76\u4ea4\u53c9\u6821\u9a8c\u771f\u6e90\u4e4b\u95f4\u7684\u4e00\u81f4\u6027\uff08manifest \u4e0e package.json\u3001version-lock \u4e0e packageManager\u3001\u89c4\u5219\u6570\u4e0e\u9884\u7b97\u7b49\uff09\u3002</li> <li>\u94fe\u63a5\u68c0\u67e5\uff1a<code>node scripts/docs/link-check.mjs</code> \u89e3\u6790 README \u4e0e\u5168\u90e8 <code>docs//.md</code> \u7684\u7ad9\u5185\u76f8\u5bf9\u94fe\u63a5\u548c\u6807\u9898\u951a\u70b9\uff0c\u5e76\u6821\u9a8c <code>mkdocs.yml</code> nav \u6536\u5f55\u5b8c\u6574\u3002</li> <li>\u65e0\u5de5\u4f5c\u6d41\u8fb9\u754c\u4e0e\u516c\u5f00\u8fb9\u754c\u9a8c\u8bc1\uff1a\u672c\u4ed3\u6ca1\u6709\u4efb\u4f55 CI/CD workflow\uff08\u65e7\u62d3\u6251\u7684 ci/docs/docs-deploy \u4e09\u4e2a Actions \u5df2\u6574\u4f53\u5220\u9664\uff09\uff0c\u5168\u90e8\u95e8\u7981\u5728\u79c1\u6709\u5de5\u4f5c\u533a\u5185\u8fd0\u884c\uff08<code>pnpm check</code>\uff09\uff1b\u516c\u5f00\u8fb9\u754c\u7531 <code>check:public-snapshots</code> \u4e0e\u53d1\u5e03\u5b57\u8282\u5408\u540c\u673a\u68b0\u9a8c\u8bc1\u3002\u516c\u5f00\u9759\u6001\u7ad9\u7531 <code>scripts/render-public-site.mjs</code> \u6e32\u67d3\uff08\u552f\u4e00\u8f93\u51fa <code>docs/public/site/</code> \u4e0e\u786e\u5b9a\u6027\u57fa\u7ebf <code>docs/public/site-baseline.json</code>\uff09\u3002</li> <li>\u7248\u672c\u9501\u5b9a\uff1a\u7ad9\u70b9\u5de5\u5177\u94fe\u9501\u5b9a\u5728 <code>scripts/docs/toolchain.json</code> \u4e0e <code>scripts/docs/requirements.txt</code>\uff0c\u6784\u5efa\u53ea\u4f7f\u7528\u4ed3\u5e93\u5916\u90e8\u7684 Python \u865a\u62df\u73af\u5883\uff0c\u4e0d\u505a\u7cfb\u7edf\u7ea7 pip install\u3002</li> </ol> <p>\u4e24\u4e2a\u68c0\u67e5\u811a\u672c\u90fd\u53ef\u76f4\u63a5 <code>node scripts/docs/<name>.mjs</code> \u8fd0\u884c\uff1a<code>fact-check.mjs</code> \u7ecf\u4ed3\u5185\u6a21\u5757\u6d88\u8d39\u6839\u76ee\u5f55\u7cbe\u786e\u9501\u5b9a\u7684 <code>semver@7.8.5</code>\uff0c\u8fd0\u884c\u524d\u5fc5\u987b\u5148\u5b8c\u6210 <code>pnpm install --frozen-lockfile</code>\uff1b<code>link-check.mjs</code> \u4e3a\u7eaf Node \u5b9e\u73b0\u3002\u804c\u8d23\u8bf4\u660e\u89c1 <code>scripts/docs/README.md</code>\u3002</p>"},{"location":"architecture/#\u7a33\u5b9a\u4ea7\u54c1\u95e8\u7981","title":"\u7a33\u5b9a\u4ea7\u54c1\u95e8\u7981","text":"<p>\u6839 <code>pnpm check</code> \u53ea\u7f16\u6392 11 \u4e2a\u7a33\u5b9a\u4ea7\u54c1 gate ID\uff08<code>check:structure</code>\uff5e<code>check:artifacts</code>\uff0c\u9010 ID \u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff09\uff0c\u4e0d\u518d\u9501\u6b7b\u539f\u59cb\u547d\u4ee4\u6e05\u5355\uff1b\u6bcf\u4e2a\u7a33\u5b9a ID \u5728\u81ea\u5df1\u7684 package script \u5185\u7ec4\u5408\u5c11\u91cf\u4ea7\u54c1\u68c0\u67e5\u3002\u95e8\u7981\u4e8b\u5b9e\u7531 <code>node scripts/docs/fact-check.mjs</code> \u4ece\u6839 <code>package.json</code> \u7684 <code>scripts.check</code> \u673a\u68b0\u63a8\u5bfc\u5e76\u9010\u5b57\u6838\u5bf9\u3002\u6587\u6863\u4e0e setup \u53ea\u8c03\u7528\u6216\u5217\u51fa 11 \u4e2a\u7a33\u5b9a ID \u6216\u6839 <code>pnpm check</code>\uff0c\u4e0d\u590d\u5236\u5e95\u5c42\u547d\u4ee4\u5217\u8868\u3002</p> <p>\u4ed3\u5185\u68c0\u67e5\u7684\u8bda\u5b9e\u8fb9\u754c\uff1a\u7ed3\u6784\u68c0\u67e5\u53ea\u8bc1\u660e\u201c\u5b57\u8282/\u7ed3\u6784\u4e00\u81f4\u6027\uff08\u4ed3\u5185\u53ef\u8bc1\uff09\u201d\uff1b\u4e00\u6b21\u6027\u8fc1\u79fb\u5b8c\u6574\u6027\u3001\u666e\u901a\u6b63\u6587\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\u7ed3\u8bba\u5c5e\u4e8e\u5916\u90e8\u5ba1\u9605\u804c\u8d23\uff0c\u4e0d\u5728\u76ee\u6807\u4ed3\u5185\u7ef4\u62a4\u7b2c\u4e8c\u4efd\u95e8\u7981 registry\u3001baseline \u6216\u547d\u4ee4\u6bd4\u8f83\u5668\u3002</p>"},{"location":"examples-and-fixtures/","title":"\u6837\u4f8b\u4e0e Fixture","text":"<p>\u672c\u9875\u8bf4\u660e Foundation \u4e2d fixture \u7684\u76ee\u7684\u3001\u8fd0\u884c\u5165\u53e3\uff0c\u4ee5\u53ca\u5b83\u80fd\u5426\u4f5c\u4e3a\u4e1a\u52a1 oracle\uff08\u5224\u5b9a\u4f9d\u636e\uff09\u3002\u7ed3\u8bba\u5148\u884c\uff1afixture \u53ea\u8bc1\u660e\u7ed3\u6784\u5951\u7ea6\uff0c\u4e0d\u8bc1\u660e\u4e1a\u52a1\u8bed\u4e49\u3002</p>"},{"location":"examples-and-fixtures/#fixture-\u7684\u76ee\u7684","title":"fixture \u7684\u76ee\u7684","text":"<p>fixture \u56de\u7b54\u4e00\u4e2a\u95ee\u9898\u2014\u2014\u300c\u8fd9\u4efd\u5951\u7ea6\u5bf9\u8c61/SPI \u5728\u7ed9\u5b9a\u8f93\u5165\u4e0b\u662f\u5426\u4ea7\u751f\u58f0\u660e\u7684\u884c\u4e3a\u300d\u3002\u5b83\u5206\u4e09\u7c7b\uff1a</p> <ul> <li>\u6b63\u4f8b\uff08positive\uff09\uff1a\u7ed9\u5b9a\u5408\u6cd5\u8f93\u5165\uff0c\u6821\u9a8c/\u673a\u5236\u5e94\u901a\u8fc7\u3002</li> <li>\u53cd\u4f8b\uff08negative\uff09\uff1a\u7ed9\u5b9a\u975e\u6cd5\u8f93\u5165\uff0c\u5fc5\u987b\u4ea7\u751f\u7a33\u5b9a\u5931\u8d25\u7801\uff08\u5982 <code>SFC1001</code>/<code>SFC1010</code>\uff09\u3002</li> <li>\u65b9\u8a00\u8fb9\u754c\uff08dialect-boundary\uff09\uff1a\u5728 draft-07 \u4e0e 2020-12 \u53cc\u65b9\u8a00\u4ea4\u754c\u5904\u7684\u9884\u671f\u884c\u4e3a\u3002</li> </ul> <p>fixture \u662f\u5b8c\u5168\u865a\u6784\u6570\u636e\uff0c\u4e0d\u542b\u771f\u5b9e\u4e1a\u52a1\u3001\u79c1\u6709 Profile\u3001\u7528\u6237\u8def\u5f84\u6216\u51ed\u636e\u3002</p>"},{"location":"examples-and-fixtures/#\u8fd0\u884c\u5165\u53e3","title":"\u8fd0\u884c\u5165\u53e3","text":"<ul> <li>Contracts fixture\uff1a<code>packages/skill-family-contracts/test/fixtures.test.mjs</code> \u673a\u68b0\u91cd\u653e <code>src/fixtures/<contract>/</code> \u7684\u671f\u671b\uff0c\u884c\u4e3a\u4e0d\u7b26\u62a5 <code>SFC1010</code>\u3002</li> <li>Profile SPI \u7b26\u5408\u6027\uff1a<code>fixtures/generic-profile-extension-conformance/verify.mjs</code>\uff08\u53ea\u8bfb\u6821\u9a8c\uff09\u4e0e <code>leak-scan.mjs</code>\uff08\u6cc4\u6f0f\u626b\u63cf\uff09\u3002</li> <li>\u9aa8\u67b6\u7cbe\u786e\u5408\u540c\uff1a<code>fixtures/scaffold-conformance/verify.mjs</code>\u3002</li> <li>\u91c7\u7528\u5371\u5bb3\u7c7b\uff1a<code>fixtures/adoption/cases/</code> \u4ee5\u5b57\u8282\u7ea7\u524d\u540e\u5feb\u7167\u8bc1\u660e <code>adopt-plan</code> \u53ea\u8bfb\u3002</li> </ul> <p>\u4ee5\u4e0a\u5165\u53e3\u5747\u4e3a\u53ea\u8bfb\u6216\u81ea\u542b\uff0c\u4e0d\u5199\u8c03\u7528\u65b9\u4ed3\u3001\u4e0d\u89e6\u78b0\u8fdc\u7aef\u3002</p>"},{"location":"examples-and-fixtures/#fixture-\u80fd\u5426\u4f5c\u4e3a\u4e1a\u52a1-oracle","title":"fixture \u80fd\u5426\u4f5c\u4e3a\u4e1a\u52a1 oracle","text":"<p>\u4e0d\u80fd\u3002\u539f\u56e0\uff1a</p> <ul> <li>fixture \u53ea\u8986\u76d6\u7ed3\u6784\u5951\u7ea6\u4e0e\u673a\u5236\u8fb9\u754c\uff0c\u4e0d\u8986\u76d6\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1\u7ed3\u8bba\u3002</li> <li>\u5ba1\u8ba1\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\u5c5e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff0cFoundation \u53ea\u63d0\u4f9b\u5ba1\u8ba1\u8868\u9762\uff08canonical JSON + sha256 \u6458\u8981\uff0c\u89c1 <code>foundation.contracts.audit-surface</code>\uff09\u3002</li> <li>\u6587\u6863\u4f53\u7cfb\u660e\u786e\uff1a\u666e\u901a\u6b63\u6587\u8bed\u4e49\u6b63\u786e\u6027\u7531\u5916\u90e8\u5ba1\u9605\u8d1f\u8d23\uff0c\u4ed3\u5185\u95e8\u7981\u53ea\u8bc1\u660e\u673a\u5668\u4e8b\u5b9e\u4e0e\u5b57\u8282/\u7ed3\u6784\u4e00\u81f4\u6027\u3002</li> </ul> <p>\u56e0\u6b64\uff0c\u628a fixture \u5f53\u4f5c\u4e1a\u52a1\u6b63\u786e\u6027\u7684\u5224\u636e\u662f\u8bef\u7528\u3002\u5b83\u8bc1\u660e\u300c\u5951\u7ea6\u88ab\u6ee1\u8db3\u300d\uff0c\u4e0d\u8bc1\u660e\u300c\u4e1a\u52a1\u662f\u5bf9\u7684\u300d\u3002</p>"},{"location":"examples-and-fixtures/#\u516c\u5f00\u8303\u56f4","title":"\u516c\u5f00\u8303\u56f4","text":"<ul> <li>Profile\uff1a<code>profiles/public-plugin</code>\uff08\u516c\u5f00\u6216\u5b8c\u5168\u865a\u6784\u6837\u4f8b\uff09\u3002</li> <li>fixture\uff1a<code>fixtures/generic-profile-extension-conformance</code>\u3001<code>fixtures/scaffold-conformance</code>\u3001<code>fixtures/licensing-profile-conformance</code>\u3001<code>fixtures/adoption</code>\u3001<code>fixtures/m0-consumer</code>\u3002</li> </ul> <p>\u5176\u4f59\u79c1\u6709\u6216\u6d88\u8d39\u8005 fixture \u4e0d\u8fdb\u5165\u516c\u5f00\u6587\u6863\uff1b\u79c1\u6709 Profile\u3001\u4ea7\u54c1\u6570\u636e\u3001\u7528\u6237\u8def\u5f84\u3001\u8d26\u53f7\u3001token \u6216\u8fd0\u884c\u65e5\u5fd7\u4e00\u5f8b\u4e0d\u5199\u5165\u516c\u5f00 fixture\u3002</p>"},{"location":"git-lifecycle/","title":"Git \u751f\u547d\u5468\u671f\u6307\u5357","text":"<p>\u672c\u6587\u662f Skill Family \u5404\u5de5\u4f5c\u533a Git \u751f\u547d\u5468\u671f\u89c4\u5219\u7684\u552f\u4e00\u6743\u5a01\u6587\u6863\u3002\u65b0\u5efa\u9879\u76ee\u9aa8\u67b6 \uff08<code>npx skill-family-engineering-kit scaffold</code>\uff09\u4e2d\u7684 AGENTS.md\u300cMinimal Git lifecycle\u300d\u533a\u5757\u4e0e <code>docs/git-lifecycle.md</code> \u9875\u9762\u90fd\u662f\u5bf9\u672c\u6307\u5357\u540c\u53e3\u5f84\u7684\u6295\u5f71\u4e0e\u6307\u9488\u2014\u2014 \u4efb\u4f55\u5de5\u4f5c\u533a\u90fd\u4e0d\u5f97\u518d\u7ef4\u62a4\u7b2c\u4e8c\u5957 Git \u89c4\u5219\u3002\u6240\u6709\u5de5\u5177\u94fe\uff08projen\u3001engineering kit\u3001 CI \u811a\u672c\uff09\u90fd\u4e0d\u6267\u884c Git \u5199\u64cd\u4f5c\uff1b\u4e0b\u8ff0\u6bcf\u4e00\u7c7b\u5199\u64cd\u4f5c\u90fd\u53ea\u6765\u81ea\u4eba\u7684\u663e\u5f0f\u51b3\u5b9a\u3002</p>"},{"location":"git-lifecycle/#\u5206\u652f\u547d\u540d\u4e0e\u5bff\u547d","title":"\u5206\u652f\u547d\u540d\u4e0e\u5bff\u547d","text":"<ul> <li>\u5206\u652f\u6a21\u578b\uff1a\u4e00\u6761\u957f\u671f\u5206\u652f <code>main</code>\uff0c\u52a0\u77ed\u5bff\u547d\u4efb\u52a1\u5206\u652f <code>task/<\u4efb\u52a1\u53f7>-<\u77ed\u6a2a\u7ebf\u6458\u8981></code> \uff08\u4f8b\u5982 <code>task/0050-git-lifecycle</code>\uff09\u3002</li> <li>\u4efb\u52a1\u5206\u652f\u53ea\u627f\u8f7d\u4e00\u4e2a\u4efb\u52a1\u7684\u4e00\u7ec4\u76f8\u5173\u53d8\u66f4\uff1b\u4efb\u52a1\u9a8c\u6536\u901a\u8fc7\u540e\u5408\u5e76\uff1b\u786e\u8ba4\u6ca1\u6709\u672a\u5408\u5e76 \u63d0\u4ea4\u540e\u53ef\u5220\u9664\u672c\u5730\u5206\u652f\u3002\u8fdc\u7aef\u5206\u652f\u5220\u9664\u5c5e\u4e8e push \u7c7b\u5916\u90e8\u5199\u5165\uff0c\u5fc5\u987b\u53e6\u884c\u53d6\u5f97\u663e\u5f0f \u6388\u6743\uff08\u89c1\u4e0b\u6587\u9010\u9879\u6388\u6743\u8282\uff09\uff0c\u5408\u5e76\u672c\u8eab\u4e0d\u81ea\u52a8\u6388\u6743\u8fdc\u7aef\u5220\u9664\u3002\u4e0d\u5b58\u5728\u957f\u671f\u5b58\u6d3b\u7684 \u7279\u6027\u5206\u652f\uff0c\u4e5f\u4e0d\u5141\u8bb8\u5728\u4efb\u52a1\u5206\u652f\u4e0a\u5806\u79ef\u4e0e\u4efb\u52a1\u65e0\u5173\u7684\u53d8\u66f4\u3002</li> <li><code>main</code> \u6c38\u8fdc\u53ea\u63a5\u6536\u5df2\u901a\u8fc7\u95e8\u7981\u7684\u5408\u5e76\uff1b\u4efb\u4f55\u60c5\u51b5\u4e0b\u90fd\u4e0d\u5f97\u5bf9 <code>main</code> \u76f4\u63a5\u63d0\u4ea4\u6216 force-push\u3002</li> </ul>"},{"location":"git-lifecycle/#\u4fee\u6539\u524d\u72b6\u6001\u68c0\u67e5","title":"\u4fee\u6539\u524d\u72b6\u6001\u68c0\u67e5","text":"<ul> <li>\u63d0\u4ea4\u3001\u8fdc\u7aef\u7b49\u5b9e\u65f6 Git \u72b6\u6001\u4e0d\u5199\u8fdb\u4efb\u4f55\u7248\u672c\u5316\u6587\u6863\uff08\u5305\u62ec\u4ea7\u54c1\u72b6\u6001\u9875\uff09\uff1b\u6267\u884c\u4efb\u4f55 Git \u52a8\u4f5c\u524d\uff0c\u5148\u73b0\u573a\u8fd0\u884c\u4e0b\u5217\u53ea\u8bfb\u547d\u4ee4\u53d1\u73b0\u5f53\u524d\u72b6\u6001\uff1a</li> </ul> <p><code>bash git status --short --branch git rev-parse --verify HEAD git remote -v</code></p> <p>\u8fd9\u4e09\u6761\u547d\u4ee4\u53ea\u662f\u53ea\u8bfb\u63a2\u6d4b\uff1a\u8f93\u51fa\u53ea\u53cd\u6620\u672c\u673a\u5de5\u4f5c\u533a\u5f53\u4e0b\u7684\u72b6\u6001\uff0c\u4e0d\u6388\u4e88\u4efb\u4f55\u5199\u6743\u9650\uff1b \u6267\u884c stage/commit/push/tag/release \u4ecd\u5fc5\u987b\u6309\u4e0b\u6587\u9010\u9879\u6388\u6743\u8282\u5355\u72ec\u53d6\u5f97\u6388\u6743\u3002 - \u5f00\u59cb\u4efb\u4f55\u4fee\u6539\u4e4b\u524d\uff0c\u5148\u8fd0\u884c <code>git status --short --branch</code>\uff0c\u786e\u8ba4\u5f53\u524d\u5206\u652f\u3001\u672a\u63d0\u4ea4 \u53d8\u66f4\u4e0e\u8fdc\u7aef\u8ddf\u8e2a\u72b6\u6001\uff1b\u5de5\u4f5c\u533a\u91cc\u51fa\u73b0\u4e0d\u8ba4\u8bc6\u7684\u5206\u652f\u3001\u672a\u6682\u5b58\u53d8\u66f4\u6216\u964c\u751f\u6587\u4ef6\u65f6\uff0c\u5148 \u8c03\u67e5\u6765\u6e90\u518d\u52a8\u624b\uff0c\u90a3\u662f\u522b\u4eba\u6b63\u5728\u8fdb\u884c\u7684\u5de5\u4f5c\uff0c\u4e0d\u662f\u53ef\u4ee5\u968f\u624b\u6e05\u7406\u7684\u566a\u58f0\u3002 - \u7981\u6b62\u7528 <code>git checkout .</code>\u3001<code>git restore .</code>\u3001<code>git clean -f</code>\u3001<code>git reset --hard</code> \u4e4b\u7c7b\u7684\u7834\u574f\u6027\u547d\u4ee4\u201c\u987a\u624b\u201d\u6e05\u7a7a\u5de5\u4f5c\u533a\u6765\u7ed5\u8fc7\u969c\u788d\uff1b\u786e\u9700\u4e22\u5f03\u672a\u63d0\u4ea4\u53d8\u66f4\u65f6\uff0c\u5fc5\u987b \u9010\u6761\u5217\u51fa\u5c06\u88ab\u4e22\u5f03\u7684\u5185\u5bb9\u5e76\u83b7\u5f97\u663e\u5f0f\u786e\u8ba4\u3002</p>"},{"location":"git-lifecycle/#\u539f\u5b50-commit-\u6761\u4ef6","title":"\u539f\u5b50 commit \u6761\u4ef6","text":"<p>\u4e00\u4e2a commit \u5fc5\u987b\u540c\u65f6\u6ee1\u8db3\uff1a</p> <ol> <li>\u53ea\u5305\u542b\u4e00\u4e2a\u903b\u8f91\u53d8\u66f4\uff08\u4e00\u4e2a\u4efb\u52a1\u7684\u63a8\u8fdb\uff0c\u6216\u4e00\u6b21\u660e\u786e\u62c6\u5206\u7684\u4fee\u6b63\uff09\uff1b</li> <li>\u53d7\u7ba1\u751f\u6210\u7269\u4e0e\u5176\u6e90\uff08<code>.projenrc.js</code>\u3001\u6295\u5f71\u811a\u672c\uff09\u5728\u540c\u4e00\u6b21\u63d0\u4ea4\u5185\u6210\u5bf9\u51fa\u73b0\uff1b</li> <li>\u63d0\u4ea4\u524d <code>pnpm check</code>\uff08\u6216\u4efb\u52a1\u6307\u5b9a\u7684\u6700\u5c0f\u9a8c\u8bc1\u5165\u53e3\uff09\u9000\u51fa\u7801\u4e3a 0\u2014\u2014\u4e0d\u5f97\u628a\u7ea2\u7684 \u72b6\u6001\u63d0\u4ea4\u8fdb\u4efb\u4f55\u5206\u652f\u540e\u518d\u201c\u56de\u5934\u4fee\u201d\uff1b</li> <li>\u63d0\u4ea4\u4fe1\u606f\u8bf4\u660e\u201c\u4e3a\u4ec0\u4e48\u201d\uff0c\u5f15\u7528\u4efb\u52a1\u53f7\uff1b\u4e0d\u5f97\u5305\u542b\u51ed\u636e\u3001\u79c1\u6709\u6570\u636e\u6216\u4e0d\u53ef\u516c\u5f00\u7684 \u5185\u90e8\u6807\u8bc6\u3002</li> </ol> <p>\u4e0d\u6ee1\u8db3\u4ee5\u4e0a\u4efb\u4e00\u6761\u4ef6\u7684\u53d8\u66f4\u4e0d\u5f97\u63d0\u4ea4\uff1b\u5b81\u53ef\u62c6\u6210\u591a\u4e2a commit\uff0c\u4e5f\u4e0d\u5408\u5e76\u6210\u4e00\u4e2a\u6df7\u5408 \u53d8\u66f4\u3002</p>"},{"location":"git-lifecycle/#stagecommitpushtagrelease-\u7684\u9010\u9879\u6388\u6743","title":"stage\u3001commit\u3001push\u3001tag\u3001release \u7684\u9010\u9879\u6388\u6743","text":"<ul> <li>\u4fee\u6539\u6388\u6743\u4e0d\u5305\u542b stage \u4e0e commit\uff1a\u83b7\u5f97\u67d0\u4efb\u52a1\u7684\u4fee\u6539\u6388\u6743\uff0c\u53ea\u8868\u793a\u53ef\u4ee5\u5728\u5de5\u4f5c\u533a \u91cc\u6539\u52a8\u6587\u4ef6\uff1bstage\uff08<code>git add</code>\uff09\u4e0e commit \u4ecd\u662f\u4e24\u4e2a\u72ec\u7acb\u7684\u5199\u64cd\u4f5c\uff0c\u5fc5\u987b\u5206\u522b \u6309\u98ce\u9669\u9010\u9879\u53d6\u5f97\u660e\u786e\u6388\u6743\uff0c\u4e0d\u5b58\u5728\u201c\u6388\u6743\u4fee\u6539\u5373\u9ed8\u8ba4\u6388\u6743\u63d0\u4ea4\u201d\u3002</li> <li>stage \u4e0e commit\uff1a\u9ed8\u8ba4\u53ea\u5728\u672c\u5730\u3001\u6309\u539f\u5b50\u6761\u4ef6\u6267\u884c\uff1b\u4e00\u6b21 commit \u6388\u6743\u53ea\u8986\u76d6\u88ab \u660e\u786e\u58f0\u660e\u7684\u90a3\u4e00\u6b21\u672c\u5730\u63d0\u4ea4\uff0c\u4e0d\u8986\u76d6\u4efb\u52a1\u4e4b\u5916\u7684\u6e05\u7406\u3001\u6539\u5199\uff08\u542b amend/rebase \u6539\u5199\u5df2\u63d0\u4ea4\u5185\u5bb9\uff09\u6216\u540e\u7eed\u63d0\u4ea4\u3002</li> <li>push\uff1a\u628a\u4efb\u52a1\u5206\u652f\u63a8\u9001\u5230\u8fdc\u7aef\u3001\u5f00 PR\uff0c\u4ee5\u53ca\u5220\u9664\u8fdc\u7aef\u5206\u652f \uff08<code>git push --delete</code> / <code>git push origin :<branch></code>\uff09\u540c\u5c5e push \u7c7b\u5916\u90e8 \u5199\u5165\uff0c\u90fd\u9700\u8981\u5728\u5f53\u524d\u4efb\u52a1\u91cc\u5355\u72ec\u6388\u6743\uff1b\u7981\u6b62\u76f4\u63a5 push <code>main</code>\u3002\u5408\u5e76\u540e\u7684\u6e05\u7406\u8bf4\u660e \u4e0d\u6784\u6210\u5bf9\u8fdc\u7aef\u5220\u9664\u7684\u81ea\u52a8\u6388\u6743\u3002</li> <li>tag \u4e0e release\uff1a\u6bcf\u4e00\u6b21\u6253 tag\u3001\u53d1\u5e03 release\uff08\u5305\u62ec npm publish\u3001Pages \u90e8\u7f72\u3001 \u5efa\u8fdc\u7aef\u4ed3\u5e93\uff09\u90fd\u662f\u72ec\u7acb\u7684\u9ad8\u98ce\u9669\u52a8\u4f5c\uff0c\u5fc5\u987b\u9010\u9879\u5355\u72ec\u6388\u6743\uff1b\u4e00\u6b21 push \u6388\u6743\u4e0d\u6784\u6210 \u4efb\u4f55 tag/release \u6388\u6743\u3002</li> <li>\u81ea\u52a8\u5316\u5de5\u5177\uff08\u542b AI \u52a9\u624b\u4e0e CI\uff09\u5728\u672a\u83b7\u5f97\u9488\u5bf9\u5f53\u524d\u4efb\u52a1\u7684\u663e\u5f0f\u4eba\u5de5\u6388\u6743\u524d\uff0c\u4e0d\u5f97 \u6267\u884c <code>git add</code>\uff08stage\uff09\u3001<code>git commit</code>\u3001<code>git push</code>\u3001<code>git tag</code> \u6216\u4efb\u4f55\u5efa \u8fdc\u7aef/\u53d1\u5e03/\u5220\u9664\u8fdc\u7aef\u5f15\u7528\u7684\u547d\u4ee4\u3002</li> <li>\u6388\u6743\u53ea\u5bf9\u58f0\u660e\u8005\u7684\u90a3\u4e00\u6b21\u64cd\u4f5c\u6709\u6548\uff0c\u4e0d\u6784\u6210\u5bf9\u540c\u7c7b\u540e\u7eed\u64cd\u4f5c\u7684\u957f\u671f\u653e\u884c\u3002</li> </ul>"},{"location":"git-lifecycle/#\u53d7\u7ba1\u6295\u5f71\u4e0e\u6e90\u540c\u63d0\u4ea4","title":"\u53d7\u7ba1\u6295\u5f71\u4e0e\u6e90\u540c\u63d0\u4ea4","text":"<ul> <li>projen \u53d7\u7ba1\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7\u4fee\u6539 <code>.projenrc.js</code> \u540e\u8fd0\u884c <code>pnpm synth</code> \u4ea7\u751f\uff1b\u751f\u6210\u7269 \u5fc5\u987b\u4e0e\u5176\u6e90\u53d8\u66f4\u5728\u540c\u4e00\u4e2a commit \u5185\u63d0\u4ea4\uff0c\u4e0d\u5f97\u5148\u63d0\u4ea4\u6e90\u3001\u540e\u8865\u751f\u6210\u7269\uff0c\u66f4\u4e0d\u5f97\u53ea \u63d0\u4ea4\u5176\u4e2d\u4e00\u4fa7\u3002</li> <li>\u6587\u6863\u53d7\u7ba1\u6295\u5f71\uff08\u5982 setup.md \u7684\u7a33\u5b9a\u95e8\u7981\u9636\u6bb5\u533a\u5757\uff09\u540c\u7406\uff1a\u6295\u5f71\u811a\u672c\u91cd\u8dd1 \u7684\u8f93\u51fa\u4e0e\u89e6\u53d1\u5b83\u7684\u771f\u6e90\u53d8\u66f4\u540c\u63d0\u4ea4\uff1bCI \u7684\u6f02\u79fb\u68c0\u67e5\uff08synth-drift / synth-idempotency\uff09 \u4f1a\u673a\u68b0\u62e6\u622a\u53ea\u63d0\u4ea4\u4e00\u4fa7\u7684\u53d8\u66f4\u3002</li> </ul>"},{"location":"git-lifecycle/#gitignore-\u5206\u7c7b","title":".gitignore \u5206\u7c7b","text":"<ul> <li>\u6bcf\u4e2a\u88ab\u5ffd\u7565\u7684\u8def\u5f84\u90fd\u5fc5\u987b\u5f52\u5165 <code>.foundation/file-registry.json</code> \u7684\u4e00\u4e2a\u7c7b\u522b\uff1a \u5de5\u5177\u751f\u6210\u7269\uff08artifacts\uff0c\u5982 <code>node_modules/</code>\u3001<code>site/</code>\u3001<code>.cache/</code>\u3001\u65e5\u5fd7\uff09\u8d70 <code>.gitignore</code>\uff1b\u4f9d\u8d56\u9501\u6587\u4ef6\uff08trackedToolLocks\uff0c\u5982 <code>pnpm-lock.yaml</code>\uff09\u88ab\u663e\u5f0f\u8ddf\u8e2a\u3001 \u4e0d\u5f97\u5ffd\u7565\uff1b\u624b\u5199\u6e90\u4e8b\u5b9e\u4e0e\u53d7\u7ba1\u6587\u4ef6\u4e00\u5f8b\u8ddf\u8e2a\u3002</li> <li><code>.gitignore</code> \u7684\u5ffd\u7565\u6a21\u5f0f\u96c6\u5408\u4e0e file-registry \u7684 artifacts \u6a21\u5f0f\u96c6\u5408\u5fc5\u987b\u9010\u5b57 \u4e00\u81f4\uff08<code>scripts/check-structure.mjs</code> \u673a\u68b0\u6838\u5bf9\uff09\uff1b\u65b0\u589e\u5ffd\u7565\u9879\u5fc5\u987b\u5148\u767b\u8bb0\u7c7b\u522b\uff0c \u4e0d\u5141\u8bb8\u51fa\u73b0\u201c\u8ddf\u8e2a\u4f46\u88ab\u5ffd\u7565\u201d\u6216\u201c\u5ffd\u7565\u4f46\u672a\u767b\u8bb0\u201d\u7684\u4e2d\u95f4\u6001\u3002</li> </ul>"},{"location":"git-lifecycle/#\u5220\u9664\u524d\u6838\u5bf9\u4e0e\u53ef\u6062\u590d\u5904\u7f6e","title":"\u5220\u9664\u524d\u6838\u5bf9\u4e0e\u53ef\u6062\u590d\u5904\u7f6e","text":"<ul> <li>\u5220\u9664\u4efb\u4f55\u6587\u4ef6\u3001\u5206\u652f\u6216\u5386\u53f2\u5185\u5bb9\u4e4b\u524d\uff0c\u5148\u6838\u5bf9\u5176\u662f\u5426\u4ecd\u88ab\u5f15\u7528\uff08\u95e8\u7981\u3001\u6587\u6863\u94fe\u63a5\u3001 \u51bb\u7ed3\u8bc1\u636e\u5f15\u7528\uff09\uff1b\u88ab\u51bb\u7ed3\u9a8c\u6536\u8f93\u5165\u5f15\u7528\u7684\u8bc1\u636e\u4e00\u5f8b\u4e0d\u5f97\u5220\u9664\u3002</li> <li>\u4f18\u5148\u53ef\u6062\u590d\u5904\u7f6e\uff1a\u80fd\u6539\u5c31\u4e0d\u5220\uff0c\u80fd\u505c\u7528\uff08\u5982 <code>if: false</code> \u786c\u95e8\u7981\uff09\u5c31\u4e0d\u79fb\u9664\uff1b\u786e\u9700 \u5220\u9664\u65f6\u4fdd\u7559\u53ef\u8ffd\u6eaf\u7684\u66ff\u4ee3\u7269\uff08\u7eed\u63a5\u8bb0\u5f55\u3001\u51b3\u5b9a\u8bb0\u5f55\u3001\u5f52\u6863\u9875\uff09\u3002</li> <li>\u5206\u652f\u9000\u51fa\uff1a\u4efb\u52a1\u5206\u652f\u5408\u5e76\u540e\uff0c\u5148\u786e\u8ba4\u6ca1\u6709\u672a\u5408\u5e76\u7684\u63d0\u4ea4\uff0c\u518d\u5220\u9664\u672c\u5730\u5206\u652f\uff1b\u8fdc\u7aef \u5206\u652f\u5220\u9664\u5c5e\u4e8e push \u7c7b\u5916\u90e8\u5199\u5165\uff0c\u5408\u5e76\u540e\u7684\u6e05\u7406\u8bf4\u660e\u4e0d\u5f97\u81ea\u52a8\u6388\u6743\u8fdc\u7aef\u5220\u9664\uff0c\u987b\u6309 \u9010\u9879\u6388\u6743\u8282\u53e6\u884c\u53d6\u5f97\u663e\u5f0f\u6388\u6743\u3002</li> <li>\u4efb\u4f55\u201c\u5220\u9664\u540e\u91cd\u653e\u201d\u90fd\u5fc5\u987b\u6709\u5148\u7ea2\u540e\u7eff\u7684\u673a\u5668\u8bc1\u636e\uff0c\u8bc1\u660e\u5220\u9664\u4e0d\u662f\u9759\u9ed8\u4e22\u5931\u3002</li> </ul>"},{"location":"git-lifecycle/#\u751f\u6210\u7269\u7981\u6b62\u624b\u6539","title":"\u751f\u6210\u7269\u7981\u6b62\u624b\u6539","text":"<ul> <li>\u5e26 projen \u751f\u6210\u6807\u8bb0\u7684\u6587\u4ef6\u3001\u6295\u5f71\u811a\u672c\u5199\u5165\u7684\u53d7\u7ba1\u533a\u5757\u3001<code>.foundation/</code> \u4e0b\u7684\u673a\u5668 \u771f\u6e90\u4e00\u5f8b\u7981\u6b62\u624b\u6539\uff1b\u624b\u6539\u4f1a\u88ab synth \u6f02\u79fb\u68c0\u67e5\u68c0\u51fa\u5e76\u62e6\u622a\u3002</li> <li>\u9700\u8981\u53d8\u66f4\u53d7\u7ba1\u5185\u5bb9\u65f6\uff0c\u552f\u4e00\u5408\u6cd5\u8def\u5f84\u662f\u4fee\u6539\u5bf9\u5e94\u7684\u6e90\uff08<code>.projenrc.js</code> \u6216\u6295\u5f71\u811a\u672c \u7684\u771f\u6e90\u8f93\u5165\uff09\u518d\u91cd\u65b0\u751f\u6210\uff1b\u201c\u624b\u6539\u540e\u518d\u91cd\u65b0\u751f\u6210\u628a\u5dee\u5f02\u6d17\u767d\u201d\u5c5e\u4e8e\u88ab\u95e8\u7981\u660e\u786e\u62d2\u7edd \u7684\u7be1\u6539\u6a21\u5f0f\u3002</li> </ul>"},{"location":"help/","title":"\u4e2d\u6587 \u00b7 \u80fd\u529b\u4e0e\u8bca\u65ad","text":"<p>English</p>"},{"location":"help/#\u5e2e\u52a9\u4e0e\u5206\u8bca","title":"\u5e2e\u52a9\u4e0e\u5206\u8bca","text":"<p>\u672c\u9875\u6309\u9519\u8bef\u7801\u3001\u8fdb\u7a0b\u9000\u51fa\u7801\u4e0e\u73b0\u8c61\u7ed9\u5206\u8bca\u8def\u5f84\u3002Foundation \u7684\u9519\u8bef\u7801\u4f53\u7cfb\u51bb\u7ed3\u5728 Contracts\uff08<code>src/error-codes.json</code>\uff09\uff0c\u4e0d\u6f02\u79fb\uff1b\u673a\u5236\u5931\u8d25\u7edf\u4e00\u4e3a <code>SFC2004</code> \u52a0\u7a33\u5b9a <code>details.kind</code>\u3002</p>"},{"location":"help/#\u6309\u7a33\u5b9a\u9519\u8bef\u7801\u5206\u8bca","title":"\u6309\u7a33\u5b9a\u9519\u8bef\u7801\u5206\u8bca","text":"\u9519\u8bef\u7801 \u540d\u79f0 \u542b\u4e49 \u5904\u7f6e SFC1001 SCHEMA_VALIDATION_FAILED \u6587\u6863\u672a\u901a\u8fc7\u76ee\u6807 Schema \u9a8c\u8bc1 \u68c0\u67e5\u6587\u6863\u5fc5\u586b\u5b57\u6bb5\u4e0e\u7c7b\u578b\u7ea6\u675f SFC1002 UNKNOWN_SCHEMA_ID <code>$id</code> \u672a\u5728\u767b\u8bb0\u8868\u6ce8\u518c \u786e\u8ba4 <code>$id</code> \u62fc\u5199\u4e0e Contracts \u7248\u672c SFC1003 DUPLICATE_SCHEMA_ID \u91cd\u590d <code>$id</code> \u6ce8\u518c\u88ab\u62d2 \u4e0d\u91cd\u590d\u6ce8\u518c\uff0c\u590d\u7528\u5df2\u6709\u767b\u8bb0 SFC1004 DUPLICATE_PROTOCOL_NAME \u91cd\u590d\u534f\u8bae\u540d/\u7248\u672c\u88ab\u62d2 \u4e0d\u91cd\u590d\u767b\u8bb0\u534f\u8bae SFC1005 UNRESOLVED_REF <code>$ref</code> \u76ee\u6807\u65e0\u6cd5\u89e3\u6790 \u68c0\u67e5 <code>$ref</code> \u6307\u5411 SFC1006 UNSUPPORTED_DIALECT \u65b9\u8a00\u4e0d\u5728\u652f\u6301\u96c6 \u4ec5\u7528 draft-07 / 2020-12 SFC1007 UNKNOWN_CHECK_TYPE \u89c4\u5219\u7528\u4e5d\u7c7b\u5916\u68c0\u67e5\u7c7b\u578b \u4e0d\u81ea\u5b9a\u4e49\u68c0\u67e5\u7c7b\u578b SFC1008 RULE_BUDGET_EXCEEDED \u5f3a\u5236\u89c4\u5219\u8d85\u9884\u7b97/\u4e0a\u9650 \u4e0d\u8d85 20\uff08\u7edd\u5bf9 30\uff09 SFC1009 UNKNOWN_ERROR_CODE \u5f15\u7528\u672a\u767b\u8bb0\u9519\u8bef\u7801 \u53ea\u5f15\u7528\u51bb\u7ed3\u767b\u8bb0\u8868 SFC1010 FIXTURE_EXPECTATION_MISMATCH fixture \u884c\u4e3a\u4e0e\u671f\u671b\u4e0d\u7b26 \u67e5 fixture \u58f0\u660e SFC1011 UNKNOWN_PROTOCOL \u5f15\u7528\u672a\u767b\u8bb0\u534f\u8bae \u786e\u8ba4\u534f\u8bae\u540d/\u7248\u672c SFC1012 SCHEMA_COMPILE_FAILED Schema \u672c\u8eab\u65e0\u6cd5\u7f16\u8bd1 \u67e5 Schema \u8bed\u6cd5 SFC2002 UNKNOWN_OPERATION \u64cd\u4f5c\u540d\u4e0d\u5728\u51bb\u7ed3\u8bcd\u6c47\u8868 \u53ea\u7528 <code>validate</code> SFC2003 INVALID_PARAMS \u53c2\u6570\u4e0d\u6ee1\u8db3 params \u5408\u540c \u68c0\u67e5\u53c2\u6570 SFC2004 EXECUTION_FAILED \u673a\u5236\u6267\u884c\u5931\u8d25 \u770b <code>details.kind</code> \u7ec6\u5206 SFC3001 REPORT_DIGEST_MISMATCH \u62a5\u544a/\u7ed3\u679c\u6458\u8981\u4e0e\u7ed1\u5b9a\u4e0d\u4e00\u81f4 \u91cd\u7b97 model/result SFC3002 REPORT_ELEMENT_MISSING \u62a5\u544a\u7f3a\u5f3a\u5236\u5143\u7d20 \u8865\u5168\u62a5\u544a\u5b57\u6bb5 SFC3003 REPORT_FACT_DRIFT \u62a5\u544a\u5b57\u8282\u504f\u79bb\u786e\u5b9a\u6027\u91cd\u6e32\u67d3 \u7528\u673a\u5668\u7ed3\u679c\u91cd\u6e32\u67d3"},{"location":"help/#\u6309\u8fdb\u7a0b\u9000\u51fa\u7801\u5206\u8bcaEngineering-Kit","title":"\u6309\u8fdb\u7a0b\u9000\u51fa\u7801\u5206\u8bca\uff08Engineering Kit\uff09","text":"\u9000\u51fa\u7801 \u542b\u4e49 \u5904\u7f6e 0 \u6210\u529f / \u65e0\u53d1\u73b0 \u65e0\u9700\u5904\u7f6e 1 <code>check</code> \u6709\u53d1\u73b0 \u5904\u7f6e\u53d1\u73b0\u9879\uff0cKit \u4e0d\u81ea\u52a8\u4fee\u590d 2 \u62d2\u7edd / \u7528\u6cd5 / \u673a\u5236\u9519\u8bef \u68c0\u67e5\u547d\u4ee4\u540d\u3001\u53c2\u6570\u4e0e <code>--fix</code> \u7b49\u88ab\u62d2\u65d7\u6807"},{"location":"help/#\u6309\u73b0\u8c61\u5206\u8bca","title":"\u6309\u73b0\u8c61\u5206\u8bca","text":"<ul> <li>\u6821\u9a8c\u4e00\u76f4\u62a5 SFC1002\uff1a<code>$id</code> \u672a\u6ce8\u518c\uff0c\u5148\u786e\u8ba4 Contracts \u7248\u672c\u4e0e <code>$id</code> \u547d\u540d\u7a7a\u95f4\u3002</li> <li>\u8def\u5f84\u64cd\u4f5c\u62a5 SFC2004 + <code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>\uff1a\u8def\u5f84\u8d8a\u51fa\u53d7\u6536\u5bb9\u6839\uff0c\u786e\u8ba4\u6839\u76ee\u5f55\u8fb9\u754c\uff0c\u4e0d\u8981\u628a\u4e1a\u52a1\u9009\u62e9\u89c4\u5219\u585e\u8fdb Foundation\u3002</li> <li>\u539f\u5b50\u5199\u62a5 SFC2004 + <code>atomic-write-failed</code>\uff1a\u76ee\u6807\u8d8a\u754c\u6216\u5185\u5bb9\u7c7b\u578b\u975e\u6cd5\uff0c\u68c0\u67e5\u8def\u5f84\u6536\u5bb9\u4e0e\u5185\u5bb9\u7c7b\u578b\u3002</li> <li>\u72b6\u6001\u5b58\u50a8\u62a5 <code>store-locked</code>\uff1a\u65e7\u5199\u8005\u53ef\u80fd\u4ecd\u6301\u6709\u9501\uff1b\u5728 Foundation \u5916\u786e\u8ba4\u65e7\u5199\u8005\u5df2\u7ec8\u6b62\uff0c\u518d\u7528\u7cbe\u786e owner/fencing \u8c03\u7528 <code>recoverStateStoreLock</code>\u3002</li> <li>host apply \u76f4\u63a5\u5931\u8d25\uff1a<code>apply</code> \u5728\u53ea\u8bfb Phase D \u5207\u7247\u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u66f4\u65b0/\u5378\u8f7d\u672a\u5b9e\u73b0\uff0cQoder \u5b8c\u6574 driver \u4e3a unsupported\u3002</li> <li>\u6587\u6863\u7248\u672c/\u547d\u4ee4\u5bf9\u4e0d\u4e0a\u771f\u6e90\uff1a\u4ee5 <code>scripts/docs/fact-check.mjs</code> \u590d\u7b97\u7ed3\u679c\u4e3a\u51c6\uff0c\u4e0d\u51ed\u8bb0\u5fc6\u4fee\u8ba2\u3002</li> </ul>"},{"location":"help/#\u9879\u76ee\u8def\u7531","title":"\u9879\u76ee\u8def\u7531","text":"<ul> <li>\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001 / npm \u53d1\u5e03 \u2192 release-skill\u3002</li> <li>\u4efb\u52a1 / \u91cd\u8bd5 / \u8fd4\u5de5 / \u9a8c\u6536 \u2192 loop-agent\u3002</li> <li>\u5236\u54c1\u5173\u7cfb / \u7248\u672c\u9501 \u2192 artifact-graph\u3002</li> <li>\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49 \u2192 \u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\u3002</li> <li>\u901a\u7528\u7ed3\u6784 / \u673a\u5236\u95ee\u9898 \u2192 \u672c\u4ed3 <code>docs/architecture.md</code> \u4e0e <code>docs/agents/</code>\u3002</li> </ul>"},{"location":"help/#\u547d\u4ee4\u901f\u67e5\u4e0e\u6743\u5a01\u4e8b\u5b9e","title":"\u547d\u4ee4\u901f\u67e5\u4e0e\u6743\u5a01\u4e8b\u5b9e","text":"<p>Engineering Kit \u53ea\u6709\u56db\u4e2a\u9876\u5c42\u547d\u4ee4\uff1a<code>scaffold</code>\u3001<code>adopt-plan</code>\u3001<code>projection</code>\u3001<code>check</code>\u3002\u5176\u4e2d <code>check</code> \u53ea\u8bca\u65ad\u4e0d\u4fee\u590d\uff0c\u53d1\u73b0\u9879\u4ea4\u8c03\u7528\u65b9\u5904\u7f6e\u3002</p> <ul> <li>\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u7248\u672c\u3001\u5305\u96c6\u5408\u3001\u955c\u50cf\u5750\u6807\u3001\u95e8\u7981\uff09\uff1a\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u552f\u4e00\u72b6\u6001\u9875\uff09\u3002</li> <li>\u5f00\u53d1\u4e0e\u63d0\u4ea4\u89c4\u8303\uff1aGit \u751f\u547d\u5468\u671f\u6307\u5357\u3002</li> </ul>"},{"location":"licensing/","title":"\u4e2d\u6587 \u00b7 \u8bb8\u53ef\u4e0e\u7f72\u540d","text":"<p>English</p>"},{"location":"licensing/#\u8bb8\u53ef\u8bc1\u4e0e\u8eab\u4efd\u8bf4\u660e","title":"\u8bb8\u53ef\u8bc1\u4e0e\u8eab\u4efd\u8bf4\u660e","text":"<p>\u672c\u9875\u8bf4\u660e Skill Family Foundation \u7684\u8bb8\u53ef\u8bc1\u91c7\u7528\u65b9\u5f0f\u3001\u5404\u8eab\u4efd\u4e3b\u4f53\u7684\u533a\u522b\uff0c\u4ee5\u53ca NOTICE \u4e0e\u7b2c\u4e09\u65b9\u7f72\u540d\u7684\u5f53\u524d\u72b6\u6001\u3002\u5b83\u4e0d\u662f Apache License 2.0 \u7684\u5b98\u65b9\u8bd1\u6587\uff1bApache-2.0 \u7684\u6cd5\u5f8b\u6b63\u6587\u4ee5\u4ed3\u5e93\u6839\u76ee\u5f55\u7684 <code>LICENSE</code> \u4e3a\u51c6\uff0c\u5982\u6709\u6b67\u4e49\u4ee5\u8be5\u82f1\u6587\u6b63\u672c\u4e3a\u51c6\u3002</p>"},{"location":"licensing/#\u8bb8\u53ef\u8bc1","title":"\u8bb8\u53ef\u8bc1","text":"<ul> <li>\u8bb8\u53ef\u8bc1\uff1a<code>Apache-2.0</code>\uff08SPDX \u6807\u8bc6\u4fdd\u6301\u4e0d\u53d8\uff09\u3002</li> <li>\u6cd5\u5f8b\u6b63\u6587\uff1a\u6839\u76ee\u5f55 <code>LICENSE</code> \u4e3a Apache License 2.0 \u5168\u6587\uff08\u82f1\u6587\u6743\u5a01\uff09\u3002\u672c\u9875\u4e0e\u4efb\u4f55\u4e2d\u6587\u6750\u6599\u53ea\u89e3\u91ca\u91c7\u7528\u65b9\u5f0f\uff0c\u4e0d\u66ff\u4ee3\u3001\u4e0d\u91cd\u8ff0\u6cd5\u5f8b\u6b63\u6587\uff0c\u4e5f\u4e0d\u58f0\u79f0\u5177\u6709\u540c\u7b49\u6cd5\u5f8b\u6548\u529b\u3002</li> <li>\u4e09\u4e2a\u53f6\u5b50\u5305\u968f\u5305\u5206\u53d1\u6839 <code>LICENSE</code> \u526f\u672c\u3002</li> </ul>"},{"location":"licensing/#\u8eab\u4efd\u4e3b\u4f53\u533a\u5206","title":"\u8eab\u4efd\u4e3b\u4f53\u533a\u5206","text":"<p>\u4ee5\u4e0b\u56db\u7c7b\u8eab\u4efd\u76f8\u4e92\u72ec\u7acb\uff0c\u4e0d\u5f97\u76f8\u4e92\u63a8\u5bfc\u6216\u5408\u5e76\uff1a</p> \u8eab\u4efd \u53d6\u503c \u8bf4\u660e \u4f5c\u8005 / \u7248\u6743\u4e3b\u4f53\uff08author / copyright holder\uff09 \u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8 \u7248\u6743\u5f52\u5c5e\u65b9\uff0c\u5199\u5165 <code>package.json</code> \u7684 <code>author</code> \u4e0e <code>LICENSE</code> \u9644\u5f55\u7f72\u540d \u4ed3\u5e93 owner\uff08GitHub owner\uff09 <code>ifoohoo</code> GitHub \u7ec4\u7ec7/\u8d26\u53f7\uff0c\u4e0e\u4f5c\u8005\u65e0\u63a8\u5bfc\u5173\u7cfb npm \u53d1\u5e03\u8005\uff08npm publisher\uff09 \u5f53\u524d\u53d1\u5e03\u914d\u7f6e\u4e2d\u7684\u8d26\u53f7 npm \u53d1\u5e03\u8eab\u4efd\uff0c\u4e0e\u4f5c\u8005/owner \u65e0\u63a8\u5bfc\u5173\u7cfb \u8d21\u732e\u8005\u7248\u6743\u884c \u6839 <code>LICENSE</code> \u9644\u5f55\u4e2d\u7684 contributors \u7f72\u540d \u4fdd\u7559\u7684\u5386\u53f2/\u8d21\u732e\u8005\u7f72\u540d\uff0c\u4e0d\u4f5c\u4e3a\u9879\u76ee\u4f5c\u8005\u6216\u7248\u6743\u4e3b\u4f53 <p><code>author</code>\u3001<code>repository.owner</code>\u3001<code>npm publisher</code> \u4e09\u8005\u5206\u522b\u8bb0\u5f55\uff0c\u4e0d\u5f97\u4ece\u4efb\u4e00\u63a8\u5bfc\u5176\u4f59\u3002</p>"},{"location":"licensing/#\u9879\u76ee\u7ea7-NOTICE","title":"\u9879\u76ee\u7ea7 NOTICE","text":"<p>FND-ADR-008 \u5df2\u6839\u636e 2026-08-10 \u7684\u7528\u6237\u88c1\u51b3\u91c7\u7528\u65b9\u6848 B\u3002Foundation \u73b0\u5728\u7ef4\u62a4\u6839 <code>NOTICE</code>\uff0c\u5176\u4e2d\u8bb0\u5f55\u9879\u76ee\u540d\u79f0\u3001\u5e74\u4efd 2026 \u548c\u7248\u6743\u4e3b\u4f53\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8\u3002\u4ece 0.2.1 \u8d77\uff0c\u4e09\u4e2a public unit \u7684\u955c\u50cf\u3001\u51bb\u7ed3\u5feb\u7167\u4e0e npm tarball \u90fd\u5fc5\u987b\u5206\u53d1\u8be5\u6587\u4ef6\u3002</p> <p><code>open-source</code> Profile \u7ee7\u7eed\u58f0\u660e <code>noticeRequired: true</code>\u3002Engineering Kit \u7ee7\u7eed\u628a Apache-2.0 \u4e0e NOTICE \u8981\u6c42\u7ed1\u5b9a\u4e3a\u673a\u5236\u4e0d\u53d8\u91cf\uff1b<code>checkIdentityDrift</code> \u5728 NOTICE \u7f3a\u5931\u65f6\u7ee7\u7eed\u62a5\u544a <code>notice-missing</code>\u3002\u8fd9\u9879\u6536\u53e3\u53ea\u6539\u53d8 Foundation \u7684\u53d1\u5e03\u6210\u5458\uff0c\u4e0d\u6539 Kit \u5bf9\u5176\u4ed6\u6d88\u8d39\u8005\u7684\u884c\u4e3a\u3002</p> <p>\u6839\u636e\u6839 <code>LICENSE</code> \u4e2d Apache License 2.0 \u7684\u7b2c 4(d) \u6761\uff0cNOTICE \u4e2d\u7684\u5185\u5bb9\u7528\u4e8e\u4fe1\u606f\u4e0e\u7f72\u540d\uff0c\u4e0d\u4fee\u6539 Apache License 2.0 \u7684\u8bb8\u53ef\u6761\u6b3e\u3002</p>"},{"location":"licensing/#\u7b2c\u4e09\u65b9\u7f72\u540dTHIRD_PARTY_NOTICES","title":"\u7b2c\u4e09\u65b9\u7f72\u540d\uff08THIRD_PARTY_NOTICES\uff09","text":"<p>Engineering Kit \u7684 public unit \u5206\u53d1 MkDocs Material\u3001lunr \u4e0e lunr-languages \u8d44\u4ea7\uff0c\u5df2\u5305\u542b <code>packages/skill-family-engineering-kit/THIRD_PARTY_NOTICES</code> \u4e0e\u5bf9\u5e94\u7b2c\u4e09\u65b9\u8bb8\u53ef\u8bc1\u6750\u6599\u3002\u7b2c\u4e09\u65b9\u7f72\u540d\u7531 <code>THIRD_PARTY_NOTICES</code> \u4e0e\u5bf9\u5e94\u8bb8\u53ef\u8bc1\u95ed\u5305\u8986\u76d6\uff0c\u4e0d\u5f97\u7528\u9879\u76ee\u7ea7 <code>NOTICE</code> \u66ff\u4ee3\u3002<code>NOTICE</code> \u53ea\u627f\u8f7d Foundation \u81ea\u8eab\u7684\u9879\u76ee\u7f72\u540d\uff0c\u4e0d\u590d\u5236\u7b2c\u4e09\u65b9\u8bb8\u53ef\u8bc1\u5168\u6587\u3002</p>"},{"location":"licensing/#private-\u5de5\u4f5c\u533a\u4e0e-public-\u955c\u50cf\u7684\u8bb8\u53ef\u8bc1\u8fb9\u754c","title":"private \u5de5\u4f5c\u533a\u4e0e public \u955c\u50cf\u7684\u8bb8\u53ef\u8bc1\u8fb9\u754c","text":"<ul> <li>\u672c\u5de5\u4f5c\u533a\u6c38\u4e45 private\uff0c\u662f\u552f\u4e00\u5f00\u53d1\u771f\u6e90\uff1b\u672c\u4f53\u4e0d\u8fdb\u5165\u516c\u5f00\u8fb9\u754c\u3002</li> <li>\u516c\u5f00\u8fb9\u754c\u53ea\u6709\u4e09\u4e2a\u7248\u672c\u5316\u53d1\u5e03\u955c\u50cf\u4e0e npm tarball\uff1b\u5b83\u4eec\u5206\u53d1\u6839 <code>LICENSE</code>\uff08Apache-2.0\uff09\u4e0e <code>NOTICE</code>\u3002Engineering Kit \u8fd8\u5206\u53d1 <code>THIRD_PARTY_NOTICES</code> \u53ca\u5bf9\u5e94\u7b2c\u4e09\u65b9\u8bb8\u53ef\u8bc1\u6750\u6599\u3002</li> <li>\u79c1\u6709\u5de5\u4f5c\u533a\u5185\u7684 Profile\u3001fixture\u3001\u5185\u90e8\u6587\u6863\u4e0e\u8fd0\u884c\u8bc1\u636e\u4e0d\u8fdb\u5165\u516c\u5f00\u5305\uff1b\u516c\u5f00\u6587\u6863\u53ea\u6d88\u8d39\u7ecf allowlist \u4e0e\u53d1\u5e03\u5408\u540c\u673a\u68b0\u9a8c\u8bc1\u7684\u53d1\u5e03\u7269\u3002</li> <li>\u53d1\u5e03\u72b6\u6001\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165\u5f52 release-skill\uff1b\u672c\u6587\u4e0d\u590d\u5236\u5b9e\u65f6\u53d1\u5e03\u72b6\u6001\u3002</li> </ul>"},{"location":"quickstart/","title":"\u4e2d\u6587 \u00b7 \u5feb\u901f\u5f00\u59cb","text":"<p>English</p>"},{"location":"quickstart/#\u5feb\u901f\u5f00\u59cb","title":"\u5feb\u901f\u5f00\u59cb","text":"<p>\u672c\u9875\u7ed9\u4e09\u7c7b\u8bfb\u8005\u5404\u7ed9\u4e00\u6761\u6700\u77ed\u6210\u529f\u8def\u5f84\uff1a\u65b0\u9879\u76ee\u3001\u5b58\u91cf\u9879\u76ee\u3001\u67b6\u6784\u8bbe\u8ba1\u8005\u3002\u6bcf\u6761\u8def\u5f84\u53ea\u5217\u5fc5\u505a\u52a8\u4f5c\u4e0e\u9a8c\u8bc1\u547d\u4ee4\uff0c\u6df1\u5165\u7ec6\u8282\u8f6c\u5230\u5bf9\u5e94\u6587\u6863\u3002</p>"},{"location":"quickstart/#\u65b0\u9879\u76ee\u751f\u6210\u9aa8\u67b6","title":"\u65b0\u9879\u76ee\uff1a\u751f\u6210\u9aa8\u67b6","text":"<p>\u76ee\u6807\u662f\u4ece\u96f6\u62ff\u5230\u4e00\u4e2a\u7b26\u5408 Foundation \u5951\u7ea6\u7684\u9879\u76ee\u9aa8\u67b6\u3002</p> <pre><code>npm install --save-dev skill-family-engineering-kit\nnpm exec -- skill-family-kit scaffold --root ./my-project --project-id my-project\nnpm exec -- skill-family-kit check --root ./my-project\n</code></pre> <p>\u4ee5\u4e0a\u547d\u4ee4\u5148\u751f\u6210\u9aa8\u67b6\uff0c\u518d\u5bf9\u751f\u6210\u7ed3\u679c\u505a\u5de5\u7a0b\u8bca\u65ad\u3002<code>scaffold</code> \u53ea\u5199\u7a7a\u76ee\u6807\u76ee\u5f55\uff0c\u975e\u7a7a\u6216\u51b2\u7a81\u76ee\u6807\u4f1a\u88ab\u62d2\u7edd\u4e14\u4e0d\u88ab\u89e6\u78b0\uff1b<code>check</code> \u53ea\u8bca\u65ad\u4e0d\u4fee\u590d\u3002\u9a8c\u8bc1\u4ee5 <code>check</code> \u9000\u51fa\u7801 0 \u4e3a\u901a\u8fc7\u3002</p>"},{"location":"quickstart/#\u5b58\u91cf\u9879\u76ee\u53ea\u8bfb\u76d8\u70b9","title":"\u5b58\u91cf\u9879\u76ee\uff1a\u53ea\u8bfb\u76d8\u70b9","text":"<p>\u76ee\u6807\u662f\u5148\u770b\u6e05\u5b58\u91cf\u4ed3\u80fd\u5426\u91c7\u7528\uff0c\u4e0d\u6539\u52a8\u4efb\u4f55\u5b57\u8282\u3002</p> <pre><code>npm exec -- skill-family-kit adopt-plan --root ./existing-repo\nnpm exec -- skill-family-kit check --root ./existing-repo\n</code></pre> <p><code>adopt-plan</code> \u8f93\u51fa\u73b0\u72b6\u3001\u76ee\u6807 Profile\u3001\u7cbe\u786e\u5199\u96c6\u3001\u51b2\u7a81\u4e0e\u65e7\u5b9e\u73b0\u9000\u51fa\u6e05\u5355\uff0c\u4e14\u5bf9\u8f93\u5165\u4ed3\u5b57\u8282\u96f6\u53d8\u5316\u3002<code>check</code> \u53ea\u505a\u53ea\u8bfb\u8bca\u65ad\u3002\u786e\u8ba4\u76d8\u70b9\u7ed3\u679c\u540e\u518d\u51b3\u5b9a\u662f\u5426\u6267\u884c\u5199\u5165\u3002</p>"},{"location":"quickstart/#\u67b6\u6784\u8bbe\u8ba1\u8005\u5224\u5b9a\u5f52\u5c5e","title":"\u67b6\u6784\u8bbe\u8ba1\u8005\uff1a\u5224\u5b9a\u5f52\u5c5e","text":"<p>\u76ee\u6807\u662f\u5224\u65ad\u4e00\u4e2a\u67b6\u6784\u9700\u6c42\u8be5\u843d\u5728 Foundation \u54ea\u4e00\u5c42\uff0c\u8fd8\u662f\u7559\u5728\u6d88\u8d39\u8005\u3002</p> <ol> <li>\u8bfb <code>docs/agents/architecture-routing.md</code> \u7684\u516b\u6b65\u51b3\u7b56\u987a\u5e8f\u3002</li> <li>\u5728 <code>docs/agents/capability-catalog.json</code> \u6309 <code>layer</code> \u4e0e <code>intent</code> \u627e\u5230\u80fd\u529b\uff0c\u8bfb\u5b83\u7684 <code>entrypoints</code>\u3001<code>sideEffects</code>\u3001<code>failureSemantics</code>\u3001<code>ownedByCaller</code>\u3002</li> <li>\u9700\u8981\u53d1\u5e03\u3001\u4efb\u52a1\u751f\u547d\u5468\u671f\u6216\u5236\u54c1\u5173\u7cfb\u65f6\uff0c\u5206\u522b\u8f6c release-skill\u3001loop-agent\u3001artifact-graph\u3002</li> </ol> <p>\u8def\u7531\u7684\u786c\u8fb9\u754c\uff1aFoundation \u4e0d\u62e5\u6709\u8fdc\u7aef\u5199\u5165\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u4e0e\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\u3002\u843d\u5165 <code>keep-business</code> \u6216 <code>foundation-gap</code> \u7684\u80fd\u529b\u4e0d\u5f3a\u884c\u6269\u5f20 Foundation\u3002</p>"},{"location":"quickstart/#\u6743\u5a01\u4e8b\u5b9e\u4e0e\u89c4\u8303","title":"\u6743\u5a01\u4e8b\u5b9e\u4e0e\u89c4\u8303","text":"<ul> <li>\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u7248\u672c\u3001\u5305\u96c6\u5408\u3001\u955c\u50cf\u5750\u6807\u3001\u95e8\u7981\uff09\uff1a\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u552f\u4e00\u72b6\u6001\u9875\uff0c\u672c\u9875\u4e0d\u590d\u5236\uff09\u3002</li> <li>\u5f00\u53d1\u4e0e\u63d0\u4ea4\u89c4\u8303\uff1aGit \u751f\u547d\u5468\u671f\u6307\u5357\u3002</li> </ul>"},{"location":"quickstart/#\u8def\u5f84\u5bf9\u7167","title":"\u8def\u5f84\u5bf9\u7167","text":"\u8bfb\u8005 \u8d77\u70b9 \u4e0b\u4e00\u6b65 \u65b0\u9879\u76ee <code>scaffold</code> <code>check</code> \u2192 \u63a5\u5165 Profile \u5b58\u91cf\u9879\u76ee <code>adopt-plan</code> \u5206\u7c7b\uff08direct-adoption / compatibility-layer / keep-business / foundation-gap\uff09\u2192 \u91c7\u7528 \u67b6\u6784\u8bbe\u8ba1\u8005 \u8def\u7531\u51b3\u7b56 \u80fd\u529b\u76ee\u5f55 \u2192 \u771f\u5b9e\u5bfc\u51fa\u4e0e\u6d4b\u8bd5"},{"location":"setup/","title":"\u5b89\u88c5\u4e0e\u73af\u5883","text":""},{"location":"setup/#\u5fc5\u9700\u73af\u5883","title":"\u5fc5\u9700\u73af\u5883","text":"\u5de5\u5177 \u7248\u672c \u9501\u5b9a\u70b9 Node.js 22.22.2\uff08\u9501\u5b9a major 22 \u5e76\u7cbe\u786e\u63d0\u9ad8 floor\uff1a<code>>=22.22.2 <23</code>\uff09 <code>.node-version</code>\uff08\u53d6\u7cbe\u786e floor\uff09\u3001\u6839\u4e0e\u5404\u53f6\u5b50\u5305 <code>package.json</code> \u7684 <code>engines.node</code>\uff1bfloor \u7531 <code>scripts/engine-floor-check.mjs</code> \u4ece\u56fa\u5b9a\u6839 devDependencies \u7684 engines \u5b9e\u65f6\u91cd\u7b97\uff0cfact-check J \u8282\u7ed1\u5b9a\u6587\u6863\u8868\u9762 pnpm 10.30.0 <code>package.json</code> \u7684 <code>packageManager</code> projen 0.101.23 <code>package.json</code> \u7684 <code>devDependencies.projen</code>\uff08\u7cbe\u786e\u7248\u672c\uff0c\u65e0\u8303\u56f4\u7b26\u53f7\uff09 Git \u8fd1\u5e74\u7248\u672c\u5373\u53ef \u4ec5\u5f00\u53d1\u8005\u81ea\u884c\u7ba1\u7406\u7248\u672c\uff1b\u672c\u4ed3\u811a\u672c\u4e0d\u6267\u884c Git \u5199\u64cd\u4f5c <p>\u5de5\u5177\u7248\u672c\u4e0e\u9501\u5b9a\u70b9\u767b\u8bb0\u5728 <code>.foundation/version-lock.json</code>\uff08projen \u751f\u6210\u7684\u673a\u5668\u771f\u6e90\uff0c\u7981\u6b62\u624b\u6539\uff09\u3002\u5347\u7ea7\u6d41\u7a0b\u89c1 <code>scripts/README.md</code>\u3002</p>"},{"location":"setup/#\u5b89\u88c5\u4f9d\u8d56","title":"\u5b89\u88c5\u4f9d\u8d56","text":"<pre><code>pnpm install\n</code></pre> <p><code>.npmrc</code> \u542f\u7528 <code>save-exact=true</code>\uff0c\u65b0\u589e\u4f9d\u8d56\u4e5f\u4f1a\u4ee5\u7cbe\u786e\u7248\u672c\u5199\u5165\u3002</p>"},{"location":"setup/#\u5408\u6210\u4e0e\u68c0\u67e5","title":"\u5408\u6210\u4e0e\u68c0\u67e5","text":"<pre><code>pnpm synth\npnpm check\n</code></pre> <ul> <li><code>pnpm synth</code> \u518d\u751f\u6210 projen \u53d7\u7ba1\u6587\u4ef6\u3002\u53d7\u7ba1\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7\u4fee\u6539 <code>.projenrc.js</code> \u95f4\u63a5\u53d8\u66f4\uff1b\u624b\u5199\u6e90\u7801\u3001\u6587\u6863\u548c fixture \u4e0d\u4f1a\u88ab synth \u8986\u76d6\u3002</li> <li><code>pnpm check</code> \u662f\u5f53\u524d\u7edf\u4e00\u6839\u95e8\u7981\uff1a11 \u4e2a\u7a33\u5b9a\u95e8\u7981 ID \u6309\u56fa\u5b9a\u987a\u5e8f\u4e32\u8054\u6267\u884c\uff0c\u4efb\u4e00\u6b65\u9aa4\u975e 0 \u5373\u6574\u4f53\u5931\u8d25\uff1b\u672c\u4ed3\u6ca1\u6709\u4efb\u4f55 CI/CD workflow\uff0c\u5168\u90e8\u95e8\u7981\u90fd\u5728\u79c1\u6709\u5de5\u4f5c\u533a\u5185\u8fd0\u884c\u3002\u4e0b\u65b9\u533a\u5757\u7531\u6839 <code>package.json</code> \u7684 <code>scripts.check</code> \u673a\u68b0\u6295\u5f71\uff08<code>node scripts/docs/fact-check.mjs</code> \u9010\u5b57\u6838\u5bf9\uff0c\u7981\u6b62\u624b\u5199\u6e05\u5355\u518d\u6b21\u6ede\u540e\uff09\uff1a</li> </ul> <ol> <li>pnpm run check:structure</li> <li>pnpm run check:packages</li> <li>pnpm run check:profiles</li> <li>pnpm run check:public-boundary</li> <li>pnpm run check:scaffold</li> <li>pnpm run check:docs</li> <li>pnpm run check:public-snapshots</li> <li>pnpm run check:release-artifacts</li> <li>pnpm run check:projen</li> <li>pnpm run check:integration</li> <li>pnpm run check:artifacts</li> </ol> <ul> <li>\u53d1\u5e03\u5b57\u8282\u5408\u540c\u7531\u4e24\u4e2a\u56fa\u5b9a\u5165\u53e3\u627f\u8f7d\uff1a<code>pnpm run release-artifacts:build</code>\uff08\u6784\u5efa\u5019\u9009\u4ea7\u7269\uff09\u4e0e <code>pnpm run release-artifacts:verify</code>\uff08\u6309\u5408\u540c\u6821\u9a8c\uff09\uff0c\u63a5\u53e3\u4e0e\u62d2\u7edd\u77e9\u9635\u8be6\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u3002</li> <li>\u8017\u65f6\u7684 Python \u6587\u6863\u77e9\u9635\u4e0d\u5c5e\u4e8e <code>pnpm check</code>\uff1a\u5b83\u6709\u72ec\u7acb\u5165\u53e3 <code>node scripts/docs/verify-matrix.mjs</code>\uff08\u77e9\u9635\u7248\u672c\u8986\u76d6\u7531\u8be5\u811a\u672c\u5bf9\u7167 <code>scripts/docs/toolchain.json</code> \u673a\u68b0\u6838\u5bf9\uff1b\u672c\u4ed3\u65e0 CI\uff0c\u77e9\u9635\u4e0d\u58f0\u660e\u5728\u4efb\u4f55\u5de5\u4f5c\u6d41\u91cc\uff09\u3002</li> </ul> <p>\u5176\u4f59\u547d\u4ee4\uff1a<code>pnpm test</code>\uff08\u4ec5\u6d4b\u8bd5\uff09\u3001<code>pnpm drift</code>\uff08\u53ea\u8bfb synth \u6f02\u79fb\u68c0\u67e5\uff09\u3001<code>pnpm synth-idempotency</code>(\u5e42\u7b49\u6027\u9a8c\u8bc1)\u3001<code>pnpm fixtures-projen</code>\uff08projen \u53cd\u4f8b fixture\uff09\u3002</p>"},{"location":"setup/#\u6587\u6863\u7ad9\u70b9Material-for-MkDocs","title":"\u6587\u6863\u7ad9\u70b9\uff08Material for MkDocs\uff09","text":"<p>\u6587\u6863\u7ad9\u70b9\u9501\u5b9a mkdocs 1.6.1 \u4e0e Material for MkDocs 9.7.7\u3002\u4f9d\u8d56\u9501\u662f <code>pip-compile --generate-hashes</code> \u751f\u6210\u7684\u5b8c\u6574\u5185\u5bb9\u9501\uff08\u5168\u90e8\u9876\u5c42\u4e0e\u4f20\u9012\u4f9d\u8d56\u90fd\u5e26 SHA-256 hash\uff09\uff0c\u89c1 <code>scripts/docs/requirements.txt</code>\uff08\u4eba\u5de5\u8f93\u5165\u53ea\u6709\u540c\u76ee\u5f55\u7684 <code>requirements.in</code>\uff09\uff1b\u5de5\u5177\u94fe\u771f\u6e90\u89c1 <code>scripts/docs/toolchain.json</code>\u3002Python 3.10 \u6216\u66f4\u9ad8\u5373\u53ef\uff08<code>node scripts/docs/verify-matrix.mjs</code> \u5728\u6700\u4f4e\u7248 3.10 \u4e0e tested 3.14 \u4e0a\u90fd\u4f1a\u7528\u5168\u65b0\u865a\u62df\u73af\u5883\u590d\u73b0\u5b89\u88c5\u4e0e\u4e25\u683c\u6784\u5efa\uff09\u3002</p> <p>\u7ea6\u5b9a\uff1a\u4e0d\u505a\u7cfb\u7edf\u7ea7 pip install\uff0c\u865a\u62df\u73af\u5883\u5fc5\u987b\u5efa\u5728\u4ed3\u5e93\u5916\u90e8\u3002\u539f\u56e0\u662f\u6839 <code>pnpm check</code> \u4f1a\u5bf9\u5168\u4ed3\u505a\u672c\u5730\u7edd\u5bf9\u8def\u5f84\u5b57\u8282\u626b\u63cf\uff08\u89c1 <code>node scripts/check-structure.mjs</code>\uff09\uff0c\u800c macOS/Windows \u4e0a\u7684\u865a\u62df\u73af\u5883\u5185\u90e8\u5d4c\u6709\u672c\u673a\u7edd\u5bf9\u8def\u5f84\uff0c\u653e\u8fdb\u4ed3\u5e93\u4f1a\u9020\u6210\u8bef\u62a5\u3002</p> <p>\u5b89\u88c5\u547d\u4ee4\u7edf\u4e00\u4f7f\u7528 <code>--require-hashes</code>\uff08\u5185\u5bb9\u9501\u8981\u6c42\u9010\u6761\u6821\u9a8c hash\uff09\uff1a</p> <pre><code># \u5728\u4ed3\u5e93\u5916\u90e8\u521b\u5efa\u865a\u62df\u73af\u5883\uff08\u8def\u5f84\u53ef\u6309\u9700\u66ff\u6362\uff0c\u793a\u4f8b\u7528\u7236\u76ee\u5f55\uff09\npython3 -m venv ../docs-site-venv\n\n# \u7528\u54c8\u5e0c\u9501\u5b89\u88c5\u9501\u5b9a\u7248\u672c\uff08\u5b57\u8282\u4e0d\u7b26\u4f1a\u76f4\u63a5\u5931\u8d25\uff09\n../docs-site-venv/bin/pip install --require-hashes -r scripts/docs/requirements.txt\n\n# \u4e25\u683c\u6a21\u5f0f\u6784\u5efa\uff08\u4efb\u4f55\u8b66\u544a\u90fd\u4f1a\u5931\u8d25\uff09\uff0c\u8f93\u51fa\u5230 site/\uff08\u5df2\u88ab .gitignore \u5ffd\u7565\uff09\n../docs-site-venv/bin/mkdocs build --strict\n\n# \u672c\u5730\u9884\u89c8\uff08\u53ef\u9009\uff09\n../docs-site-venv/bin/mkdocs serve\n</code></pre> <p>\u79bb\u7ebf\u73af\u5883\u5b89\u88c5\uff08\u56fa\u5b9a\u6d41\u7a0b\uff09\uff1a\u5728\u7ebf\u673a\u5668\u53ea\u4e0b\u8f7d wheelhouse\uff0c\u79bb\u7ebf\u5b89\u88c5\u5fc5\u987b\u8fdb\u5165\u4e00\u4e2a\u4ece\u672a\u5728\u7ebf\u5b89\u88c5\u8fc7\u7684\u65b0 offline venv\u2014\u2014\u590d\u7528\u5728\u7ebf venv \u65e0\u6cd5\u8bc1\u660e\u79bb\u7ebf\u94fe\u8def\u53ef\u7528\uff1a</p> <pre><code># 1. \u5728\u7ebf\u673a\u5668\uff1a\u4e0b\u8f7d wheelhouse\uff08\u4e0b\u8f7d\u540c\u6837\u9010\u6761\u6821\u9a8c hash\uff1b\u672c\u6b65\u4e0d\u5b89\u88c5\u5230\u4efb\u4f55 venv\uff09\npython3 -m pip download --require-hashes -r scripts/docs/requirements.txt -d ../docs-wheels\n\n# 2. \u79bb\u7ebf\u673a\u5668\uff1a\u65b0\u5efa\u4e00\u4e2a\u4ece\u672a\u5728\u7ebf\u5b89\u88c5\u8fc7\u7684 offline venv\uff08\u8def\u5f84\u53ef\u6309\u9700\u66ff\u6362\uff0c\u4e0d\u5f97\u590d\u7528 ../docs-site-venv\uff09\npython3 -m venv ../docs-site-offline-venv\n\n# 3. \u5b8c\u5168\u79bb\u7ebf\u5b89\u88c5\uff1a\u4e0d\u8bbf\u95ee\u4efb\u4f55\u7d22\u5f15\uff0c\u53ea\u4ece wheelhouse \u89e3\u6790\uff0c\u7ee7\u7eed\u9010\u6761\u6821\u9a8c hash\uff08\u5b57\u8282\u4e0d\u7b26\u76f4\u63a5\u5931\u8d25\uff09\n../docs-site-offline-venv/bin/pip install --no-index --find-links ../docs-wheels --require-hashes -r scripts/docs/requirements.txt\n\n# 4. \u4e25\u683c\u6a21\u5f0f\u6784\u5efa\uff08\u4efb\u4f55\u8b66\u544a\u90fd\u4f1a\u5931\u8d25\uff09\n../docs-site-offline-venv/bin/mkdocs build --strict\n</code></pre>"},{"location":"setup/#\u516c\u5f00\u9759\u6001\u7ad9render-public-sitemjs","title":"\u516c\u5f00\u9759\u6001\u7ad9\uff08render-public-site.mjs\uff09","text":"<p>\u516c\u5f00\u9759\u6001\u7ad9\u662f\u672c\u4ed3\u6587\u6863\u7ad9\u7684\u516c\u5f00\u5b50\u96c6\uff0c\u552f\u4e00\u7531 <code>scripts/render-public-site.mjs</code> \u7528\u4e0a\u8ff0\u51bb\u7ed3 MkDocs \u73af\u5883\u6e32\u67d3\uff1a</p> <ul> <li>\u811a\u672c\u53ea\u53d1\u73b0\u5e76\u6821\u9a8c\u51bb\u7ed3\u865a\u62df\u73af\u5883\uff08<code>SKILL_FAMILY_DOCS_VENV</code>\uff0c\u6216\u6309\u672c\u8282\u6b65\u9aa4\u5efa\u7684 <code>../docs-site-venv</code> / <code>../docs-site-offline-venv</code>\uff09\uff0c\u81ea\u8eab\u4e0d\u505a\u4efb\u4f55\u5b89\u88c5\uff1b</li> <li>\u6267\u884c\u4e24\u6b21 strict \u6784\u5efa\u5e76\u8981\u6c42\u6811\u54c8\u5e0c\u4e00\u81f4\uff08\u786e\u5b9a\u6027\uff09\uff0c\u968f\u540e\u590d\u7528 <code>scripts/leak-scan.mjs</code> \u6838\u5fc3\u4e0e <code>scripts/leak-policy.json</code> \u505a\u5185\u5bb9\u6cc4\u6f0f\u626b\u63cf\uff1b</li> <li><code>--write</code> \u53ea\u5199 <code>docs/public/site/</code> \u4e0e <code>docs/public/site-baseline.json</code>\uff1b<code>--check</code> \u96f6\u5199\u5165\u91cd\u7b97\u5e76\u6bd4\u5bf9\u57fa\u7ebf\uff1b<code>--self-test</code> \u8fd0\u884c\u4e3b\u52a8\u53cd\u4f8b\u81ea\u6d4b\uff1b</li> <li>symlink\u3001\u7279\u6b8a\u6587\u4ef6\u3001\u8d8a\u754c realpath\u3001\u5355\u6587\u4ef6\u8d85\u9650\u4e0e\u4e0d\u786e\u5b9a\u8f93\u51fa\u4e00\u5f8b\u62d2\u7edd\uff1b\u57fa\u7ebf\u7981\u6b62\u624b\u6539\uff08\u6e32\u67d3\u5668\u662f\u552f\u4e00\u5199\u5165\u9762\uff09\u3002</li> </ul> <pre><code>node scripts/render-public-site.mjs --write\nnode scripts/render-public-site.mjs --check\n</code></pre> <p>\u7ad9\u70b9\u6587\u4ef6\u4e0e engineering-kit public \u53d1\u5e03\u955c\u50cf\u4ed3\u7684 <code>docs/*</code> \u9010\u6587\u4ef6\u5bf9\u5e94\uff08\u6620\u5c04\u7531\u53d1\u5e03\u914d\u7f6e\u6267\u884c\uff0c\u672c\u4ed3\u4e0d\u76f4\u63a5\u5199\u955c\u50cf\uff09\uff1bPages \u5b9e\u4f8b\u662f\u5426\u5728\u7ebf\u662f\u53d1\u5e03\u540e\u9a8c\u8bc1\u4e8b\u5b9e\uff0c\u53e3\u5f84\u552f\u4e00\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u3002</p>"},{"location":"setup/#\u6587\u6863\u4e8b\u5b9e\u4e0e\u94fe\u63a5\u68c0\u67e5","title":"\u6587\u6863\u4e8b\u5b9e\u4e0e\u94fe\u63a5\u68c0\u67e5","text":"<p>\u6587\u6863\u4e2d\u7684\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\u4e0e\u95e8\u7981\u4e8b\u5b9e\u7531\u786e\u5b9a\u6027\u811a\u672c\u5bf9\u7167\u673a\u5668\u771f\u6e90\u6821\u9a8c\uff0c\u94fe\u63a5\u7531\u72ec\u7acb\u811a\u672c\u89e3\u6790\uff1a</p> <pre><code>node scripts/docs/fact-check.mjs\nnode scripts/docs/link-check.mjs\n</code></pre> <p><code>fact-check.mjs</code> \u662f Node \u811a\u672c\uff0c\u7ecf\u4ed3\u5185\u6a21\u5757\uff08<code>scripts/engine-floor-check.mjs</code>\uff09\u6d88\u8d39\u6839\u76ee\u5f55\u7cbe\u786e\u9501\u5b9a\u7684 <code>semver@7.8.5</code>\uff0c\u8fd0\u884c\u524d\u5fc5\u987b\u5148\u5b8c\u6210 <code>pnpm install --frozen-lockfile</code>\uff1b<code>link-check.mjs</code> \u4e3a\u7eaf Node \u5b9e\u73b0\uff08\u65e0\u7b2c\u4e09\u65b9\u4f9d\u8d56\uff09\u3002\u4e24\u8005\u9000\u51fa\u7801 0 \u8868\u793a\u901a\u8fc7\u3002\u811a\u672c\u804c\u8d23\u89c1 <code>scripts/docs/README.md</code>\u3002</p>"},{"location":"agents/","title":"\u4e2d\u6587 \u00b7 \u667a\u80fd\u4f53\u5165\u53e3","text":"<p>English</p>"},{"location":"agents/#\u9762\u5411\u667a\u80fd\u4f53\u7684\u6587\u6863\u5165\u53e3","title":"\u9762\u5411\u667a\u80fd\u4f53\u7684\u6587\u6863\u5165\u53e3","text":"<p>\u672c\u76ee\u5f55\u662f Skill Family Foundation \u7ed9\u667a\u80fd\u4f53\uff08Agent\uff09\u7528\u7684\u51b3\u7b56\u5165\u53e3\u3002\u4eba\u7c7b\u8bfb\u8005\u4ece\u6839 <code>README.md</code> \u8fdb\u5165\uff1b\u667a\u80fd\u4f53\u5728\u6709\u9650\u4e0a\u4e0b\u6587\u91cc\u5148\u8bfb\u8fd9\u91cc\uff0c\u518d\u6309\u610f\u56fe\u8df3\u5230\u5177\u4f53\u80fd\u529b\uff0c\u907f\u514d\u901a\u8bfb\u5168\u90e8\u6e90\u7801\u3002</p> <p>Foundation \u4e0d\u62e5\u6709\u4e1a\u52a1\u8bed\u4e49\u3002\u5b83\u53ea\u63d0\u4f9b\u4e09\u4ef6\u4e8b\uff1a\u673a\u5668\u5951\u7ea6\uff08Contracts\uff09\u3001Node \u8584\u673a\u5236\u8fd0\u884c\u65f6\uff08Harness\uff09\u3001\u5de5\u7a0b\u9636\u6bb5\u7684\u56db\u4e2a\u547d\u4ee4\uff08Engineering Kit\uff09\uff0c\u4ee5\u53ca\u6a2a\u5411\u58f0\u660e\u5dee\u5f02\u7684 Profile\u3002\u9886\u57df\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u3001\u53d1\u5e03\u8fdc\u7aef\u5199\u5165\u3001\u5ba1\u8ba1\u8bed\u4e49\u90fd\u7559\u5728\u8c03\u7528\u65b9\u6216\u5176\u4ed6\u9879\u76ee\u3002</p>"},{"location":"agents/#\u9605\u8bfb\u987a\u5e8f","title":"\u9605\u8bfb\u987a\u5e8f","text":"<p>\u667a\u80fd\u4f53\u6309\u4e0b\u9762\u7684\u987a\u5e8f\u53d6\u7528\uff0c\u4e0d\u5fc5\u4ece\u5934\u8bfb\u5230\u5c3e\uff1a</p> <ol> <li><code>capability-catalog.json</code> \u2014\u2014 \u5168\u90e8\u7a33\u5b9a\u80fd\u529b\u7684\u673a\u5668\u4e8b\u5b9e\u76ee\u5f55\uff0c\u662f\u5224\u65ad\u300c\u8be5\u9700\u6c42\u662f\u5426\u5c5e\u4e8e Foundation\u3001\u843d\u5728\u54ea\u4e00\u5c42\u3001\u7528\u54ea\u4e2a\u5165\u53e3\u300d\u7684\u8d77\u70b9\u3002</li> <li><code>architecture-routing.md</code> \u2014\u2014 \u4ece\u67b6\u6784\u610f\u56fe\u5230\u5c42/\u80fd\u529b/\u5165\u53e3/\u5916\u90e8\u9879\u76ee\u7684\u51b3\u7b56\u8868\u4e0e\u51b3\u7b56\u6811\u3002</li> <li><code>capability-catalog.schema.json</code> \u2014\u2014 \u76ee\u5f55\u81ea\u8eab\u7684\u7ed3\u6784\u5408\u540c\uff0c\u6821\u9a8c\u5668\u4e0e\u6295\u5f71\u90fd\u4f9d\u8d56\u5b83\u3002</li> <li>\u6839 <code>README.md</code> \u7684 Agent Quick Reference \u2014\u2014 \u53ea\u505a\u8def\u7531\uff0c\u4e0d\u590d\u5236 API\u3002</li> <li>\u4e09\u4e2a\u5305 README \u7684 Agent Quick Reference \u2014\u2014 \u7cbe\u786e\u5230\u5305\u7ea7\u80fd\u529b\u548c\u5931\u8d25\u8fb9\u754c\u3002</li> <li><code>../reference/failure-and-side-effect-matrix.md</code> \u2014\u2014 \u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u7684\u8bfb\u5199/spawn/Git/\u7f51\u7edc/\u6b8b\u4f59\u72b6\u6001/\u9519\u8bef\u7801\u3002</li> <li><code>../reference/api/README.md</code> \u2014\u2014 \u4e09\u5305\u516c\u5171 API \u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\uff0c\u6309\u5165\u53e3\u7ed9\u51fa\u7b7e\u540d\u3001\u8f93\u5165/\u8f93\u51fa\u3001\u7eaf\u51fd\u6570\u6027\u3001\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code>/<code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1b\u4e0e catalog \u80fd\u529b ID \u4e92\u94fe\u3002</li> </ol> <p>\u4e8b\u5b9e\u4f18\u5148\u7ea7\uff1a\u672c\u6587\u6863\u53ea\u6d88\u8d39\u673a\u5668\u771f\u6e90\uff08package.json\u3001src/index.mjs\u3001CLI\u3001registry.json\u3001profile descriptor\uff09\u3002\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\u3001\u652f\u6301\u72b6\u6001\u90fd\u4ece\u771f\u6e90\u590d\u7b97\uff0c\u4e0d\u4ece\u8bb0\u5fc6\u6216\u65e7\u6587\u6863\u7167\u642c\u3002</p>"},{"location":"agents/#\u76ee\u5f55\u5408\u540c","title":"\u76ee\u5f55\u5408\u540c","text":"<p><code>docs/agents/</code> \u4e0b\u7684\u6587\u4ef6\u627f\u62c5\u4e0d\u540c\u804c\u8d23\uff0c\u4e0d\u4e92\u76f8\u91cd\u590d\uff1a</p> \u6587\u4ef6 \u89d2\u8272 \u8c01\u8be5\u6539 <code>capability-catalog.json</code> \u673a\u5668\u53ef\u8bfb\u7684\u80fd\u529b\u4e8b\u5b9e\uff0c\u6587\u6863\u5c42\u552f\u4e00\u4e8b\u5b9e\u9762 \u80fd\u529b\u53d8\u5316\u65f6\u6539\uff0c\u5e76\u7ecf <code>capability-catalog-check.mjs</code> \u6821\u9a8c <code>capability-catalog.schema.json</code> \u76ee\u5f55\u7ed3\u6784\u5408\u540c \u7ed3\u6784\u53d8\u5316\u65f6\u624d\u6539 <code>architecture-routing.md</code> \u610f\u56fe \u2192 \u5c42/\u80fd\u529b/\u5165\u53e3/\u5916\u90e8\u9879\u76ee\u7684\u51b3\u7b56 \u8def\u7531\u88c1\u51b3\u53d8\u5316\u65f6\u6539 <code>README.md</code>\uff08\u672c\u6587\u4ef6\uff09 \u667a\u80fd\u4f53\u603b\u5165\u53e3\u4e0e\u9605\u8bfb\u987a\u5e8f \u5165\u53e3\u7ed3\u6784\u53d8\u5316\u65f6\u6539 <code>../reference/api/README.md</code> \u53ca\u4e09\u5305\u9875 \u516c\u5171 API \u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\uff0ccatalog \u80fd\u529b\u7684\u7b7e\u540d\u7ea7\u5c55\u5f00 \u771f\u5b9e\u5bfc\u51fa\u53d8\u5316\u65f6\u6539\uff0c\u5e76\u4e0e <code>capability-catalog-check.mjs</code> \u540c\u6b65 <p>capability catalog \u4e0d\u662f Contracts \u7684\u65b0\u516c\u5171\u5bf9\u8c61\uff0c\u4e5f\u4e0d\u662f\u7b2c\u56db\u7c7b\u767b\u8bb0\u8868\u3002\u5b83\u53ea\u662f\u6587\u6863\u5c42\u7684\u673a\u5668\u4e8b\u5b9e\uff0c\u907f\u514d README \u5f62\u6210\u7b2c\u4e8c\u5957\u4f1a\u6f02\u79fb\u7684\u624b\u5199\u6743\u5a01\u3002</p>"},{"location":"agents/#\u67b6\u6784\u8bbe\u8ba1\u5de5\u4f5c\u6cd5","title":"\u67b6\u6784\u8bbe\u8ba1\u5de5\u4f5c\u6cd5","text":"<p>\u667a\u80fd\u4f53\u5904\u7406\u4e00\u4e2a Foundation \u76f8\u5173\u9700\u6c42\u65f6\uff0c\u6309\u4e0b\u9762\u56db\u6b65\u63a8\u8fdb\uff1a</p> <ol> <li>\u5148\u5224\u5f52\u5c5e\u3002\u8be5\u9700\u6c42\u662f\u5426\u542b\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1 oracle\uff1f\u82e5\u662f\uff0c\u7559\u5728\u6d88\u8d39\u8005\uff0c\u53ea\u628a\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\u63a5 Foundation\u3002</li> <li>\u518d\u5224\u5206\u5c42\u3002\u7ed3\u6784/\u534f\u8bae/\u7a33\u5b9a\u9519\u8bef\u7801/\u5bf9\u8c61 Schema \u843d Contracts\uff1b\u8de8\u6280\u80fd\u65cf\u53ef\u590d\u7528\u7684 Node \u673a\u5236\u843d Harness\uff1bscaffold/adopt/projection/check \u6216\u5177\u4f53 Profile \u6ce8\u5165\u843d Kit/Profile\u3002</li> <li>\u67e5\u76ee\u5f55\u5b9a\u5165\u53e3\u3002\u5728 <code>capability-catalog.json</code> \u6309 <code>layer</code> \u4e0e <code>intent</code> \u627e\u5230\u80fd\u529b\uff0c\u8bfb\u5b83\u7684 <code>entrypoints</code>\u3001<code>sideEffects</code>\u3001<code>failureSemantics</code>\u3001<code>ownedByCaller</code>\u3001<code>routeElsewhere</code>\u3002</li> <li>\u9a8c\u8bc1\u636e\u518d\u4e0b\u7ed3\u8bba\u3002\u76ee\u5f55\u6bcf\u6761\u80fd\u529b\u90fd\u5e26 <code>sourceRefs</code> \u4e0e <code>positiveTestRefs</code>/<code>negativeTestRefs</code>\uff0c\u6539\u52a8\u5224\u65ad\u524d\u5148\u56de\u5230\u8fd9\u4e9b\u771f\u6e90\u786e\u8ba4\uff0c\u4e0d\u51ed\u76ee\u5f55\u6563\u6587\u63a8\u65ad\u3002</li> </ol> <p>\u8def\u7531\u8fb9\u754c\u7684\u786c\u89c4\u5219\uff1aFoundation \u4e0d\u62e5\u6709\u8fdc\u7aef\u5199\u5165\uff08\u5f52 release-skill\uff09\u3001\u4e0d\u62e5\u6709\u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5\uff08\u5f52 loop-agent\uff09\u3001\u4e0d\u62e5\u6709\u5236\u54c1\u5173\u7cfb\u4e0e context\uff08\u5f52 artifact-graph\uff09\u3001\u4e0d\u62e5\u6709\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\uff08\u5f52\u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\uff09\u3002\u8be6\u60c5\u89c1 <code>architecture-routing.md</code> \u7684\u8def\u7531\u8868\u3002</p>"},{"location":"agents/#\u4e0e\u673a\u68b0\u95e8\u7981\u7684\u5173\u7cfb","title":"\u4e0e\u673a\u68b0\u95e8\u7981\u7684\u5173\u7cfb","text":"<p>\u4e24\u4e2a\u68c0\u67e5\u811a\u672c\u5b88\u62a4\u76ee\u5f55\u4e0e README \u4e0d\u6f02\u79fb\uff1a</p> <ul> <li><code>scripts/docs/capability-catalog-check.mjs</code> \u6821\u9a8c\u7ed3\u6784\u3001\u552f\u4e00 ID\u3001\u6e90/\u6d4b\u8bd5\u5f15\u7528\u5b58\u5728\u3001unsupported \u8fb9\u754c\u3001Kit \u56db\u547d\u4ee4\u672a\u6269\u5f20\u3002</li> <li><code>scripts/docs/agent-section-check.mjs</code> \u6821\u9a8c\u6839 README \u4e0e\u4e09\u4e2a\u5305 README \u7684\u56fa\u5b9a Agent Quick Reference \u7ae0\u8282\u3001\u5fc5\u542b\u5b50\u6807\u9898\u4e0e\u80fd\u529b ID \u94fe\u63a5\u3002</li> </ul> <p>\u4e8c\u8005\u90fd\u53ea\u62a5\u5f62\u72b6\u4e0d\u81ea\u52a8\u6539\u6587\uff1b\u8b66\u544a\u9879\u9700\u56de\u5230\u771f\u6e90\u4e0e\u58f0\u97f3\u4eba\u5de5\u5224\u65ad\u3002</p>"},{"location":"agents/architecture-routing/","title":"\u4e2d\u6587 \u00b7 \u67b6\u6784\u8def\u7531","text":"<p>English</p>"},{"location":"agents/architecture-routing/#\u67b6\u6784\u8def\u7531\u4ece\u610f\u56fe\u5230\u5c42\u80fd\u529b\u4e0e\u5916\u90e8\u9879\u76ee","title":"\u67b6\u6784\u8def\u7531\uff1a\u4ece\u610f\u56fe\u5230\u5c42\u3001\u80fd\u529b\u4e0e\u5916\u90e8\u9879\u76ee","text":"<p>\u672c\u9875\u628a\u300c\u4e00\u4e2a\u67b6\u6784\u9700\u6c42\u8be5\u843d\u5728\u54ea\u91cc\u300d\u6536\u655b\u6210\u53ef\u673a\u68b0\u590d\u7528\u7684\u51b3\u7b56\u987a\u5e8f\u4e0e\u8def\u7531\u8868\u3002\u5b83\u670d\u52a1\u4e8e\u65b0\u667a\u80fd\u4f53\u5728\u4e0d\u901a\u8bfb\u6e90\u7801\u7684\u524d\u63d0\u4e0b\uff0c\u5feb\u901f\u5f97\u5230\u53ef\u9a8c\u8bc1\u7b54\u6848\uff1a\u8be5\u9700\u6c42\u662f\u5426\u5c5e\u4e8e Foundation\u3001\u5e94\u843d\u5728 Contracts/Harness/Kit/Profile \u54ea\u4e00\u5c42\u3001\u7528\u54ea\u4e2a\u7a33\u5b9a\u5165\u53e3\u3001\u4ec0\u4e48\u8bed\u4e49\u4ecd\u7531\u8c03\u7528\u65b9\u62e5\u6709\u3001\u4f55\u65f6\u5e94\u8f6c\u4ea4\u5916\u90e8\u9879\u76ee\u3002</p>"},{"location":"agents/architecture-routing/#\u51b3\u7b56\u987a\u5e8f","title":"\u51b3\u7b56\u987a\u5e8f","text":"<p>\u6309\u7f16\u53f7\u4f9d\u6b21\u5224\u65ad\uff0c\u547d\u4e2d\u5373\u505c\uff1a</p> <ol> <li>\u662f\u5426\u542b\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1 oracle\uff1f \u82e5\u662f\uff0c\u7559\u5728\u6d88\u8d39\u8005\uff1bFoundation \u53ea\u63a5\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\u3002</li> <li>\u662f\u5426\u662f\u7ed3\u6784\u3001\u534f\u8bae\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u6216\u5bf9\u8c61 Schema\uff1f \u843d Contracts\uff08\u5951\u7ea6\u6743\u5a01\uff09\u3002</li> <li>\u662f\u5426\u662f\u8de8\u6280\u80fd\u65cf\u53ef\u590d\u7528\u7684 Node \u673a\u5236\uff1f \u843d Harness\uff08Contracts \u673a\u5236\u534f\u8bae\u7684 Node \u5b9e\u73b0\uff09\u3002</li> <li>\u662f\u5426\u662f\u5de5\u7a0b\u9636\u6bb5\u7684 scaffold/adopt-plan/projection/check\uff0c\u6216\u5177\u4f53 host Profile \u6ce8\u5165\uff1f \u843d Kit / Profile\u3002</li> <li>\u662f\u5426\u6d89\u53ca\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001\uff1f \u8f6c release-skill\u3002</li> <li>\u662f\u5426\u6d89\u53ca\u4efb\u52a1\u3001\u91cd\u8bd5\u3001\u8fd4\u5de5\u3001\u9a8c\u6536\u6216\u81ea\u8fed\u4ee3\uff1f \u8f6c loop-agent\u3002</li> <li>\u662f\u5426\u6d89\u53ca\u5236\u54c1\u5173\u7cfb\u3001context\u3001packet \u6216 version-lock\uff1f \u8f6c artifact-graph\u3002</li> <li>\u662f\u5426\u53ea\u6709\u4e00\u4e2a\u6d88\u8d39\u8005\uff0c\u6216\u5c1a\u672a\u8bc1\u660e\u8de8\u4e24\u4e2a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\uff1f \u9ed8\u8ba4\u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u6269\u5f20 Foundation\u3002</li> </ol> <p>\u7b2c 8 \u6b65\u662f\u6269\u5f20\u95f8\u95e8\u3002\u4efb\u4f55\u65b0\u589e\u7ec4\u4ef6\u90fd\u5fc5\u987b\u8bf4\u660e\uff1a\u5220\u9664\u5b83\u4f1a\u8ba9\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\uff0c\u5e76\u7ecf\u72ec\u7acb fixture \u9a8c\u8bc1\u3002\u5426\u5219\u7559\u5728\u6d88\u8d39\u8005\u4fa7\u3002</p>"},{"location":"agents/architecture-routing/#\u8def\u7531\u8868","title":"\u8def\u7531\u8868","text":"<p>\u4e0b\u8868\u7ed9\u51fa\u5e38\u89c1\u67b6\u6784\u610f\u56fe\u7684\u9996\u9009\u80fd\u529b\u4e0e\u7981\u6b62\u8bef\u7528\u3002\u6bcf\u6761\u9996\u9009\u80fd\u529b\u90fd\u53ef\u5728 <code>capability-catalog.json</code> \u6309 id \u67e5\u5230\u5165\u53e3\u3001\u526f\u4f5c\u7528\u4e0e\u5931\u8d25\u8bed\u4e49\u3002</p> \u67b6\u6784\u610f\u56fe \u9996\u9009\u80fd\u529b \u7981\u6b62\u8bef\u7528 \u9a8c\u8bc1 Foundation \u5408\u540c\u5bf9\u8c61 Contracts / Harness validation\uff08<code>foundation.contracts.object-validation</code>\u3001<code>foundation.harness.contract-validation</code>\uff09 \u4e0d\u53d6\u4ee3\u6d88\u8d39\u8005\u4e1a\u52a1 Schema \u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u548c\u539f\u5b50\u5199 Harness path / atomic API\uff08<code>foundation.harness.path-containment</code>\u3001<code>foundation.harness.atomic-write</code>\uff09 \u4e0d\u628a\u6587\u4ef6\u9009\u62e9\u4e1a\u52a1\u89c4\u5219\u653e\u5165 Harness \u751f\u6210\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a Harness report \u6216 Kit report \u5b50\u52a8\u4f5c\uff08<code>foundation.harness.report</code>\u3001<code>foundation.kit.report</code>\uff09 \u4e0d\u4ece\u5f00\u653e\u4e1a\u52a1 outputs \u81ea\u7531\u7f16\u62a5\u544a \u6301\u4e45\u4e8b\u4ef6\u548c\u6d3e\u751f snapshot Harness state-store\uff08<code>foundation.harness.state-store</code>\uff09 \u4e0d\u5728 Foundation \u5b9a\u4e49 workflow \u72b6\u6001\u673a \u65b0\u9879\u76ee\u9aa8\u67b6 Kit scaffold\uff08<code>foundation.kit.scaffold</code>\uff09 \u4e0d\u8986\u76d6\u975e\u7a7a\u5b58\u91cf\u4ed3 \u5b58\u91cf\u91c7\u7528\u76d8\u70b9 Kit adopt-plan\uff08<code>foundation.kit.adopt-plan</code>\uff09 \u4e0d\u5199\u6587\u4ef6\u3001\u4e0d\u81ea\u52a8\u8fc1\u79fb \u53d7\u7ba1\u6295\u5f71 Kit projection + Profile\uff08<code>foundation.kit.projection</code>\uff09 \u4e0d\u8986\u76d6 handwritten \u6587\u4ef6 \u5de5\u7a0b\u8bca\u65ad Kit check\uff08<code>foundation.kit.check</code>\uff09 \u4e0d\u81ea\u52a8\u4fee\u590d \u53d1\u5e03 release-skill Foundation \u4e0d\u62e5\u6709\u8fdc\u7aef\u5199\u5165 \u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5 loop-agent Foundation \u4e0d\u62e5\u6709\u4e1a\u52a1\u72b6\u6001\u673a \u5236\u54c1\u5173\u7cfb/\u7248\u672c\u9501 artifact-graph Foundation \u4e0d\u62e5\u6709\u5236\u54c1\u56fe"},{"location":"agents/architecture-routing/#\u5206\u5c42\u5b9a\u4f4d\u901f\u67e5","title":"\u5206\u5c42\u5b9a\u4f4d\u901f\u67e5","text":"<p>\u4f9d\u8d56\u65b9\u5411\u56fa\u5b9a\u4e3a Contracts \u2192 Harness \u2192 Engineering Kit\uff1bProfile \u6a2a\u5411\u58f0\u660e\uff0c\u516c\u5171\u6838\u5fc3\u4e0d\u53cd\u5411\u4f9d\u8d56\u5177\u4f53 Profile\u3002</p> <ul> <li>Contracts\uff1a\u7ed3\u6784\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001\u534f\u8bae\u540d\u767b\u8bb0\uff1b18 \u7c7b\u9876\u5c42\u5bf9\u8c61\u30019 \u6761 mandatory rule\u3002</li> <li>Harness\uff1aContracts \u7684 Node \u8584\u673a\u5236\u8fd0\u884c\u65f6\uff1b\u53ea\u5b9e\u73b0\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\uff0c\u4e0d\u62e5\u6709\u8bed\u4e49\u3002</li> <li>Engineering Kit\uff1a\u56db\u4e2a\u5de5\u7a0b\u547d\u4ee4\uff08scaffold\u3001adopt-plan\u3001projection\u3001check\uff09\u53ca\u5176\u53ea\u8bfb/\u53d7\u9650\u5199\u5165\u8fb9\u754c\u3002</li> <li>Profile\uff1a\u5bbf\u4e3b\u4e0e\u9879\u76ee\u5f62\u6001\u5dee\u5f02\u7684\u58f0\u660e\u5f0f SPI\uff1b\u53ea\u5b9e\u73b0\u7a33\u5b9a SPI\uff0c\u4e0d\u6ce8\u5165\u4e1a\u52a1\u8bed\u4e49\u3002</li> <li>\u5916\u90e8\u9879\u76ee\uff1arelease-skill\uff08\u53d1\u5e03\uff09\u3001loop-agent\uff08\u4efb\u52a1\u751f\u547d\u5468\u671f\uff09\u3001artifact-graph\uff08\u5236\u54c1\u5173\u7cfb\uff09\u3001\u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\uff08\u9886\u57df\u8bed\u4e49\uff09\u3002</li> </ul>"},{"location":"agents/architecture-routing/#\u5178\u578b\u8bef\u8def\u7531\u4e0e\u7ea0\u6b63","title":"\u5178\u578b\u8bef\u8def\u7531\u4e0e\u7ea0\u6b63","text":"<ul> <li>\u8bef\u628a\u9886\u57df Schema \u8def\u7531\u5230 Foundation\uff1a\u9886\u57df Schema \u7531\u6d88\u8d39\u8005\u62e5\u6709\uff0cFoundation \u53ea\u63d0\u4f9b\u901a\u7528\u6821\u9a8c\u673a\u5236\uff08<code>foundation.contracts.object-validation</code>\uff09\u3002</li> <li>\u8bef\u628a workflow \u72b6\u6001\u673a\u8def\u7531\u5230 Foundation\uff1astate-store \u53ea\u63d0\u4f9b\u4e8b\u4ef6\u65e5\u5fd7\u4e0e\u5feb\u7167\u5e95\u5ea7\uff0creducer \u8f6c\u79fb\u4e0e\u7ec8\u6001\u7531\u8c03\u7528\u65b9\u62e5\u6709\uff08<code>foundation.unsupported.business-state-machine</code>\uff09\u3002</li> <li>\u8bef\u628a\u53d1\u5e03\u5199\u5165\u8def\u7531\u5230 Foundation\uff1a\u8fdc\u7aef\u5199\u5165\u5f52 release-skill\uff0cFoundation \u4e0d\u542b\u4efb\u4f55 publish/remote-write \u5165\u53e3\uff08<code>foundation.unsupported.remote-publish</code>\uff09\u3002</li> <li>\u8bef\u628a\u5ba1\u8ba1 oracle \u8def\u7531\u5230 Foundation\uff1a\u5ba1\u8ba1\u8868\u9762\u53ea\u505a\u786e\u5b9a\u6027\u5e8f\u5217\u5316\uff0c\u9886\u57df\u7ed3\u8bba\u5c5e\u5916\u90e8\u5ba1\u9605\uff08<code>foundation.unsupported.domain-audit-semantics</code>\uff09\u3002</li> </ul> <p>\u8def\u7531\u5224\u65ad\u7684\u8bda\u5b9e\u8fb9\u754c\uff1a\u7ed3\u6784\u68c0\u67e5\u53ea\u8bc1\u660e\u5b57\u8282/\u7ed3\u6784\u4e00\u81f4\u6027\uff08\u4ed3\u5185\u53ef\u8bc1\uff09\uff1b\u666e\u901a\u6b63\u6587\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\u7ed3\u8bba\u5c5e\u4e8e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff0c\u4e0d\u5728\u76ee\u6807\u4ed3\u5185\u7ef4\u62a4\u7b2c\u4e8c\u4efd\u95e8\u7981\u3002</p>"},{"location":"en/","title":"English \u00b7 Home","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/#Skill-Family-Foundation-Workspace","title":"Skill Family Foundation Workspace","text":"<p>The shared engineering-infrastructure parent workspace for the Skill Family lifecycle. This repository provides the machine contracts (Contracts), the thin Node runtime (Harness), the engineering kit (Engineering Kit), the Profile SPI, fully fictional generic sample fixtures, and the engineering documentation skeleton.</p>"},{"location":"en/#Current-Status","title":"Current Status","text":"<p>This repository is a first-version skeleton under development. Dynamic state such as versions, releases, Pages, and Git is recorded solely in Current Product Status; the license is approved as Apache License 2.0, with the copyright holder being \u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8 (Guangzhou Fenghe Technology Co., Ltd.). The full text is in the root-level <code>LICENSE</code>.</p> <p>This workspace is permanently private and is the single source of truth for development; the only public boundary consists of three versioned release mirrors and the npm tarball. The pinned consumer coordinates and release status are recorded solely in Current Product Status.</p> <p>The single product-level status page is Current Product Status, mechanically verified by <code>node scripts/docs/fact-check.mjs</code> against the machine source of truth; other pages do not carry a second status caliber.</p>"},{"location":"en/#First-Version-Composition","title":"First-Version Composition","text":"Component Path Responsibility Contracts <code>packages/skill-family-contracts</code> Sole authority for machine-executable engineering structure and mechanism protocols Harness <code>packages/skill-family-harness-node</code> Implements only the mechanism protocols defined by Contracts; owns no business semantics Engineering Kit <code>packages/skill-family-engineering-kit</code> Provides only the four top-level commands <code>scaffold</code>, <code>adopt-plan</code>, <code>projection</code>, <code>check</code> Profile seed <code>profiles/public-plugin</code> Profile seed in the form of a public plugin Fictional sample <code>fixtures/generic-profile-extension-conformance</code> A fully fictional extension-conformance sample <p>The package manifest, Profiles, fixtures, and top-level commands use <code>.foundation/skeleton-manifest.json</code> as the machine source of truth; tool version locks are in <code>.foundation/version-lock.json</code>.</p>"},{"location":"en/#Documentation-Map","title":"Documentation Map","text":"<ul> <li>Setup and Environment \u2014 tool version pinning, installation, and documentation site build</li> <li>Quickstart \u2014 the shortest path from local verification to a trial run</li> <li>Capabilities and Diagnostics \u2014 the Kit's four commands, exit codes, and troubleshooting</li> <li>Architecture Boundaries \u2014 layering, single source of truth, budget, and documentation fact-check</li> <li>Current Product Status \u2014 the single product status page</li> <li>Git Lifecycle Guide \u2014 authorized boundaries for branches, commits, pushes, and releases</li> </ul>"},{"location":"en/#Writing-Boundaries","title":"Writing Boundaries","text":"<p>Documentation consumes only a frozen fact package composed of the machine source of truth (manifest, package.json, Contracts registry, etc.), mechanically verified by <code>node scripts/docs/fact-check.mjs</code>. Model names, credentials, and scheduling information do not enter documentation, nor do they enter Contracts; see Architecture Boundaries.</p>"},{"location":"en/architecture/","title":"English \u00b7 Architecture","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/architecture/#Architecture-Boundaries","title":"Architecture Boundaries","text":"<p>This page is the stable architecture projection of Skill Family Foundation for users. It explains only structure, responsibilities, boundaries, and routing; it does not carry dynamic release state (release state is recorded solely in <code>docs/status/current.md</code> and mechanically verified by <code>scripts/docs/fact-check.mjs</code>). All versions, commands, package counts, and support states are recomputed from the machine source of truth.</p>"},{"location":"en/architecture/#Layers","title":"Layers","text":"<p>The layering established by the 2026-08-09 architecture hand-off (FND-ADR-001~007, active, see <code>artifacts/decisions/</code>): a vertical dependency chain of four layers, with horizontal capability attachments, and no new vertical layers added.</p> <pre><code>Skill Family business (per-product repositories: release-skill, loop-agent, skill-eval, etc.)\n \u2502 depends on\n \u25bc\nEngineering Kit (scaffold / adopt-plan / projection / check)\n \u2502 depends on\n \u25bc\nHarness Node (Contracts mechanism-protocol implementation)\n \u2502 depends on\n \u25bc\nContracts (structure, protocols, error codes, protocol-name registry)\n \u25b2\n \u2514---------------- independent Audit consumer\n\nHorizontal (attachment surfaces, no new vertical layers):\n- profiles/ declarations of host and project-shape differences; implements only the stable SPI\n- host external AI coding runtime environment: owns semantics; Foundation unifies structural differences\n- release-skill release state and all remote writes; does not enter Foundation\n- Artifact Graph the `artifacts/` architecture artifact system; its gate is check:artifacts\n</code></pre> <p>Arrows point to the depended-upon party. The public core must not depend in reverse on a concrete Profile or a concrete skill family; where a new capability's dependency direction lands is specified in <code>artifacts/design/FND-DES-001.md</code>, and asset-by-asset ownership is in FND-ADR-002.</p>"},{"location":"en/architecture/#Responsibility-Matrix","title":"Responsibility Matrix","text":"<p>Each layer assumes only the responsibilities listed below; out-of-scope capabilities are owned by external projects or consumers.</p> Layer Owns Does not own (lands elsewhere) Contracts Structure, protocols, error codes, protocol-name registry; 20 top-level object kinds; 9 mandatory rules Business-field semantics, domain auditing, remote writes, model generation Harness Node mechanism implementation of Contracts; path containment, atomic write, closures, request handling, report rendering, host-access mechanism, state substrate Business semantics, workflow orchestration, model invocation, git writes, network remotes Engineering Kit The four engineering commands and their read-only / restricted-write boundaries; host sub-action injection of concrete Profiles Auto-fix, auto-migration, remote release, a fifth command Profile Declarative SPI for host and project-shape differences; implements only the stable SPI Business semantics, executable-script entry points, public-core changes release-skill Release state and all remote writes Foundation contains no publish/remote-write entry point loop-agent Tasks, retries, rework, acceptance, self-iteration Foundation does not define a workflow state machine Artifact Graph Artifact relationships, context, packet, version-lock Foundation does not own the artifact graph Audit Independent fixtures, expected values, adjudication Domain-semantic conclusions are owned by external review"},{"location":"en/architecture/#Capability-Ownership-Algorithm","title":"Capability Ownership Algorithm","text":"<p>Given an architecture requirement, decide ownership in the following order, stopping at the first match:</p> <ol> <li>Contains domain semantics, a business state machine, or an audit oracle \u2192 keep it with the consumer; connect only business-neutral mechanisms.</li> <li>Is structure, a protocol, a stable error code, or an object Schema \u2192 Contracts.</li> <li>Is a Node mechanism reusable across skill families \u2192 Harness.</li> <li>Is scaffold/adopt-plan/projection/check or a concrete host Profile injection \u2192 Kit / Profile.</li> <li>Involves publishing remote state \u2192 release-skill.</li> <li>Involves tasks/retries/rework/acceptance \u2192 loop-agent.</li> <li>Involves artifact relationships / version-lock \u2192 artifact-graph.</li> <li>Has only one consumer, or has not been proven to repeat across two real consumers \u2192 keep it with the consumer; do not expand Foundation.</li> </ol> <p>Step 8 is the expansion gate: a new component must justify that deleting it would force two or more real consumers to re-implement it, and this must be verified by an independent fixture; admission gate 1 additionally requires at least one existing real consumer plus one structurally isomorphic foreseeable consumer (the second consumer need not be live, but its need must be expressible with the same structure; adjustment record in FND-ADR-009). Step 9 is the finite-closed-semantics gate (FND-ADR-001 gate 8): a capability carrying limited domain semantics must satisfy either \u2014 its semantics are covered by a small stable closed enumeration, or it is a deterministic estimation primitive whose algorithm, scope, and bias direction are declared in the contract; this gate does not cancel gate 2's \"semantics-free\" veto. The machine-readable version is in <code>docs/agents/architecture-routing.md</code>.</p>"},{"location":"en/architecture/#Trust-and-Side-Effect-Boundaries","title":"Trust and Side-Effect Boundaries","text":"<p>Foundation's trust assumptions and side-effect conventions are solidified per layer; callers judge risk accordingly:</p> <ul> <li>Contracts: pure functions, no file/Git/network/process side effects; error codes are frozen and do not drift (<code>foundation.contracts.error-codes</code>).</li> <li>Harness: the mechanism layer reads and writes only within contained paths; <code>HARNESS_EXCLUSIONS</code> excludes release-state, remote-network-access, business-semantics, workflow-orchestration, model-calls, git-writes (<code>foundation.harness.errors</code>).</li> <li>Engineering Kit: <code>FORBIDDEN_SIDE_EFFECTS</code> includes git-init/commit/push/tag, publish, remote-write; <code>REFUSED_MUTATION_FLAGS</code> are refused at the CLI entry point (<code>foundation.kit.cli</code>).</li> <li>Profile: declarative differences; the entry point must be a JSON data resource; <code>coreOwned</code> (packages/commands/namespacePrefixes) is a forbidden target (<code>foundation.profile.extension-spi</code>).</li> <li>State substrate: the event log is the sole authority, and the snapshot is a derived cache; <code>confirmOwnerTerminated</code> is an external trust anchor provided by the caller, and does not promise resistance against same-privilege malicious processes (<code>foundation.harness.state-store</code>).</li> </ul>"},{"location":"en/architecture/#Architecture-Decision-Tree","title":"Architecture Decision Tree","text":"<pre><code>Requirement contains domain semantics/state machine/audit? \u2500\u2500yes\u2500\u2500\u25b6 keep with consumer\n \u2502no\nIs it structure/protocol/error code/Schema? \u2500\u2500yes\u2500\u2500\u25b6 Contracts\n \u2502no\nIs it a Node mechanism across skill families? \u2500\u2500yes\u2500\u2500\u25b6 Harness\n \u2502no\nIs it scaffold/adopt/projection/check or Profile injection? \u2500\u2500yes\u2500\u2500\u25b6 Kit / Profile\n \u2502no\nInvolves publishing remote state? \u2500\u2500yes\u2500\u2500\u25b6 release-skill\n \u2502no\nInvolves tasks/retries/rework/acceptance? \u2500\u2500yes\u2500\u2500\u25b6 loop-agent\n \u2502no\nInvolves artifact relationships/version-lock? \u2500\u2500yes\u2500\u2500\u25b6 artifact-graph\n \u2502no\nOnly one consumer / not proven across two real consumers? \u2500\u2500yes\u2500\u2500\u25b6 keep with consumer, do not expand\n \u2502no\nCarries limited domain semantics? \u2500\u2500yes\u2500\u2500\u25b6 finite closed semantics: covered by a\n \u2502 stable closed enumeration, or a deterministic estimation\n \u2502 primitive (algorithm/scope/bias declared in the contract)\n \u2502 \u2192 admissible; otherwise keep with consumer\n \u2502 (FND-ADR-001 gate 8; does not cancel gate 2's veto)\n \u2502no\n \u2500\u2500\u25b6 admissible\n</code></pre>"},{"location":"en/architecture/#Routing-Relationships-with-External-Projects","title":"Routing Relationships with External Projects","text":"<p>Foundation is not an all-powerful base. The following responsibilities are explicitly outside Foundation:</p> <ul> <li>Release and remote writes: owned by release-skill; Foundation provides no publish/remote-write entry point (<code>foundation.unsupported.remote-publish</code>).</li> <li>Task lifecycle: owned by loop-agent (tasks, retries, rework, acceptance); Foundation contains no workflow state machine (<code>foundation.unsupported.business-state-machine</code>).</li> <li>Artifact governance: artifact-graph owns the <code>artifacts/</code> relationship contract and version-lock; its gate is <code>check:artifacts</code>.</li> <li>Domain auditing: an independent audit consumer owns the semantics and final accept/reject; Foundation provides only a deterministic audit surface (<code>foundation.unsupported.domain-audit-semantics</code>).</li> <li>Host apply and lifecycle: host apply is stably refused, install/update/uninstall are unimplemented, and the full Qoder driver is unsupported (<code>foundation.unsupported.host-apply</code>, <code>foundation.unsupported.host-install-update-uninstall</code>, <code>foundation.unsupported.qoder-driver</code>).</li> </ul>"},{"location":"en/architecture/#Next-Phase-Capability-Lines-Architecture-Hand-off","title":"Next-Phase Capability Lines (Architecture Hand-off)","text":"<p>All three capability lines were included via the FND-ADR-001 capability admission-gate adjudication and all land within the existing layers:</p> <ul> <li>Host-access line (FND-FR-001/FND-FR-002, FND-ADR-003): Contracts registers descriptor/source/manifest/probe/plan/receipt; Harness implements generic source closure, atomic build/materialize, and probe classification; Kit injects the concrete Profile and trusted driver. Currently only describe/build/probe/plan are supported; <code>apply</code> is stably refused; install/uninstall/update are unimplemented.</li> <li>Durable state-substrate line (FND-FR-003, FND-ADR-004): append-only events, hash chain, snapshots, and verification recovery; provides only the state substrate, not business semantics such as state machines, task nodes, retries, terminal states, or memory.</li> <li>Human-report line (FND-FR-004, FND-ADR-005): a two-layer contract \u2014 machine results are the sole source of truth, and the human report is deterministically rendered from machine results (Markdown + digest binding + graded checks), not freely authored.</li> <li>Finite-closed-semantics tools line (FND-ADR-009): baseline materialization + contentGuard (digest mismatch, mid-materialization change, and guard rejection all fail closed), generic read chokepoint (allowed-root set + optional identity predicate), strategy-driven surface scan (policy contract + injection self-test), token upper-bound estimation (deterministic estimation primitive with no model/network/tokenizer dependency), and a generic upper-bound guard (reusing the state-store event ledger and token-lock; the bound and over-limit policy are consumer-configured).</li> </ul> <p>The three-package structure is preserved and a fourth package is not split out (FND-ADR-007); artifact governance uses the artifact-graph CLI and version-lock (FND-ADR-006).</p>"},{"location":"en/architecture/#First-Version-Budget","title":"First-Version Budget","text":"<ul> <li>Top-level Contracts objects: 20 kinds (the complete list uses <code>packages/skill-family-contracts/src/registry.json</code> as the sole source of truth): project-manifest, profile-descriptor, managed-file-lock, operation-request, operation-result, migration-manifest, adapter-source, report-model, report-binding, host-descriptor, host-registry, host-capability-fact, host-probe-result, adapter-build-manifest, host-operation-plan, host-operation-receipt, state-event-envelope, state-snapshot-metadata, token-estimate-result, surface-scan-policy;</li> <li>Kit top-level commands: 4 (scaffold, adopt-plan, projection, check);</li> <li>Mandatory mechanical rules: currently 9, budget not exceeding 20, absolute ceiling 30; CR-001 uniformly compiles all Schemas within the registry;</li> <li>Leaf packages: 3 (skill-family-contracts, skill-family-harness-node, skill-family-engineering-kit);</li> <li>Schema validator: Ajv 8.20.0 (exact version pin), supporting both draft-07 and 2020-12 dialects;</li> <li>kernel protocol: skill-family.kernel.operation (stable), Contracts version 1.4.0;</li> <li>Default runtime language: Node; first-version implementations in a second language: 0.</li> </ul> <p>Any new component must justify the two-or-more real-consumer re-implementation that deleting it would cause, and be verified by an independent fixture.</p>"},{"location":"en/architecture/#Machine-Source-of-Truth-and-File-Classification","title":"Machine Source of Truth and File Classification","text":"Source of truth Content <code>.foundation/skeleton-manifest.json</code> Package manifest, Profiles, fixtures, top-level commands <code>.foundation/version-lock.json</code> Exact versions and lock points for projen, pnpm, Node <code>.foundation/file-registry.json</code> Registration of managed / handwritten / artifact file classes <code>package.json</code> and <code>packages//package.json</code> Versions, commands, dependencies (all projen-managed) <code>packages/skill-family-contracts/src/registry.json</code> Protocol-name and Schema $id registry <code>scripts/release-artifact-contract.json</code> Fixed three-package release byte contract (members, required items, and content-digest rules) <p>Managed files can only be modified via <code>.projenrc.js</code> and regenerated by running <code>pnpm synth</code>; handwritten files (including all documentation) are not overwritten by synth. The authoritative classification is in <code>.foundation/file-registry.json</code>.</p>"},{"location":"en/architecture/#Documentation-System-and-Fact-Check","title":"Documentation System and Fact-Check","text":"<p>The documentation system aims to eliminate manual drift through deterministic checks:</p> <ol> <li>Frozen fact package: documentation writing consumes only the machine sources of truth listed in the table above. Models or authors must not write versions, commands, or package counts from memory; model names, credentials, and scheduling information do not enter documentation, nor do they enter Contracts.</li> <li>Fact-check: <code>node scripts/docs/fact-check.mjs</code> verifies package names, commands, gate facts, version pins, and key numbers in the documentation against the source of truth, and cross-checks consistency across sources (manifest vs package.json, version-lock vs packageManager, rule count vs budget, etc.).</li> <li>Link-check: <code>node scripts/docs/link-check.mjs</code> resolves in-repo relative links and heading anchors across the README and all <code>docs/*/.md</code>, and verifies that <code>mkdocs.yml</code> nav is complete.</li> <li>No-workflow boundary and public-boundary verification: this repository has no CI/CD workflow at all (the old topology's three Actions \u2014 ci/docs/docs-deploy \u2014 have been entirely deleted); all gates run within the private workspace (<code>pnpm check</code>); the public boundary is mechanically verified by <code>check:public-snapshots</code> and the release byte contract. The public static site is rendered by <code>scripts/render-public-site.mjs</code> (with the sole output <code>docs/public/site/*</code> and the deterministic baseline <code>docs/public/site-baseline.json</code>).</li> <li>Version lock: the site toolchain is locked in <code>scripts/docs/toolchain.json</code> and <code>scripts/docs/requirements.txt</code>; the build uses only an out-of-repo Python virtual environment, with no system-level pip install.</li> </ol> <p>Both check scripts can be run directly via <code>node scripts/docs/<name>.mjs</code>: <code>fact-check.mjs</code> consumes the root-pinned <code>semver@7.8.5</code> via in-repo modules and requires <code>pnpm install --frozen-lockfile</code> to be completed first; <code>link-check.mjs</code> is a pure Node implementation. See <code>scripts/docs/README.md</code> for responsibilities.</p>"},{"location":"en/architecture/#Stable-Product-Gates","title":"Stable Product Gates","text":"<p>The root <code>pnpm check</code> orchestrates only the 11 stable product gate IDs (<code>check:structure</code>~<code>check:artifacts</code>, each ID listed in Current Product Status), and no longer hard-pins the original command list; each stable ID composes a few product checks within its own package script. Gate facts are mechanically derived by <code>node scripts/docs/fact-check.mjs</code> from the root <code>package.json</code>'s <code>scripts.check</code> and verified verbatim. Documentation and setup invoke or list only the 11 stable IDs or the root <code>pnpm check</code>, and do not duplicate the underlying command list.</p> <p>The honest boundary of in-repo checks: structural checks only prove \"byte/structural consistency (provable in-repo)\"; one-time migration completeness, ordinary prose semantics, and the final accept/reject conclusion belong to the responsibility of external review; no second gate registry, baseline, or command comparator is maintained within the target repository.</p>"},{"location":"en/examples-and-fixtures/","title":"English \u00b7 Examples and fixtures","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/examples-and-fixtures/#Examples-and-Fixtures","title":"Examples and Fixtures","text":"<p>Foundation fixtures prove structural contracts and mechanism boundaries. They do not serve as an oracle for business correctness.</p>"},{"location":"en/examples-and-fixtures/#Fixture-Classes","title":"Fixture Classes","text":"<ul> <li>Positive fixtures provide valid input and must pass the declared contract or mechanism.</li> <li>Negative fixtures provide invalid input and must produce the stable failure code required by the contract.</li> <li>Dialect-boundary fixtures freeze expected behavior where draft-07 and 2020-12 JSON Schema handling differs.</li> </ul> <p>All published fixtures use fictional data. They must not contain a private Profile, real business data, credentials, user-specific paths, or consumer evidence.</p>"},{"location":"en/examples-and-fixtures/#Verification-Entry-Points","title":"Verification Entry Points","text":"Scope Verification entry point What it proves Contracts fixtures <code>packages/skill-family-contracts/test/fixtures.test.mjs</code> Registered fixture inputs and expected structural results still match; mismatch uses <code>SFC1010</code> Profile SPI conformance <code>fixtures/generic-profile-extension-conformance/verify.mjs</code> and <code>leak-scan.mjs</code> A fictional extension follows the stable SPI and public-data boundary Scaffold contract <code>fixtures/scaffold-conformance/verify.mjs</code> Generated skeleton bytes match the frozen contract Adoption hazards <code>fixtures/adoption/cases/</code> <code>adopt-plan</code> preserves its read-only boundary through before/after byte snapshots <p>These entry points are read-only or self-contained. They do not write a caller repository or access a remote service.</p>"},{"location":"en/examples-and-fixtures/#Oracle-Boundary","title":"Oracle Boundary","text":"<p>A fixture can prove that a contract was satisfied. It cannot prove that a business decision was correct. Domain state transitions, business acceptance, and audit conclusions remain with the consumer or an independent reviewer.</p> <p>The audit surface illustrates this boundary: Foundation can produce canonical JSON and a SHA-256 digest, while the caller still owns the meaning of the evidence and the final accept/reject decision.</p>"},{"location":"en/examples-and-fixtures/#Published-Example-Scope","title":"Published Example Scope","text":"<p>The public example surface includes the fictional <code>profiles/public-plugin</code> Profile and the generic conformance, scaffold, licensing, adoption, and minimal-consumer fixtures listed by the workspace manifest. Any private consumer fixture or real operational evidence remains outside the public release boundary.</p> <p>For capability selection, start with the agent documentation entry. For the exact machine facts behind an example, inspect the core capability catalog and its English overlay.</p>"},{"location":"en/help/","title":"English \u00b7 Capabilities and diagnostics","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/help/#Help-and-Triage","title":"Help and Triage","text":"<p>This page provides triage paths by error code, process exit code, and symptom. Foundation's error-code system is frozen in Contracts (<code>src/error-codes.json</code>) and does not drift; mechanism failures are unified as <code>SFC2004</code> with a stable <code>details.kind</code>.</p>"},{"location":"en/help/#Triage-by-Stable-Error-Code","title":"Triage by Stable Error Code","text":"Error code Name Meaning Handling SFC1001 SCHEMA_VALIDATION_FAILED Document failed target Schema validation Check the document's required fields and type constraints SFC1002 UNKNOWN_SCHEMA_ID <code>$id</code> is not registered in the registry Confirm the <code>$id</code> spelling and Contracts version SFC1003 DUPLICATE_SCHEMA_ID Duplicate <code>$id</code> registration refused Do not re-register; reuse the existing registration SFC1004 DUPLICATE_PROTOCOL_NAME Duplicate protocol name/version refused Do not re-register a protocol SFC1005 UNRESOLVED_REF <code>$ref</code> target cannot be resolved Check the <code>$ref</code> target SFC1006 UNSUPPORTED_DIALECT Dialect is not in the supported set Use only draft-07 / 2020-12 SFC1007 UNKNOWN_CHECK_TYPE Rule uses a check type outside the nine classes Do not define custom check types SFC1008 RULE_BUDGET_EXCEEDED Mandatory rule exceeded budget/ceiling Do not exceed 20 (absolute 30) SFC1009 UNKNOWN_ERROR_CODE Referenced an unregistered error code Reference only the frozen registry SFC1010 FIXTURE_EXPECTATION_MISMATCH Fixture behavior does not match expectation Check the fixture declaration SFC1011 UNKNOWN_PROTOCOL Referenced an unregistered protocol Confirm protocol name/version SFC1012 SCHEMA_COMPILE_FAILED The Schema itself cannot be compiled Check Schema syntax SFC2002 UNKNOWN_OPERATION Operation name is not in the frozen vocabulary Use only <code>validate</code> SFC2003 INVALID_PARAMS Parameters do not satisfy the params contract Check parameters SFC2004 EXECUTION_FAILED Mechanism execution failed See <code>details.kind</code> for the sub-classification SFC3001 REPORT_DIGEST_MISMATCH Report/result digest is inconsistent with the binding Recompute model/result SFC3002 REPORT_ELEMENT_MISSING Report is missing a mandatory element Complete the report fields SFC3003 REPORT_FACT_DRIFT Report bytes deviated from deterministic re-render Re-render from machine results"},{"location":"en/help/#Triage-by-Process-Exit-Code-Engineering-Kit","title":"Triage by Process Exit Code (Engineering Kit)","text":"Exit code Meaning Handling 0 Success / no findings No handling needed 1 <code>check</code> found findings Address the findings; Kit does not auto-fix 2 Refused / usage / mechanism error Check command name, parameters, and refused flags such as <code>--fix</code>"},{"location":"en/help/#Triage-by-Symptom","title":"Triage by Symptom","text":"<ul> <li>Validation keeps reporting SFC1002: <code>$id</code> is unregistered; first confirm the Contracts version and <code>$id</code> namespace.</li> <li>Path operation reports SFC2004 + <code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>: the path escaped the contained root; confirm the root-directory boundary, and do not cram business-selection rules into Foundation.</li> <li>Atomic write reports SFC2004 + <code>atomic-write-failed</code>: the target is out of bounds or the content type is illegal; check path containment and content type.</li> <li>State storage reports <code>store-locked</code>: an old writer may still hold the lock; confirm outside Foundation that the old writer has terminated, then call <code>recoverStateStoreLock</code> with the exact owner/fencing.</li> <li>host apply fails immediately: <code>apply</code> is stably refused in the read-only Phase D slice; install/update/uninstall are unimplemented; the full Qoder driver is unsupported.</li> <li>Document versions/commands do not match the source of truth: rely on the recomputation result of <code>scripts/docs/fact-check.mjs</code>; do not revise from memory.</li> </ul>"},{"location":"en/help/#Project-Routing","title":"Project Routing","text":"<ul> <li>Publishing remote state / npm publish \u2192 release-skill.</li> <li>Tasks / retries / rework / acceptance \u2192 loop-agent.</li> <li>Artifact relationships / version-lock \u2192 artifact-graph.</li> <li>Domain-audit semantics \u2192 independent audit consumer.</li> <li>General structure / mechanism issues \u2192 this repository's <code>docs/architecture.md</code> and <code>docs/agents/</code>.</li> </ul>"},{"location":"en/help/#Command-Quick-Reference-and-Authoritative-Facts","title":"Command Quick Reference and Authoritative Facts","text":"<p>The Engineering Kit has only four top-level commands: <code>scaffold</code>, <code>adopt-plan</code>, <code>projection</code>, <code>check</code>. Of these, <code>check</code> only diagnoses and does not fix; the caller handles the findings.</p> <ul> <li>Current product status (versions, package set, mirror coordinates, gates): Current Product Status (the single status page).</li> <li>Development and commit specifications: Git Lifecycle Guide.</li> </ul>"},{"location":"en/licensing/","title":"English \u00b7 Licensing","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/licensing/#Licensing-and-identity","title":"Licensing and identity","text":"<p>This page explains how Skill Family Foundation adopts its license, the distinction between identity roles, and the current status of NOTICE and third-party attribution. It is not an official translation of the Apache License 2.0; the legal text of Apache-2.0 is the root-level <code>LICENSE</code>, and in case of any ambiguity the English original prevails.</p>"},{"location":"en/licensing/#License","title":"License","text":"<ul> <li>License: <code>Apache-2.0</code> (the SPDX identifier is unchanged).</li> <li>Legal text: the root-level <code>LICENSE</code> is the full Apache License 2.0 text (authoritative in English). This page and any Chinese material only explain how the license is adopted; they do not replace or restate the legal text and do not claim equal legal effect.</li> <li>The three leaf packages distribute a copy of the root <code>LICENSE</code> with the package.</li> </ul>"},{"location":"en/licensing/#Distinction-between-identity-roles","title":"Distinction between identity roles","text":"<p>The following four identities are independent; none may be inferred from or merged with another:</p> Role Value Notes Author / copyright holder Guangzhou Fenghe Technology Co., Ltd. (\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8) The copyright owner; written into <code>package.json</code>'s <code>author</code> and the <code>LICENSE</code> appendix attribution Repository owner (GitHub owner) <code>ifoohoo</code> The GitHub organization/account; no inference relationship with the author npm publisher The account in the current publish configuration The npm publish identity; no inference relationship with author/owner Contributor copyright line The contributors attribution in the root <code>LICENSE</code> appendix A retained historical/contributor attribution, not the project author or copyright holder <p><code>author</code>, <code>repository.owner</code>, and <code>npm publisher</code> are recorded separately; none may be derived from another.</p>"},{"location":"en/licensing/#Project-level-NOTICE","title":"Project-level NOTICE","text":"<p>FND-ADR-008 adopts Option B following the user's explicit ruling on 2026-08-10. Foundation now maintains a root <code>NOTICE</code> containing the project name, the year 2026, and the copyright holder, \u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8 (Guangzhou Fenghe Technology Co., Ltd.). Starting with 0.2.1, the three public-unit mirrors, frozen snapshots, and npm tarballs must all distribute that file.</p> <p>The <code>open-source</code> Profile continues to declare <code>noticeRequired: true</code>. Engineering Kit continues to enforce the invariant between Apache-2.0 and the NOTICE requirement, and <code>checkIdentityDrift</code> continues to report <code>notice-missing</code> when the file is absent. This closure changes only Foundation's publish members; it does not alter the Kit's behavior for other consumers.</p> <p>Under Section 4(d) of the Apache License 2.0 in the root <code>LICENSE</code>, NOTICE content is informational and attributional; it does not modify the terms of the Apache License 2.0.</p>"},{"location":"en/licensing/#Third-party-attribution-THIRD_PARTY_NOTICES","title":"Third-party attribution (THIRD_PARTY_NOTICES)","text":"<p>The Engineering Kit public unit distributes MkDocs Material, lunr, and lunr-languages assets and already includes <code>packages/skill-family-engineering-kit/THIRD_PARTY_NOTICES</code> with the corresponding third-party license material. Third-party attribution remains covered by <code>THIRD_PARTY_NOTICES</code> and the corresponding license closure; the project-level <code>NOTICE</code> must not replace them. The <code>NOTICE</code> carries only Foundation's own project attribution and does not copy full third-party license texts.</p>"},{"location":"en/licensing/#License-boundary-between-the-private-workspace-and-public-mirrors","title":"License boundary between the private workspace and public mirrors","text":"<ul> <li>This workspace is permanently private and is the single source of development truth; the workspace itself never enters the public boundary.</li> <li>The public boundary consists only of three versioned publish mirrors and npm tarballs; they distribute the root <code>LICENSE</code> (Apache-2.0) and <code>NOTICE</code>. Engineering Kit additionally distributes <code>THIRD_PARTY_NOTICES</code> and the corresponding third-party license material.</li> <li>Profiles, fixtures, internal docs, and run evidence inside the private workspace do not enter the public packages; public docs only consume artifacts mechanically verified by the allowlist and release contract.</li> <li>Publish state and all remote writes belong to release-skill; this page does not duplicate live publish state.</li> </ul>"},{"location":"en/quickstart/","title":"English \u00b7 Quickstart","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/quickstart/#Quickstart","title":"Quickstart","text":"<p>This page gives each of three reader types a shortest path to success: new projects, existing projects, and architecture designers. Each path lists only the required actions and verification commands; follow the corresponding documentation for deeper detail.</p>"},{"location":"en/quickstart/#New-Project-Generate-a-Skeleton","title":"New Project: Generate a Skeleton","text":"<p>The goal is to obtain a Foundation-compliant project skeleton from scratch.</p> <pre><code>npm install --save-dev skill-family-engineering-kit\nnpm exec -- skill-family-kit scaffold --root ./my-project --project-id my-project\nnpm exec -- skill-family-kit check --root ./my-project\n</code></pre> <p>The commands above first generate a skeleton, then run engineering diagnostics on the generated result. <code>scaffold</code> writes only to an empty target directory; a non-empty or conflicting target is refused and not touched; <code>check</code> diagnoses only, it does not fix. Verification passes when <code>check</code> exits with code 0.</p>"},{"location":"en/quickstart/#Existing-Project-Read-Only-Inventory","title":"Existing Project: Read-Only Inventory","text":"<p>The goal is to first see whether the existing repository can be adopted, without changing any bytes.</p> <pre><code>npm exec -- skill-family-kit adopt-plan --root ./existing-repo\nnpm exec -- skill-family-kit check --root ./existing-repo\n</code></pre> <p><code>adopt-plan</code> outputs the current state, target Profile, exact write set, conflicts, and the legacy-implementation exit list, with zero change to the input repository's bytes. <code>check</code> performs read-only diagnostics only. Decide whether to perform a write after confirming the inventory results.</p>"},{"location":"en/quickstart/#Architecture-Designer-Decide-Ownership","title":"Architecture Designer: Decide Ownership","text":"<p>The goal is to determine which Foundation layer an architecture requirement should land in, or whether it should stay with the consumer.</p> <ol> <li>Read the eight-step decision order in <code>docs/agents/architecture-routing.md</code>.</li> <li>In <code>docs/agents/capability-catalog.json</code>, find the capability by <code>layer</code> and <code>intent</code>, and read its <code>entrypoints</code>, <code>sideEffects</code>, <code>failureSemantics</code>, <code>ownedByCaller</code>.</li> <li>When publishing, task lifecycle, or artifact relationships are involved, route to release-skill, loop-agent, and artifact-graph respectively.</li> </ol> <p>The hard boundary of routing: Foundation does not own remote writes, business state machines, model orchestration, or domain-audit semantics. Capabilities that fall into <code>keep-business</code> or <code>foundation-gap</code> do not forcibly expand Foundation.</p>"},{"location":"en/quickstart/#Authoritative-Facts-and-Specifications","title":"Authoritative Facts and Specifications","text":"<ul> <li>Current product status (versions, package set, mirror coordinates, gates): Current Product Status (the single status page; not duplicated here).</li> <li>Development and commit specifications: Git Lifecycle Guide.</li> </ul>"},{"location":"en/quickstart/#Path-Reference","title":"Path Reference","text":"Reader Starting point Next step New project <code>scaffold</code> <code>check</code> \u2192 integrate Profile Existing project <code>adopt-plan</code> classify (direct-adoption / compatibility-layer / keep-business / foundation-gap) \u2192 adopt Architecture designer routing decision capability catalog \u2192 real exports and tests"},{"location":"en/agents/","title":"English \u00b7 Agent entry","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/agents/#Documentation-Entry-for-Agents","title":"Documentation Entry for Agents","text":"<p>This directory is the decision entry point of Skill Family Foundation for agents (Agents). Human readers enter from the root <code>README.md</code>; agents, within a limited context, read here first, then jump to the specific capability by intent, avoiding reading all the source code end-to-end.</p> <p>Foundation does not own business semantics. It provides only three things: machine contracts (Contracts), the thin Node mechanism runtime (Harness), the four engineering-phase commands (Engineering Kit), and the horizontally-declared-difference Profile. Domain state machines, model orchestration, remote publish writes, and audit semantics all stay with the caller or other projects.</p>"},{"location":"en/agents/#Reading-Order","title":"Reading Order","text":"<p>Agents consume the following in order, without needing to read from start to finish:</p> <ol> <li><code>../../agents/capability-catalog.json</code> \u2014 the language-neutral machine-fact catalog of stable and candidate capabilities; the starting point for judging \"does this requirement belong to Foundation, in which layer, and with which entry point.\"</li> <li><code>architecture-routing.md</code> \u2014 the decision table and decision tree from architecture intent to layer/capability/entry-point/external-project.</li> <li><code>../../agents/capability-catalog.en.json</code> \u2014 English intent, use conditions, inputs, outputs, failure semantics, caller ownership, and external routing for exactly the same capability IDs.</li> <li><code>../../agents/capability-catalog.schema.json</code> \u2014 the closed structural contract for the core catalog and locale overlays.</li> <li>The root <code>README.md</code>'s Agent Quick Reference \u2014 routing only, no API duplication.</li> <li>The three packages' README Agent Quick References \u2014 down to package-level capabilities and failure boundaries.</li> <li><code>../reference/failure-and-side-effect-matrix.md</code> \u2014 read/write/spawn/Git/network/residual-state/error-code for each public entry point.</li> <li><code>../reference/api/README.md</code> \u2014 the English API route across the three packages, including key capabilities, failure rules, evidence paths, and caller-owned semantics.</li> </ol> <p>Fact priority: this documentation consumes only the machine source of truth (package.json, src/index.mjs, CLI, registry.json, profile descriptor). Versions, commands, package counts, and support states are recomputed from the source of truth, never copied from memory or old docs.</p>"},{"location":"en/agents/#Catalog-Contract","title":"Catalog Contract","text":"<p>Files under <code>docs/agents/</code> assume different responsibilities and do not duplicate each other:</p> File Role Who should change it <code>../../agents/capability-catalog.json</code> Language-neutral machine-readable capability facts; the documentation layer's sole fact surface Change when capabilities change, validated by <code>capability-catalog-check.mjs</code> <code>../../agents/capability-catalog.en.json</code> English explanation overlay for every core capability ID Change when the English intent or behavior explanation changes <code>../../agents/capability-catalog.zh-CN.json</code> Simplified Chinese explanation overlay for every core capability ID Change when the Chinese intent or behavior explanation changes <code>../../agents/capability-catalog.schema.json</code> Closed catalog and overlay structural contract Change only when structure changes <code>architecture-routing.md</code> Intent \u2192 layer/capability/entry-point/external-project decisions Change when routing adjudication changes <code>README.md</code> (this file) Agent total entry point and reading order Change when entry-point structure changes <code>../reference/api/README.md</code> and the three Chinese package detail pages Human-readable routing and signature-level expansion of catalog capabilities Change when real exports change, and sync with <code>capability-catalog-check.mjs</code> <p>The capability catalog is not a new public object of Contracts, nor a fourth registry class. It is only the documentation layer's machine facts, avoiding the README becoming a second drifting handwritten authority.</p>"},{"location":"en/agents/#Architecture-Design-Method","title":"Architecture Design Method","text":"<p>When an agent handles a Foundation-related requirement, it proceeds in the following four steps:</p> <ol> <li>Decide ownership first. Does this requirement contain domain semantics, a business state machine, or an audit oracle? If so, keep it with the consumer, connecting only business-neutral mechanisms to Foundation.</li> <li>Then decide the layer. Structure/protocol/stable error code/object Schema \u2192 Contracts; cross-skill-family reusable Node mechanism \u2192 Harness; scaffold/adopt/projection/check or concrete Profile injection \u2192 Kit/Profile.</li> <li>Check the catalog to determine the entry point. Find the capability by <code>layer</code> in the core catalog, then read the matching <code>intent</code>, <code>sideEffects</code>, <code>failureSemantics</code>, <code>ownedByCaller</code>, and <code>routeElsewhere</code> in the English overlay.</li> <li>Verify evidence before concluding. Each catalog capability carries <code>sourceRefs</code> and <code>positiveTestRefs</code>/<code>negativeTestRefs</code>; before changing a judgment, return to these sources of truth to confirm, rather than inferring from the catalog's prose.</li> </ol> <p>The hard rule of routing boundaries: Foundation does not own remote writes (\u2192 release-skill), does not own tasks/retries/rework (\u2192 loop-agent), does not own artifact relationships and context (\u2192 artifact-graph), does not own domain-audit semantics (\u2192 independent audit consumer). See the routing table in <code>architecture-routing.md</code> for details.</p>"},{"location":"en/agents/#Relationship-with-Mechanical-Gates","title":"Relationship with Mechanical Gates","text":"<p>Two check scripts guard the catalog and README against drift:</p> <ul> <li><code>scripts/docs/capability-catalog-check.mjs</code> validates structure, unique IDs, existence of source/test references, unsupported boundaries, and that the Kit's four commands are not expanded.</li> <li><code>scripts/docs/agent-section-check.mjs</code> validates the fixed Agent Quick Reference sections of the root README and the three packages' READMEs, the required subheadings, and capability-ID links.</li> </ul> <p>Neither only reports shape and does not auto-edit; warnings require returning to the source of truth and human judgment.</p>"},{"location":"en/agents/architecture-routing/","title":"English \u00b7 Architecture routing","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/agents/architecture-routing/#Architecture-Routing-From-Intent-to-Layer-Capability-and-External-Project","title":"Architecture Routing: From Intent to Layer, Capability, and External Project","text":"<p>This page converges \"where should an architecture requirement land\" into a mechanically-reusable decision order and routing table. It serves new agents who, without reading the source code end-to-end, quickly obtain a verifiable answer: does this requirement belong to Foundation, in which layer (Contracts/Harness/Kit/Profile), with which stable entry point, what semantics remain owned by the caller, and when should it be handed off to an external project.</p>"},{"location":"en/agents/architecture-routing/#Decision-Order","title":"Decision Order","text":"<p>Judge in order by number, stopping at the first match:</p> <ol> <li>Does it contain domain semantics, a business state machine, or an audit oracle? If yes, keep it with the consumer; Foundation connects only business-neutral mechanisms.</li> <li>Is it structure, a protocol, a stable error code, or an object Schema? \u2192 Contracts (contract authority).</li> <li>Is it a cross-skill-family reusable Node mechanism? \u2192 Harness (Node implementation of the Contracts mechanism protocol).</li> <li>Is it the engineering-phase scaffold/adopt-plan/projection/check, or a concrete host Profile injection? \u2192 Kit / Profile.</li> <li>Does it involve publishing remote state? \u2192 release-skill.</li> <li>Does it involve tasks, retries, rework, acceptance, or self-iteration? \u2192 loop-agent.</li> <li>Does it involve artifact relationships, context, packet, or version-lock? \u2192 artifact-graph.</li> <li>Does it have only one consumer, or has cross-two-real-consumer duplication not been proven? Keep it with the consumer by default; do not expand Foundation.</li> </ol> <p>Step 8 is the expansion gate. Any new component must justify: deleting it would force two or more real consumers to re-implement it, and this is verified by an independent fixture. Otherwise keep it on the consumer side.</p>"},{"location":"en/agents/architecture-routing/#Routing-Table","title":"Routing Table","text":"<p>The table below gives the preferred capability and the forbidden misuse for common architecture intents. Each preferred capability can be looked up in <code>capability-catalog.json</code> by id for its entry points, side effects, and failure semantics.</p> Architecture intent Preferred capability Forbidden misuse Validate a Foundation contract object Contracts / Harness validation (<code>foundation.contracts.object-validation</code>, <code>foundation.harness.contract-validation</code>) Do not replace the consumer's business Schema Safe file access and atomic write Harness path / atomic API (<code>foundation.harness.path-containment</code>, <code>foundation.harness.atomic-write</code>) Do not put file-selection business rules into Harness Generate a deterministic human report Harness report or Kit report sub-action (<code>foundation.harness.report</code>, <code>foundation.kit.report</code>) Do not freely author reports from open business outputs Durable events and derived snapshot Harness state-store (<code>foundation.harness.state-store</code>) Do not define a workflow state machine in Foundation New-project skeleton Kit scaffold (<code>foundation.kit.scaffold</code>) Do not overwrite a non-empty existing repository Existing-repository adoption inventory Kit adopt-plan (<code>foundation.kit.adopt-plan</code>) Do not write files, do not auto-migrate Managed projection Kit projection + Profile (<code>foundation.kit.projection</code>) Do not overwrite handwritten files Engineering diagnostics Kit check (<code>foundation.kit.check</code>) Do not auto-fix Publishing release-skill Foundation does not own remote writes Tasks/retries/rework loop-agent Foundation does not own a business state machine Artifact relationships/version-lock artifact-graph Foundation does not own the artifact graph"},{"location":"en/agents/architecture-routing/#Layer-Location-Quick-Reference","title":"Layer-Location Quick Reference","text":"<p>The dependency direction is fixed as Contracts \u2192 Harness \u2192 Engineering Kit; Profile declares horizontally, and the public core does not depend in reverse on a concrete Profile.</p> <ul> <li>Contracts: structure, protocols, error codes, protocol-name registry; 18 top-level object kinds, 9 mandatory rules.</li> <li>Harness: the thin Node mechanism runtime of Contracts; implements only business-neutral mechanisms, owning no semantics.</li> <li>Engineering Kit: the four engineering commands (scaffold, adopt-plan, projection, check) and their read-only / restricted-write boundaries.</li> <li>Profile: the declarative SPI for host and project-shape differences; implements only the stable SPI, injecting no business semantics.</li> <li>External projects: release-skill (publishing), loop-agent (task lifecycle), artifact-graph (artifact relationships), independent audit consumer (domain semantics).</li> </ul>"},{"location":"en/agents/architecture-routing/#Typical-Misrouting-and-Correction","title":"Typical Misrouting and Correction","text":"<ul> <li>Misrouting a domain Schema to Foundation: the domain Schema is owned by the consumer; Foundation provides only a generic validation mechanism (<code>foundation.contracts.object-validation</code>).</li> <li>Misrouting a workflow state machine to Foundation: state-store provides only the event-log and snapshot substrate; reducer transitions and terminal states are owned by the caller (<code>foundation.unsupported.business-state-machine</code>).</li> <li>Misrouting a publish write to Foundation: remote writes belong to release-skill; Foundation contains no publish/remote-write entry point (<code>foundation.unsupported.remote-publish</code>).</li> <li>Misrouting an audit oracle to Foundation: the audit surface only performs deterministic serialization; domain conclusions belong to external review (<code>foundation.unsupported.domain-audit-semantics</code>).</li> </ul> <p>The honest boundary of routing judgment: structural checks only prove byte/structural consistency (provable in-repo); ordinary prose semantics and the final accept/reject conclusion belong to external independent review; no second gate is maintained within the target repository.</p>"},{"location":"en/migration/","title":"English \u00b7 Migration","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/migration/#Existing-Repository-Adoption-and-Migration-FND-070","title":"Existing-Repository Adoption and Migration (FND-070)","text":"<p>This page describes how an existing project adopts the Skill Family infrastructure, and the gate for judging migration completion. It serves two reader types: a human owner uses it to judge the adoption path and risks; an agent uses it to run a read-only inventory via <code>adopt-plan</code>, without duplicating write actions on this page.</p>"},{"location":"en/migration/#Classification-Method","title":"Classification Method","text":"<p>Before an existing repository connects to Foundation, classify it into one of the four categories below. The classification determines which path to take, whether files are written, and how the legacy implementation is handled.</p> Category Meaning Handling path Writes files? <code>direct-adoption</code> The repository already has a capability that can be replaced by Foundation as-is, with no business-semantic coupling Direct adoption: <code>adopt-plan</code> inventory \u2192 <code>scaffold</code>/<code>projection</code> writes to disk Yes (contained) <code>compatibility-layer</code> The repository's existing implementation differs from the Foundation interface and needs a compatibility adaptation layer Write a compatibility layer, then adopt; the legacy implementation exits via the compatibility layer Yes (compatibility layer contained) <code>keep-business</code> The capability contains domain semantics or a business state machine, belongs to the caller, and Foundation does not take it Keep with the consumer; connect only business-neutral mechanisms No (on the Foundation side) <code>foundation-gap</code> A needed capability is not yet provided by Foundation (e.g., host apply, Qoder driver) Keep with the consumer or a later version; do not forcibly expand Foundation No <p>Classification is a prerequisite for the adoption decision. Capabilities that fall into <code>keep-business</code> or <code>foundation-gap</code> should not be stuffed into Foundation just to \"complete adoption\"; this is exactly the concrete instantiation of architecture-routing steps 1 and 8.</p>"},{"location":"en/migration/#Principles","title":"Principles","text":"<ol> <li>Plan first: any existing repository first runs the read-only <code>adopt-plan</code>, obtaining the current state, target Profile, exact write set, conflicts, legacy-implementation exit list, and acceptance commands, before deciding whether to perform a write.</li> <li>Read-only plan, zero change: <code>adopt-plan</code> writes no files (including temporary files), runs no git write commands, renames nothing, and touches no remotes; zero change to the input repository's bytes (provable by before/after hash walk-through).</li> <li>Adoption and rename are separate: infrastructure adoption never drags along a repository rename or remote-coordinate change; the two are independent decisions, and the tool provides no rename capability.</li> <li>Dual-track does not count as complete: the migration-completion judgment requires the legacy duplicate implementation to have been deleted; connecting the new infrastructure while the legacy implementation still remains is permanently judged false.</li> </ol>"},{"location":"en/migration/#adopt-plan-Output-Structure","title":"adopt-plan Output Structure","text":"Section Content <code>target</code> Current state: entry-point count, target's own managed declarations <code>project</code> / <code>traceability</code> Target Profile and the source of truth for each write (Contracts version, skeleton generation function, license Profile and variant) <code>git</code> Read-only Git pre-state (repository, HEAD, clean) <code>writeSet</code> Exact write set: per-path action (only <code>create</code>/<code>unchanged</code>), fileClass, sha256 <code>conflicts</code> Handwritten conflicts, managed drift, symlink placeholders, temporary exceptions for missing fields <code>risks</code> dirty, nested repository, tracked-but-ignored, expired exceptions, etc. <code>migration</code> Migration state machine: binding, on-disk proof (adoptionProof), pending-write count, check gate, four-class verification evidence, state and completion judgment <code>verificationPlan</code> Acceptance command sequence (check \u2192 projection \u2192 re-check)"},{"location":"en/migration/#Migration-Manifest-skill-familymigrationjson","title":"Migration Manifest (skill-family.migration.json)","text":"<p>The target repository declares its own migration state in the root directory:</p> <pre><code>{\n \"kind\": \"skill-family.migration-manifest\",\n \"legacyInfra\": [\n { \"path\": \"scripts/old-validator.mjs\", \"replacedBy\": \"sf-kit check\" }\n ],\n \"exceptions\": [\n {\n \"owner\": \"owner\",\n \"reason\": \"specific reason\",\n \"deadline\": \"2026-12-31\",\n \"migrationTarget\": \"wave-m1\"\n }\n ],\n \"targetProfile\": \"generic\",\n \"foundationPackages\": [\n { \"name\": \"skill-family-contracts\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 hex digits>\" },\n { \"name\": \"skill-family-harness-node\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 hex digits>\" },\n { \"name\": \"skill-family-engineering-kit\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 hex digits>\" }\n ],\n \"verification\": {\n \"unit\": \"docs/evidence/unit.json\",\n \"integration\": \"docs/evidence/integration.json\",\n \"consumer\": \"docs/evidence/consumer.json\",\n \"independentAudit\": \"docs/evidence/independent-audit.json\"\n }\n}\n</code></pre> <p>The structure above shows the core fields of the migration manifest; each <code>legacyInfra</code> entry gives the legacy-implementation path and its replacement; the tool only read-only evaluates existence and never deletes on its behalf.</p> <p>The Quickstart Profile candidate moves to v2 in 0.3.0. A migration manifest that binds candidate capabilities must pin all three Foundation packages to exactly 0.3.0; an existing integration that still requires v1 must keep all three packages pinned to exactly 0.2.1 and must not mix the two sets.</p> <ul> <li><code>legacyInfra</code>: each entry gives the legacy-implementation path and its replacement; the tool only read-only evaluates existence and never deletes on its behalf.</li> <li><code>exceptions</code> are temporary exceptions: must simultaneously contain all four fields \u2014 owner, reason, deadline, and migrationTarget \u2014 and missing any field counts as a conflict (plan failure); expired exceptions are not auto-renewed and persistently block the completion judgment.</li> <li><code>targetProfile</code> / <code>foundationPackages</code>: adoption binding. The target Profile must be consistent with the plan Profile; the three Foundation packages (contracts, harness-node, engineering-kit) must each bind an exact version number (floating ranges not accepted) and a <code>sha256:</code> digest.</li> <li><code>verification</code>: paths to the four classes of verification-evidence documents (unit, integration, consumer, independentAudit). Each piece of evidence must be parseable JSON whose <code>projectId</code> matches the target project's identity to count as proven; out-of-bounds paths, missing, unparseable, or identity-mismatched evidence are all unproven, fail-closed.</li> </ul>"},{"location":"en/migration/#Migration-State-Machine","title":"Migration State Machine","text":"<p>States advance monotonically and are derived only from read-only evidence; no tool advances state by writing.</p> <pre><code>not-declared \u2192 declared \u2192 adopted \u2192 verified \u2192 complete\n</code></pre> State Meaning <code>not-declared</code> No contract-valid migration manifest exists <code>declared</code> The manifest contract is valid, but the adoption-proof facts are incomplete <code>adopted</code> Foundation bytes are on disk and the legacy implementation has exited, but the check gate is not green <code>verified</code> The check gate is green, but not all verification evidence is proven <code>complete</code> All eight completion conditions are satisfied; <code>complete</code> is true if and only if the state is <code>complete</code>"},{"location":"en/migration/#Completion-Gate","title":"Completion Gate","text":"<p><code>migration.completion.complete</code> is true if and only if all eight hold:</p> <ol> <li>A contract-valid migration manifest has been declared (kind/fields validated by the Contracts schema);</li> <li>The adoption binding is proven: the target Profile is consistent with the plan, and the three Foundation packages each bind an exact version and a sha256 digest;</li> <li>The Project Manifest, managed lock, identity, and all managed skeleton files are on disk and their digests are consistent with the plan (<code>adoptionProof.missing</code>/<code>mismatched</code> are empty);</li> <li>The write set has no pending create/replace/project actions (<code>pendingWrites</code> is 0);</li> <li>The Foundation check gate is green;</li> <li>Each legacy implementation has exited (absent) \u2014 containment refusal or malformed entries fail-closed identically to present;</li> <li>No missing fields, no unparseable deadline, no expired temporary exceptions; no unresolved adoption conflicts;</li> <li>All four classes of verification evidence (unit/integration/consumer/independentAudit) are proven and identity (projectId) matches.</li> </ol> <p>An unevaluated input is equivalent to unproven: the gate advances only on presented evidence. The blocking reason (<code>blockers</code>) is a stable, readable string that can go directly into the migration review record.</p>"},{"location":"en/migration/#Mandatory-Negative-Cases-completion-must-be-false-in-any-scenario","title":"Mandatory Negative Cases (completion must be false in any scenario)","text":"<ul> <li>Empty repository + empty manifest (no contract-valid manifest \u2192 <code>not-declared</code>);</li> <li>Manifest with wrong kind (schema-invalid \u2192 treated as undeclared);</li> <li>9 skeleton files still pending create (<code>declared</code>, all missing paths listed);</li> <li>Managed lock drift (<code>mismatched</code> non-empty);</li> <li>Only the new implementation connected, legacy still present (dual-track \u2192 <code>declared</code>);</li> <li>Consumer verification evidence missing or identity mismatched (<code>verified</code>, must not complete);</li> <li>Temporary exception expired (the tool never renews).</li> </ul>"},{"location":"en/migration/#Legacy-Removal-and-Rollback-Contract","title":"Legacy-Removal and Rollback Contract","text":"<ul> <li>Removal is the caller's responsibility: <code>adopt-plan</code> only evaluates legacy-implementation existence and lists the exit manifest, never deleting on its behalf; <code>foundation-gap</code> and <code>keep-business</code> capabilities do not require removal.</li> <li>Rollback relies on evidence: before adoption writes to disk, a dual-digest binding of <code>adoptionProof</code> and <code>foundationPlanDigest</code> must exist first; on rollback, the plan write set's <code>expect.sha256</code> pre-state is used to restore; an overwrite action that does not declare its pre-state is refused at the <code>projection</code> stage.</li> <li>fail-closed default: any unparseable, out-of-bounds, identity-mismatched, or evidence-missing input makes the corresponding judgment unproven; success is not assumed.</li> </ul>"},{"location":"en/migration/#Ten-Field-Hand-off-Draft","title":"Ten-Field Hand-off Draft","text":"<p><code>adopt-plan</code> output carries a <code>handoffDraft</code> sub-block (kind=<code>skill-family.handoff-draft</code>, schemaVersion=1), providing structured data draft for the planner-side ten-field hand-off. Field sources are only two kinds: <code>derived</code> (mechanically derivable from read-only evidence) and <code>INCOMPLETE</code> (not mechanically derivable, never guessed). The ten fields correspond one-to-one with the source constant <code>HANDOFF_FIELDS</code>:</p> id Field name Source 1 <code>project-identity</code> derived 2 <code>repository-state</code> derived 3 <code>foundation-binding</code> derived (manifest declared binding) / INCOMPLETE (no manifest declared) 4 <code>write-set-policy</code> derived 5 <code>legacy-exits</code> derived 6 <code>business-logic-to-keep</code> always INCOMPLETE 7 <code>plan-summary</code> derived 8 <code>verification-entries</code> derived (all four classes of evidence proven) / INCOMPLETE (any unproven) 9 <code>legacy-removal-recovery</code> always INCOMPLETE 10 <code>authorization-status</code> derived (commit/push/tag/publish always false)"},{"location":"en/migration/#INCOMPLETE-Blocking-Rules","title":"INCOMPLETE Blocking Rules","text":"<ul> <li>Any INCOMPLETE field makes <code>ready=false</code>: a draft with gaps must not enter the hand-off.</li> <li>The tool never guesses mechanically-undeterminable fields:</li> <li><code>business-logic-to-keep</code> and <code>legacy-removal-recovery</code> are always INCOMPLETE and must be provided by a human owner; the tool has no basis to derive them;</li> <li><code>foundation-binding</code> is INCOMPLETE when no migration manifest declares (<code>foundationPackages</code>) it, counting only the manifest-declared binding;</li> <li><code>verification-entries</code> is INCOMPLETE when any of the four classes of evidence (unit/integration/consumer/independentAudit) is not proven.</li> </ul>"},{"location":"en/migration/#Binding","title":"Binding","text":"<p>The draft carries a dual sha256 digest (the <code>binding</code> block): <code>targetSetDigest</code> summarizes the target repository's file set, and <code>foundationPlanDigest</code> summarizes the Foundation plan write set. Two plans for the same target yield the same digest, precisely binding the draft and the target state at plan time.</p>"},{"location":"en/migration/#Rendering-Boundary","title":"Rendering Boundary","text":"<ul> <li>The renderer writes only the planner-side hand-off draft, never the consumer repository;</li> <li>No fifth Kit top-level command is added: Kit top-level commands are permanently the four \u2014 scaffold, adopt-plan, projection, check \u2014 and <code>handoffDraft</code> is only a sub-block of <code>adopt-plan</code> output.</li> </ul>"},{"location":"en/migration/#Hazard-Class-Fixtures","title":"Hazard-Class Fixtures","text":"<p><code>fixtures/adoption/cases/</code> covers seven hazard classes: dirty repository, nested repository, tracked-but-ignored, symlink placeholder, generated-artifact drift, legacy-implementation exit gate, and temporary-exception fields. Each case proves the plan is read-only via byte-level before/after snapshots; see the in-repo <code>fixtures/adoption/README.md</code> for case descriptions.</p>"},{"location":"en/recipes/","title":"English \u00b7 Recipes","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/#Recipe-Index","title":"Recipe Index","text":"<p>This directory provides the minimal, copy-paste-runnable approach for common architecture requirements. Each recipe follows a fixed nine-section structure: scenario and non-scenario, architecture choice and capability ID, preconditions and trust boundary, minimal code or command, expected output and evidence, safety/failure negative case, copy-paste verification command, business logic the caller continues to own, and upgrade/rollback notes.</p>"},{"location":"en/recipes/#Selection-Rules","title":"Selection Rules","text":"<ul> <li>Requirement contains domain semantics / state machine / audit oracle \u2192 keep with the consumer; do not look for a Foundation capability here.</li> <li>Need structure or protocol validation \u2192 see <code>domain-schema-validation</code>.</li> <li>Need safe file access or atomic write \u2192 see <code>safe-filesystem-and-atomic-write</code>.</li> <li>Need a deterministic human report \u2192 see <code>deterministic-human-report</code>.</li> <li>Need durable events and derived snapshots \u2192 see <code>durable-local-state</code>.</li> <li>Need an existing-repository adoption inventory \u2192 see <code>adopt-existing-repository</code>.</li> <li>Need a text-resource closure or host access \u2192 see <code>adapter-text-closure</code> / <code>host-profile-integration</code>.</li> <li>Need to trial Quickstart Profile v2 \u2192 pin the 0.3.0 candidate subpaths of all three packages exactly; remain on exactly 0.2.1 when v1 is still required.</li> </ul>"},{"location":"en/recipes/#Common-Verification-Conventions","title":"Common Verification Conventions","text":"<ul> <li>All examples run in a new system temp directory, leaving no personal paths or credentials.</li> <li>Examples contain no enterprise identifiers, private Profiles, real business data, or personal paths.</li> <li>Each recipe gives at least one positive case and one negative case; the negative case must produce a stable failure code or refusal.</li> <li>Verification commands can be copied and run directly; when a package is needed, first <code>npm install</code> the corresponding <code>@0.3.0</code>.</li> </ul>"},{"location":"en/recipes/#Capability-ID-Overview","title":"Capability ID Overview","text":"Recipe Preferred capability ID adopt-existing-repository <code>foundation.kit.adopt-plan</code> safe-filesystem-and-atomic-write <code>foundation.harness.path-containment</code>, <code>foundation.harness.atomic-write</code> domain-schema-validation <code>foundation.contracts.object-validation</code> adapter-text-closure <code>foundation.harness.resource-closure</code>, <code>foundation.harness.host-adapter</code> deterministic-human-report <code>foundation.harness.report</code>, <code>foundation.kit.report</code> durable-local-state <code>foundation.harness.state-store</code> host-profile-integration <code>foundation.kit.host</code>, <code>foundation.profile.extension-spi</code>"},{"location":"en/recipes/adapter-text-closure/","title":"English \u00b7 Adapter text closure","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/adapter-text-closure/#Recipe-Text-Resource-Closure-and-Host-Build","title":"Recipe: Text Resource Closure and Host Build","text":""},{"location":"en/recipes/adapter-text-closure/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to normalize a set of text resources into a recomputable closure, and based on it materialize a host-adapter build at a contained location, with the build manifest fully digest-verifiable.</p> <p>Not applicable: needs to include binary resources in the adapter projection (text closure only); needs host apply/install/update/uninstall (explicitly unsupported).</p>"},{"location":"en/recipes/adapter-text-closure/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.harness.resource-closure</code> (deterministic closure and sha256 digest) and <code>foundation.harness.host-adapter</code> (adapter source closure / build / manifest verification / materialize).</p>"},{"location":"en/recipes/adapter-text-closure/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The adapter source is a declared text closure (<code>content</code> accepts only string, utf8).</li> <li>Trust boundary: materialize uses sibling staging + a single rename, and refuses if the target already exists; probe does not spawn by default and does not walk PATH.</li> </ul>"},{"location":"en/recipes/adapter-text-closure/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import {\n computeResourceClosure,\n buildAdapterClosure,\n verifyAdapterBuildManifest,\n materializeAdapterBuild,\n} from \"skill-family-harness-node\";\n\nconst closure = computeResourceClosure([\n { path: \"skill.json\", content: \"{}\" },\n { path: \"readme.md\", content: \"# demo\" },\n]);\nconst built = buildAdapterClosure(closure);\nverifyAdapterBuildManifest(built.manifest); // fully digest-verifiable\nawait materializeAdapterBuild(built, { outDir: \"./out\" }); // contained write to disk\n</code></pre> <p>The code above shows the order of first computing the closure, then verifying the manifest, then atomically materializing.</p>"},{"location":"en/recipes/adapter-text-closure/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>computeResourceClosure</code> returns a deterministic closure object and a sha256 digest; <code>materializeAdapterBuild</code> writes the artifact at the contained target. Evidence: <code>packages/skill-family-harness-node/test/closure.test.mjs</code> and <code>test/host.test.mjs</code>.</p>"},{"location":"en/recipes/adapter-text-closure/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: binary content unsupported -> verification/build refusal\nbuildAdapterClosure({ path: \"x.bin\", content: Buffer.from([0, 1, 2]) });\n// throws HarnessError: adapter source content supports string (utf8) only\n</code></pre> <p>A manifest-digest mismatch, an already-existing target, or a non-trusted executable file also throw.</p>"},{"location":"en/recipes/adapter-text-closure/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/closure.test.mjs \\\n packages/skill-family-harness-node/test/host.test.mjs\n</code></pre>"},{"location":"en/recipes/adapter-text-closure/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>The host's concrete business semantics.</li> <li>Host-difference declarations are injected via Profile + Kit host sub-action.</li> </ul>"},{"location":"en/recipes/adapter-text-closure/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>host apply is stably refused, and install/uninstall/update are unimplemented; the full Qoder driver is unsupported.</li> <li>materialize is an atomic sibling + rename, and on failure does not affect the existing target; upgrade follows the <code>skill-family-harness-node</code> version.</li> </ul>"},{"location":"en/recipes/adopt-existing-repository/","title":"English \u00b7 Adopt an existing repository","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/adopt-existing-repository/#Recipe-Existing-Repository-Read-Only-Adoption-Inventory","title":"Recipe: Existing-Repository Read-Only Adoption Inventory","text":""},{"location":"en/recipes/adopt-existing-repository/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to judge whether an existing repository can adopt Foundation, and obtain the exact write set, conflicts, and legacy-implementation exit list, without changing any bytes.</p> <p>Not applicable: needs to auto-rewrite the existing repository (writing files is forbidden, auto-migration is forbidden); needs to publish to a remote (\u2192 release-skill).</p>"},{"location":"en/recipes/adopt-existing-repository/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capability: <code>foundation.kit.adopt-plan</code> (strictly read-only inventory and completion judgment). It only outputs, writes no files, runs no git write commands.</p>"},{"location":"en/recipes/adopt-existing-repository/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The target repository exists and is read-only accessible.</li> <li>Trust boundary: <code>adopt-plan</code> makes zero byte changes to the input repository; legacy-implementation deletion is the caller's responsibility, and the tool never deletes on its behalf.</li> </ul>"},{"location":"en/recipes/adopt-existing-repository/#4-Minimal-Command","title":"4. Minimal Command","text":"<pre><code>npm install --save-dev skill-family-engineering-kit@0.3.0\nnpm exec -- skill-family-kit adopt-plan --root <repo>\n</code></pre>"},{"location":"en/recipes/adopt-existing-repository/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p>The output includes the current state (<code>target</code>), target Profile and traceability (<code>project</code>/<code>traceability</code>), read-only Git pre-state (<code>git</code>), exact write set (<code>writeSet</code>), conflicts (<code>conflicts</code>), risks (<code>risks</code>), migration state machine (<code>migration</code>), and acceptance command sequence (<code>verificationPlan</code>). Evidence from <code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code> and <code>test/migration.test.mjs</code>.</p>"},{"location":"en/recipes/adopt-existing-repository/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<p>Before and after running <code>adopt-plan</code> on a dirty repository, the input repository's bytes must be exactly identical (provable by hash walk-through); the tool writes no temp files and touches no remote. If the migration manifest is missing a required <code>exceptions</code> field, the plan fails directly (completion false), and the tool does not renew.</p>"},{"location":"en/recipes/adopt-existing-repository/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code># Positive case: read-only inventory of a public fixture existing-repository\nnpm exec -- skill-family-kit adopt-plan --root fixtures/m0-consumer\n\n# Read-only diagnostics, no fix\nnpm exec -- skill-family-kit check --root fixtures/m0-consumer\n</code></pre>"},{"location":"en/recipes/adopt-existing-repository/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Whether the legacy implementation exits, and when to delete it (the tool only evaluates existence and lists the exit manifest).</li> <li><code>business-logic-to-keep</code> and <code>legacy-removal-recovery</code> are always INCOMPLETE and must be provided by a human owner.</li> </ul>"},{"location":"en/recipes/adopt-existing-repository/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li><code>adopt-plan</code> is read-only, has no write risk, and needs no rollback.</li> <li>Actual disk writes are performed by <code>scaffold</code>/<code>projection</code>; rollback relies on the dual-digest binding of <code>adoptionProof</code> and <code>foundationPlanDigest</code>; an overwrite action that does not declare the <code>expect.sha256</code> pre-state is refused at the <code>projection</code> stage.</li> <li>When adopting the Quickstart Profile candidate, pin all three packages to one profile: 0.3.0 for v2 or 0.2.1 for v1. Do not mix them.</li> </ul>"},{"location":"en/recipes/deterministic-human-report/","title":"English \u00b7 Deterministic human report","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/deterministic-human-report/#Recipe-Deterministic-Human-Report","title":"Recipe: Deterministic Human Report","text":""},{"location":"en/recipes/deterministic-human-report/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to deterministically render machine results into a human-readable report (Markdown + digest binding + graded checks), writing the paired dual outputs as a group and refusing path aliases and input overwrites.</p> <p>Not applicable: needs to freely author a report from open business outputs (forbidden); needs model invocation or business orchestration.</p>"},{"location":"en/recipes/deterministic-human-report/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.harness.report</code> (validate \u2192 render \u2192 bind \u2192 check, pure functions) and <code>foundation.kit.report</code> (CLI sub-action orchestrating rendering and grading).</p>"},{"location":"en/recipes/deterministic-human-report/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>A Contracts-validated report-model and operation-result already exist.</li> <li>Trust boundary: deterministic Markdown escaping; a three-digest binding of model/result/report; the caller must first construct a valid model, and Kit does not derive facts from business outputs.</li> </ul>"},{"location":"en/recipes/deterministic-human-report/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import {\n validateReportModel,\n renderReportMarkdown,\n buildBinding,\n checkReport,\n} from \"skill-family-harness-node\";\n\nvalidateReportModel(model);\nconst markdown = renderReportMarkdown(model, { locale: \"zh-CN\" });\nconst binding = buildBinding(model, result, markdown);\nconst graded = checkReport(model, result, markdown, binding); // graded check findings\n</code></pre> <p>The code above shows the four-step order of model validation, rendering, binding, and graded check.</p>"},{"location":"en/recipes/deterministic-human-report/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>renderReportMarkdown</code> returns deterministic Markdown; <code>buildBinding</code> produces the three-digest binding; <code>checkReport</code> returns graded check findings. Evidence: <code>packages/skill-family-harness-node/test/report.test.mjs</code> and <code>packages/skill-family-engineering-kit/test/report.test.mjs</code>.</p>"},{"location":"en/recipes/deterministic-human-report/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: report bytes deviate from deterministic re-render -> SFC3003 (REPORT_FACT_DRIFT)\n// after manually editing markdown then bind/check, the digest mismatch fails\ncheckReport(model, result, tamperedMarkdown, binding);\n// throws HarnessError, errorCode = \"SFC3003\"\n</code></pre> <p><code>SFC3001</code> (digest mismatch) and <code>SFC3002</code> (missing mandatory element) are likewise hard failures.</p>"},{"location":"en/recipes/deterministic-human-report/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/report.test.mjs \\\n packages/skill-family-engineering-kit/test/report.test.mjs\n</code></pre>"},{"location":"en/recipes/deterministic-human-report/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Interpretation of the report's business conclusions.</li> <li>The caller must first construct a valid report-model (Kit does not derive facts from business outputs).</li> </ul>"},{"location":"en/recipes/deterministic-human-report/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The report is deterministically rendered from machine results, not freely authored; upgrade follows the <code>skill-family-harness-node</code> and <code>skill-family-engineering-kit</code> versions.</li> <li>The paired dual outputs are written as a group, refusing path aliases and input overwrites; rollback restores from the <code>expect.sha256</code> pre-state written before the write.</li> </ul>"},{"location":"en/recipes/domain-schema-validation/","title":"English \u00b7 Domain Schema validation","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/domain-schema-validation/#Recipe-Domain-Agnostic-Contract-Object-Validation","title":"Recipe: Domain-Agnostic Contract Object Validation","text":""},{"location":"en/recipes/domain-schema-validation/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to validate whether a document conforms to a Foundation-registered contract object (e.g., project-manifest), choosing a validation strategy by dialect.</p> <p>Not applicable: needs to validate the consumer's own business Schema (the consumer should hold it itself; Foundation does not replace it); needs to mix domain-semantic validation into the generic contract.</p> <p>Quickstart Profile v2 is a separate candidate path. The consumer still owns its business schemas; Engineering Kit only compiles an explicit schema collection into offline validators selected by <code>$id</code>, and does not own the method-to-schema choice.</p>"},{"location":"en/recipes/domain-schema-validation/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capability: <code>foundation.contracts.object-validation</code> (<code>validateDocument</code> / <code>compileSchema</code> / <code>detectDialect</code>). A pure Ajv implementation, supporting draft-07 and 2020-12.</p>"},{"location":"en/recipes/domain-schema-validation/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The document to be validated carries the <code>$id</code> of a registered contract object.</li> <li>Trust boundary: <code>validateDocument</code> never modifies the caller's input; a normalized copy is returned only in the result's <code>data</code> field.</li> </ul>"},{"location":"en/recipes/domain-schema-validation/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import { validateDocument } from \"skill-family-contracts\";\n\nconst document = {\n schemaVersion: 1,\n kind: \"skill-family.project-manifest\",\n project: { id: \"my-project\", name: \"My Project\", description: \"Example\" },\n contracts: { version: \"1.0.0\", profile: \"generic\" },\n managedFiles: [\"package.json\"],\n updatedAt: \"2026-01-01T00:00:00Z\",\n};\n\nconst result = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/project-manifest.json\",\n dialect: \"2020-12\",\n});\nif (!result.valid) console.error(result.errorCode);\n</code></pre> <p>The code above shows using <code>$id</code> to specify the target Schema and retrieving <code>{ valid, errorCode, errors, data }</code>.</p>"},{"location":"en/recipes/domain-schema-validation/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p>On successful validation <code>result.valid</code> is true; on failure <code>errorCode</code> is a stable code such as <code>SFC1001</code>. Evidence: <code>packages/skill-family-contracts/test/validator.test.mjs</code> and <code>test/schemas.test.mjs</code>.</p>"},{"location":"en/recipes/domain-schema-validation/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: unknown $id -> returns valid:false, errorCode = SFC1002 (UNKNOWN_SCHEMA_ID)\nconst bad = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/does-not-exist.json\",\n dialect: \"2020-12\",\n});\n// does not throw, returns a structured result:\n// { valid: false, errorCode: \"SFC1002\",\n// errors: [{ message: \"unknown schema $id: https://contracts.skill-family.example/v1/does-not-exist.json\" }] }\nif (!bad.valid) console.error(bad.errorCode); // SFC1002\n</code></pre>"},{"location":"en/recipes/domain-schema-validation/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-contracts/test/validator.test.mjs \\\n packages/skill-family-contracts/test/schemas.test.mjs\n</code></pre>"},{"location":"en/recipes/domain-schema-validation/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Semantic interpretation of specific business fields.</li> <li>Domain-level validation rules (not within the Foundation generic contract).</li> </ul>"},{"location":"en/recipes/domain-schema-validation/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The contract authority version <code>CONTRACTS_VERSION = 1.4.0</code>, and the npm package version <code>0.3.0</code> run in parallel and are not mixed.</li> <li>Error codes are frozen and do not drift; Schema changes are handled as a new contract-version task, not by modifying frozen content in place.</li> <li>Candidate v2 must be pinned to exactly 0.3.0; integrations that still require v1 must remain pinned to exactly 0.2.1.</li> </ul>"},{"location":"en/recipes/durable-local-state/","title":"English \u00b7 Durable local state","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/durable-local-state/#Recipe-Durable-Local-State-Substrate","title":"Recipe: Durable Local State Substrate","text":""},{"location":"en/recipes/durable-local-state/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to persist an event log while guaranteeing order and integrity, rebuild or verify a derived snapshot, and inspect or recover a cooperative single-writer lock.</p> <p>Not applicable: needs to define a workflow state machine in Foundation (forbidden); needs to resist same-privilege malicious processes (fencing does not promise this scenario).</p>"},{"location":"en/recipes/durable-local-state/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capability: <code>foundation.harness.state-store</code> (append-only events, hash chain, snapshot, and lock inspect/recover). Event meaning and reducer transitions are owned by the caller.</p>"},{"location":"en/recipes/durable-local-state/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li><code>STATE_GENESIS_DIGEST</code> as the chain starting point.</li> <li>Trust boundary: the event log is the sole authority, and the snapshot is a derived cache; <code>confirmOwnerTerminated</code> is an external trust anchor provided by the caller and does not promise resistance against same-privilege malicious processes.</li> </ul>"},{"location":"en/recipes/durable-local-state/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n openStateStore,\n appendEvent,\n readEvents,\n writeSnapshot,\n readSnapshot,\n inspectStateStoreLock,\n recoverStateStoreLock,\n} from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-state-\"));\nconst store = openStateStore(root, { owner: \"writer-a\", expectedSchemas: [] });\nappendEvent(store, { eventType: \"demo\", payload: { n: 1 } });\nwriteSnapshot(store, readEvents(store));\nconst snap = readSnapshot(store);\nconst lock = inspectStateStoreLock(root); // { owner, fencing, ageMs, recovering }\nawait recoverStateStoreLock(root, {\n expectedOwner: lock.owner,\n expectedFencing: lock.fencing,\n confirmOwnerTerminated: true,\n});\n</code></pre> <p>The code above shows the order of opening the store, appending events, writing a snapshot, inspecting the lock, and explicitly recovering.</p>"},{"location":"en/recipes/durable-local-state/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>readEvents</code> returns the appended events, <code>readSnapshot</code> returns the derived snapshot, and <code>inspectStateStoreLock</code> returns <code>owner</code>/<code>fencing</code>/<code>ageMs</code>/<code>recovering</code>. Evidence: <code>packages/skill-family-harness-node/test/state-store.test.mjs</code> (with 34 assertions).</p>"},{"location":"en/recipes/durable-local-state/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: a second writer immediately receives store-locked\nconst other = openStateStore(root, { owner: \"writer-b\", expectedSchemas: [] });\n// throws HarnessError: details.kind = \"store-locked\"\n</code></pre> <p>A broken hash chain, a mismatched lock fencing, or recovery missing <code>confirmOwnerTerminated</code> all fail-closed.</p>"},{"location":"en/recipes/durable-local-state/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/state-store.test.mjs\n</code></pre>"},{"location":"en/recipes/durable-local-state/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Event business meaning, reducer transitions.</li> <li>The <code>confirmOwnerTerminated</code> trust anchor (confirm outside Foundation that the old writer has terminated).</li> </ul>"},{"location":"en/recipes/durable-local-state/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The state substrate provides only the mechanism; the business state machine / terminal state belongs to loop-agent.</li> <li>A crash-left lock requires external evidence-gathering before explicit recovery, with no silent lock-stealing; the system stays diagnosable as a lock-out rather than silently overwriting.</li> </ul>"},{"location":"en/recipes/host-profile-integration/","title":"English \u00b7 Host Profile integration","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/host-profile-integration/#Recipe-Host-Access-and-Profile-Injection","title":"Recipe: Host Access and Profile Injection","text":""},{"location":"en/recipes/host-profile-integration/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to describe a registered host (claude/codex), probe or plan host access, and inject a concrete host Profile and trusted driver into Foundation.</p> <p>Not applicable: needs host apply/install/update/uninstall (explicitly unsupported); needs the full Qoder driver (that host is unsupported).</p>"},{"location":"en/recipes/host-profile-integration/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.kit.host</code> (<code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code>) and <code>foundation.profile.extension-spi</code> (<code>verifyProfile</code>). Host-difference declarations are in <code>foundation.profile.hosts</code>.</p>"},{"location":"en/recipes/host-profile-integration/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The host Profile is registered in <code>profiles/hosts</code>; the only trusted drivers are <code>claude-version-v1</code> / <code>codex-version-v1</code>.</li> <li>Trust boundary: the Profile entry point must be a JSON data resource, and the public core does not import <code>profiles/</code>; <code>coreOwned</code> is a forbidden target.</li> </ul>"},{"location":"en/recipes/host-profile-integration/#4-Minimal-Command-and-Code","title":"4. Minimal Command and Code","text":"<pre><code># Describe a registered host\nnpm exec -- skill-family-kit adopt-plan host-describe --host claude --hosts-root profiles/hosts\n\n# Read-only probe (no spawn by default)\nnpm exec -- skill-family-kit adopt-plan host-probe --host claude --hosts-root profiles/hosts\n</code></pre> <pre><code>import { describeHost, probeHost, planHost } from \"skill-family-engineering-kit\";\nimport { verifyProfile } from \"profiles/spi/index.mjs\";\n\nconst desc = describeHost(\"claude\"); // supported host description\nconst facts = probeHost(\"claude\", { allowSpawn: false });\nconst plan = planHost(desc, facts);\nconst spi = verifyProfile({ profileRoot: \"profiles/public-plugin\" }); // SPE0000\n</code></pre> <p>The command and code above show the read-only describe/probe/plan mechanism, and using <code>verifyProfile</code> to validate the Profile declaration.</p>"},{"location":"en/recipes/host-profile-integration/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>describeHost</code> returns the host description, <code>probeHost</code> returns read-only probe facts, <code>planHost</code> returns the access plan, and <code>verifyProfile</code> returns result codes such as <code>SPE0000</code>. Evidence: <code>packages/skill-family-engineering-kit/test/host.test.mjs</code> and <code>fixtures/generic-profile-extension-conformance/verify.mjs</code>.</p>"},{"location":"en/recipes/host-profile-integration/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code># Negative case: apply stably refused\nnpm exec -- skill-family-kit adopt-plan host-apply --host claude --hosts-root profiles/hosts\n# exit code 2: host apply is not implemented in the read-only Phase D slice\n</code></pre> <pre><code>// Negative case: qoder is unsupported\ndescribeHost(\"qoder\"); // throws: support = \"unsupported\"\n</code></pre>"},{"location":"en/recipes/host-profile-integration/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-engineering-kit/test/host.test.mjs \\\n fixtures/generic-profile-extension-conformance/verify.mjs\n</code></pre>"},{"location":"en/recipes/host-profile-integration/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>The host's concrete business semantics.</li> <li>The final landing of host apply (currently outside Foundation's scope).</li> </ul>"},{"location":"en/recipes/host-profile-integration/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The host-access line supports only describe/build/probe/plan; apply is stably refused, and install/uninstall/update are unimplemented.</li> <li>The full Qoder driver is unsupported; only its structure is referenced, and it is not claimed to have been run on Qoder; adding a supported host on upgrade requires registering a descriptor and binding a trusted driver.</li> </ul>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/","title":"English \u00b7 Safe filesystem and atomic write","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#Recipe-Safe-File-Access-and-Atomic-Write","title":"Recipe: Safe File Access and Atomic Write","text":""},{"location":"en/recipes/safe-filesystem-and-atomic-write/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to constrain, within Node, an externally-provided path to within some root directory, and atomically write an ordinary file to a contained path, rolling back on failure without leaving residue.</p> <p>Not applicable: needs to put file-selection business rules into Foundation (business rules are owned by the caller); needs to write to an uncontained path.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.harness.path-containment</code> (path classification and contained resolution) and <code>foundation.harness.atomic-write</code> (atomic write within contained paths). Both implement only the mechanism, owning no semantics.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The caller provides an explicit root directory (containment boundary).</li> <li>Trust boundary: all resolution results must fall within the root directory; out-of-bounds, symlink escape, and realpath escape are all refused.</li> </ul>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { resolveContained, writeFileAtomic } from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-safe-\"));\nconst target = resolveContained(root, \"nested/config.json\"); // contained absolute path\nawait writeFileAtomic(target, JSON.stringify({ ok: true }));\n</code></pre> <p>The code above shows the basic order of first containing the path, then atomically writing; <code>writeFileAtomic</code> uses temp-file + fsync + rename, rolling back on failure.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>resolveContained</code> returns an absolute path within the root; <code>writeFileAtomic</code> writes the completed file, whose bytes are consistent with the input. Evidence: <code>packages/skill-family-harness-node/test/containment.test.mjs</code> and <code>test/atomic.test.mjs</code>.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: attempting to escape the root -> SFC2004 (path-traversal)\nimport { resolveContained } from \"skill-family-harness-node\";\nresolveContained(root, \"../escape.json\"); // throws HarnessError, details.kind = \"path-traversal\"\n</code></pre> <p>Out-of-bounds, symlink-escape, and realpath-escape all map to <code>SFC2004</code> with a stable <code>details.kind</code>; atomic write throws on an out-of-bounds path or illegal data type and rolls back the temp file.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/containment.test.mjs \\\n packages/skill-family-harness-node/test/atomic.test.mjs\n</code></pre>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Which paths are business-allowed selection rules (not within Foundation).</li> <li>The business correctness of the written content.</li> </ul>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>Path containment and atomic write are contained mechanisms; on failure they roll back without leaving half-products, so no external rollback is needed.</li> <li>Upgrade follows the <code>skill-family-harness-node</code> version; <code>HARNESS_EXCLUSIONS</code> introduces no remote or git writes.</li> </ul>"},{"location":"en/reference/compatibility/","title":"English \u00b7 Compatibility","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/reference/compatibility/#Compatibility-and-Support-Matrix","title":"Compatibility and Support Matrix","text":"<p>This page gives the support matrix and upgrade rules for packages, Contracts, Node, and hosts. All version numbers are recomputed from the machine source of truth, not from memory.</p>"},{"location":"en/reference/compatibility/#Package-Version-Matrix","title":"Package Version Matrix","text":"Package Version (package.json) Role Release status <code>skill-family-contracts</code> 0.3.0 Contracts 1.4.0 machine contracts Public release target (private: false) <code>skill-family-harness-node</code> 0.3.0 Node thin-mechanism runtime of Contracts Public release target <code>skill-family-engineering-kit</code> 0.3.0 Four engineering commands (CLI <code>skill-family-kit</code>) Public release target Workspace repository 0.3.0 Private parent workspace (private: true) Development source of truth only <p>The contract authority version (<code>CONTRACTS_VERSION</code>) is <code>1.4.0</code>, and the npm package version is <code>0.3.0</code>; the two version lines run in parallel and are not mixed.</p>"},{"location":"en/reference/compatibility/#Quickstart-Profile-Candidate-Compatibility","title":"Quickstart Profile Candidate Compatibility","text":"Package version Candidate profile Compatibility rule 0.2.1 v1 Existing integrations may remain pinned to exactly 0.2.1 0.3.0 v2 Uses <code>execute-method</code>, real <code>$id</code> schema resolution, and the offline Bundle; pin exactly 0.3.0 <p>Version 2 replaces v1 and provides no dual-track compatibility layer. Stable Contracts 1.4.0, the 18 object classes, the kernel protocol, and the error-code registry do not change with the candidate profile.</p>"},{"location":"en/reference/compatibility/#Node-Support-Matrix","title":"Node Support Matrix","text":"<ul> <li>Engine requirement: <code>>=22.22.2 <23</code> (major 22 locked).</li> <li>Exact floor: <code>.node-version</code> takes <code>22.22.2</code>, as the mechanical source of truth for runtime version determination.</li> <li>pnpm: <code>10.30.0</code> (the <code>packageManager</code> in <code>package.json</code>).</li> <li>projen: <code>0.101.23</code> (the sole generation entry point for managed engineering files).</li> </ul> <p>A Node version below the floor cannot substitute for the authoritative result; first-version implementations in a second language: 0.</p>"},{"location":"en/reference/compatibility/#Contracts-Version-and-Stability","title":"Contracts Version and Stability","text":"<ul> <li>Top-level objects: 18 kinds (with <code>packages/skill-family-contracts/src/registry.json</code> as the sole source of truth).</li> <li>Mandatory mechanical rules: 9, budget ceiling 20, absolute ceiling 30.</li> <li>kernel protocol: <code>skill-family.kernel.operation</code> (stable), Contracts 1.4.0.</li> <li>Schema validator: Ajv 8.20.0 (exact pin), supporting draft-07 and 2020-12.</li> <li>Error codes: a frozen registry; codes only increase, never change or get reused.</li> </ul>"},{"location":"en/reference/compatibility/#Host-Support-Matrix","title":"Host Support Matrix","text":"Host support driver Notes claude supported claude-version-v1 Skill path is determined by the Profile codex supported codex-version-v1 Skill path fixed at <code>.agents/skills</code> qoder unsupported none No auditable non-interactive host driver is frozen <p>The host-access line currently supports only <code>describe</code>/<code>build</code>/<code>probe</code>/<code>plan</code>; <code>apply</code> is stably refused, and install/uninstall/update are unimplemented.</p>"},{"location":"en/reference/compatibility/#Upgrade-Rules","title":"Upgrade Rules","text":"<ul> <li>Package version: the three leaf packages must synchronize versions; single-package drift is forbidden; a new component must justify that deleting it would force two or more real consumers to re-implement it.</li> <li>Contracts: the object set is fixed at 18 kinds; additions require an ADR; error codes are frozen and do not drift; Schema changes are handled as a new contract-version task.</li> <li>Kit commands: top-level commands are fixed at 4 (scaffold/adopt-plan/projection/check), not expanded; <code>REFUSED_MUTATION_FLAGS</code> are refused at the CLI entry point.</li> <li>Node/pnpm/projen: follow the exact locks in <code>.foundation/version-lock.json</code> and <code>package.json</code>; upgrades require re-generating the managed projection via <code>pnpm synth</code>.</li> <li>Host: adding a supported host requires registering a descriptor and binding a trusted driver; unsupported hosts (e.g., qoder) are only referenced structurally and not claimed to have been run on.</li> <li>Candidate: a later minor version may change or remove a candidate subpath; do not mix the 0.2.1 v1 packages with the 0.3.0 v2 packages, and pin all three package versions exactly.</li> </ul>"},{"location":"en/reference/compatibility/#Anti-Compatibility-Boundaries-Explicitly-Unsupported","title":"Anti-Compatibility Boundaries (Explicitly Unsupported)","text":"<ul> <li>host apply / install / update / uninstall (unsupported).</li> <li>Full Qoder driver (unsupported).</li> <li>Binary adapter source (text closure only).</li> <li>Remote publishing and all remote writes (\u2192 release-skill).</li> <li>Business state machine, model orchestration, domain-audit semantics (\u2192 consumer / loop-agent / independent audit respectively).</li> </ul>"},{"location":"en/reference/failure-and-side-effect-matrix/","title":"English \u00b7 Failures and side effects","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Failure-and-Side-Effect-Matrix","title":"Failure and Side-Effect Matrix","text":"<p>This page lists, per public entry point, read/write, spawn, Git, network, residual state, and stable error codes. It serves callers judging risk before integrating, and is the human-readable projection of the <code>sideEffects</code> and <code>failureSemantics</code> fields in <code>capability-catalog.json</code>. All facts are based on the real implementation and negative tests.</p> <p>Symbol convention: read = reads the filesystem; write = writes the filesystem; spawn = launches a subprocess; Git = reads/writes Git; network = accesses a remote; residual = state still left on disk/in-process after the call ends.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Contracts-Pure-Function-Layer","title":"Contracts (Pure-Function Layer)","text":"Entry read write spawn Git network residual state stable error code <code>validateDocument</code> no no no no no none (compile cache memory-resident only) <code>SFC1001</code>/<code>SFC1002</code>/<code>SFC1006</code> <code>compileSchema</code> / <code>detectDialect</code> no no no no no none <code>SFC1006</code>/<code>SFC1012</code> <code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code> no no no no no none <code>SFC1003</code>/<code>SFC1004</code> <code>runChecks</code> / <code>collectUnresolvedRefs</code> no no no no no none <code>SFC1002</code>\u2013<code>SFC1010</code> <code>verifyAllFixtures</code> / <code>verifyFixture</code> no no no? no no no none <code>SFC1010</code> <code>ERROR_CODES</code> / <code>stableError</code> no no no no no none frozen registry, no additions <p>Contracts are all pure functions, with no file/Git/network/process side effects; error objects contain <code>stableError</code> and <code>details.kind</code> for easy caller classification.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Harness-Mechanism-Layer-Contained","title":"Harness (Mechanism Layer, Contained)","text":"Entry read write spawn Git network residual state stable error code <code>validateContractDocument</code> no no no no no none (validator cache in memory) <code>SFC</code> validation failure <code>resolveContained</code> / <code>readFileContained</code> yes (read-only) no no no no none <code>SFC2004</code> (<code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>) <code>writeFileAtomic</code> no yes (contained) no no no failed rollback temp file <code>SFC2004</code> (<code>atomic-write-failed</code>) <code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code> no yes (temp directory) no no no temp directory cleaned on exit <code>SFC2004</code> (<code>workspace-disposed</code>) <code>computeResourceClosure</code> / <code>digestBytes</code> no no no no no none <code>SFC</code> (declaration/content violation) <code>parseRequest</code> / <code>processRequest</code> no no no no no none (pure-function pipeline) <code>SFC2004</code> <code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>checkReport</code> no no no no no none (pure function) <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code> no no no no no none <code>SFC2004</code> (<code>missing-resource</code>) <code>materializeAdapterBuild</code> no yes (contained, sibling + rename) no no no none (atomic rename) <code>SFC2004</code> <code>probeVersionVector</code> no no default no (requires explicit <code>--allow-host-spawn</code>) no no none <code>SFC2004</code> <code>openStateStore</code> / <code>appendEvent</code> / <code>readEvents</code> / <code>writeSnapshot</code> yes yes (event/snapshot/lock files) no no no event log + lock file <code>SFC2004</code> (<code>store-locked</code>/chain broken) <code>inspectStateStoreLock</code> / <code>recoverStateStoreLock</code> yes yes (recovery write-lock only) no no no lock file (monotonic fencing) <code>SFC2004</code> <p>Harness's <code>HARNESS_EXCLUSIONS</code> explicitly excludes release-state, remote-network-access, business-semantics, workflow-orchestration, model-calls, git-writes.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Engineering-Kit-Engineering-Command-Layer","title":"Engineering Kit (Engineering Command Layer)","text":"Entry read write spawn Git network residual state stable error code / exit code <code>scaffoldTarget</code> no yes (contained skeleton, atomic + contained) no no no none (no half-product on failure) <code>SFC2004</code> (<code>target-not-empty</code>) <code>planAdoption</code> / <code>buildHandoffDraft</code> yes no no read-only probe no none (stdout output) <code>SFC</code> completion false <code>runProjection</code> yes (reads manifest) yes (managed path, two-phase) no no no none (zero write/rollback on failure) <code>SFC2004</code> (<code>unauthorized-path</code>/<code>handwritten-overwrite</code>/<code>conflict-drift</code>) <code>runChecks</code> (<code>check</code>) yes no no read-only allowlist no none exit code 1 (findings) / 2 (mechanism) <code>renderReportAction</code> / <code>checkReportAction</code> yes only <code>--out</code>/<code>--binding</code> no no no default stdout only <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>probeGitState</code> / <code>probeGitFacts</code> yes no no read-only allowlist no none <code>SFC</code> (over-privileged parameter refused) <code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code> yes build writes (contained) probe default no no no none <code>SFC2004</code>; apply stably refused <code>loadLicensingProfile</code> / <code>generateLicenseContent</code> etc. no no (pure-function generation) no no no none <code>SFC</code> (illegal Profile) <code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code> yes no no no no none findings <code>cliMain</code> / <code>runCommand</code> per command per command per command per command no per command exit code 0/1/2 <p>Kit's <code>FORBIDDEN_SIDE_EFFECTS</code> includes git-init/commit/push/tag, publish, remote-write; <code>REFUSED_MUTATION_FLAGS</code> (including <code>--apply</code>) are refused at the CLI entry point.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Residual-State-Collection","title":"Residual-State Collection","text":"<ul> <li>Atomic write: on failure, rolls back the temp file, leaving no half-product in the target directory.</li> <li>Temporary workspaces are cleaned on exit, including exception paths.</li> <li>State store: the event log is the sole authority, and the snapshot is a derived cache; a crash-left lock requires the caller, outside Foundation, to confirm the old writer has terminated before explicitly recovering; no silent lock-stealing.</li> <li>Projection: any validation failure rejects wholesale, zero writes; overwriting an existing file requires declaring the <code>expect.sha256</code> pre-state.</li> <li>adopt-plan / check: structurally read-only, byte-level zero change before and after running.</li> </ul>"},{"location":"en/reference/failure-and-side-effect-matrix/#What-the-Caller-Should-Do-After-Failure","title":"What the Caller Should Do After Failure","text":"<ul> <li>Validation failure (<code>SFC1001</code>/<code>SFC2002</code>/<code>SFC2003</code>): check whether the input satisfies the target Schema or parameter contract; do not retry a registration that has been frozen-refused.</li> <li>Containment failure (<code>SFC2004</code> + <code>path-traversal</code>, etc.): confirm whether the root directory and path are out of bounds; do not cram business-selection rules into Foundation.</li> <li>State-lock conflict (<code>store-locked</code>): outside Foundation, confirm the old writer has terminated, then call recovery with the exactly-matching owner/fencing.</li> <li>check findings (exit code 1): address the findings; Kit does not auto-fix.</li> </ul>"},{"location":"en/reference/api/","title":"English \u00b7 API reference","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/reference/api/#Public-API-Reference","title":"Public API Reference","text":"<p>This page is the English entry point for the public APIs of the three Foundation packages. It is a human-readable route into the machine facts in the capability catalog; package exports, schemas, protocols, and stable error codes remain authoritative.</p>"},{"location":"en/reference/api/#Choose-the-Owning-Layer","title":"Choose the Owning Layer","text":"Package Use it for Start with <code>skill-family-contracts</code> Object schemas, protocol registries, validation, stable error codes, fixtures, and deterministic audit surfaces <code>foundation.contracts.object-validation</code>, <code>foundation.contracts.registry-protocol</code>, <code>foundation.contracts.audit-surface</code> <code>skill-family-harness-node</code> Business-neutral Node mechanisms such as contained paths, atomic writes, subprocess requests, durable local state, and deterministic reports <code>foundation.harness.path-containment</code>, <code>foundation.harness.atomic-write</code>, <code>foundation.harness.state-store</code>, <code>foundation.harness.report</code> <code>skill-family-engineering-kit</code> The four engineering commands and controlled host/Profile integration <code>foundation.kit.scaffold</code>, <code>foundation.kit.adopt-plan</code>, <code>foundation.kit.projection</code>, <code>foundation.kit.check</code>, <code>foundation.kit.host-integration</code> <p>The dependency direction is Contracts \u2192 Harness \u2192 Engineering Kit. A Profile declares host or project-shape differences horizontally; public core code does not depend on a concrete Profile.</p>"},{"location":"en/reference/api/#Verified-Capability-Details","title":"Verified Capability Details","text":"<p>Use the following public data files before selecting an entry point:</p> <ol> <li>Core capability facts contain stable IDs, packages, layers, entry points, stability, source references, and test references.</li> <li>English capability explanations add intent, use and non-use conditions, inputs, outputs, failure semantics, caller ownership, and external routing for the same IDs.</li> <li>Catalog schema defines the closed structure of both files.</li> </ol> <p>The failure and side-effect matrix compares filesystem, process, Git, network, residual-state, and error behavior across public entry points. The architecture routing guide starts from design intent when the package or capability is not yet known.</p>"},{"location":"en/reference/api/#Key-Failure-Rules","title":"Key Failure Rules","text":"<ul> <li>Contracts document validation returns <code>{ valid: false, errorCode, errors }</code> for ordinary validation failures. Callers inspect <code>valid</code>; <code>validateDocument</code> does not turn those failures into exceptions.</li> <li>Harness mechanism failures use <code>SFC2004</code> (<code>EXECUTION_FAILED</code>) and distinguish the failure with a frozen <code>details.kind</code> value.</li> <li>Engineering Kit keeps exactly four top-level commands: <code>scaffold</code>, <code>adopt-plan</code>, <code>projection</code>, and <code>check</code>. Each command retains its documented read-only or controlled-write boundary.</li> <li>Candidate capabilities are marked <code>stability: candidate</code> in the catalog. Their presence in the public package does not promote them to the stable surface.</li> </ul>"},{"location":"en/reference/api/#Quickstart-Profile-v2-Candidate","title":"Quickstart Profile v2 Candidate","text":"<p>All three packages expose v2 through their existing candidate subpaths. Contracts defines the business-neutral <code>execute-method</code> exchange, Harness verifies bytes and bindings, and Kit turns explicit consumer schemas into an offline Bundle with standalone validators selected by schema <code>$id</code>. Version 0.3.0 candidate v2 is incompatible with the 0.2.1 candidate v1; consumers must pin the selected package versions exactly.</p>"},{"location":"en/reference/api/#Detailed-Package-Pages","title":"Detailed Package Pages","text":"<p>The current signature-level package pages are maintained in Chinese because they enumerate every verified export and test reference:</p> <ul> <li>Contracts API details</li> <li>Harness API details</li> <li>Engineering Kit API details</li> </ul> <p>These pages are part of the same public site and link to source and test evidence. The English catalog overlay provides the complete English intent and failure semantics for every capability, so an agent can route and design against Foundation without inferring meaning from the Chinese prose.</p>"},{"location":"en/reference/api/#Boundary","title":"Boundary","text":"<p>Foundation does not own domain schemas, business state machines, audit conclusions, task/retry orchestration, artifact relationships, or remote publishing. Keep those semantics with the caller, or route them to the external project named by the capability catalog.</p>"},{"location":"integration/audit/","title":"\u72ec\u7acb\u5ba1\u8ba1\u96c6\u6210\uff08FND-060\uff09","text":"<p>\u672c\u76ee\u5f55\u662f\u72ec\u7acb\u5ba1\u8ba1\uff08Audit\uff09\u6d88\u8d39\u5df2\u53d1\u5e03 Contracts \u7684\u6700\u5c0f\u96c6\u6210\u9762\u3002\u5ba1\u8ba1\u7684\u804c\u8d23\u662f\uff1a\u4ee5\u72ec\u7acb\u4e8e\u751f\u6210\u5668\u4e0e oracle \u7684 fixture\u3001\u9884\u671f\u503c\u548c\u88c1\u51b3\uff0c\u9a8c\u8bc1\u88ab\u6d88\u8d39\u7684 <code>skill-family-contracts</code> \u5305\u6ca1\u6709\u88ab\u7be1\u6539\u3001\u524a\u5f31\u6216\u6f0f\u68c0\u3002</p>"},{"location":"integration/audit/#\u6743\u5a01\u8fb9\u754c","title":"\u6743\u5a01\u8fb9\u754c","text":"<ul> <li>\u5ba1\u8ba1\u53ea\u6d88\u8d39 Contracts \u7684\u516c\u5f00\u63a5\u53e3\uff08<code>describeAuditSurface</code>\u3001<code>validateDocument</code>\u3001<code>checkOperation</code>\u3001<code>findProtocol</code>\u3001<code>isRegisteredErrorCode</code>\u3001<code>digestDocument</code> \u7b49\uff09\uff0c\u4f9d\u8d56\u65b9\u5411\u6052\u4e3a Audit \u2192 Contracts\uff1b</li> <li>\u5ba1\u8ba1\u4e0d\u4f9d\u8d56 engineering-kit\uff0c\u4e5f\u4e0d\u4f9d\u8d56 harness\uff08\u89c1 independence.md \u7684\u673a\u68b0\u8bc1\u660e\uff09\uff1b</li> <li>Contracts \u4e0d\u53cd\u5411\u4f9d\u8d56\u5ba1\u8ba1\uff1aContracts \u4fa7\u53ea\u65b0\u589e\u4e86\u53ea\u8bfb\u6295\u5f71\u6a21\u5757 <code>src/audit-surface.mjs</code>\uff0c\u4e0d\u63a5\u53d7\u4efb\u4f55\u56de\u8c03\u3001\u6ce8\u518c\u6216\u5ba1\u8ba1\u4fa7\u8f93\u5165\uff1b</li> <li>\u5ba1\u8ba1 fixture\u3001\u9884\u671f\u4e0e\u88c1\u51b3\u5168\u90e8\u7531\u4ea7\u54c1\u4fa7\u7ef4\u62a4\uff08\u5939\u5177 provenance <code>product-fixture</code>\uff0cpin provenance <code>product-compatibility-fixture</code>\uff09\uff0c\u4e0d\u590d\u7528\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\uff0c\u4e5f\u4e0d\u8bfb\u53d6 oracle \u5224\u636e\uff08\u8be5\u9694\u79bb\u7531 independence.md \u7684\u673a\u68b0\u8bc1\u660e\u5f3a\u5236\uff09\u3002</li> </ul>"},{"location":"integration/audit/#\u76ee\u5f55\u7ed3\u6784","title":"\u76ee\u5f55\u7ed3\u6784","text":"<pre><code>docs/integration/audit/\n README.md \u672c\u6587\u4ef6\n mutation-taxonomy.md \u4e94\u7c7b\u53d8\u5f02\u5206\u7c7b\u5b66\uff08\u51bb\u7ed3\uff09\n failure-evidence.md \u5931\u8d25\u8bc1\u636e\u683c\u5f0f\u4e0e AUD \u7801\u767b\u8bb0\u8868\n version-compatibility.md \u7248\u672c\u517c\u5bb9\u5b9a\u4e49\n isolation-and-lockfile.md \u9694\u79bb\u5b89\u88c5\u4e0e\u5305\u9501\u9a8c\u8bc1\u8bbe\u8ba1\n independence.md \u72ec\u7acb\u6027\u58f0\u660e\u4e0e\u673a\u68b0\u8bc1\u660e\n schemas/audit-evidence.schema.json \u8bc1\u636e\u6587\u6863\u7684 JSON Schema\uff08\u5ba1\u8ba1\u81ea\u6709\uff09\n baseline/contracts-1.4.0.pin.json Contracts 1.4.0 \u73b0\u884c\u57fa\u7ebf pin\uff08\u6458\u8981+\u4e8b\u5b9e\uff09\n baseline/contracts-1.1.1.pin.json Contracts 1.1.1 \u53ea\u8bfb\u517c\u5bb9\u5b58\u6863 pin\n baseline/contracts-1.1.0.pin.json Contracts 1.1.0 \u53ea\u8bfb\u517c\u5bb9\u5b58\u6863 pin\n baseline/contracts-1.0.0.pin.json Contracts 1.0.0 \u53ea\u8bfb\u517c\u5bb9\u5b58\u6863 pin\n baseline/audit-codes.json AUD \u7801\u767b\u8bb0\u8868\uff08append-only\uff09\n fixtures/{structure,semantics,digest,omission,engine}/ 18 \u4e2a\u53d8\u5f02 fixture\n runner/ \u5ba1\u8ba1\u8fd0\u884c\u5668\uff08\u53ea\u8bfb\uff0c\u8bc1\u636e\u8f93\u51fa\u5230 stdout\uff09\n</code></pre>"},{"location":"integration/audit/#\u8fd0\u884c","title":"\u8fd0\u884c","text":"<pre><code># \u5b8c\u6574\u7ba1\u7ebf\uff1a\u72ec\u7acb\u6027\u8bc1\u660e \u2192 \u5305\u9501\u9a8c\u8bc1 \u2192 \u53d8\u5f02\u91cd\u653e \u2192 \u6f0f\u62a5\u8d1f\u4f8b\u81ea\u68c0\nnode docs/integration/audit/runner/run-all.mjs\n\n# \u5206\u6b65\u8fd0\u884c\nnode docs/integration/audit/runner/proof-independence.mjs # \u72ec\u7acb\u6027\u673a\u68b0\u8bc1\u660e\nnode docs/integration/audit/runner/verify-lock.mjs # \u6d88\u8d39\u5305 pin/\u9501\u9a8c\u8bc1\nnode docs/integration/audit/runner/run-audit.mjs # \u53d8\u5f02\u91cd\u653e + \u8bc1\u636e\nnode docs/integration/audit/runner/selftest-negative.mjs # \u6f0f\u62a5\u8d1f\u4f8b\u63a7\u5236\n</code></pre> <p>\u9000\u51fa\u7801\u7ea6\u5b9a\uff1a<code>0</code> \u901a\u8fc7\uff1b<code>1</code> \u6709\u53d1\u73b0\uff08verdict fail\uff09\uff1b<code>2</code> \u7528\u6cd5\u6216\u673a\u5236\u9519\u8bef\u3002\u6240\u6709\u62a5\u544a\u4ee5 JSON \u8f93\u51fa\u5230 stdout\uff0c\u8fd0\u884c\u5668\u5bf9\u4ed3\u5e93\u96f6\u5199\u5165\u3002</p>"},{"location":"integration/audit/#\u88c1\u51b3\u89c4\u5219","title":"\u88c1\u51b3\u89c4\u5219","text":"<ul> <li>\u4e94\u7c7b\u53d8\u5f02\uff08\u7ed3\u6784\u3001\u8bed\u4e49\u3001\u6458\u8981\u3001\u9057\u6f0f\u3001\u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31\uff09\u6bcf\u7c7b\u81f3\u5c11 3 \u4e2a fixture\uff0c\u4e14\u81f3\u5c11\u68c0\u51fa 1 \u4e2a\uff1b</li> <li>\u4efb\u4e00\u7c7b\u6f0f\u62a5\u5373\u5931\u8d25\uff1a\u8986\u76d6\u95e8\uff08AUD-MISS-001\uff09\u673a\u68b0\u5f3a\u5236\uff0c\u6f0f\u62a5\u7c7b\u7684\u5b58\u5728\u4f7f\u6574\u4f53 verdict \u5fc5\u4e3a fail\uff1b</li> <li>\u4efb\u4e00 fixture \u672a\u88ab\u5982\u9884\u671f\u68c0\u51fa\u3001\u57fa\u7ebf pin \u6f02\u79fb\u3001fixture \u4fe1\u5c01\u4e0d\u5408\u6cd5\uff0c\u90fd\u4ea7\u751f mandatory \u7ea7\u53d1\u73b0\u5e76\u4f7f verdict fail\u3002</li> </ul>"},{"location":"integration/audit/failure-evidence/","title":"\u5931\u8d25\u8bc1\u636e\u683c\u5f0f\u4e0e AUD \u7801\u767b\u8bb0\u8868","text":"<p>\u5ba1\u8ba1\u53d1\u73b0\u5fc5\u987b\u4ee5\u673a\u5668\u53ef\u8bfb\u7684\u8bc1\u636e\u6587\u6863\u8bb0\u5f55\u3002\u8bc1\u636e\u6587\u6863\u7531 <code>runner/run-audit.mjs</code> \u8f93\u51fa\u5230 stdout\uff0c\u683c\u5f0f\u7531 schemas/audit-evidence.schema.json \u51bb\u7ed3\uff0c\u5e76\u901a\u8fc7\u88ab\u6d88\u8d39 Contracts \u7684 <code>validateDocument</code>\uff082020-12 \u65b9\u8a00\u3001strict \u7b56\u7565\uff09\u81ea\u6821\u9a8c\u2014\u2014\u8bc1\u636e\u6587\u6863\u672c\u8eab\u4e0d\u5408\u683c\u662f\u673a\u5236\u9519\u8bef\uff08\u9000\u51fa\u7801 2\uff09\u3002</p>"},{"location":"integration/audit/failure-evidence/#\u8bc1\u636e\u6587\u6863\u5f62\u72b6","title":"\u8bc1\u636e\u6587\u6863\u5f62\u72b6","text":"<pre><code>{\n \"schemaVersion\": 1,\n \"kind\": \"skill-family.audit.evidence\",\n \"auditId\": \"fnd-060-independent-audit\",\n \"generatedAt\": \"RFC 3339 date-time\",\n \"consumer\": {\n \"contractsVersion\": \"1.0.0\",\n \"auditSurfaceVersion\": 1,\n \"surfaceDigest\": { \"algorithm\": \"sha256\", \"value\": \"64 \u4f4d\u5341\u516d\u8fdb\u5236\" }\n },\n \"verdict\": \"pass \| fail\",\n \"classCoverage\": {\n \"<class>\": { \"fixtures\": 0, \"detected\": 0, \"required\": 3, \"satisfied\": false }\n },\n \"fixtureResults\": [\n { \"fixtureId\": \"AUD-M1-01\", \"mutationClass\": \"structure\", \"expectedAuditCode\": \"AUD-M1-STRUCT\", \"detected\": true, \"observed\": {} }\n ],\n \"findings\": [\n {\n \"findingId\": \"F-0001\",\n \"auditCode\": \"AUD-BASE-001\",\n \"severity\": \"mandatory\",\n \"mutationClass\": null,\n \"fixtureId\": null,\n \"detected\": true,\n \"summary\": \"\u4eba\u7c7b\u53ef\u8bfb\u6458\u8981\",\n \"details\": {}\n }\n ]\n}\n</code></pre> <p>\u8981\u70b9\uff1a</p> <ul> <li><code>consumer</code> \u7528\u7248\u672c\u5750\u6807 + surface \u6458\u8981\u9489\u6b7b\u88ab\u6d88\u8d39\u7684 Contracts \u5305\uff0c\u8bc1\u636e\u56e0\u6b64\u53ef\u56de\u6eaf\u5230\u7cbe\u786e\u5b57\u8282\uff1b</li> <li><code>fixtureResults</code> \u662f\u5168\u90e8 fixture \u7684\u91cd\u653e\u8bb0\u5f55\uff08\u542b\u901a\u8fc7\u9879\uff09\uff0c<code>findings</code> \u53ea\u6536\u8fdd\u89c4\u9879\uff1b</li> <li>v1 \u51bb\u7ed3\u5355\u4e00\u4e25\u91cd\u7ea7 <code>mandatory</code>\uff1a\u4efb\u4f55\u53d1\u73b0\u90fd\u4f7f <code>verdict</code> \u4e3a <code>fail</code>\uff1b</li> <li><code>classCoverage</code> \u4e94\u7c7b\u9f50\u5168\uff1b<code>satisfied = fixtures \u2265 3 \u4e14 detected \u2265 1</code>\u3002</li> </ul>"},{"location":"integration/audit/failure-evidence/#\u88c1\u51b3\u89c4\u5219","title":"\u88c1\u51b3\u89c4\u5219","text":"<ol> <li><code>findings</code> \u4e3a\u7a7a \u2192 <code>verdict = pass</code>\uff0c\u9000\u51fa\u7801 0\uff1b</li> <li>\u4efb\u4e00\u53d1\u73b0\u5b58\u5728 \u2192 <code>verdict = fail</code>\uff0c\u9000\u51fa\u7801 1\uff1b</li> <li>\u7528\u6cd5\u6216\u673a\u5236\u9519\u8bef\uff08\u542b\u8bc1\u636e\u81ea\u6821\u9a8c\u5931\u8d25\uff09\u2192 \u9000\u51fa\u7801 2\uff0c\u4e0d\u4ea7\u751f\u8bc1\u636e\u6216\u4ea7\u751f\u4f5c\u5e9f\u8bc1\u636e\uff1b</li> <li>\u6f0f\u62a5\u5f8b\uff1a\u4efb\u4e00\u7c7b <code>satisfied = false</code> \u5fc5\u987b\u4ea7\u751f AUD-MISS-001 \u53d1\u73b0\uff0c\u6574\u4f53 verdict \u5fc5\u4e3a fail\u3002</li> </ol>"},{"location":"integration/audit/failure-evidence/#AUD-\u7801\u767b\u8bb0\u8868append-only","title":"AUD \u7801\u767b\u8bb0\u8868\uff08append-only\uff09","text":"<p>\u5ba1\u8ba1\u7801\u5c5e\u4e8e\u5ba1\u8ba1\u81ea\u6709\u547d\u540d\u7a7a\u95f4 <code>AUD-</code>\uff0c\u4e0d\u8fdb\u5165 Contracts \u7684 SFC \u767b\u8bb0\uff1b\u5ba1\u8ba1\u5bf9 SFC \u7801\u53ea\u8bfb\u6d88\u8d39\u3002\u673a\u5668\u53ef\u8bfb\u526f\u672c\u89c1 baseline/audit-codes.json\u3002</p> \u7801 \u540d\u79f0 \u542b\u4e49 AUD-M1-STRUCT STRUCTURE_MUTATION_DETECTED \u7ed3\u6784\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u89c2\u5bdf\u7801\u7b49\u4e8e\u9884\u671f\u7a33\u5b9a\u7801\uff09 AUD-M2-SEM SEMANTIC_MUTATION_DETECTED \u8bed\u4e49\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa AUD-M3-DIGEST DIGEST_MISMATCH_DETECTED \u6458\u8981\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u89c4\u8303\u5316\u6458\u8981\u4e0e pin \u4e0d\u4e00\u81f4\uff09 AUD-M4-OMIT OMISSION_DETECTED \u9057\u6f0f\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u7f3a\u5931\u6e05\u5355\u4e0e\u9884\u671f\u4e00\u81f4\uff09 AUD-M5-ENGINE ENGINE_WEAKENING_DETECTED \u5f15\u64ce\u524a\u5f31\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u88ab\u524a\u5f31\u5b57\u6bb5\u4e0e\u9884\u671f\u4e00\u81f4\uff09 AUD-MISS-001 MUTATION_CLASS_MISSED \u67d0\u7c7b fixture \u6570\u4f4e\u4e8e\u51bb\u7ed3\u4e0b\u9650\u6216\u96f6\u68c0\u51fa\uff1b\u6f0f\u62a5\u5373\u6574\u4f53\u5931\u8d25 AUD-BASE-001 BASELINE_DRIFT \u6d88\u8d39\u7684 Contracts \u6d3b\u8dc3 surface \u4e0e\u51bb\u7ed3\u57fa\u7ebf pin \u4e0d\u4e00\u81f4 AUD-FMT-001 EVIDENCE_OR_FIXTURE_FORMAT_INVALID fixture \u4fe1\u5c01\u6216\u8bc1\u636e\u6587\u6863\u683c\u5f0f\u975e\u6cd5 AUD-LOCK-001 LOCK_VERIFICATION_FAILED \u6d88\u8d39\u5305\u7684\u8eab\u4efd\u3001\u4f9d\u8d56\u95ed\u5305\u6216 pin \u5bf9\u6bd4\u5931\u8d25 AUD-IND-001 INDEPENDENCE_VIOLATION \u5ba1\u8ba1\u8bfb\u53d6\u6216\u5bfc\u5165\u8d8a\u51fa\u5141\u8bb8\u96c6\u5408 <p>\u767b\u8bb0\u7eaa\u5f8b\uff1a\u7801\u53ea\u589e\u4e0d\u6539\u4e0d\u590d\u7528\uff1b\u65b0\u589e\u7801\u5fc5\u987b\u540c\u6b65\u66f4\u65b0\u672c\u8868\u4e0e <code>baseline/audit-codes.json</code>\uff0c\u4e14\u4e0d\u5f97\u4e0e SFC \u547d\u540d\u7a7a\u95f4\u4ea7\u751f\u4efb\u4f55\u4ea4\u53c9\u62e5\u6709\u3002</p>"},{"location":"integration/audit/independence/","title":"\u72ec\u7acb\u6027\u58f0\u660e\u4e0e\u673a\u68b0\u8bc1\u660e","text":"<p>FND-060 \u7684\u9a8c\u6536\u8981\u6c42\uff1a\u5ba1\u8ba1 fixture\u3001\u9884\u671f\u503c\u548c\u88c1\u51b3\u4e0d\u6765\u81ea\u751f\u6210\u5668\uff1bAudit \u4e0d\u4f9d\u8d56 Kit\u3002\u672c\u9875\u7684\u73b0\u884c\u4e8b\u5b9e\u662f\uff1a\u672c\u4ed3\u5e93\u4e0d\u5b58\u5728\u72ec\u7acb\u7684\u7b2c\u4e8c\u5ba1\u9605\u4f1a\u8bdd\uff0c\u5ba1\u8ba1\u6811\u662f\u4ea7\u54c1\u4fa7\u7684\u673a\u68b0\u9a8c\u8bc1\u8bbe\u65bd\u3002\u673a\u68b0\u8bc1\u660e\u80fd\u591f\u8bc1\u660e\u7684\u662f\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u4e0e\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\uff1b\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002</p>"},{"location":"integration/audit/independence/#provenance-\u73b0\u884c\u4e8b\u5b9e","title":"provenance \u73b0\u884c\u4e8b\u5b9e","text":"<ul> <li>\u5168\u90e8 18 \u4e2a\u53d8\u5f02 fixture \u7684 provenance \u4e3a <code>product-fixture</code>\uff1a\u4ea7\u54c1\u4fa7\u7ef4\u62a4\u7684\u6d4b\u8bd5\u8bed\u6599\u3002\u9884\u671f\u7531\u4ea7\u54c1\u4fa7\u5bf9\u7167\u5408\u540c\u6587\u6863\u63a8\u5bfc\uff08schema \u7ea6\u675f required/pattern/additionalProperties\u3001\u767b\u8bb0\u8868\u6210\u5458\u8d44\u683c\u3001kernel \u8bcd\u8868\u4e0e params \u5951\u7ea6\u3001\u9519\u8bef\u7801 append-only \u8bed\u4e49\uff09\uff0c\u4e0d\u590d\u7528\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\uff0c\u4e0d\u8bfb\u53d6 oracle \u5224\u636e\uff1b\u8fd9\u4e00\u8f93\u5165\u9694\u79bb\u7531\u4e0b\u65b9 P4/P5/P6 \u673a\u68b0\u5f3a\u5236\u3002</li> <li>\u57fa\u7ebf pin \u7684 provenance \u4e3a <code>product-compatibility-fixture</code>\uff1a\u4ea7\u54c1\u4fa7\u7ef4\u62a4\u7684\u517c\u5bb9\u57fa\u7ebf\u3002\u6458\u8981\u6765\u81ea\u5bf9\u5df2\u51bb\u7ed3\u4ea7\u7269\u7684 <code>digestAuditSurface()</code> \u673a\u68b0\u8ba1\u7b97\uff0c\u4e8b\u5b9e\u6e05\u5355\u76f4\u63a5\u5bf9\u7167\u5408\u540c\u6587\u6863\u63a8\u5bfc\u3002</li> <li>\u5b83\u4eec\u8bc1\u660e\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u548c\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\u3002fixture \u4e0e pin \u80cc\u540e\u7684\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u8fc7\u7a0b\u662f\u5426\u72ec\u7acb\u4e8e\u5176\u4ed6\u9879\u76ee\u53c2\u4e0e\u8005\uff0c\u4e0d\u662f\u4ed3\u5185\u673a\u68b0\u68c0\u67e5\u53ef\u4ee5\u8bc1\u660e\u7684\u5bf9\u8c61\u3002</li> <li>\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\uff1a\u5b9e\u73b0\u8005\u81ea\u6d4b\u4e0e\u672c\u9875\u673a\u68b0\u8bc1\u660e\u90fd\u53ea\u5f62\u6210\u5f85\u5ba1\u8bc1\u636e\uff0c\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002</li> <li>\u8bda\u5b9e\u6027\u7ea0\u9519\uff1a\u65e7 fixture \u4e0e pin \u66fe\u643a\u5e26 <code>independent-r2</code> provenance \u548c\u72ec\u7acb\u4f5c\u8005\u53d9\u4e8b\uff08\u542b\u4f5c\u8005\u9605\u8bfb\u53f2\u58f0\u660e\uff09\uff0c\u4e0e\u672c\u4ed3\u4e8b\u5b9e\u4e0d\u7b26\uff1bprovenance \u5df2\u4fee\u6b63\u4e3a\u4e0a\u8ff0\u5982\u5b9e\u8bcd\u6c47\uff0c\u672c\u9875\u968f\u4e4b\u91cd\u5199\u3002\u7ea0\u9519\u53ea\u89e6\u53ca provenance\u3001note \u4e0e\u6587\u6848\u7b49\u8bda\u5b9e\u6027\u5b57\u6bb5\uff0c\u4e0d\u6539\u53d8\u4efb\u4f55 digest\u3001facts\u3001fixture \u5185\u5bb9\u6216\u673a\u68b0\u8bc1\u660e\u884c\u4e3a\u3002</li> </ul>"},{"location":"integration/audit/independence/#\u673a\u68b0\u8bc1\u660e\u5165\u53e3","title":"\u673a\u68b0\u8bc1\u660e\u5165\u53e3","text":"<pre><code>node docs/integration/audit/runner/proof-independence.mjs\n</code></pre> <p>\u8bc1\u660e\u68c0\u67e5\u4e0e\u7ed3\u8bba\uff1a</p> \u68c0\u67e5 \u7ed3\u8bba P0-modules \u6536\u96c6\u5230\u5168\u90e8\u5ba1\u8ba1\u6a21\u5757\uff08\u8bc1\u660e\u8303\u56f4\u5b8c\u5907\uff09 P1-imports \u5168\u90e8 import \u53ea\u5141\u8bb8 <code>node:</code> \u5185\u5efa\u4e0e\u76f8\u5bf9\u8def\u5f84\uff0c\u4e14\u76f8\u5bf9\u8bf4\u660e\u7b26\u7684\u89e3\u6790\u57df\u88ab\u9650\u5236\u5728\u5ba1\u8ba1\u6811\u6216 contracts \u5305\u5185\uff08\u675c\u7edd\u76f8\u5bf9\u8def\u5f84\u7ed5\u5230\u751f\u6210\u5668/oracle \u6a21\u5757\uff09\uff1b\u7981\u6b62 engineering-kit / harness / \u7b2c\u4e09\u65b9\u5305 \u2192 Audit \u4e0d\u4f9d\u8d56 Kit P2-contracts-site Contracts \u53ea\u5728\u552f\u4e00\u58f0\u660e\u70b9\uff08<code>lib/contracts-client.mjs</code>\uff09\u88ab\u5bfc\u5165 P3-chokepoint \u6587\u4ef6\u8bfb\u53d6\u53ea\u7ecf\u8fc7\u4e24\u4e2a\u58f0\u660e\u8bfb\u53d6\u70b9\uff1a<code>lib/guard.mjs</code>\uff08\u5ba1\u8ba1\u6811\u5185\uff0c\u88c1\u51b3\u8f93\u5165\uff09\u4e0e <code>lib/consumed-package.mjs</code>\uff08\u88ab\u6d88\u8d39\u5305\u6839\u5185\uff0c\u9501\u9a8c\u8bc1\uff09\uff1b\u53ea\u8bfb API\uff1b\u5168\u6811\u65e0\u4efb\u4f55\u5199 API P4-refusal \u73b0\u573a\u62d2\u8bfb\u6f14\u793a\uff1a\u5bf9\u751f\u6210\u5668\u81ea\u6d4b\u8fd0\u884c\u5668\u3001oracle \u5224\u636e\u3001oracle \u8fd0\u884c\u5668\u3001fixture README\u3001profiles\u3001kit \u5165\u53e3\u3001harness \u5165\u53e3\u9010\u4e00\u5c1d\u8bd5\u8bfb\u53d6\uff0c\u5168\u90e8\u88ab guard \u4ee5 AUD-IND-001 \u62d2\u7edd P5-provenance \u5168\u90e8\u53d8\u5f02 fixture \u7684 provenance \u4e3a <code>product-fixture</code>\uff0c\u57fa\u7ebf pin \u7684 provenance \u5728\u58f0\u660e\u8bcd\u6c47\u8868\u5185\uff08\u5f53\u524d\u552f\u4e00\u6210\u5458 <code>product-compatibility-fixture</code>\uff09\uff1b\u4efb\u4f55\u6cbf\u7528\u65e7\u72ec\u7acb\u89d2\u8272 provenance \u8bcd\u6c47\u7684\u5de5\u4ef6\u90fd\u4f1a\u88ab\u5224\u8fdd\u89c4 P6-literals \u9664\u8bc1\u660e\u811a\u672c\u81ea\u8eab\uff08\u62d2\u8bfb\u6f14\u793a\u8005\uff0c\u53d7 P4 \u7ea6\u675f\uff09\u5916\uff0c\u4efb\u4f55\u5ba1\u8ba1\u6a21\u5757\u7684\u5b57\u7b26\u4e32\u5b57\u9762\u91cf\u90fd\u4e0d\u5f97\u70b9\u540d\u751f\u6210\u5668\u81ea\u6d4b\u8868\u6216 oracle \u5224\u636e\u6587\u4ef6 <p>\u63a8\u7406\u94fe\u4e0e\u80fd\u529b\u8fb9\u754c\uff1aP3 \u4fdd\u8bc1\u88c1\u51b3\u8f93\u5165\u53ea\u80fd\u6765\u81ea\u5ba1\u8ba1\u6811\uff1bP4 \u8bc1\u660e\u751f\u6210\u5668/oracle \u5de5\u4ef6\u5728\u8fd0\u884c\u65f6\u4e0d\u53ef\u8bfb\uff1bP6 \u8bc1\u660e\u5176\u6587\u4ef6\u540d\u5728\u4ee3\u7801\u4e2d\u4e0d\u53ef\u5f15\u7528\uff1bP5 \u673a\u68b0\u7981\u6b62\u65e7\u72ec\u7acb\u89d2\u8272 provenance \u8bcd\u6c47\u56de\u6f6e\u3002\u56e0\u6b64\u8fd0\u884c\u65f6\u4e0d\u5b58\u5728\u4efb\u4f55\u628a\u751f\u6210\u5668\u9884\u671f\u53d8\u6210\u5ba1\u8ba1\u5224\u636e\u7684\u8def\u5f84\u2014\u2014\u8fd9\u8bc1\u660e\u7684\u662f\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u3002\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u662f\u5426\u72ec\u7acb\u4e0d\u5728\u673a\u68b0\u8bc1\u660e\u80fd\u529b\u4e4b\u5185\uff0c\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u6700\u7ec8\u63a5\u53d7\u3002</p>"},{"location":"integration/audit/independence/#\u53cd\u5411\u62e5\u6709\u7981\u4ee4","title":"\u53cd\u5411\u62e5\u6709\u7981\u4ee4","text":"<p>Contracts \u4fa7\u65b0\u589e\u7684 <code>src/audit-surface.mjs</code> \u662f\u7eaf\u53ea\u8bfb\u6295\u5f71\uff1a\u4e0d\u63a5\u6536\u56de\u8c03\u3001\u4e0d\u6ce8\u518c\u4efb\u4f55\u4e1c\u897f\u3001\u4e0d import \u4efb\u4f55\u5ba1\u8ba1\u5de5\u4ef6\uff1b<code>packages/skill-family-contracts/test/audit-surface.test.mjs</code> \u542b\u4e00\u6761\u673a\u68b0\u6d4b\u8bd5\uff0c\u65ad\u8a00\u8be5\u6a21\u5757\u7684 import \u5168\u90e8\u4e3a <code>node:</code> \u6216\u672c\u5730\u76f8\u5bf9\u6a21\u5757\uff0c\u4e14\u6e90\u7801\u4e0d\u51fa\u73b0 integration/audit\u3001engineering-kit\u3001harness \u5b57\u6837\u3002\u4f9d\u8d56\u65b9\u5411\u6052\u4e3a Audit \u2192 Contracts\u3002</p>"},{"location":"integration/audit/independence/#\u517c\u5bb9\u6027\u8bc1\u660e\u5165\u53e3","title":"\u517c\u5bb9\u6027\u8bc1\u660e\u5165\u53e3","text":"<p>\u53d8\u5f02\u91cd\u653e\u4e0e\u57fa\u7ebf pin \u7684\u6bd4\u5bf9\uff08\u6458\u8981\u3001\u4e8b\u5b9e\u6e05\u5355\u3001\u5f15\u64ce\u53c2\u6570\u5b8c\u6574\u6027\uff09\u89c1 version-compatibility.md \u4e0e isolation-and-lockfile.md\uff1b\u5206\u7c7b\u5b66\u89c1 mutation-taxonomy.md\u3002pin \u662f\u4ea7\u54c1\u4fa7\u517c\u5bb9\u57fa\u7ebf\uff08<code>product-compatibility-fixture</code>\uff09\uff0c\u8bc1\u660e\u88ab\u6d88\u8d39\u7684 Contracts \u5305\u4e0e\u51bb\u7ed3\u57fa\u7ebf\u5b57\u8282\u4e00\u81f4\u3001\u6821\u9a8c\u8bed\u4e49\u4e00\u81f4\uff0c\u540c\u6837\u4e0d\u4f5c\u4efb\u4f55\u72ec\u7acb\u89d2\u8272\u58f0\u79f0\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/","title":"\u53d8\u5f02\u5206\u7c7b\u5b66\uff08\u51bb\u7ed3\uff09","text":"<p>FND-060 \u51bb\u7ed3\u4e94\u7c7b\u53d8\u5f02\u3002\u6bcf\u4e00\u7c7b\u90fd\u6709\u72ec\u7acb\u7684\u68c0\u6d4b\u673a\u5236\u4e0e\u6bcf\u7c7b \u22653 \u4f8b\u7684\u53d8\u5f02 fixture\uff1bfixture \u4e0e\u9884\u671f\u662f\u4ea7\u54c1\u4fa7\u7ef4\u62a4\u7684\u6d4b\u8bd5\u8bed\u6599\uff08provenance <code>product-fixture</code>\uff0c\u89c1\u4e0b\u65b9 fixture \u4fe1\u5c01\uff09\uff0c\u4e0d\u590d\u7528\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\uff0c\u4e0d\u8bfb\u53d6 oracle \u5224\u636e\uff08\u8be5\u8f93\u5165\u9694\u79bb\u7531 independence.md \u7684\u673a\u68b0\u8bc1\u660e\u5f3a\u5236\uff09\u3002\u5b83\u4eec\u8bc1\u660e\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u548c\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\uff1b\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002\u5206\u7c7b\u96c6\u5408\u662f\u95ed\u5408\u7684\uff1a\u65b0\u589e\u7c7b\u522b\u5c5e\u4e8e\u5ba1\u8ba1\u5206\u7c7b\u5b66\u53d8\u66f4\uff0c\u5fc5\u987b\u8d70\u65b0\u7684\u88c1\u51b3\u5e76\u66f4\u65b0\u672c\u6587\u4ef6\u4e0e <code>runner/lib/paths.mjs</code> \u7684 <code>MUTATION_CLASSES</code>\u3002</p> \u7c7b\u522b \u679a\u4e3e\u503c \u68c0\u6d4b\u673a\u5236 \u6d88\u8d39\u63a5\u53e3 \u5ba1\u8ba1\u7801 \u7ed3\u6784 <code>structure</code> \u4e25\u683c\u65b9\u8a00\u4e0b\u7684 schema \u6821\u9a8c\u62d2\u7edd <code>validateDocument</code>\uff08strict, 2020-12\uff09 AUD-M1-STRUCT \u8bed\u4e49 <code>semantics</code> \u7ed3\u6784\u5408\u6cd5\u4f46\u8fdd\u53cd\u51bb\u7ed3\u8bed\u4e49\uff08\u534f\u8bae\u767b\u8bb0\u3001\u64cd\u4f5c\u8bcd\u8868\u3001params \u5951\u7ea6\u3001\u9519\u8bef\u7801\u6210\u5458\u8d44\u683c\uff09 <code>findProtocol</code>\u3001<code>checkOperation</code>\u3001<code>isRegisteredErrorCode</code> AUD-M2-SEM \u6458\u8981 <code>digest</code> \u89c4\u8303\u5316 JSON \u7684 SHA-256 \u4e0e\u51bb\u7ed3 pin \u4e0d\u4e00\u81f4 <code>digestDocument</code> AUD-M3-DIGEST \u9057\u6f0f <code>omission</code> \u51bb\u7ed3\u5fc5\u5907\u90e8\u4ef6\u7f3a\u5931\uff08\u767b\u8bb0\u3001\u89c4\u5219\u8986\u76d6\u3001\u9519\u8bef\u7801\u6210\u5458\uff09 \u57fa\u7ebf pin \u4e8b\u5b9e\u6e05\u5355\u5bf9\u6bd4 AUD-M4-OMIT \u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31 <code>engine</code> \u5f15\u64ce\u53c2\u6570\u5b8c\u6574\u6027\u5bf9\u6bd4\uff08\u9884\u7b97\u3001\u6821\u9a8c\u7b56\u7565\u3001\u68c0\u67e5\u7c7b\u578b\u95ed\u96c6\u3001\u7a33\u5b9a\u6027\u653f\u7b56\uff09 <code>describeAuditSurface</code> + \u57fa\u7ebf pin AUD-M5-ENGINE"},{"location":"integration/audit/mutation-taxonomy/#\u5404\u7c7b\u522b\u5b9a\u4e49\u4e0e\u5224\u636e","title":"\u5404\u7c7b\u522b\u5b9a\u4e49\u4e0e\u5224\u636e","text":""},{"location":"integration/audit/mutation-taxonomy/#M1-\u7ed3\u6784structure","title":"M1 \u7ed3\u6784\uff08structure\uff09","text":"<p>\u53d8\u5f02\u6539\u53d8\u6587\u6863\u7684\u5f62\u72b6\uff1a\u7f3a\u5fc5\u586b\u6210\u5458\u3001\u7c7b\u578b\u6f02\u79fb\u3001\u672a\u58f0\u660e\u6210\u5458\u3001\u6a21\u5f0f\u8fdd\u89c4\u3002\u5224\u636e\uff1a\u5728 <code>2020-12</code> \u65b9\u8a00\u3001<code>strict</code> \u7b56\u7565\u4e0b\uff0c\u6587\u6863\u5fc5\u987b\u88ab\u62d2\u7edd\uff0c\u4e14\u7a33\u5b9a\u7801\u7b49\u4e8e fixture \u58f0\u660e\u7684 <code>expect.observedErrorCode</code>\uff08\u672c\u7c7b\u5168\u90e8\u4e3a SFC1001\uff09\u3002\u9884\u671f\u7531\u4ea7\u54c1\u4fa7\u5bf9\u7167\u76f8\u5e94 schema \u7684 required/pattern/additionalProperties \u63a8\u5bfc\uff0c\u4e0d\u53d6\u81ea\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\u6216 oracle \u5224\u636e\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#M2-\u8bed\u4e49semantics","title":"M2 \u8bed\u4e49\uff08semantics\uff09","text":"<p>\u53d8\u5f02\u4fdd\u6301 schema \u5408\u6cd5\u6027\uff0c\u4f46\u8fdd\u53cd\u51bb\u7ed3\u7684\u767b\u8bb0\u8bed\u4e49\u3002\u4e09\u4e2a\u8bed\u4e49\u68c0\u67e5\u70b9\uff08fixture \u7528 <code>expect.semanticCheck</code> \u58f0\u660e\uff09\uff1a</p> <ul> <li><code>protocol-registered</code>\uff1a\u534f\u8bae\u540d/\u7248\u672c\u5fc5\u987b\u5728\u767b\u8bb0\u8868\u4e2d\uff0c\u5426\u5219 SFC1011\uff1b</li> <li><code>operation-vocabulary</code>\uff1a\u64cd\u4f5c\u540d\u5fc5\u987b\u5728\u534f\u8bae\u7248\u672c\u7684\u51bb\u7ed3\u8bcd\u8868\u5185\uff08\u5426\u5219 SFC2002\uff09\uff0cparams \u5fc5\u987b\u6ee1\u8db3\u8be5\u64cd\u4f5c\u7684\u51bb\u7ed3 params \u5951\u7ea6\uff08\u5426\u5219 SFC2003\uff09\uff1b</li> <li><code>error-code-registered</code>\uff1aoperation-result \u4e2d\u7684\u9519\u8bef\u7801\u5fc5\u987b\u662f\u51bb\u7ed3\u767b\u8bb0\u8868\u6210\u5458\uff08\u5f62\u72b6\u5408\u6cd5\u4f46\u672a\u767b\u8bb0 \u2192 SFC1009\uff09\u3002</li> </ul>"},{"location":"integration/audit/mutation-taxonomy/#M3-\u6458\u8981digest","title":"M3 \u6458\u8981\uff08digest\uff09","text":"<p>\u53d8\u5f02\u4fdd\u6301\u7ed3\u6784\u4e0e\u8bed\u4e49\uff0c\u4ec5\u6539\u53d8\u89c4\u8303\u5316\u5b57\u8282\uff08\u63aa\u8f9e\u6539\u5199\u3001\u540c\u4e49\u66ff\u6362\uff09\u3002\u5224\u636e\uff1a<code>digestDocument(input)</code> \u5fc5\u987b\u4e0d\u7b49\u4e8e\u57fa\u7ebf pin \u4e2d <code>documentDigests[expect.pinField]</code>\u3002\u8fd9\u662f\u552f\u4e00\u80fd\u6355\u83b7\"\u542b\u4e49\u4e0d\u53d8\u3001\u5b57\u8282\u6539\u53d8\"\u7684\u7c7b\u522b\u3002\u89c4\u8303\u5316\u89c4\u5219\u7531 Contracts \u7684 <code>canonicalJson</code> \u51bb\u7ed3\uff1a\u5bf9\u8c61\u952e\u9010\u7ea7\u5b57\u5178\u5e8f\u6392\u5e8f\u3001\u6570\u7ec4\u4fdd\u5e8f\u3001\u53ea\u63a5\u53d7 JSON \u6570\u636e\u7c7b\u578b\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#M4-\u9057\u6f0fomission","title":"M4 \u9057\u6f0f\uff08omission\uff09","text":"<p>\u53d8\u5f02\u4ece\u51bb\u7ed3\u6587\u6863\u4e2d\u5220\u9664\u5fc5\u5907\u90e8\u4ef6\u3002\u4e09\u4e2a\u8986\u76d6\u68c0\u67e5\uff08fixture \u7528 <code>expect.check</code> \u58f0\u660e\uff09\uff1a</p> <ul> <li><code>registry-schema-coverage</code>\uff1a\u4e94\u4e2a\u9876\u5c42\u5bf9\u8c61\u7684 schema \u767b\u8bb0\u7f3a\u4e00\u4e0d\u53ef\uff1b</li> <li><code>rules-checktype-coverage</code>\uff1a\u4e5d\u4e2a\u68c0\u67e5\u7c7b\u578b\u6bcf\u4e2a\u90fd\u5fc5\u987b\u88ab\u81f3\u5c11\u4e00\u6761 mandatory \u89c4\u5219\u8986\u76d6\uff1b</li> <li><code>error-code-coverage</code>\uff1a\u51bb\u7ed3\u9519\u8bef\u7801\u6e05\u5355\u4e00\u4e2a\u4e0d\u80fd\u5c11\u3002</li> </ul> <p>\u5224\u636e\uff1a\u89c2\u5bdf\u5230\u7684\u7f3a\u5931\u6e05\u5355\u5fc5\u987b\u4e0e <code>expect.missing</code> \u5b8c\u5168\u4e00\u81f4\uff08\u591a\u62a5\u3001\u6f0f\u62a5\u90fd\u7b97 fixture \u5931\u8d25\uff09\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#M5-\u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31engine","title":"M5 \u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31\uff08engine\uff09","text":"<p>\u53d8\u5f02\u4e0d\u5220\u9664\u90e8\u4ef6\uff0c\u800c\u662f\u653e\u5bbd\u5f15\u64ce\u53c2\u6570\u3002\u56db\u4e2a\u5b8c\u6574\u6027\u68c0\u67e5\uff08fixture \u7528 <code>expect.check</code> \u58f0\u660e\uff09\uff1a</p> <ul> <li><code>rules-budget</code>\uff1a\u9884\u7b97\u6570\u503c\uff08firstVersionMax=20\u3001absoluteMax=30\uff09\u4e0d\u5f97\u53d8\u5316\uff1b</li> <li><code>validation-policies</code>\uff1astrict \u7b56\u7565\u5fc5\u987b\u4fdd\u6301 coerceTypes=false\u3001useDefaults=false\u3001allErrors=true\u3001validateFormats=true\uff1btolerant \u7b56\u7565\u9010\u952e\u5bf9\u6bd4\uff1b</li> <li><code>check-type-set</code>\uff1a\u4e5d\u4e2a\u68c0\u67e5\u7c7b\u578b\u662f\u95ed\u96c6\uff0c\u7f3a\u4e00\u4e0d\u53ef\uff1b</li> <li><code>error-code-stability</code>\uff1a\u9519\u8bef\u7801 append-only \u7a33\u5b9a\u6027\u653f\u7b56\u539f\u6587\u4e0d\u5f97\u6539\u5199\u3002</li> </ul> <p>\u5224\u636e\uff1a\u89c2\u5bdf\u5230\u7684\u88ab\u524a\u5f31\u5b57\u6bb5\u6e05\u5355\u5fc5\u987b\u4e0e <code>expect.weakened</code> \u5b8c\u5168\u4e00\u81f4\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#fixture-\u4fe1\u5c01\u51bb\u7ed3","title":"fixture \u4fe1\u5c01\uff08\u51bb\u7ed3\uff09","text":"<p>\u6bcf\u4e2a fixture \u662f\u4e00\u4e2a JSON \u6587\u4ef6\uff1a</p> \u5b57\u6bb5 \u8981\u6c42 <code>schemaVersion</code> \u5e38\u91cf <code>1</code> <code>kind</code> \u5e38\u91cf <code>skill-family.audit.mutation-fixture</code> <code>fixtureId</code> <code>^AUD-M[1-5]-[0-9]{2}$</code>\uff0c\u7b2c 6 \u4f4d\u6570\u5b57\u5fc5\u987b\u4e0e\u7c7b\u522b\u4e00\u81f4 <code>mutationClass</code> \u4e94\u7c7b\u4e4b\u4e00\uff0c\u4e14\u5fc5\u987b\u4e0e\u6240\u5728\u76ee\u5f55\u4e00\u81f4 <code>provenance</code> \u5fc5\u987b\u4e3a <code>product-fixture</code>\uff08\u673a\u68b0\u68c0\u67e5 P5\uff09 <code>description</code> \u53d8\u5f02\u610f\u56fe\u8bf4\u660e <code>target</code> \u88ab\u6d4b\u5bf9\u8c61\uff08schema/\u6587\u4ef6/\u6295\u5f71\uff09 <code>input</code> \u53d8\u5f02\u540e\u7684\u5b8c\u6574\u6587\u6863\u6216\u6295\u5f71 <code>expect.detected</code> \u5fc5\u987b\u4e3a <code>true</code>\uff08\u53d8\u5f02\u5fc5\u987b\u88ab\u68c0\u51fa\uff09 <code>expect.auditCode</code> \u5fc5\u987b\u7b49\u4e8e\u8be5\u7c7b\u522b\u7684\u5ba1\u8ba1\u7801 <p>provenance \u73b0\u884c\u4e8b\u5b9e\uff1a\u53d8\u5f02 fixture \u662f\u4ea7\u54c1\u4fa7\u6d4b\u8bd5\u8bed\u6599\uff08<code>product-fixture</code>\uff09\uff0c\u57fa\u7ebf pin \u662f\u4ea7\u54c1\u4fa7\u517c\u5bb9\u57fa\u7ebf\uff08<code>product-compatibility-fixture</code>\uff0c\u89c1 version-compatibility.md\uff09\uff1b\u5b83\u4eec\u8bc1\u660e\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u548c\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\u3002\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002\u5386\u53f2\u7ea0\u9519\uff1afixture \u4e0e pin \u66fe\u643a\u5e26\u65e7\u503c <code>independent-r2</code> \u4e0e\u72ec\u7acb\u4f5c\u8005\u53d9\u4e8b\uff0c\u8be5\u58f0\u79f0\u4e0e\u672c\u4ed3\u4e8b\u5b9e\u4e0d\u7b26\uff0c\u5df2\u4fee\u6b63\u4e3a\u4e0a\u8ff0\u5982\u5b9e\u8bcd\u6c47\uff1b\u7ea0\u9519\u4e0d\u6539\u53d8\u4efb\u4f55 fixture \u7684 <code>input</code>/<code>expect</code>\u3001digest \u6216 facts \u5b57\u6bb5\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#\u6570\u91cf\u51bb\u7ed3\u4e0e\u6f0f\u62a5\u5f8b","title":"\u6570\u91cf\u51bb\u7ed3\u4e0e\u6f0f\u62a5\u5f8b","text":"<ul> <li>\u6bcf\u7c7b fixture \u2265 3\uff08\u5f53\u524d\u5b9e\u9645\uff1a\u7ed3\u6784 4\u3001\u8bed\u4e49 4\u3001\u6458\u8981 3\u3001\u9057\u6f0f 3\u3001\u5f15\u64ce 4\uff0c\u5171 18\uff09\uff1b</li> <li>\u8986\u76d6\u95e8\u8981\u6c42\u6bcf\u7c7b <code>fixtures \u2265 3 \u4e14 detected \u2265 1</code>\uff0c\u4e0d\u6ee1\u8db3\u4ea7\u751f AUD-MISS-001 \u5e76\u5f3a\u5236 verdict fail\uff1b</li> <li>\u6f0f\u62a5\u5f8b\u7684\u8d1f\u4f8b\u9a8c\u8bc1\u7531 <code>runner/selftest-negative.mjs</code> \u6267\u884c\uff1a\u9010\u7c7b\u7981\u7528\u68c0\u6d4b\u5668\uff0c\u65ad\u8a00\u6bcf\u6b21\u7834\u574f\u90fd\u4f7f\u8fd0\u884c\u5931\u8d25\u3002</li> </ul>"},{"location":"integration/audit/version-compatibility/","title":"\u7248\u672c\u517c\u5bb9\u5b9a\u4e49","text":"<p>\u5ba1\u8ba1\u6d88\u8d39 Contracts \u4ee5\u4e24\u4e2a\u7248\u672c\u5750\u6807 + \u4e00\u4e2a\u6458\u8981\u4e3a\u51c6\uff1a</p> \u5750\u6807 \u6765\u6e90 \u542b\u4e49 <code>contractsVersion</code> Contracts \u51bb\u7ed3\u7248\u672c\uff08\u5f53\u524d <code>1.4.0</code>\uff09 \u673a\u5668\u5951\u7ea6\u5185\u5bb9\u7684\u7248\u672c <code>auditSurfaceVersion</code> \u5ba1\u8ba1\u6d88\u8d39\u63a5\u53e3\u81ea\u8eab\u7684\u7248\u672c\uff08\u5f53\u524d <code>1</code>\uff09 \u6d88\u8d39\u9762\u5f62\u72b6\u7684\u7248\u672c <code>surfaceDigest</code> <code>digestAuditSurface()</code>\uff08SHA-256\uff09 \u6d88\u8d39\u9762\u7684\u7cbe\u786e\u5b57\u8282\u6307\u7eb9 <p>\u4e09\u8005\u90fd\u7531 <code>describeAuditSurface()</code> \u4e00\u6b21\u6027\u7ed9\u51fa\uff0c\u5ba1\u8ba1\u4fa7\u628a\u5b83\u4eec\u4e0e\u57fa\u7ebf pin\uff08\u5f53\u524d\u4e3a <code>baseline/contracts-1.4.0.pin.json</code>\uff09\u6bd4\u5bf9\u3002</p>"},{"location":"integration/audit/version-compatibility/#\u517c\u5bb9\u89c4\u5219","title":"\u517c\u5bb9\u89c4\u5219","text":"<p>\u4e00\u4e2a\u88ab\u6d88\u8d39\u7684 Contracts \u5305\u4e0e\u67d0\u4e2a\u57fa\u7ebf pin \u517c\u5bb9\uff0c\u5f53\u4e14\u4ec5\u5f53\u540c\u65f6\u6ee1\u8db3\uff1a</p> <ol> <li><code>contractsVersion</code> \u4e0e pin \u76f8\u540c\uff1b</li> <li><code>auditSurfaceVersion</code> \u4e0e pin \u76f8\u540c\uff1b</li> <li><code>digestAuditSurface()</code> \u4e0e pin \u7684 <code>surfaceDigest</code> \u76f8\u540c\u3002</li> </ol> <p>\u7531\u4e8e surface \u6458\u8981\u8986\u76d6\u4e86\u767b\u8bb0\u8868\u3001\u9519\u8bef\u7801\u3001\u89c4\u5219\u3001kernel \u534f\u8bae\u3001\u5168\u90e8 schema \u6587\u6863\u4e0e\u5f15\u64ce\u53c2\u6570\uff0c\u6458\u8981\u76f8\u540c\u8574\u542b\u5185\u5bb9\u9010\u5b57\u8282\u7b49\u4ef7\uff08\u89c4\u8303\u5316\u610f\u4e49\u4e0b\uff09\u3002\u4e09\u4e2a\u6761\u4ef6\u4efb\u4e00\u4e0d\u6ee1\u8db3\u5373\u4e0d\u517c\u5bb9\uff1a\u5ba1\u8ba1\u5fc5\u987b\u62a5\u544a AUD-BASE-001\uff08\u8fd0\u884c\u671f\u57fa\u7ebf\u68c0\u67e5\uff09\u6216 AUD-LOCK-001\uff08\u5305\u9501\u9a8c\u8bc1\uff09\uff0c\u5e76\u62d2\u7edd\u7ed9\u51fa\u901a\u8fc7\u88c1\u51b3\u3002</p>"},{"location":"integration/audit/version-compatibility/#\u53d8\u66f4\u5206\u7ea7","title":"\u53d8\u66f4\u5206\u7ea7","text":"\u53d8\u66f4 \u5206\u7ea7 \u9700\u8981\u7684\u52a8\u4f5c \u4e0d\u6539\u53d8 surface \u5b57\u8282\u7684\u53d8\u66f4\uff08\u5982\u6ce8\u91ca\u3001\u6d4b\u8bd5\uff09 \u65e0\u5f71\u54cd \u65e0\u9700\u65b0 pin \u6539\u53d8 surface \u5b57\u8282\u4f46\u4e0d\u6539\u53d8\u542b\u4e49\u7684\u53d8\u66f4 \u4e0d\u517c\u5bb9 \u7981\u6b62\u4ee5\"\u540c\u4e49\"\u4e3a\u7531\u514d\u68c0\uff1b\u5fc5\u987b\u8d70\u5408\u540c\u53d8\u66f4\u5e76\u91cd\u65b0\u6279\u51c6 pin \u65b0\u589e\u5ba1\u8ba1\u6d88\u8d39\u63a5\u53e3\uff08\u53ea\u8bfb\u3001\u589e\u91cf\uff09 auditSurfaceVersion \u9012\u589e \u65b0 pin + \u672c\u6587\u4ef6\u66f4\u65b0 \u6539\u53d8\u65e2\u6709\u6d88\u8d39\u63a5\u53e3\u542b\u4e49 auditSurfaceVersion \u9012\u589e + \u5408\u540c\u53d8\u66f4 \u65b0 pin\uff1b\u65e7 pin \u5b58\u6863\u4e0d\u5220 Contracts \u7248\u672c\u6f14\u8fdb\uff081.0.0 \u2192 \u4e0b\u4e00\u7248\u672c\uff09 contractsVersion \u53d8\u5316 \u65b0\u7684\u57fa\u7ebf pin \u6587\u4ef6\uff1b\u65e7 pin \u6587\u4ef6\u53ea\u8bfb\u5b58\u6863"},{"location":"integration/audit/version-compatibility/#pin-\u751f\u547d\u5468\u671f","title":"pin \u751f\u547d\u5468\u671f","text":"<ul> <li>\u6bcf\u4e2a\u7ecf\u7248\u672c\u5316\u6279\u51c6\u7684 Contracts \u53d1\u5e03\u5bf9\u5e94\u4e00\u4e2a pin \u6587\u4ef6\uff1a<code>baseline/contracts-<version>.pin.json</code>\uff1b</li> <li>pin \u662f append-only\uff1a\u6279\u51c6\u540e\u4e0d\u518d\u539f\u5730\u7f16\u8f91\uff0c\u4f5c\u5e9f\u4ee5\u65b0 pin \u53d6\u4ee3\u5e76\u5728 <code>note</code> \u4e2d\u8bf4\u660e\uff1b</li> <li>pin \u7531\u4ea7\u54c1\u4fa7\u5728\u51bb\u7ed3\u65f6\u523b\u6784\u9020\uff08provenance <code>product-compatibility-fixture</code>\uff09\uff1a\u6458\u8981\u6765\u81ea\u5bf9\u5df2\u51bb\u7ed3\u4ea7\u7269\u7684 <code>digestAuditSurface()</code> \u673a\u68b0\u8ba1\u7b97\uff0c\u4e8b\u5b9e\u6e05\u5355\u76f4\u63a5\u5bf9\u7167\u5408\u540c\u6587\u6863\u63a8\u5bfc\uff0c\u4e0d\u53d6\u81ea\u751f\u6210\u5668\u6216 oracle\uff1b\u672c\u4ed3\u5e93\u4e0d\u5b58\u5728\u72ec\u7acb\u7684\u7b2c\u4e8c\u5ba1\u9605\u4f1a\u8bdd\uff0cpin \u4e0d\u4f5c\u4efb\u4f55\u72ec\u7acb\u89d2\u8272\u58f0\u79f0\uff1b</li> <li>\u8bda\u5b9e\u6027\u4fee\u6b63\uff082026-08-05\uff09\uff1a\u65e7 pin\uff081.0.0\u30011.1.0\uff09\u66fe\u643a\u5e26 <code>independent-r2</code> provenance \u4e0e\u72ec\u7acb\u91cd\u7b7e\u53d9\u4e8b\uff0c\u8be5\u58f0\u79f0\u4e0e\u672c\u4ed3\u4e8b\u5b9e\u4e0d\u7b26\uff0c\u5df2\u5c31\u5730\u4fee\u6b63 provenance \u4e0e note\uff1b\u4fee\u6b63\u53ea\u89e6\u53ca provenance/note \u4e24\u5904\u8bda\u5b9e\u6027\u5b57\u6bb5\uff0c\u4e0d\u6539\u53d8\u4efb\u4f55 digest \u6216 facts \u5b57\u6bb5\uff0c\u65e7 pin \u7ee7\u7eed\u4f5c\u4e3a\u53ea\u8bfb\u517c\u5bb9\u5b58\u6863\uff1b</li> <li>Contracts 1.1.1\uff082026-08-05\uff09\uff1a\u4ec5\u63cf\u8ff0\u8865\u4e01\uff08migration-manifest schema \u4e09\u5904 description \u6539\u5199\u4e3a\u7a33\u5b9a\u4ea7\u54c1\u8bed\u4e49\uff1b\u65e0\u4efb\u4f55\u6821\u9a8c\u5173\u952e\u5b57\u3001\u516c\u5f00 API\u3001\u9519\u8bef\u7801\u3001\u89c4\u5219\u6216\u5f15\u64ce\u53c2\u6570\u53d8\u5316\uff09\u3002\u6309\u672c\u751f\u547d\u5468\u671f\u65b0\u589e <code>contracts-1.1.1.pin.json</code> \u4e3a\u73b0\u884c\u57fa\u7ebf\uff0c<code>contracts-1.1.0.pin.json</code> \u8f6c\u4e3a\u53ea\u8bfb\u517c\u5bb9\u5b58\u6863\u30021.1.1 pin \u76f8\u5bf9 1.1.0 pin \u7684\u51c6\u786e\u4e8b\u5b9e\uff1a\u6821\u9a8c\u8bed\u4e49\u548c\u4e8b\u5b9e\u6e05\u5355\u4e0d\u53d8\uff08<code>facts</code> \u9010\u9879\u4e00\u81f4\uff09\uff1b\u56db\u4e2a Contracts \u6587\u6863\uff08registry\u3001error-codes\u3001rules\u3001kernel-protocol\uff09\u56e0\u5185\u5d4c <code>contractsVersion</code> \u4ece <code>1.1.0</code> \u66f4\u65b0\u5230 <code>1.1.1</code> \u800c\u6539\u53d8\u6458\u8981\uff1bmigration-manifest Schema \u56e0\u4e0a\u8ff0\u4e09\u5904 description \u66f4\u65b0\u800c\u6539\u53d8\u6458\u8981\uff1b\u5176\u4f59\u4e94\u4e2a Schema\uff08project-manifest\u3001profile-descriptor\u3001managed-file-lock\u3001operation-request\u3001operation-result\uff09\u6458\u8981\u4e0d\u53d8\u3002<code>proof-independence.mjs</code> \u7684 P5 \u5f3a\u5236\u8fd9\u5957\u5982\u5b9e\u58f0\u660e\u7684 provenance \u8bcd\u6c47\uff08pin\uff1a<code>product-compatibility-fixture</code>\uff1b\u53d8\u5f02\u5939\u5177\uff1a<code>product-fixture</code>\uff09\uff1b</li> <li>Contracts 1.2.0\uff082026-08-09\uff09\uff1a\u62a5\u544a\u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>report-model</code>\u3001<code>report-binding</code> \u4e24\u4e2a\u9876\u5c42\u5951\u7ea6\u548c SFC3001\uff5eSFC3003 \u62a5\u544a\u9519\u8bef\u7801\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002</li> <li>Contracts 1.3.0\uff082026-08-09\uff09\uff1a\u5bbf\u4e3b\u63a5\u5165\u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>host-descriptor</code>\u3001<code>host-capability-fact</code>\u3001<code>adapter-build-manifest</code>\u3001<code>host-operation-plan</code>\u3001<code>host-operation-receipt</code> \u4e94\u4e2a\u9876\u5c42\u5951\u7ea6\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002</li> <li>Contracts 1.4.0\uff082026-08-09\uff09\uff1a\u6301\u4e45\u72b6\u6001\u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>state-event-envelope</code>\u3001<code>state-snapshot-metadata</code> \u4e24\u4e2a\u9876\u5c42\u5951\u7ea6\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002<code>contracts-1.4.0.pin.json</code> \u662f\u5f53\u524d\u73b0\u884c\u57fa\u7ebf\uff1b1.1.x \u53ca\u66f4\u65e9 pin \u4fdd\u7559\u4e3a\u53ea\u8bfb\u517c\u5bb9\u5b58\u6863\u3002\u8be5 pin \u7684\u6458\u8981\u4e0e\u4e8b\u5b9e\u5747\u4ece\u5f53\u524d <code>describeAuditSurface()/digestAuditSurface()</code> \u673a\u68b0\u6295\u5f71\uff0cprovenance \u4ecd\u4e3a <code>product-compatibility-fixture</code>\u3002</li> <li>\u5ba1\u8ba1\u8fd0\u884c\u65f6\u5148\u505a\u5305\u9501\u9a8c\u8bc1\uff08\u89c1 isolation-and-lockfile.md\uff09\uff0c\u518d\u505a\u53d8\u5f02\u91cd\u653e\uff1bpin \u4e0d\u5339\u914d\u65f6\uff0c\u53d8\u5f02\u91cd\u653e\u7ed3\u679c\u4e0d\u5f97\u88ab\u91c7\u4fe1\u3002</li> </ul>"},{"location":"migration/","title":"\u4e2d\u6587 \u00b7 \u5b58\u91cf\u91c7\u7528\u4e0e\u8fc1\u79fb","text":"<p>English</p>"},{"location":"migration/#\u5b58\u91cf\u91c7\u7528\u4e0e\u8fc1\u79fbFND-070","title":"\u5b58\u91cf\u91c7\u7528\u4e0e\u8fc1\u79fb\uff08FND-070\uff09","text":"<p>\u672c\u9875\u63cf\u8ff0\u5b58\u91cf\u9879\u76ee\u5982\u4f55\u91c7\u7528 Skill Family \u57fa\u7840\u8bbe\u65bd\uff0c\u4ee5\u53ca\u8fc1\u79fb\u5b8c\u6210\u5224\u5b9a\u7684\u95e8\u7981\u3002\u5b83\u670d\u52a1\u4e8e\u4e24\u7c7b\u8bfb\u8005\uff1a\u4eba\u7c7b\u8d1f\u8d23\u4eba\u636e\u6b64\u5224\u65ad\u91c7\u7528\u8def\u5f84\u4e0e\u98ce\u9669\uff1b\u667a\u80fd\u4f53\u636e\u6b64\u7528 <code>adopt-plan</code> \u505a\u53ea\u8bfb\u76d8\u70b9\uff0c\u4e0d\u5728\u672c\u9875\u590d\u5236\u5199\u5165\u52a8\u4f5c\u3002</p>"},{"location":"migration/#\u5206\u7c7b\u65b9\u6cd5","title":"\u5206\u7c7b\u65b9\u6cd5","text":"<p>\u5b58\u91cf\u4ed3\u63a5\u5165 Foundation \u524d\uff0c\u5148\u6309\u4e0b\u9762\u56db\u7c7b\u5f52\u7c7b\u3002\u5206\u7c7b\u51b3\u5b9a\u8d70\u54ea\u6761\u8def\u5f84\u3001\u662f\u5426\u5199\u6587\u4ef6\u3001\u65e7\u5b9e\u73b0\u5982\u4f55\u5904\u7406\u3002</p> \u7c7b\u522b \u542b\u4e49 \u5904\u7406\u8def\u5f84 \u662f\u5426\u5199\u6587\u4ef6 <code>direct-adoption</code> \u4ed3\u5185\u5df2\u6709\u80fd\u529b\u53ef\u88ab Foundation \u539f\u6837\u66ff\u4ee3\uff0c\u65e0\u4e1a\u52a1\u8bed\u4e49\u8026\u5408 \u76f4\u63a5\u91c7\u7528\uff1a<code>adopt-plan</code> \u76d8\u70b9 \u2192 <code>scaffold</code>/<code>projection</code> \u843d\u76d8 \u662f\uff08\u53d7\u6536\u5bb9\uff09 <code>compatibility-layer</code> \u4ed3\u5185\u5df2\u6709\u5b9e\u73b0\u4e0e Foundation \u63a5\u53e3\u5b58\u5728\u5dee\u5f02\uff0c\u9700\u4e00\u5c42\u517c\u5bb9\u9002\u914d \u5199\u517c\u5bb9\u5c42\u540e\u91c7\u7528\uff0c\u65e7\u5b9e\u73b0\u7ecf\u517c\u5bb9\u5c42\u9000\u51fa \u662f\uff08\u517c\u5bb9\u5c42\u53d7\u6536\u5bb9\uff09 <code>keep-business</code> \u80fd\u529b\u542b\u9886\u57df\u8bed\u4e49\u6216\u4e1a\u52a1\u72b6\u6001\u673a\uff0c\u5c5e\u4e8e\u8c03\u7528\u65b9\u62e5\u6709\uff0cFoundation \u4e0d\u63a5 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u53ea\u63a5\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236 \u5426\uff08Foundation \u4fa7\uff09 <code>foundation-gap</code> \u9700\u8981\u7684\u80fd\u529b Foundation \u5c1a\u672a\u63d0\u4f9b\uff08\u5982 host apply\u3001Qoder driver\uff09 \u7559\u5728\u6d88\u8d39\u8005\u6216\u540e\u7eed\u7248\u672c\uff0c\u4e0d\u5f3a\u884c\u6269\u5f20 Foundation \u5426 <p>\u5206\u7c7b\u662f\u91c7\u7528\u51b3\u7b56\u7684\u524d\u63d0\u3002\u843d\u5165 <code>keep-business</code> \u6216 <code>foundation-gap</code> \u7684\u80fd\u529b\uff0c\u4e0d\u5e94\u4e3a\u4e86\u300c\u5b8c\u6210\u91c7\u7528\u300d\u800c\u585e\u8fdb Foundation\uff1b\u8fd9\u6b63\u597d\u662f\u67b6\u6784\u8def\u7531\u7b2c 1\u30018 \u6b65\u7684\u843d\u5730\u3002</p>"},{"location":"migration/#\u539f\u5219","title":"\u539f\u5219","text":"<ol> <li>\u8ba1\u5212\u5148\u884c\uff1a\u4efb\u4f55\u5b58\u91cf\u4ed3\u5148\u8fd0\u884c\u53ea\u8bfb <code>adopt-plan</code>\uff0c\u62ff\u5230\u73b0\u72b6\u3001\u76ee\u6807 Profile\u3001\u7cbe\u786e\u5199\u96c6\u3001\u51b2\u7a81\u3001\u65e7\u5b9e\u73b0\u9000\u51fa\u6e05\u5355\u4e0e\u9a8c\u6536\u547d\u4ee4\uff0c\u518d\u51b3\u5b9a\u662f\u5426\u6267\u884c\u5199\u5165\u3002</li> <li>\u53ea\u8bfb\u8ba1\u5212\u96f6\u53d8\u5316\uff1a<code>adopt-plan</code> \u4e0d\u5199\u4efb\u4f55\u6587\u4ef6\uff08\u542b\u4e34\u65f6\u6587\u4ef6\uff09\u3001\u4e0d\u8fd0\u884c git \u5199\u547d\u4ee4\u3001\u4e0d\u6539\u540d\u3001\u4e0d\u89e6\u78b0\u8fdc\u7aef\uff1b\u5bf9\u8f93\u5165\u4ed3\u5b57\u8282\u96f6\u53d8\u5316\uff08\u524d\u540e\u54c8\u5e0c\u8d70\u67e5\u53ef\u8bc1\uff09\u3002</li> <li>\u91c7\u7528\u4e0e\u6539\u540d\u5206\u79bb\uff1a\u57fa\u7840\u8bbe\u65bd\u91c7\u7528\u7edd\u4e0d\u8fde\u5e26\u4ed3\u5e93\u6539\u540d\u6216\u8fdc\u7aef\u5750\u6807\u53d8\u66f4\uff1b\u4e24\u8005\u662f\u72ec\u7acb\u51b3\u7b56\uff0c\u5de5\u5177\u4e0d\u63d0\u4f9b\u4efb\u4f55\u6539\u540d\u80fd\u529b\u3002</li> <li>\u53cc\u8f68\u4e0d\u7b97\u5b8c\u6210\uff1a\u8fc1\u79fb\u5b8c\u6210\u5224\u5b9a\u8981\u6c42\u65e7\u91cd\u590d\u5b9e\u73b0\u5df2\u5220\u9664\uff1b\u53ea\u63a5\u5165\u65b0\u57fa\u7840\u8bbe\u65bd\u800c\u65e7\u5b9e\u73b0\u4ecd\u5728\uff0c\u5224\u5b9a\u6052\u4e3a false\u3002</li> </ol>"},{"location":"migration/#adopt-plan-\u8f93\u51fa\u7ed3\u6784","title":"adopt-plan \u8f93\u51fa\u7ed3\u6784","text":"\u6bb5\u843d \u5185\u5bb9 <code>target</code> \u73b0\u72b6\uff1a\u5165\u53e3\u6570\u3001\u76ee\u6807\u81ea\u6709\u53d7\u7ba1\u58f0\u660e <code>project</code> / <code>traceability</code> \u76ee\u6807 Profile \u4e0e\u6bcf\u9879\u5199\u5165\u7684\u771f\u6e90\uff08Contracts \u7248\u672c\u3001skeleton \u751f\u6210\u51fd\u6570\u3001\u8bb8\u53ef\u8bc1 Profile \u4e0e\u53d8\u4f53\uff09 <code>git</code> \u53ea\u8bfb Git \u524d\u7f6e\u72b6\u6001\uff08\u4ed3\u5e93\u3001HEAD\u3001clean\uff09 <code>writeSet</code> \u7cbe\u786e\u5199\u96c6\uff1a\u6bcf\u8def\u5f84\u7684 action\uff08\u4ec5 <code>create</code>/<code>unchanged</code>\uff09\u3001fileClass\u3001sha256 <code>conflicts</code> \u624b\u5199\u51b2\u7a81\u3001\u53d7\u7ba1\u6f02\u79fb\u3001\u7b26\u53f7\u94fe\u63a5\u5360\u4f4d\u3001\u7f3a\u5b57\u6bb5\u4e34\u65f6\u4f8b\u5916 <code>risks</code> dirty\u3001\u5d4c\u5957\u4ed3\u3001tracked-but-ignored\u3001\u5230\u671f\u4f8b\u5916\u7b49 <code>migration</code> \u8fc1\u79fb\u72b6\u6001\u673a\uff1a\u7ed1\u5b9a\uff08binding\uff09\u3001\u5728\u76d8\u8bc1\u660e\uff08adoptionProof\uff09\u3001\u5f85\u5199\u5165\u6570\u3001check \u95e8\u7981\u3001\u56db\u7c7b\u9a8c\u8bc1\u8bc1\u636e\u3001\u72b6\u6001\u4e0e\u5b8c\u6210\u5224\u5b9a <code>verificationPlan</code> \u9a8c\u6536\u547d\u4ee4\u5e8f\u5217\uff08check \u2192 projection \u2192 \u590d\u67e5\uff09"},{"location":"migration/#\u8fc1\u79fb\u6e05\u5355skill-familymigrationjson","title":"\u8fc1\u79fb\u6e05\u5355\uff08skill-family.migration.json\uff09","text":"<p>\u76ee\u6807\u4ed3\u5728\u6839\u76ee\u5f55\u58f0\u660e\u81ea\u5df1\u7684\u8fc1\u79fb\u72b6\u6001\uff1a</p> <pre><code>{\n \"kind\": \"skill-family.migration-manifest\",\n \"legacyInfra\": [\n { \"path\": \"scripts/old-validator.mjs\", \"replacedBy\": \"sf-kit check\" }\n ],\n \"exceptions\": [\n {\n \"owner\": \"\u8d1f\u8d23\u4eba\",\n \"reason\": \"\u5177\u4f53\u539f\u56e0\",\n \"deadline\": \"2026-12-31\",\n \"migrationTarget\": \"wave-m1\"\n }\n ],\n \"targetProfile\": \"generic\",\n \"foundationPackages\": [\n { \"name\": \"skill-family-contracts\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 \u4f4d\u5341\u516d\u8fdb\u5236>\" },\n { \"name\": \"skill-family-harness-node\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 \u4f4d\u5341\u516d\u8fdb\u5236>\" },\n { \"name\": \"skill-family-engineering-kit\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 \u4f4d\u5341\u516d\u8fdb\u5236>\" }\n ],\n \"verification\": {\n \"unit\": \"docs/evidence/unit.json\",\n \"integration\": \"docs/evidence/integration.json\",\n \"consumer\": \"docs/evidence/consumer.json\",\n \"independentAudit\": \"docs/evidence/independent-audit.json\"\n }\n}\n</code></pre> <p>\u4ee5\u4e0a\u7ed3\u6784\u5c55\u793a\u4e86\u8fc1\u79fb\u6e05\u5355\u7684\u6838\u5fc3\u5b57\u6bb5\uff1b<code>legacyInfra</code> \u6bcf\u9879\u7ed9\u51fa\u65e7\u5b9e\u73b0\u8def\u5f84\u4e0e\u66ff\u4ee3\u7269\uff0c\u5de5\u5177\u53ea\u8bfb\u8bc4\u4f30\u5b58\u5728\u6027\uff0c\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\u3002</p> <p>0.3.0 \u4e2d\u7684 Quickstart Profile candidate \u5df2\u5347\u7ea7\u5230 v2\u3002\u8fc1\u79fb\u6e05\u5355\u82e5\u7ed1\u5b9a candidate \u80fd\u529b\uff0c\u4e09\u4e2a Foundation \u5305\u5fc5\u987b\u7edf\u4e00\u7cbe\u786e\u9501\u5b9a\u4e3a 0.3.0\uff1b\u4ecd\u9700 v1 \u7684\u5b58\u91cf\u63a5\u5165\u7ee7\u7eed\u7edf\u4e00\u9501\u5b9a 0.2.1\uff0c\u4e0d\u6df7\u88c5\u4e24\u7ec4\u7248\u672c\u3002</p> <ul> <li><code>legacyInfra</code> \u6bcf\u9879\u7ed9\u51fa\u65e7\u5b9e\u73b0\u8def\u5f84\u4e0e\u66ff\u4ee3\u7269\uff1b\u5de5\u5177\u53ea\u8bfb\u8bc4\u4f30\u5b58\u5728\u6027\uff0c\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\u3002</li> <li><code>exceptions</code> \u662f\u4e34\u65f6\u4f8b\u5916\uff1a\u5fc5\u987b\u540c\u65f6\u542b\u8d1f\u8d23\u4eba\uff08owner\uff09\u3001\u539f\u56e0\uff08reason\uff09\u3001\u622a\u6b62\u65f6\u95f4\uff08deadline\uff09\u3001\u8fc1\u79fb\u76ee\u6807\uff08migrationTarget\uff09\u56db\u9879\uff0c\u7f3a\u4efb\u4e00\u5b57\u6bb5\u5373\u8ba1\u4e3a\u51b2\u7a81\uff08\u8ba1\u5212\u5931\u8d25\uff09\uff1b\u5230\u671f\u4f8b\u5916\u4e0d\u81ea\u52a8\u7eed\u671f\uff0c\u6301\u7eed\u963b\u65ad\u5b8c\u6210\u5224\u5b9a\u3002</li> <li><code>targetProfile</code> / <code>foundationPackages</code>\uff1a\u91c7\u7528\u7ed1\u5b9a\u3002\u76ee\u6807 Profile \u5fc5\u987b\u4e0e\u8ba1\u5212 Profile \u4e00\u81f4\uff1b\u4e09\u4e2a Foundation \u5305\uff08contracts\u3001harness-node\u3001engineering-kit\uff09\u5fc5\u987b\u5404\u81ea\u7ed1\u5b9a\u7cbe\u786e\u7248\u672c\u53f7\uff08\u4e0d\u63a5\u53d7\u6d6e\u52a8\u8303\u56f4\uff09\u4e0e <code>sha256:</code> \u6458\u8981\u3002</li> <li><code>verification</code>\uff1a\u56db\u7c7b\u9a8c\u8bc1\u8bc1\u636e\u6587\u6863\u8def\u5f84\uff08unit\u3001integration\u3001consumer\u3001independentAudit\uff09\u3002\u6bcf\u4efd\u8bc1\u636e\u5fc5\u987b\u662f\u53ef\u89e3\u6790 JSON \u4e14\u5176 <code>projectId</code> \u4e0e\u76ee\u6807\u9879\u76ee\u8eab\u4efd\u4e00\u81f4\uff0c\u624d\u8ba1\u4e3a proven\uff1b\u8def\u5f84\u8d8a\u754c\u3001\u7f3a\u5931\u3001\u4e0d\u53ef\u89e3\u6790\u3001\u8eab\u4efd\u4e0d\u7b26\u5747\u4e3a\u672a\u8bc1\u660e\uff0cfail-closed\u3002</li> </ul>"},{"location":"migration/#\u8fc1\u79fb\u72b6\u6001\u673a","title":"\u8fc1\u79fb\u72b6\u6001\u673a","text":"<p>\u72b6\u6001\u5355\u8c03\u9012\u8fdb\uff0c\u53ea\u7531\u53ea\u8bfb\u8bc1\u636e\u63a8\u5bfc\uff0c\u4efb\u4f55\u5de5\u5177\u90fd\u4e0d\u901a\u8fc7\u5199\u5165\u63a8\u8fdb\u72b6\u6001\uff1a</p> <pre><code>not-declared \u2192 declared \u2192 adopted \u2192 verified \u2192 complete\n</code></pre> \u72b6\u6001 \u542b\u4e49 <code>not-declared</code> \u4e0d\u5b58\u5728\u5951\u7ea6\u6709\u6548\u7684\u8fc1\u79fb\u6e05\u5355 <code>declared</code> \u6e05\u5355\u5951\u7ea6\u6709\u6548\uff0c\u4f46\u91c7\u7528\u4e8b\u5b9e\u8bc1\u660e\u4e0d\u5168 <code>adopted</code> Foundation \u5b57\u8282\u5df2\u5728\u76d8\u4e14\u65e7\u5b9e\u73b0\u5df2\u9000\u51fa\uff0ccheck \u95e8\u7981\u672a\u7eff <code>verified</code> check \u95e8\u7981\u7eff\uff0c\u9a8c\u8bc1\u8bc1\u636e\u672a\u5168\u90e8 proven <code>complete</code> \u516b\u9879\u5b8c\u6210\u6761\u4ef6\u5168\u90e8\u6ee1\u8db3\uff1b<code>complete</code> \u4e3a\u771f\u5f53\u4e14\u4ec5\u5f53\u72b6\u6001\u4e3a <code>complete</code>"},{"location":"migration/#\u5b8c\u6210\u5224\u5b9a\u95e8\u7981","title":"\u5b8c\u6210\u5224\u5b9a\u95e8\u7981","text":"<p><code>migration.completion.complete</code> \u4e3a true \u5f53\u4e14\u4ec5\u5f53\u5168\u90e8\u516b\u9879\u6210\u7acb\uff1a</p> <ol> <li>\u5df2\u58f0\u660e\u5951\u7ea6\u6709\u6548\u7684\u8fc1\u79fb\u6e05\u5355\uff08kind/\u5b57\u6bb5\u7ecf Contracts schema \u6821\u9a8c\uff09\uff1b</li> <li>\u91c7\u7528\u7ed1\u5b9a\u5df2\u8bc1\u660e\uff1a\u76ee\u6807 Profile \u4e0e\u8ba1\u5212\u4e00\u81f4\uff0c\u4e09\u4e2a Foundation \u5305\u5747\u7ed1\u5b9a\u7cbe\u786e\u7248\u672c\u4e0e sha256 \u6458\u8981\uff1b</li> <li>Project Manifest\u3001managed lock\u3001identity \u4e0e\u5168\u90e8\u53d7\u7ba1\u9aa8\u67b6\u6587\u4ef6\u5728\u76d8\u4e14\u6458\u8981\u4e0e\u8ba1\u5212\u4e00\u81f4\uff08<code>adoptionProof.missing</code>/<code>mismatched</code> \u4e3a\u7a7a\uff09\uff1b</li> <li>\u5199\u96c6\u4e2d\u65e0\u5f85\u6267\u884c\u7684 create/replace/project \u52a8\u4f5c\uff08<code>pendingWrites</code> \u4e3a 0\uff09\uff1b</li> <li>Foundation check \u95e8\u7981\u7eff\uff1b</li> <li>\u6bcf\u9879\u65e7\u5b9e\u73b0\u5747\u5df2\u9000\u51fa\uff08absent\uff09\u2014\u2014containment \u62d2\u7edd\u6216\u7578\u5f62\u6761\u76ee\u4e0e present \u540c\u7b49 fail-closed\uff1b</li> <li>\u65e0\u7f3a\u5b57\u6bb5\u3001\u65e0\u4e0d\u53ef\u89e3\u6790\u622a\u6b62\u65f6\u95f4\u3001\u65e0\u5df2\u5230\u671f\u7684\u4e34\u65f6\u4f8b\u5916\uff1b\u65e0\u672a\u89e3\u51b3\u7684\u91c7\u7528\u51b2\u7a81\uff1b</li> <li>\u56db\u7c7b\u9a8c\u8bc1\u8bc1\u636e\uff08unit/integration/consumer/independentAudit\uff09\u5168\u90e8 proven \u4e14\u8eab\u4efd\uff08projectId\uff09\u5339\u914d\u3002</li> </ol> <p>\u672a\u8bc4\u4f30\u7684\u8f93\u5165\u4e0e\u672a\u8bc1\u660e\u7b49\u4ef7\uff1a\u95e8\u7981\u53ea\u4f9d\u636e\u51fa\u793a\u7684\u8bc1\u636e\u524d\u8fdb\u3002\u963b\u65ad\u7406\u7531\uff08<code>blockers</code>\uff09\u4e3a\u7a33\u5b9a\u53ef\u8bfb\u5b57\u7b26\u4e32\uff0c\u53ef\u76f4\u63a5\u8fdb\u5165\u8fc1\u79fb\u8bc4\u5ba1\u8bb0\u5f55\u3002</p>"},{"location":"migration/#\u5f3a\u5236\u8d1f\u4f8b\u4efb\u4e00\u573a\u666f-completion-\u5fc5\u987b\u4e3a-false","title":"\u5f3a\u5236\u8d1f\u4f8b\uff08\u4efb\u4e00\u573a\u666f completion \u5fc5\u987b\u4e3a false\uff09","text":"<ul> <li>\u7a7a\u4ed3 + \u7a7a\u6e05\u5355\uff08\u65e0\u5951\u7ea6\u6709\u6548\u6e05\u5355 \u2192 <code>not-declared</code>\uff09\uff1b</li> <li>\u6e05\u5355 kind \u9519\u8bef\uff08schema-invalid \u2192 \u89c6\u540c\u672a\u58f0\u660e\uff09\uff1b</li> <li>9 \u4e2a\u9aa8\u67b6\u6587\u4ef6\u4ecd\u5f85 create\uff08<code>declared</code>\uff0c\u5217\u51fa\u5168\u90e8\u7f3a\u5931\u8def\u5f84\uff09\uff1b</li> <li>managed lock \u6f02\u79fb\uff08<code>mismatched</code> \u975e\u7a7a\uff09\uff1b</li> <li>\u53ea\u63a5\u5165\u65b0\u5b9e\u73b0\u3001\u65e7\u5b9e\u73b0\u4ecd\u5728\uff08\u53cc\u8f68 \u2192 <code>declared</code>\uff09\uff1b</li> <li>\u6d88\u8d39\u8005\u9a8c\u8bc1\u8bc1\u636e\u7f3a\u5931\u6216\u8eab\u4efd\u4e0d\u7b26\uff08<code>verified</code>\uff0c\u4e0d\u5f97 complete\uff09\uff1b</li> <li>\u4e34\u65f6\u4f8b\u5916\u8fc7\u671f\uff08\u5de5\u5177\u7edd\u4e0d\u7eed\u671f\uff09\u3002</li> </ul>"},{"location":"migration/#\u65e7\u5b9e\u73b0\u5220\u9664\u4e0e\u56de\u6eda\u5408\u540c","title":"\u65e7\u5b9e\u73b0\u5220\u9664\u4e0e\u56de\u6eda\u5408\u540c","text":"<ul> <li>\u5220\u9664\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff1a<code>adopt-plan</code> \u53ea\u8bc4\u4f30\u65e7\u5b9e\u73b0\u5b58\u5728\u6027\u5e76\u5217\u51fa\u9000\u51fa\u6e05\u5355\uff0c\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\uff1b<code>foundation-gap</code> \u4e0e <code>keep-business</code> \u7c7b\u80fd\u529b\u4e0d\u8981\u6c42\u5220\u9664\u3002</li> <li>\u56de\u6eda\u4ee5\u8bc1\u636e\u4e3a\u51c6\uff1a\u91c7\u7528\u843d\u76d8\u524d\u5fc5\u987b\u5148\u6709 <code>adoptionProof</code> \u4e0e <code>foundationPlanDigest</code> \u53cc\u6458\u8981\u7ed1\u5b9a\uff1b\u56de\u6eda\u65f6\u4ee5\u8ba1\u5212\u5199\u96c6\u7684 <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u8fd8\u539f\uff0c\u672a\u58f0\u660e\u524d\u7f6e\u72b6\u6001\u7684\u8986\u76d6\u52a8\u4f5c\u5728 <code>projection</code> \u9636\u6bb5\u5373\u62d2\u7edd\u3002</li> <li>fail-closed \u9ed8\u8ba4\uff1a\u4efb\u4f55\u4e0d\u53ef\u89e3\u6790\u3001\u8d8a\u754c\u3001\u8eab\u4efd\u4e0d\u7b26\u6216\u8bc1\u636e\u7f3a\u5931\u7684\u8f93\u5165\uff0c\u90fd\u4f7f\u5bf9\u5e94\u5224\u5b9a\u4e3a\u672a\u8bc1\u660e\uff0c\u4e0d\u5047\u8bbe\u6210\u529f\u3002</li> </ul>"},{"location":"migration/#\u5341\u5b57\u6bb5-hand-off-\u8349\u6848","title":"\u5341\u5b57\u6bb5 hand-off \u8349\u6848","text":"<p><code>adopt-plan</code> \u8f93\u51fa\u643a\u5e26 <code>handoffDraft</code> \u5b50\u5757\uff08kind=<code>skill-family.handoff-draft</code>\uff0cschemaVersion=1\uff09\uff0c\u4e3a planner \u4fa7\u7684\u5341\u5b57\u6bb5 hand-off \u63d0\u4f9b\u7ed3\u6784\u5316\u6570\u636e\u8349\u6848\u3002\u5b57\u6bb5\u6765\u6e90\u53ea\u6709\u4e24\u79cd\uff1a<code>derived</code>\uff08\u53ef\u7531\u53ea\u8bfb\u8bc1\u636e\u673a\u68b0\u63a8\u5bfc\uff09\u4e0e <code>INCOMPLETE</code>\uff08\u4e0d\u53ef\u673a\u68b0\u63a8\u5bfc\uff0c\u7edd\u4e0d\u731c\u6d4b\uff09\u3002\u5341\u5b57\u6bb5\u4e0e\u6e90\u7801\u5e38\u91cf <code>HANDOFF_FIELDS</code> \u9010\u4e00\u5bf9\u5e94\uff1a</p> id \u5b57\u6bb5\u540d \u6765\u6e90 1 <code>project-identity</code> derived 2 <code>repository-state</code> derived 3 <code>foundation-binding</code> derived\uff08\u6e05\u5355\u5df2\u58f0\u660e\u7ed1\u5b9a\uff09\uff0fINCOMPLETE\uff08\u65e0\u6e05\u5355\u58f0\u660e\uff09 4 <code>write-set-policy</code> derived 5 <code>legacy-exits</code> derived 6 <code>business-logic-to-keep</code> \u6052 INCOMPLETE 7 <code>plan-summary</code> derived 8 <code>verification-entries</code> derived\uff08\u56db\u7c7b\u8bc1\u636e\u5168\u90e8 proven\uff09\uff0fINCOMPLETE\uff08\u4efb\u4e00\u672a\u8bc1\u660e\uff09 9 <code>legacy-removal-recovery</code> \u6052 INCOMPLETE 10 <code>authorization-status</code> derived\uff08commit/push/tag/publish \u6052\u4e3a false\uff09"},{"location":"migration/#INCOMPLETE-\u963b\u65ad\u89c4\u5219","title":"INCOMPLETE \u963b\u65ad\u89c4\u5219","text":"<ul> <li>\u4efb\u4f55 INCOMPLETE \u5b57\u6bb5\u90fd\u4f7f <code>ready=false</code>\uff1a\u8349\u6848\u5e26\u7f3a\u53e3\u5c31\u4e0d\u5f97\u8fdb\u5165 hand-off\u3002</li> <li>\u5de5\u5177\u7edd\u4e0d\u731c\u6d4b\u4e0d\u53ef\u673a\u68b0\u63a8\u5bfc\u7684\u5b57\u6bb5\uff1a</li> <li><code>business-logic-to-keep</code> \u4e0e <code>legacy-removal-recovery</code> \u6052 INCOMPLETE\uff0c\u5fc5\u987b\u7531\u4eba\u7c7b\u8d1f\u8d23\u4eba\u7ed9\u51fa\uff0c\u5de5\u5177\u65e0\u63a8\u5bfc\u4f9d\u636e\uff1b</li> <li><code>foundation-binding</code> \u5728\u65e0\u8fc1\u79fb\u6e05\u5355\u58f0\u660e\uff08<code>foundationPackages</code>\uff09\u65f6 INCOMPLETE\uff0c\u53ea\u8ba1\u6e05\u5355\u58f0\u660e\u7684\u7ed1\u5b9a\uff1b</li> <li><code>verification-entries</code> \u5728\u56db\u7c7b\u8bc1\u636e\uff08unit/integration/consumer/independentAudit\uff09\u4efb\u4e00\u672a\u8fbe proven \u65f6 INCOMPLETE\u3002</li> </ul>"},{"location":"migration/#\u7ed1\u5b9a","title":"\u7ed1\u5b9a","text":"<p>\u8349\u6848\u643a\u5e26\u53cc sha256 \u6458\u8981\uff08<code>binding</code> \u5757\uff09\uff1a<code>targetSetDigest</code> \u6c47\u603b\u76ee\u6807\u4ed3\u6587\u4ef6\u96c6\u5408\uff0c<code>foundationPlanDigest</code> \u6c47\u603b Foundation \u8ba1\u5212\u5199\u96c6\u3002\u540c\u4e00\u76ee\u6807\u4e24\u6b21\u8ba1\u5212\u5f97\u5230\u76f8\u540c\u6458\u8981\uff0c\u8349\u6848\u4e0e\u8ba1\u5212\u65f6\u523b\u7684\u76ee\u6807\u72b6\u6001\u7cbe\u786e\u7ed1\u5b9a\u3002</p>"},{"location":"migration/#\u6e32\u67d3\u8fb9\u754c","title":"\u6e32\u67d3\u8fb9\u754c","text":"<ul> <li>\u6e32\u67d3\u5668\u53ea\u5199 planner \u4fa7\u7684 hand-off \u8349\u6848\uff0c\u7edd\u4e0d\u5199\u6d88\u8d39\u8005\u4ed3\uff1b</li> <li>\u4e0d\u65b0\u589e\u7b2c\u4e94\u4e2a Kit \u9876\u5c42\u547d\u4ee4\uff1aKit \u9876\u5c42\u547d\u4ee4\u6052\u4e3a scaffold\u3001adopt-plan\u3001projection\u3001check \u56db\u4e2a\uff0c<code>handoffDraft</code> \u53ea\u662f <code>adopt-plan</code> \u8f93\u51fa\u7684\u5b50\u5757\u3002</li> </ul>"},{"location":"migration/#\u5371\u5bb3\u7c7b-fixture","title":"\u5371\u5bb3\u7c7b fixture","text":"<p><code>fixtures/adoption/cases/</code> \u8986\u76d6\u4e03\u4e2a\u5371\u5bb3\u7c7b\uff1adirty \u4ed3\u3001\u5d4c\u5957\u4ed3\u3001tracked-but-ignored\u3001\u7b26\u53f7\u94fe\u63a5\u5360\u4f4d\u3001\u751f\u6210\u7269\u6f02\u79fb\u3001\u65e7\u5b9e\u73b0\u9000\u51fa\u95e8\u7981\u3001\u4e34\u65f6\u4f8b\u5916\u5b57\u6bb5\u3002\u6bcf\u4e2a\u6848\u4f8b\u4ee5\u5b57\u8282\u7ea7\u524d\u540e\u5feb\u7167\u8bc1\u660e\u8ba1\u5212\u53ea\u8bfb\uff1b\u6848\u4f8b\u8bf4\u660e\u89c1\u4ed3\u5185 <code>fixtures/adoption/README.md</code>\u3002</p>"},{"location":"public/status/","title":"Skill Family Foundation \u2014 \u516c\u5f00\u72b6\u6001","text":"<p>\u672c\u9875\u662f\u672c\u9759\u6001\u53d1\u5e03\u5feb\u7167\u7684\u76ee\u6807\u5750\u6807\u548c\u9a8c\u8bc1\u5165\u53e3\u3002\u9875\u9762\u53ea\u4ece\u5404\u5305 package.json \u7684\u7248\u672c\u771f\u6e90\u673a\u68b0\u751f\u6210\uff0c\u7531 <code>node scripts/render-public-status.mjs --check</code> \u96f6\u5199\u5165\u91cd\u7b97\u5e76\u9010\u5b57\u8282\u6821\u9a8c\u3002</p>"},{"location":"public/status/#\u5305","title":"\u5305","text":"\u5305 \u7248\u672c \u516c\u5f00\u53d1\u5e03\u955c\u50cf <code>skill-family-contracts</code> 0.4.0 ifoohoo/skill-family-contracts <code>skill-family-harness-node</code> 0.4.0 ifoohoo/skill-family-harness-node <code>skill-family-engineering-kit</code> 0.4.0 ifoohoo/skill-family-engineering-kit"},{"location":"public/status/#\u6587\u6863","title":"\u6587\u6863","text":"<ul> <li>\u516c\u5f00\u6587\u6863\u7ad9</li> </ul>"},{"location":"public/status/#\u9a8c\u8bc1\u5165\u53e3","title":"\u9a8c\u8bc1\u5165\u53e3","text":"<ul> <li>\u672c\u9875\uff1a<code>node scripts/render-public-status.mjs --check</code>\uff08\u96f6\u5199\u5165\u91cd\u7b97\uff0c\u4e0e\u5df2\u63d0\u4ea4\u9875\u9762\u9010\u5b57\u8282\u4e00\u81f4\uff09</li> <li>\u9759\u6001\u7ad9\u4e0e\u57fa\u7ebf\uff1a<code>node scripts/render-public-site.mjs --check</code>\uff08\u51bb\u7ed3 MkDocs \u73af\u5883\u91cd\u7b97\uff0c\u4e0e\u5df2\u63d0\u4ea4\u57fa\u7ebf\u9010\u9879\u4e00\u81f4\uff09</li> <li>\u5de5\u4f5c\u533a\u6839\u95e8\u7981\uff1a<code>pnpm check</code>\uff0811 \u4e2a\u7a33\u5b9a\u4ea7\u54c1\u95e8\u7981\u6309\u56fa\u5b9a\u987a\u5e8f\u4e32\u8054\uff09</li> <li>registry\u3001Pages \u4e0e Release \u7684\u5b9e\u65f6\u8fdc\u7aef\u72b6\u6001\uff1a\u7531\u53d1\u5e03\u540e\u9a8c\u8bc1\u62a5\u544a\u8bc1\u660e\uff0c\u4e0d\u5728\u672c\u9875\u8bb0\u5f55</li> </ul>"},{"location":"public/status/#\u8bf4\u660e","title":"\u8bf4\u660e","text":"<ul> <li>\u672c\u9875\u4e0d\u5ba3\u79f0\u4efb\u4f55\u7248\u672c\u5df2\u5728\u8fdc\u7aef\u53d1\u5e03\uff1b\u53d1\u5e03\u52a8\u4f5c\u662f\u5426\u5df2\u6267\u884c\u7531\u53d1\u5e03\u540e\u7684\u8fdc\u7aef\u9a8c\u8bc1\u62a5\u544a\u8bc1\u660e\u3002</li> <li>\u4e09\u4e2a\u5305\u5747\u4e3a\u72ec\u7acb\u53d1\u5e03\u5230 npm \u7684\u516c\u5f00\u53d1\u5e03\u76ee\u6807\u3002</li> <li>\u8bb8\u53ef\u8bc1\uff1aApache-2.0</li> <li>\u79c1\u6709\u5de5\u4f5c\u533a\u4ed3\u4e0d\u5bf9\u5916\u53ef\u89c1\uff1b\u516c\u5f00\u53d1\u5e03\u7269\u53ea\u7ecf\u5404\u5305 public \u53d1\u5e03\u955c\u50cf\u4ed3\u4e0e npm tarball \u5206\u53d1\u3002</li> </ul>"},{"location":"recipes/","title":"\u4e2d\u6587 \u00b7 Recipes","text":"<p>English</p>"},{"location":"recipes/#Recipe-\u7d22\u5f15","title":"Recipe \u7d22\u5f15","text":"<p>\u672c\u76ee\u5f55\u7ed9\u5e38\u89c1\u67b6\u6784\u9700\u6c42\u63d0\u4f9b\u53ef\u76f4\u63a5\u590d\u5236\u6267\u884c\u7684\u6700\u5c0f\u505a\u6cd5\u3002\u6bcf\u4e2a recipe \u6309\u56fa\u5b9a\u4e5d\u6bb5\u7ec4\u7ec7\uff1a\u573a\u666f\u4e0e\u975e\u573a\u666f\u3001\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c\u3001\u6700\u5c0f\u4ee3\u7801\u6216\u547d\u4ee4\u3001\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e\u3001\u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b\u3001\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4\u3001\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91\u3001\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879\u3002</p>"},{"location":"recipes/#\u9009\u62e9\u89c4\u5219","title":"\u9009\u62e9\u89c4\u5219","text":"<ul> <li>\u9700\u6c42\u542b\u9886\u57df\u8bed\u4e49 / \u72b6\u6001\u673a / \u5ba1\u8ba1 oracle \u2192 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u5728\u8fd9\u91cc\u627e Foundation \u80fd\u529b\u3002</li> <li>\u9700\u8981\u7ed3\u6784\u6216\u534f\u8bae\u6821\u9a8c \u2192 \u770b <code>domain-schema-validation</code>\u3002</li> <li>\u9700\u8981\u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u6216\u539f\u5b50\u5199 \u2192 \u770b <code>safe-filesystem-and-atomic-write</code>\u3002</li> <li>\u9700\u8981\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a \u2192 \u770b <code>deterministic-human-report</code>\u3002</li> <li>\u9700\u8981\u6301\u4e45\u4e8b\u4ef6\u4e0e\u6d3e\u751f\u5feb\u7167 \u2192 \u770b <code>durable-local-state</code>\u3002</li> <li>\u9700\u8981\u5b58\u91cf\u91c7\u7528\u76d8\u70b9 \u2192 \u770b <code>adopt-existing-repository</code>\u3002</li> <li>\u9700\u8981\u6587\u672c\u8d44\u6e90\u95ed\u5305\u6216\u5bbf\u4e3b\u63a5\u5165 \u2192 \u770b <code>adapter-text-closure</code> / <code>host-profile-integration</code>\u3002</li> <li>\u9700\u8981\u8bd5\u7528 Quickstart Profile v2 \u2192 \u7cbe\u786e\u9501\u5b9a\u4e09\u4e2a\u5305\u7684 0.3.0 candidate \u5b50\u8def\u5f84\uff1b\u9700\u8981 v1 \u65f6\u7ee7\u7eed\u9501\u5b9a 0.2.1\u3002</li> </ul>"},{"location":"recipes/#\u5171\u540c\u9a8c\u8bc1\u7ea6\u5b9a","title":"\u5171\u540c\u9a8c\u8bc1\u7ea6\u5b9a","text":"<ul> <li>\u6240\u6709\u793a\u4f8b\u5728\u65b0\u7684\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u6267\u884c\uff0c\u4e0d\u7559\u4e2a\u4eba\u8def\u5f84\u6216\u51ed\u636e\u3002</li> <li>\u793a\u4f8b\u4e0d\u542b\u4f01\u4e1a\u6807\u8bc6\u3001\u79c1\u6709 Profile\u3001\u771f\u5b9e\u4e1a\u52a1\u6570\u636e\u6216\u4e2a\u4eba\u8def\u5f84\u3002</li> <li>\u6bcf\u4e2a recipe \u81f3\u5c11\u7ed9\u51fa\u4e00\u4e2a\u6b63\u4f8b\u4e0e\u4e00\u4e2a\u8d1f\u4f8b\uff1b\u8d1f\u4f8b\u5fc5\u987b\u4ea7\u751f\u7a33\u5b9a\u5931\u8d25\u7801\u6216\u62d2\u7edd\u3002</li> <li>\u9a8c\u8bc1\u547d\u4ee4\u53ef\u76f4\u63a5\u590d\u5236\u8fd0\u884c\uff1b\u9700\u8981\u5305\u65f6\u5148 <code>npm install</code> \u5bf9\u5e94 <code>@0.3.0</code>\u3002</li> </ul>"},{"location":"recipes/#\u80fd\u529b-ID-\u603b\u89c8","title":"\u80fd\u529b ID \u603b\u89c8","text":"Recipe \u9996\u9009\u80fd\u529b ID adopt-existing-repository <code>foundation.kit.adopt-plan</code> safe-filesystem-and-atomic-write <code>foundation.harness.path-containment</code>\u3001<code>foundation.harness.atomic-write</code> domain-schema-validation <code>foundation.contracts.object-validation</code> adapter-text-closure <code>foundation.harness.resource-closure</code>\u3001<code>foundation.harness.host-adapter</code> deterministic-human-report <code>foundation.harness.report</code>\u3001<code>foundation.kit.report</code> durable-local-state <code>foundation.harness.state-store</code> host-profile-integration <code>foundation.kit.host</code>\u3001<code>foundation.profile.extension-spi</code>"},{"location":"recipes/adapter-text-closure/","title":"\u4e2d\u6587 \u00b7 Adapter \u6587\u672c\u95ed\u5305","text":"<p>English</p>"},{"location":"recipes/adapter-text-closure/#Recipe\u6587\u672c\u8d44\u6e90\u95ed\u5305\u4e0e\u5bbf\u4e3b\u6784\u5efa","title":"Recipe\uff1a\u6587\u672c\u8d44\u6e90\u95ed\u5305\u4e0e\u5bbf\u4e3b\u6784\u5efa","text":""},{"location":"recipes/adapter-text-closure/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u628a\u4e00\u7ec4\u6587\u672c\u8d44\u6e90\u5f52\u4e00\u6210\u53ef\u590d\u7b97\u7684\u95ed\u5305\uff0c\u5e76\u636e\u6b64\u5728\u53d7\u6536\u5bb9\u5904 materialize \u4e00\u4e2a\u5bbf\u4e3b\u9002\u914d\u6784\u5efa\uff0c\u4e14\u6784\u5efa\u6e05\u5355\u53ef\u5168\u6458\u8981\u590d\u9a8c\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u628a\u4e8c\u8fdb\u5236\u8d44\u6e90\u7eb3\u5165 adapter \u6295\u5f71\uff08\u4ec5\u652f\u6301\u6587\u672c\u95ed\u5305\uff09\uff1b\u9700\u8981 host apply/install/update/uninstall\uff08\u660e\u786e unsupported\uff09\u3002</p>"},{"location":"recipes/adapter-text-closure/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.resource-closure</code>\uff08\u786e\u5b9a\u6027\u95ed\u5305\u4e0e sha256 \u6458\u8981\uff09\u4e0e <code>foundation.harness.host-adapter</code>\uff08adapter source closure / build / manifest \u6821\u9a8c / materialize\uff09\u3002</p>"},{"location":"recipes/adapter-text-closure/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>adapter source \u4e3a\u5df2\u58f0\u660e\u7684\u6587\u672c\u95ed\u5305\uff08<code>content</code> \u53ea\u63a5\u53d7 string\uff0cutf8\uff09\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1amaterialize \u7528 sibling staging + \u5355\u6b21 rename\uff0c\u76ee\u6807\u5df2\u5b58\u5728\u5219\u62d2\u7edd\uff1bprobe \u9ed8\u8ba4\u4e0d spawn\u3001\u4e0d\u8d70 PATH\u3002</li> </ul>"},{"location":"recipes/adapter-text-closure/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import {\n computeResourceClosure,\n buildAdapterClosure,\n verifyAdapterBuildManifest,\n materializeAdapterBuild,\n} from \"skill-family-harness-node\";\n\nconst closure = computeResourceClosure([\n { path: \"skill.json\", content: \"{}\" },\n { path: \"readme.md\", content: \"# demo\" },\n]);\nconst built = buildAdapterClosure(closure);\nverifyAdapterBuildManifest(built.manifest); // \u5168\u6458\u8981\u590d\u9a8c\nawait materializeAdapterBuild(built, { outDir: \"./out\" }); // \u53d7\u6536\u5bb9\u843d\u76d8\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u5148\u7b97\u95ed\u5305\u3001\u518d\u6821\u9a8c\u6e05\u5355\u3001\u6700\u540e\u539f\u5b50 materialize \u7684\u987a\u5e8f\u3002</p>"},{"location":"recipes/adapter-text-closure/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>computeResourceClosure</code> \u8fd4\u56de\u786e\u5b9a\u6027\u95ed\u5305\u5bf9\u8c61\u4e0e sha256 \u6458\u8981\uff1b<code>materializeAdapterBuild</code> \u5728\u53d7\u6536\u5bb9\u76ee\u6807\u5199\u51fa\u4ea7\u7269\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/closure.test.mjs</code> \u4e0e <code>test/host.test.mjs</code>\u3002</p>"},{"location":"recipes/adapter-text-closure/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u4e8c\u8fdb\u5236 content \u4e0d\u652f\u6301 -> \u6821\u9a8c/\u6784\u5efa\u62d2\u7edd\nbuildAdapterClosure({ path: \"x.bin\", content: Buffer.from([0, 1, 2]) });\n// \u629b HarnessError\uff1aadapter source content \u4ec5\u652f\u6301 string (utf8)\n</code></pre> <p>\u6e05\u5355\u6458\u8981\u4e0d\u7b26\u3001\u76ee\u6807\u5df2\u5b58\u5728\u3001\u975e\u53d7\u4fe1\u53ef\u6267\u884c\u6587\u4ef6\u4e5f\u4f1a\u629b\u9519\u3002</p>"},{"location":"recipes/adapter-text-closure/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/closure.test.mjs \\\n packages/skill-family-harness-node/test/host.test.mjs\n</code></pre>"},{"location":"recipes/adapter-text-closure/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u5bbf\u4e3b\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\u3002</li> <li>\u5bbf\u4e3b\u5dee\u5f02\u58f0\u660e\u7531 Profile + Kit host \u5b50\u52a8\u4f5c\u6ce8\u5165\u3002</li> </ul>"},{"location":"recipes/adapter-text-closure/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>host apply \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u672a\u5b9e\u73b0\uff1bQoder \u5b8c\u6574 driver \u4e3a unsupported\u3002</li> <li>materialize \u4e3a\u539f\u5b50 sibling + rename\uff0c\u5931\u8d25\u65f6\u4e0d\u5f71\u54cd\u65e2\u6709\u76ee\u6807\uff1b\u5347\u7ea7\u8ddf\u968f <code>skill-family-harness-node</code> \u7248\u672c\u3002</li> </ul>"},{"location":"recipes/adopt-existing-repository/","title":"\u4e2d\u6587 \u00b7 \u91c7\u7528\u5b58\u91cf\u4ed3\u5e93","text":"<p>English</p>"},{"location":"recipes/adopt-existing-repository/#Recipe\u5b58\u91cf\u4ed3\u53ea\u8bfb\u91c7\u7528\u76d8\u70b9","title":"Recipe\uff1a\u5b58\u91cf\u4ed3\u53ea\u8bfb\u91c7\u7528\u76d8\u70b9","text":""},{"location":"recipes/adopt-existing-repository/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u5bf9\u4e00\u4e2a\u5df2\u5b58\u5728\u7684\u5b58\u91cf\u4ed3\u5224\u65ad\u662f\u5426\u53ef\u91c7\u7528 Foundation\uff0c\u5e76\u62ff\u5230\u7cbe\u786e\u5199\u96c6\u3001\u51b2\u7a81\u4e0e\u65e7\u5b9e\u73b0\u9000\u51fa\u6e05\u5355\uff0c\u4e14\u4e0d\u6539\u52a8\u4efb\u4f55\u5b57\u8282\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u81ea\u52a8\u6539\u5199\u5b58\u91cf\u4ed3\uff08\u7981\u6b62\u5199\u6587\u4ef6\u3001\u7981\u6b62\u81ea\u52a8\u8fc1\u79fb\uff09\uff1b\u9700\u8981\u53d1\u5e03\u5230\u8fdc\u7aef\uff08\u5f52 release-skill\uff09\u3002</p>"},{"location":"recipes/adopt-existing-repository/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.kit.adopt-plan</code>\uff08\u4e25\u683c\u53ea\u8bfb\u76d8\u70b9\u4e0e\u5b8c\u6210\u5224\u5b9a\uff09\u3002\u5b83\u53ea\u8f93\u51fa\uff0c\u4e0d\u5199\u6587\u4ef6\u3001\u4e0d\u8fd0\u884c git \u5199\u547d\u4ee4\u3002</p>"},{"location":"recipes/adopt-existing-repository/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u76ee\u6807\u4ed3\u5b58\u5728\u4e14\u53ef\u88ab\u53ea\u8bfb\u8bbf\u95ee\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a<code>adopt-plan</code> \u5bf9\u8f93\u5165\u4ed3\u5b57\u8282\u96f6\u53d8\u5316\uff1b\u65e7\u5b9e\u73b0\u5220\u9664\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff0c\u5de5\u5177\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\u3002</li> </ul>"},{"location":"recipes/adopt-existing-repository/#4-\u6700\u5c0f\u547d\u4ee4","title":"4. \u6700\u5c0f\u547d\u4ee4","text":"<pre><code>npm install --save-dev skill-family-engineering-kit@0.3.0\nnpm exec -- skill-family-kit adopt-plan --root <repo>\n</code></pre>"},{"location":"recipes/adopt-existing-repository/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p>\u8f93\u51fa\u5305\u542b\u73b0\u72b6\uff08<code>target</code>\uff09\u3001\u76ee\u6807 Profile \u4e0e\u8ffd\u6eaf\uff08<code>project</code>/<code>traceability</code>\uff09\u3001\u53ea\u8bfb Git \u524d\u7f6e\u72b6\u6001\uff08<code>git</code>\uff09\u3001\u7cbe\u786e\u5199\u96c6\uff08<code>writeSet</code>\uff09\u3001\u51b2\u7a81\uff08<code>conflicts</code>\uff09\u3001\u98ce\u9669\uff08<code>risks</code>\uff09\u3001\u8fc1\u79fb\u72b6\u6001\u673a\uff08<code>migration</code>\uff09\u4e0e\u9a8c\u6536\u547d\u4ee4\u5e8f\u5217\uff08<code>verificationPlan</code>\uff09\u3002\u8bc1\u636e\u6765\u81ea <code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code> \u4e0e <code>test/migration.test.mjs</code>\u3002</p>"},{"location":"recipes/adopt-existing-repository/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<p>dirty \u4ed3\u8fd0\u884c <code>adopt-plan</code> \u524d\u540e\uff0c\u8f93\u5165\u4ed3\u5b57\u8282\u5fc5\u987b\u5b8c\u5168\u4e00\u81f4\uff08\u54c8\u5e0c\u8d70\u67e5\u53ef\u8bc1\uff09\uff1b\u5de5\u5177\u4e0d\u5199\u4e34\u65f6\u6587\u4ef6\u3001\u4e0d\u89e6\u78b0\u8fdc\u7aef\u3002\u82e5\u8fc1\u79fb\u6e05\u5355\u7f3a <code>exceptions</code> \u5fc5\u586b\u5b57\u6bb5\uff0c\u8ba1\u5212\u76f4\u63a5\u5931\u8d25\uff08\u5b8c\u6210\u5224\u5b9a false\uff09\uff0c\u5de5\u5177\u4e0d\u7eed\u671f\u3002</p>"},{"location":"recipes/adopt-existing-repository/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code># \u6b63\u4f8b\uff1a\u5bf9\u516c\u5f00 fixture \u5b58\u91cf\u4ed3\u505a\u53ea\u8bfb\u76d8\u70b9\nnpm exec -- skill-family-kit adopt-plan --root fixtures/m0-consumer\n\n# \u53ea\u8bfb\u8bca\u65ad\uff0c\u4e0d\u4fee\u590d\nnpm exec -- skill-family-kit check --root fixtures/m0-consumer\n</code></pre>"},{"location":"recipes/adopt-existing-repository/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u65e7\u5b9e\u73b0\u662f\u5426\u9000\u51fa\u3001\u4f55\u65f6\u5220\u9664\uff08\u5de5\u5177\u53ea\u8bc4\u4f30\u5b58\u5728\u6027\u5e76\u5217\u51fa\u9000\u51fa\u6e05\u5355\uff09\u3002</li> <li><code>business-logic-to-keep</code> \u4e0e <code>legacy-removal-recovery</code> \u6052\u4e3a INCOMPLETE\uff0c\u5fc5\u987b\u7531\u4eba\u7c7b\u8d1f\u8d23\u4eba\u7ed9\u51fa\u3002</li> </ul>"},{"location":"recipes/adopt-existing-repository/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li><code>adopt-plan</code> \u53ea\u8bfb\uff0c\u65e0\u5199\u98ce\u9669\uff0c\u65e0\u9700\u56de\u6eda\u3002</li> <li>\u771f\u6b63\u843d\u76d8\u7531 <code>scaffold</code>/<code>projection</code> \u6267\u884c\uff0c\u56de\u6eda\u4ee5 <code>adoptionProof</code> \u4e0e <code>foundationPlanDigest</code> \u53cc\u6458\u8981\u7ed1\u5b9a\u4e3a\u51c6\uff1b\u672a\u58f0\u660e <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u7684\u8986\u76d6\u52a8\u4f5c\u5728 <code>projection</code> \u9636\u6bb5\u5373\u62d2\u7edd\u3002</li> <li>\u82e5\u91c7\u7528 Quickstart Profile candidate\uff0c\u4e09\u4e2a\u5305\u6309\u540c\u4e00 profile \u7cbe\u786e\u9501\u5b9a\uff1av2 \u4f7f\u7528 0.3.0\uff0cv1 \u7ee7\u7eed\u4f7f\u7528 0.2.1\uff0c\u4e0d\u6df7\u88c5\u3002</li> </ul>"},{"location":"recipes/deterministic-human-report/","title":"\u4e2d\u6587 \u00b7 \u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a","text":"<p>English</p>"},{"location":"recipes/deterministic-human-report/#Recipe\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a","title":"Recipe\uff1a\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a","text":""},{"location":"recipes/deterministic-human-report/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u4ece\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\u6210\u4eba\u7c7b\u53ef\u8bfb\u62a5\u544a\uff08Markdown + digest \u7ed1\u5b9a + \u5206\u7ea7\u68c0\u67e5\uff09\uff0c\u53cc\u8f93\u51fa\u6210\u7ec4\u5199\u5165\u5e76\u62d2\u7edd\u8def\u5f84\u522b\u540d\u4e0e\u8f93\u5165\u8986\u76d6\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u4ece\u5f00\u653e\u4e1a\u52a1 outputs \u81ea\u7531\u7f16\u62a5\u544a\uff08\u7981\u6b62\uff09\uff1b\u9700\u8981\u6a21\u578b\u8c03\u7528\u6216\u4e1a\u52a1\u7f16\u6392\u3002</p>"},{"location":"recipes/deterministic-human-report/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.report</code>\uff08validate \u2192 render \u2192 bind \u2192 check\uff0c\u7eaf\u51fd\u6570\uff09\u4e0e <code>foundation.kit.report</code>\uff08CLI \u5b50\u52a8\u4f5c\u7f16\u6392\u6e32\u67d3\u4e0e\u5206\u7ea7\uff09\u3002</p>"},{"location":"recipes/deterministic-human-report/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u5df2\u5b58\u5728\u7ecf Contracts \u6821\u9a8c\u7684 report-model \u4e0e operation-result\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1aMarkdown \u786e\u5b9a\u6027\u8f6c\u4e49\uff1bmodel/result/report \u4e09\u6458\u8981\u7ed1\u5b9a\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u5148\u6784\u9020\u5408\u6cd5 model\uff0cKit \u4e0d\u4ece\u4e1a\u52a1 outputs \u63a8\u5bfc\u4e8b\u5b9e\u3002</li> </ul>"},{"location":"recipes/deterministic-human-report/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import {\n validateReportModel,\n renderReportMarkdown,\n buildBinding,\n checkReport,\n} from \"skill-family-harness-node\";\n\nvalidateReportModel(model);\nconst markdown = renderReportMarkdown(model, { locale: \"zh-CN\" });\nconst binding = buildBinding(model, result, markdown);\nconst graded = checkReport(model, result, markdown, binding); // \u5206\u7ea7\u68c0\u67e5\u53d1\u73b0\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u6a21\u578b\u6821\u9a8c\u3001\u6e32\u67d3\u3001\u7ed1\u5b9a\u4e0e\u5206\u7ea7\u68c0\u67e5\u7684\u56db\u6b65\u987a\u5e8f\u3002</p>"},{"location":"recipes/deterministic-human-report/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>renderReportMarkdown</code> \u8fd4\u56de\u786e\u5b9a\u6027 Markdown\uff1b<code>buildBinding</code> \u4ea7\u51fa\u4e09\u6458\u8981\u7ed1\u5b9a\uff1b<code>checkReport</code> \u8fd4\u56de\u5206\u7ea7\u68c0\u67e5\u53d1\u73b0\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/report.test.mjs</code> \u4e0e <code>packages/skill-family-engineering-kit/test/report.test.mjs</code>\u3002</p>"},{"location":"recipes/deterministic-human-report/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u62a5\u544a\u5b57\u8282\u504f\u79bb\u786e\u5b9a\u6027\u91cd\u6e32\u67d3 -> SFC3003 (REPORT_FACT_DRIFT)\n// \u624b\u5de5\u6539\u4e86 markdown \u518d bind/check\uff0c\u6458\u8981\u5bf9\u4e0d\u4e0a\u5373\u5931\u8d25\ncheckReport(model, result, tamperedMarkdown, binding);\n// \u629b HarnessError\uff0cerrorCode = \"SFC3003\"\n</code></pre> <p><code>SFC3001</code>\uff08\u6458\u8981\u4e0d\u4e00\u81f4\uff09\u3001<code>SFC3002</code>\uff08\u7f3a\u5f3a\u5236\u5143\u7d20\uff09\u540c\u6837\u4e3a\u786c\u5931\u8d25\u3002</p>"},{"location":"recipes/deterministic-human-report/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/report.test.mjs \\\n packages/skill-family-engineering-kit/test/report.test.mjs\n</code></pre>"},{"location":"recipes/deterministic-human-report/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u62a5\u544a\u4e1a\u52a1\u7ed3\u8bba\u7684\u89e3\u8bfb\u3002</li> <li>\u8c03\u7528\u65b9\u5fc5\u987b\u5148\u6784\u9020\u5408\u6cd5 report-model\uff08Kit \u4e0d\u4ece\u4e1a\u52a1 outputs \u63a8\u5bfc\u4e8b\u5b9e\uff09\u3002</li> </ul>"},{"location":"recipes/deterministic-human-report/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\uff0c\u4e0d\u81ea\u7531\u64b0\u5199\uff1b\u5347\u7ea7\u8ddf\u968f <code>skill-family-harness-node</code> \u4e0e <code>skill-family-engineering-kit</code> \u7248\u672c\u3002</li> <li>\u53cc\u8f93\u51fa\u6210\u7ec4\u5199\u5165\uff0c\u62d2\u7edd\u8def\u5f84\u522b\u540d\u4e0e\u8f93\u5165\u8986\u76d6\uff0c\u56de\u6eda\u4ee5\u5199\u5165\u524d\u7684 <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u8fd8\u539f\u3002</li> </ul>"},{"location":"recipes/domain-schema-validation/","title":"\u4e2d\u6587 \u00b7 \u9886\u57df Schema \u6821\u9a8c","text":"<p>English</p>"},{"location":"recipes/domain-schema-validation/#Recipe\u9886\u57df\u65e0\u5173\u7684\u5951\u7ea6\u5bf9\u8c61\u6821\u9a8c","title":"Recipe\uff1a\u9886\u57df\u65e0\u5173\u7684\u5951\u7ea6\u5bf9\u8c61\u6821\u9a8c","text":""},{"location":"recipes/domain-schema-validation/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u6821\u9a8c\u4e00\u4efd\u6587\u6863\u662f\u5426\u7b26\u5408 Foundation \u5df2\u767b\u8bb0\u7684\u5951\u7ea6\u5bf9\u8c61\uff08\u5982 project-manifest\uff09\uff0c\u6309\u65b9\u8a00\u9009\u62e9\u6821\u9a8c\u7b56\u7565\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u6821\u9a8c\u6d88\u8d39\u8005\u81ea\u6709\u4e1a\u52a1 Schema\uff08\u6d88\u8d39\u8005\u5e94\u81ea\u884c\u6301\u6709\uff0cFoundation \u4e0d\u53d6\u4ee3\uff09\uff1b\u9700\u8981\u628a\u9886\u57df\u8bed\u4e49\u6821\u9a8c\u6df7\u5165\u901a\u7528\u5951\u7ea6\u3002</p> <p>Quickstart Profile v2 \u662f\u5355\u72ec\u7684 candidate \u8def\u5f84\u3002\u6d88\u8d39\u8005\u4ecd\u62e5\u6709\u4e1a\u52a1 Schema\uff1bEngineering Kit \u53ea\u5728\u6784\u5efa\u9636\u6bb5\u628a\u663e\u5f0f Schema \u96c6\u5408\u7f16\u8bd1\u6210\u6309 <code>$id</code> \u67e5\u8be2\u7684\u79bb\u7ebf validator\uff0c\u4e0d\u63a5\u7ba1 method \u5230 Schema \u7684\u9009\u62e9\u3002</p>"},{"location":"recipes/domain-schema-validation/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.contracts.object-validation</code>\uff08<code>validateDocument</code> / <code>compileSchema</code> / <code>detectDialect</code>\uff09\u3002\u7eaf Ajv \u5b9e\u73b0\uff0c\u652f\u6301 draft-07 \u4e0e 2020-12\u3002</p>"},{"location":"recipes/domain-schema-validation/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u5f85\u6821\u9a8c\u6587\u6863\u5e26\u6709\u5df2\u767b\u8bb0\u5951\u7ea6\u5bf9\u8c61\u7684 <code>$id</code>\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a<code>validateDocument</code> \u6c38\u4e0d\u4fee\u6539\u8c03\u7528\u8005\u8f93\u5165\uff1b\u89c4\u8303\u5316\u526f\u672c\u53ea\u5728\u7ed3\u679c <code>data</code> \u5b57\u6bb5\u8fd4\u56de\u3002</li> </ul>"},{"location":"recipes/domain-schema-validation/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import { validateDocument } from \"skill-family-contracts\";\n\nconst document = {\n schemaVersion: 1,\n kind: \"skill-family.project-manifest\",\n project: { id: \"my-project\", name: \"My Project\", description: \"Example\" },\n contracts: { version: \"1.0.0\", profile: \"generic\" },\n managedFiles: [\"package.json\"],\n updatedAt: \"2026-01-01T00:00:00Z\",\n};\n\nconst result = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/project-manifest.json\",\n dialect: \"2020-12\",\n});\nif (!result.valid) console.error(result.errorCode);\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u7528 <code>$id</code> \u6307\u5b9a\u76ee\u6807 Schema \u5e76\u53d6\u56de <code>{ valid, errorCode, errors, data }</code>\u3002</p>"},{"location":"recipes/domain-schema-validation/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p>\u6821\u9a8c\u901a\u8fc7\u65f6 <code>result.valid</code> \u4e3a true\uff1b\u5931\u8d25\u65f6 <code>errorCode</code> \u4e3a <code>SFC1001</code> \u7b49\u7a33\u5b9a\u7801\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-contracts/test/validator.test.mjs</code> \u4e0e <code>test/schemas.test.mjs</code>\u3002</p>"},{"location":"recipes/domain-schema-validation/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u672a\u77e5 $id -> \u8fd4\u56de valid:false\uff0cerrorCode = SFC1002 (UNKNOWN_SCHEMA_ID)\nconst bad = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/does-not-exist.json\",\n dialect: \"2020-12\",\n});\n// \u4e0d\u629b\u5f02\u5e38\uff0c\u8fd4\u56de\u7ed3\u6784\u5316\u7ed3\u679c\uff1a\n// { valid: false, errorCode: \"SFC1002\",\n// errors: [{ message: \"unknown schema $id: https://contracts.skill-family.example/v1/does-not-exist.json\" }] }\nif (!bad.valid) console.error(bad.errorCode); // SFC1002\n</code></pre>"},{"location":"recipes/domain-schema-validation/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-contracts/test/validator.test.mjs \\\n packages/skill-family-contracts/test/schemas.test.mjs\n</code></pre>"},{"location":"recipes/domain-schema-validation/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u5177\u4f53\u4e1a\u52a1\u5b57\u6bb5\u7684\u8bed\u4e49\u89e3\u91ca\u3002</li> <li>\u9886\u57df\u7ea7\u6821\u9a8c\u89c4\u5219\uff08\u4e0d\u5728 Foundation \u901a\u7528\u5951\u7ea6\u5185\uff09\u3002</li> </ul>"},{"location":"recipes/domain-schema-validation/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u5951\u7ea6\u6743\u5a01\u7248\u672c <code>CONTRACTS_VERSION = 1.4.0</code>\uff0cnpm \u5305\u7248\u672c <code>0.3.0</code> \u5e76\u884c\uff0c\u4e0d\u6df7\u7528\u3002</li> <li>\u9519\u8bef\u7801\u51bb\u7ed3\u4e0d\u6f02\u79fb\uff1bSchema \u53d8\u66f4\u4f5c\u4e3a\u65b0\u7684\u5408\u540c\u7248\u672c\u4efb\u52a1\u8fdb\u884c\uff0c\u4e0d\u5c31\u5730\u6539\u51bb\u7ed3\u5185\u5bb9\u3002</li> <li>candidate v2 \u5fc5\u987b\u7cbe\u786e\u9501\u5b9a 0.3.0\uff1b\u4ecd\u9700 v1 \u7684\u63a5\u5165\u7ee7\u7eed\u7cbe\u786e\u9501\u5b9a 0.2.1\u3002</li> </ul>"},{"location":"recipes/durable-local-state/","title":"\u4e2d\u6587 \u00b7 \u6301\u4e45\u672c\u5730\u72b6\u6001","text":"<p>English</p>"},{"location":"recipes/durable-local-state/#Recipe\u6301\u4e45\u672c\u5730\u72b6\u6001\u5e95\u5ea7","title":"Recipe\uff1a\u6301\u4e45\u672c\u5730\u72b6\u6001\u5e95\u5ea7","text":""},{"location":"recipes/durable-local-state/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u6301\u4e45\u5316\u4e8b\u4ef6\u65e5\u5fd7\u5e76\u4fdd\u8bc1\u987a\u5e8f\u4e0e\u5b8c\u6574\u6027\uff0c\u91cd\u5efa\u6216\u6821\u9a8c\u6d3e\u751f\u5feb\u7167\uff0c\u4ee5\u53ca\u68c0\u67e5\u6216\u6062\u590d\u534f\u4f5c\u5f0f\u5355\u5199\u8005\u9501\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u5728 Foundation \u5b9a\u4e49 workflow \u72b6\u6001\u673a\uff08\u7981\u6b62\uff09\uff1b\u9700\u8981\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\uff08fencing \u4e0d\u627f\u8bfa\u8be5\u573a\u666f\uff09\u3002</p>"},{"location":"recipes/durable-local-state/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.state-store</code>\uff08append-only \u4e8b\u4ef6\u3001hash chain\u3001\u5feb\u7167\u4e0e\u9501\u68c0\u67e5/\u6062\u590d\uff09\u3002\u4e8b\u4ef6\u542b\u4e49\u4e0e reducer \u8f6c\u79fb\u7531\u8c03\u7528\u65b9\u62e5\u6709\u3002</p>"},{"location":"recipes/durable-local-state/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li><code>STATE_GENESIS_DIGEST</code> \u4f5c\u4e3a\u94fe\u8d77\u70b9\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u662f\u552f\u4e00\u6743\u5a01\uff0csnapshot \u4e3a\u6d3e\u751f\u7f13\u5b58\uff1b<code>confirmOwnerTerminated</code> \u662f\u8c03\u7528\u65b9\u63d0\u4f9b\u7684\u5916\u90e8\u4fe1\u4efb\u951a\uff0c\u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\u3002</li> </ul>"},{"location":"recipes/durable-local-state/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n openStateStore,\n appendEvent,\n readEvents,\n writeSnapshot,\n readSnapshot,\n inspectStateStoreLock,\n recoverStateStoreLock,\n} from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-state-\"));\nconst store = openStateStore(root, { owner: \"writer-a\", expectedSchemas: [] });\nappendEvent(store, { eventType: \"demo\", payload: { n: 1 } });\nwriteSnapshot(store, readEvents(store));\nconst snap = readSnapshot(store);\nconst lock = inspectStateStoreLock(root); // { owner, fencing, ageMs, recovering }\nawait recoverStateStoreLock(root, {\n expectedOwner: lock.owner,\n expectedFencing: lock.fencing,\n confirmOwnerTerminated: true,\n});\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u5f00\u5e93\u3001\u8ffd\u52a0\u4e8b\u4ef6\u3001\u5199\u5feb\u7167\u3001\u67e5\u9501\u4e0e\u663e\u5f0f\u6062\u590d\u7684\u987a\u5e8f\u3002</p>"},{"location":"recipes/durable-local-state/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>readEvents</code> \u8fd4\u56de\u8ffd\u52a0\u7684\u4e8b\u4ef6\uff0c<code>readSnapshot</code> \u8fd4\u56de\u6d3e\u751f\u5feb\u7167\uff0c<code>inspectStateStoreLock</code> \u8fd4\u56de <code>owner</code>/<code>fencing</code>/<code>ageMs</code>/<code>recovering</code>\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/state-store.test.mjs</code>\uff08\u542b 34 \u5904\u65ad\u8a00\uff09\u3002</p>"},{"location":"recipes/durable-local-state/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u7b2c\u4e8c\u5199\u8005\u7acb\u5373\u6536\u5230 store-locked\nconst other = openStateStore(root, { owner: \"writer-b\", expectedSchemas: [] });\n// \u629b HarnessError\uff1adetails.kind = \"store-locked\"\n</code></pre> <p>hash chain \u65ad\u88c2\u3001\u9501 fencing \u4e0d\u5339\u914d\u3001\u6062\u590d\u7f3a\u5c11 <code>confirmOwnerTerminated</code> \u5747\u5931\u8d25\u5173\u95ed\u3002</p>"},{"location":"recipes/durable-local-state/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/state-store.test.mjs\n</code></pre>"},{"location":"recipes/durable-local-state/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u4e8b\u4ef6\u4e1a\u52a1\u542b\u4e49\u3001reducer \u8f6c\u79fb\u3002</li> <li><code>confirmOwnerTerminated</code> \u4fe1\u4efb\u951a\uff08Foundation \u4e4b\u5916\u786e\u8ba4\u65e7\u5199\u8005\u5df2\u7ec8\u6b62\uff09\u3002</li> </ul>"},{"location":"recipes/durable-local-state/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u72b6\u6001\u5e95\u5ea7\u53ea\u63d0\u4f9b\u673a\u5236\uff1b\u4e1a\u52a1\u72b6\u6001\u673a/\u7ec8\u6001\u5f52 loop-agent\u3002</li> <li>\u5d29\u6e83\u9057\u7559\u9501\u9700\u5916\u90e8\u53d6\u8bc1\u540e\u663e\u5f0f\u6062\u590d\uff0c\u4e0d\u81ea\u52a8\u5077\u9501\uff1b\u7cfb\u7edf\u4fdd\u6301\u53ef\u8bca\u65ad\u9501\u6b7b\u800c\u975e\u9759\u9ed8\u8986\u76d6\u3002</li> </ul>"},{"location":"recipes/host-profile-integration/","title":"\u4e2d\u6587 \u00b7 \u5bbf\u4e3b Profile \u96c6\u6210","text":"<p>English</p>"},{"location":"recipes/host-profile-integration/#Recipe\u5bbf\u4e3b\u63a5\u5165\u4e0e-Profile-\u6ce8\u5165","title":"Recipe\uff1a\u5bbf\u4e3b\u63a5\u5165\u4e0e Profile \u6ce8\u5165","text":""},{"location":"recipes/host-profile-integration/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u63cf\u8ff0\u5df2\u767b\u8bb0\u5bbf\u4e3b\uff08claude/codex\uff09\u3001\u63a2\u6d4b\u6216\u89c4\u5212\u5bbf\u4e3b\u63a5\u5165\uff0c\u5e76\u5411 Foundation \u6ce8\u5165\u5177\u4f53\u5bbf\u4e3b Profile \u4e0e\u53d7\u4fe1 driver\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981 host apply/install/update/uninstall\uff08\u660e\u786e unsupported\uff09\uff1b\u9700\u8981 Qoder \u5b8c\u6574 driver\uff08\u8be5\u5bbf\u4e3b unsupported\uff09\u3002</p>"},{"location":"recipes/host-profile-integration/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.kit.host</code>\uff08<code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code>\uff09\u4e0e <code>foundation.profile.extension-spi</code>\uff08<code>verifyProfile</code>\uff09\u3002\u5bbf\u4e3b\u5dee\u5f02\u58f0\u660e\u5728 <code>foundation.profile.hosts</code>\u3002</p>"},{"location":"recipes/host-profile-integration/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u5bbf\u4e3b Profile \u5df2\u5728 <code>profiles/hosts</code> \u767b\u8bb0\uff1b\u53d7\u4fe1 driver \u4ec5 <code>claude-version-v1</code> / <code>codex-version-v1</code>\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1aProfile \u5165\u53e3\u5fc5\u987b\u662f JSON \u6570\u636e\u8d44\u6e90\uff0c\u516c\u5171\u6838\u5fc3\u4e0d\u5bfc\u5165 <code>profiles/</code>\uff1b<code>coreOwned</code> \u4e3a\u7981\u5165\u76ee\u6807\u3002</li> </ul>"},{"location":"recipes/host-profile-integration/#4-\u6700\u5c0f\u547d\u4ee4\u4e0e\u4ee3\u7801","title":"4. \u6700\u5c0f\u547d\u4ee4\u4e0e\u4ee3\u7801","text":"<pre><code># \u63cf\u8ff0\u5df2\u767b\u8bb0\u5bbf\u4e3b\nnpm exec -- skill-family-kit adopt-plan host-describe --host claude --hosts-root profiles/hosts\n\n# \u53ea\u8bfb\u63a2\u6d4b\uff08\u9ed8\u8ba4\u4e0d spawn\uff09\nnpm exec -- skill-family-kit adopt-plan host-probe --host claude --hosts-root profiles/hosts\n</code></pre> <pre><code>import { describeHost, probeHost, planHost } from \"skill-family-engineering-kit\";\nimport { verifyProfile } from \"profiles/spi/index.mjs\";\n\nconst desc = describeHost(\"claude\"); // \u53d7\u652f\u6301\u5bbf\u4e3b\u63cf\u8ff0\nconst facts = probeHost(\"claude\", { allowSpawn: false });\nconst plan = planHost(desc, facts);\nconst spi = verifyProfile({ profileRoot: \"profiles/public-plugin\" }); // SPE0000\n</code></pre> <p>\u4ee5\u4e0a\u547d\u4ee4\u4e0e\u4ee3\u7801\u5c55\u793a\u4e86 describe/probe/plan \u7684\u53ea\u8bfb\u673a\u5236\uff0c\u4ee5\u53ca\u7528 <code>verifyProfile</code> \u6821\u9a8c Profile \u58f0\u660e\u3002</p>"},{"location":"recipes/host-profile-integration/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>describeHost</code> \u8fd4\u56de\u5bbf\u4e3b\u63cf\u8ff0\uff0c<code>probeHost</code> \u8fd4\u56de\u53ea\u8bfb\u63a2\u6d4b\u4e8b\u5b9e\uff0c<code>planHost</code> \u8fd4\u56de\u63a5\u5165\u8ba1\u5212\uff0c<code>verifyProfile</code> \u8fd4\u56de <code>SPE0000</code> \u7b49\u7ed3\u679c\u7801\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-engineering-kit/test/host.test.mjs</code> \u4e0e <code>fixtures/generic-profile-extension-conformance/verify.mjs</code>\u3002</p>"},{"location":"recipes/host-profile-integration/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code># \u8d1f\u4f8b\uff1aapply \u7a33\u5b9a\u62d2\u7edd\nnpm exec -- skill-family-kit adopt-plan host-apply --host claude --hosts-root profiles/hosts\n# \u9000\u51fa\u7801 2\uff1ahost apply is not implemented in the read-only Phase D slice\n</code></pre> <pre><code>// \u8d1f\u4f8b\uff1aqoder \u4e3a unsupported\ndescribeHost(\"qoder\"); // \u629b\u9519\uff1asupport = \"unsupported\"\n</code></pre>"},{"location":"recipes/host-profile-integration/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-engineering-kit/test/host.test.mjs \\\n fixtures/generic-profile-extension-conformance/verify.mjs\n</code></pre>"},{"location":"recipes/host-profile-integration/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u5bbf\u4e3b\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\u3002</li> <li>\u5bbf\u4e3b\u5e94\u7528\uff08apply\uff09\u7684\u6700\u7ec8\u843d\u5730\uff08\u5f53\u524d\u4e0d\u5728 Foundation \u8303\u56f4\uff09\u3002</li> </ul>"},{"location":"recipes/host-profile-integration/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u5bbf\u4e3b\u63a5\u5165\u7ebf\u53ea\u652f\u6301 describe/build/probe/plan\uff1bapply \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u672a\u5b9e\u73b0\u3002</li> <li>Qoder \u5b8c\u6574 driver \u4e3a unsupported\uff0c\u53ea\u53c2\u8003\u5176\u7ed3\u6784\uff0c\u4e0d\u58f0\u79f0\u5df2\u5728 Qoder \u8fd0\u884c\uff1b\u5347\u7ea7\u65b0\u589e\u53d7\u652f\u6301\u5bbf\u4e3b\u987b\u767b\u8bb0 descriptor \u5e76\u7ed1\u5b9a\u53d7\u4fe1 driver\u3002</li> </ul>"},{"location":"recipes/safe-filesystem-and-atomic-write/","title":"\u4e2d\u6587 \u00b7 \u5b89\u5168\u6587\u4ef6\u7cfb\u7edf\u4e0e\u539f\u5b50\u5199","text":"<p>English</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#Recipe\u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u4e0e\u539f\u5b50\u5199","title":"Recipe\uff1a\u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u4e0e\u539f\u5b50\u5199","text":""},{"location":"recipes/safe-filesystem-and-atomic-write/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u5728 Node \u5185\u628a\u5916\u90e8\u63d0\u4f9b\u7684\u8def\u5f84\u9650\u5236\u5728\u67d0\u4e2a\u6839\u76ee\u5f55\u5185\uff0c\u5e76\u5411\u53d7\u6536\u5bb9\u8def\u5f84\u539f\u5b50\u5199\u5165\u666e\u901a\u6587\u4ef6\uff0c\u5931\u8d25\u65f6\u56de\u6eda\u4e0d\u7559\u6b8b\u5f71\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u628a\u6587\u4ef6\u9009\u62e9\u7684\u4e1a\u52a1\u89c4\u5219\u653e\u5165 Foundation\uff08\u4e1a\u52a1\u89c4\u5219\u7531\u8c03\u7528\u65b9\u62e5\u6709\uff09\uff1b\u9700\u8981\u5199\u5165\u672a\u53d7\u6536\u5bb9\u8def\u5f84\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.path-containment</code>\uff08\u8def\u5f84\u5206\u7c7b\u4e0e\u53d7\u6536\u5bb9\u89e3\u6790\uff09\u4e0e <code>foundation.harness.atomic-write</code>\uff08\u53d7\u6536\u5bb9\u8def\u5f84\u5185\u539f\u5b50\u5199\uff09\u3002\u4e24\u8005\u90fd\u53ea\u5b9e\u73b0\u673a\u5236\uff0c\u4e0d\u62e5\u6709\u8bed\u4e49\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u8c03\u7528\u65b9\u63d0\u4f9b\u660e\u786e\u7684\u6839\u76ee\u5f55\uff08\u6536\u5bb9\u8fb9\u754c\uff09\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a\u6240\u6709\u89e3\u6790\u7ed3\u679c\u5fc5\u987b\u843d\u5728\u6839\u76ee\u5f55\u5185\uff1b\u8d8a\u754c\u3001\u7b26\u53f7\u94fe\u63a5\u9003\u9038\u3001\u771f\u5b9e\u8def\u5f84\u9003\u9038\u5747\u88ab\u62d2\u7edd\u3002</li> </ul>"},{"location":"recipes/safe-filesystem-and-atomic-write/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { resolveContained, writeFileAtomic } from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-safe-\"));\nconst target = resolveContained(root, \"nested/config.json\"); // \u53d7\u6536\u5bb9\u7edd\u5bf9\u8def\u5f84\nawait writeFileAtomic(target, JSON.stringify({ ok: true }));\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u5148\u6536\u5bb9\u8def\u5f84\u3001\u518d\u539f\u5b50\u5199\u5165\u7684\u57fa\u672c\u987a\u5e8f\uff1b<code>writeFileAtomic</code> \u7528\u4e34\u65f6\u6587\u4ef6 + fsync + rename\uff0c\u5931\u8d25\u56de\u6eda\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>resolveContained</code> \u8fd4\u56de\u843d\u5728\u6839\u5185\u7684\u7edd\u5bf9\u8def\u5f84\uff1b<code>writeFileAtomic</code> \u5199\u5165\u5b8c\u6210\u7684\u6587\u4ef6\uff0c\u5b57\u8282\u4e0e\u8f93\u5165\u4e00\u81f4\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/containment.test.mjs</code> \u4e0e <code>test/atomic.test.mjs</code>\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u8bd5\u56fe\u8d8a\u51fa\u6839\u76ee\u5f55 -> SFC2004 (path-traversal)\nimport { resolveContained } from \"skill-family-harness-node\";\nresolveContained(root, \"../escape.json\"); // \u629b HarnessError\uff0cdetails.kind = \"path-traversal\"\n</code></pre> <p>\u8d8a\u754c\u3001symlink-escape\u3001realpath-escape \u5747\u5f52 <code>SFC2004</code> \u52a0\u7a33\u5b9a <code>details.kind</code>\uff1b\u539f\u5b50\u5199\u5bf9\u8d8a\u754c\u8def\u5f84\u6216\u975e\u6cd5\u6570\u636e\u7c7b\u578b\u629b\u9519\u5e76\u56de\u6eda\u4e34\u65f6\u6587\u4ef6\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/containment.test.mjs \\\n packages/skill-family-harness-node/test/atomic.test.mjs\n</code></pre>"},{"location":"recipes/safe-filesystem-and-atomic-write/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u54ea\u4e9b\u8def\u5f84\u662f\u4e1a\u52a1\u5141\u8bb8\u7684\u9009\u62e9\u89c4\u5219\uff08\u4e0d\u5728 Foundation \u5185\uff09\u3002</li> <li>\u5199\u5165\u5185\u5bb9\u7684\u4e1a\u52a1\u6b63\u786e\u6027\u3002</li> </ul>"},{"location":"recipes/safe-filesystem-and-atomic-write/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u8def\u5f84\u6536\u5bb9\u4e0e\u539f\u5b50\u5199\u5747\u4e3a\u53d7\u6536\u5bb9\u673a\u5236\uff0c\u5931\u8d25\u56de\u6eda\u4e0d\u7559\u534a\u6210\u54c1\uff0c\u65e0\u5916\u90e8\u56de\u6eda\u9700\u6c42\u3002</li> <li>\u5347\u7ea7\u8ddf\u968f <code>skill-family-harness-node</code> \u7248\u672c\uff1b<code>HARNESS_EXCLUSIONS</code> \u4e0d\u5f15\u5165\u8fdc\u7aef\u6216 git \u5199\u3002</li> </ul>"},{"location":"reference/compatibility/","title":"\u4e2d\u6587 \u00b7 \u517c\u5bb9\u6027","text":"<p>English</p>"},{"location":"reference/compatibility/#\u517c\u5bb9\u6027\u4e0e\u652f\u6301\u77e9\u9635","title":"\u517c\u5bb9\u6027\u4e0e\u652f\u6301\u77e9\u9635","text":"<p>\u672c\u9875\u7ed9\u51fa\u5305\u3001Contracts\u3001Node \u4e0e\u5bbf\u4e3b\u7684\u652f\u6301\u77e9\u9635\u548c\u5347\u7ea7\u89c4\u5219\u3002\u6240\u6709\u7248\u672c\u53f7\u4ece\u673a\u5668\u771f\u6e90\u590d\u7b97\uff0c\u4e0d\u51ed\u8bb0\u5fc6\u3002</p>"},{"location":"reference/compatibility/#\u5305\u7248\u672c\u77e9\u9635","title":"\u5305\u7248\u672c\u77e9\u9635","text":"\u5305 \u7248\u672c\uff08package.json\uff09 \u89d2\u8272 \u53d1\u5e03\u72b6\u6001 <code>skill-family-contracts</code> 0.3.0 Contracts 1.4.0 \u673a\u5668\u5951\u7ea6 \u516c\u5f00\u53d1\u5e03\u76ee\u6807\uff08private: false\uff09 <code>skill-family-harness-node</code> 0.3.0 Contracts \u7684 Node \u8584\u673a\u5236\u8fd0\u884c\u65f6 \u516c\u5f00\u53d1\u5e03\u76ee\u6807 <code>skill-family-engineering-kit</code> 0.3.0 \u56db\u4e2a\u5de5\u7a0b\u547d\u4ee4\uff08CLI <code>skill-family-kit</code>\uff09 \u516c\u5f00\u53d1\u5e03\u76ee\u6807 \u5de5\u4f5c\u533a\u4ed3 0.3.0 \u79c1\u6709\u7236\u5de5\u4f5c\u533a\uff08private: true\uff09 \u4ec5\u5f00\u53d1\u771f\u6e90 <p>\u5951\u7ea6\u6743\u5a01\u7248\u672c\uff08<code>CONTRACTS_VERSION</code>\uff09\u4e3a <code>1.4.0</code>\uff0cnpm \u5305\u7248\u672c\u4e3a <code>0.3.0</code>\uff0c\u4e24\u5957\u7248\u672c\u5e76\u884c\uff0c\u4e0d\u6df7\u7528\u3002</p>"},{"location":"reference/compatibility/#Quickstart-Profile-candidate-\u517c\u5bb9\u6027","title":"Quickstart Profile candidate \u517c\u5bb9\u6027","text":"\u5305\u7248\u672c candidate profile \u517c\u5bb9\u89c4\u5219 0.2.1 v1 \u5df2\u6709\u63a5\u5165\u53ef\u7ee7\u7eed\u7cbe\u786e\u9501\u5b9a 0.2.1 0.3.0 v2 \u4f7f\u7528 <code>execute-method</code>\u3001\u771f\u5b9e <code>$id</code> Schema \u96c6\u5408\u4e0e\u79bb\u7ebf Bundle\uff1b\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a 0.3.0 <p>v2 \u66ff\u6362 v1\uff0c\u4e0d\u63d0\u4f9b\u53cc\u8f68\u517c\u5bb9\u5c42\u3002\u7a33\u5b9a Contracts 1.4.0\u300118 \u7c7b\u5bf9\u8c61\u3001\u5185\u6838\u534f\u8bae\u4e0e\u9519\u8bef\u7801\u767b\u8bb0\u4e0d\u968f candidate \u5207\u6362\u800c\u53d8\u5316\u3002</p>"},{"location":"reference/compatibility/#Node-\u652f\u6301\u77e9\u9635","title":"Node \u652f\u6301\u77e9\u9635","text":"<ul> <li>\u5f15\u64ce\u8981\u6c42\uff1a<code>>=22.22.2 <23</code>\uff08\u9501\u5b9a major 22\uff09\u3002</li> <li>\u7cbe\u786e floor\uff1a<code>.node-version</code> \u53d6 <code>22.22.2</code>\uff0c\u4f5c\u4e3a\u8fd0\u884c\u65f6\u7248\u672c\u5224\u5b9a\u7684\u673a\u68b0\u771f\u6e90\u3002</li> <li>pnpm\uff1a<code>10.30.0</code>\uff08<code>package.json</code> \u7684 <code>packageManager</code>\uff09\u3002</li> <li>projen\uff1a<code>0.101.23</code>\uff08\u53d7\u7ba1\u5de5\u7a0b\u6587\u4ef6\u552f\u4e00\u751f\u6210\u5165\u53e3\uff09\u3002</li> </ul> <p>\u4f4e\u4e8e floor \u7684 Node \u7248\u672c\u4e0d\u80fd\u66ff\u4ee3\u6743\u5a01\u7ed3\u679c\uff1b\u7b2c\u4e8c\u8bed\u8a00\u5b9e\u73b0\u9996\u7248\u4e3a 0\u3002</p>"},{"location":"reference/compatibility/#Contracts-\u7248\u672c\u4e0e\u7a33\u5b9a\u6027","title":"Contracts \u7248\u672c\u4e0e\u7a33\u5b9a\u6027","text":"<ul> <li>\u9876\u5c42\u5bf9\u8c61\uff1a18 \u7c7b\uff08\u4ee5 <code>packages/skill-family-contracts/src/registry.json</code> \u4e3a\u552f\u4e00\u771f\u6e90\uff09\u3002</li> <li>\u5f3a\u5236\u673a\u68b0\u89c4\u5219\uff1a9 \u6761\uff0c\u9884\u7b97\u4e0a\u9650 20\u3001\u7edd\u5bf9\u4e0a\u9650 30\u3002</li> <li>kernel \u534f\u8bae\uff1a<code>skill-family.kernel.operation</code>\uff08stable\uff09\uff0cContracts 1.4.0\u3002</li> <li>Schema \u6821\u9a8c\u5668\uff1aAjv 8.20.0\uff08\u7cbe\u786e pin\uff09\uff0c\u652f\u6301 draft-07 \u4e0e 2020-12\u3002</li> <li>\u9519\u8bef\u7801\uff1a\u51bb\u7ed3\u767b\u8bb0\u8868\uff0c\u7801\u53ea\u589e\u4e0d\u6539\u3001\u4e0d\u590d\u7528\u3002</li> </ul>"},{"location":"reference/compatibility/#\u5bbf\u4e3b\u652f\u6301\u77e9\u9635","title":"\u5bbf\u4e3b\u652f\u6301\u77e9\u9635","text":"\u5bbf\u4e3b support driver \u5907\u6ce8 claude supported claude-version-v1 \u6280\u80fd\u8def\u5f84\u7531 Profile \u51b3\u5b9a codex supported codex-version-v1 \u6280\u80fd\u8def\u5f84\u56fa\u5b9a <code>.agents/skills</code> qoder unsupported \u65e0 No auditable non-interactive host driver is frozen <p>\u5bbf\u4e3b\u63a5\u5165\u7ebf\u5f53\u524d\u53ea\u652f\u6301 <code>describe</code>/<code>build</code>/<code>probe</code>/<code>plan</code>\uff1b<code>apply</code> \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u5747\u672a\u5b9e\u73b0\u3002</p>"},{"location":"reference/compatibility/#\u5347\u7ea7\u89c4\u5219","title":"\u5347\u7ea7\u89c4\u5219","text":"<ul> <li>\u5305\u7248\u672c\uff1a\u4e09\u4e2a\u53f6\u5b50\u5305\u5fc5\u987b\u540c\u6b65\u7248\u672c\uff0c\u7981\u6b62\u5355\u5305\u6f02\u79fb\uff1b\u65b0\u589e\u7ec4\u4ef6\u987b\u8bf4\u660e\u5220\u9664\u5b83\u4f1a\u8ba9\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\u3002</li> <li>Contracts\uff1a\u5bf9\u8c61\u96c6\u5408\u56fa\u5b9a 18 \u7c7b\uff0c\u65b0\u589e\u9700 ADR\uff1b\u9519\u8bef\u7801\u51bb\u7ed3\u4e0d\u6f02\u79fb\uff1bSchema \u53d8\u66f4\u4f5c\u4e3a\u65b0\u7684\u5408\u540c\u7248\u672c\u4efb\u52a1\u8fdb\u884c\u3002</li> <li>Kit \u547d\u4ee4\uff1a\u9876\u5c42\u547d\u4ee4\u56fa\u5b9a 4 \u4e2a\uff08scaffold/adopt-plan/projection/check\uff09\uff0c\u4e0d\u6269\u5f20\uff1b<code>REFUSED_MUTATION_FLAGS</code> \u5728 CLI \u5165\u53e3\u5373\u62d2\u3002</li> <li>Node/pnpm/projen\uff1a\u8ddf\u968f <code>.foundation/version-lock.json</code> \u4e0e <code>package.json</code> \u7684\u7cbe\u786e\u9501\u5b9a\uff0c\u5347\u7ea7\u987b\u7ecf <code>pnpm synth</code> \u91cd\u65b0\u751f\u6210\u53d7\u7ba1\u6295\u5f71\u3002</li> <li>\u5bbf\u4e3b\uff1a\u65b0\u589e\u53d7\u652f\u6301\u5bbf\u4e3b\u987b\u767b\u8bb0 descriptor \u5e76\u7ed1\u5b9a\u53d7\u4fe1 driver\uff1bunsupported \u5bbf\u4e3b\uff08\u5982 qoder\uff09\u53ea\u53c2\u8003\u7ed3\u6784\uff0c\u4e0d\u58f0\u79f0\u5df2\u5728\u5176\u4e0a\u8fd0\u884c\u3002</li> <li>Candidate\uff1acandidate \u5b50\u8def\u5f84\u5141\u8bb8\u5728\u540e\u7eed minor \u7248\u672c\u4fee\u6539\u6216\u79fb\u9664\uff1b0.2.1 v1 \u4e0e 0.3.0 v2 \u4e0d\u6df7\u88c5\uff0c\u6d88\u8d39\u8005\u6309\u6240\u9700 profile \u7cbe\u786e\u9501\u5b9a\u4e09\u4e2a\u5305\u7248\u672c\u3002</li> </ul>"},{"location":"reference/compatibility/#\u53cd\u517c\u5bb9\u8fb9\u754c\u660e\u786e\u4e0d\u652f\u6301","title":"\u53cd\u517c\u5bb9\u8fb9\u754c\uff08\u660e\u786e\u4e0d\u652f\u6301\uff09","text":"<ul> <li>host apply / install / update / uninstall\uff08unsupported\uff09\u3002</li> <li>Qoder \u5b8c\u6574 driver\uff08unsupported\uff09\u3002</li> <li>\u4e8c\u8fdb\u5236 adapter source\uff08\u4ec5\u6587\u672c\u95ed\u5305\uff09\u3002</li> <li>\u8fdc\u7aef\u53d1\u5e03\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165\uff08\u5f52 release-skill\uff09\u3002</li> <li>\u4e1a\u52a1\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u3001\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\uff08\u5206\u522b\u7559\u6d88\u8d39\u8005 / loop-agent / \u72ec\u7acb\u5ba1\u8ba1\uff09\u3002</li> </ul>"},{"location":"reference/failure-and-side-effect-matrix/","title":"\u4e2d\u6587 \u00b7 \u5931\u8d25\u4e0e\u526f\u4f5c\u7528","text":"<p>English</p>"},{"location":"reference/failure-and-side-effect-matrix/#\u5931\u8d25\u4e0e\u526f\u4f5c\u7528\u77e9\u9635","title":"\u5931\u8d25\u4e0e\u526f\u4f5c\u7528\u77e9\u9635","text":"<p>\u672c\u9875\u9010\u516c\u5171\u5165\u53e3\u5217\u51fa\u8bfb\u5199\u3001spawn\u3001Git\u3001\u7f51\u7edc\u3001\u6b8b\u4f59\u72b6\u6001\u4e0e\u7a33\u5b9a\u9519\u8bef\u7801\u3002\u5b83\u670d\u52a1\u4e8e\u8c03\u7528\u65b9\u5728\u63a5\u5165\u524d\u5224\u65ad\u98ce\u9669\uff0c\u5e76\u4f5c\u4e3a <code>capability-catalog.json</code> \u4e2d <code>sideEffects</code> \u4e0e <code>failureSemantics</code> \u5b57\u6bb5\u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\u3002\u6240\u6709\u4e8b\u5b9e\u4ee5\u771f\u5b9e\u5b9e\u73b0\u4e0e\u8d1f\u4f8b\u6d4b\u8bd5\u4e3a\u51c6\u3002</p> <p>\u7b26\u53f7\u7ea6\u5b9a\uff1a\u8bfb=\u8bfb\u53d6\u6587\u4ef6\u7cfb\u7edf\uff1b\u5199=\u5199\u5165\u6587\u4ef6\u7cfb\u7edf\uff1bspawn=\u542f\u52a8\u5b50\u8fdb\u7a0b\uff1bGit=\u8bfb\u5199 Git\uff1b\u7f51\u7edc=\u8bbf\u95ee\u8fdc\u7aef\uff1b\u6b8b\u4f59=\u8c03\u7528\u7ed3\u675f\u540e\u4ecd\u7559\u5728\u78c1\u76d8/\u8fdb\u7a0b\u4e2d\u7684\u72b6\u6001\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#Contracts\u7eaf\u51fd\u6570\u5c42","title":"Contracts\uff08\u7eaf\u51fd\u6570\u5c42\uff09","text":"\u5165\u53e3 \u8bfb \u5199 spawn Git \u7f51\u7edc \u6b8b\u4f59\u72b6\u6001 \u7a33\u5b9a\u9519\u8bef\u7801 <code>validateDocument</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u7f16\u8bd1\u7f13\u5b58\u4ec5\u9a7b\u7559\u5185\u5b58\uff09 <code>SFC1001</code>/<code>SFC1002</code>/<code>SFC1006</code> <code>compileSchema</code> / <code>detectDialect</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC1006</code>/<code>SFC1012</code> <code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC1003</code>/<code>SFC1004</code> <code>runChecks</code> / <code>collectUnresolvedRefs</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC1002</code>\u2013<code>SFC1010</code> <code>verifyAllFixtures</code> / <code>verifyFixture</code> \u5426 \u5426 \u5426? \u5426 \u5426 \u5426 \u65e0 <code>SFC1010</code> <code>ERROR_CODES</code> / <code>stableError</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 \u51bb\u7ed3\u767b\u8bb0\u8868\uff0c\u4e0d\u65b0\u589e <p>Contracts \u5168\u90e8\u4e3a\u7eaf\u51fd\u6570\uff0c\u65e0\u6587\u4ef6/Git/\u7f51\u7edc/\u8fdb\u7a0b\u526f\u4f5c\u7528\uff1b\u9519\u8bef\u5bf9\u8c61\u542b <code>stableError</code> \u4e0e <code>details.kind</code>\uff0c\u4fbf\u4e8e\u8c03\u7528\u65b9\u5206\u7c7b\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#Harness\u673a\u5236\u5c42\u53d7\u6536\u5bb9","title":"Harness\uff08\u673a\u5236\u5c42\uff0c\u53d7\u6536\u5bb9\uff09","text":"\u5165\u53e3 \u8bfb \u5199 spawn Git \u7f51\u7edc \u6b8b\u4f59\u72b6\u6001 \u7a33\u5b9a\u9519\u8bef\u7801 <code>validateContractDocument</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u6821\u9a8c\u5668\u7f13\u5b58\u5185\u5b58\uff09 <code>SFC</code> \u6821\u9a8c\u5931\u8d25 <code>resolveContained</code> / <code>readFileContained</code> \u662f\uff08\u53ea\u8bfb\uff09 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC2004</code>\uff08<code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>\uff09 <code>writeFileAtomic</code> \u5426 \u662f\uff08\u53d7\u6536\u5bb9\uff09 \u5426 \u5426 \u5426 \u5931\u8d25\u56de\u6eda\u4e34\u65f6\u6587\u4ef6 <code>SFC2004</code>\uff08<code>atomic-write-failed</code>\uff09 <code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code> \u5426 \u662f\uff08\u4e34\u65f6\u76ee\u5f55\uff09 \u5426 \u5426 \u5426 \u9000\u51fa\u65f6\u6e05\u7406\u4e34\u65f6\u76ee\u5f55 <code>SFC2004</code>\uff08<code>workspace-disposed</code>\uff09 <code>computeResourceClosure</code> / <code>digestBytes</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC</code>\uff08\u58f0\u660e/\u5185\u5bb9\u8fdd\u89c4\uff09 <code>parseRequest</code> / <code>processRequest</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u7eaf\u51fd\u6570\u7ba1\u7ebf\uff09 <code>SFC2004</code> <code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>checkReport</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u7eaf\u51fd\u6570\uff09 <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC2004</code>\uff08<code>missing-resource</code>\uff09 <code>materializeAdapterBuild</code> \u5426 \u662f\uff08\u53d7\u6536\u5bb9\uff0csibling + rename\uff09 \u5426 \u5426 \u5426 \u65e0\uff08\u539f\u5b50 rename\uff09 <code>SFC2004</code> <code>probeVersionVector</code> \u5426 \u5426 \u9ed8\u8ba4\u5426\uff08\u9700\u663e\u5f0f <code>--allow-host-spawn</code>\uff09 \u5426 \u5426 \u65e0 <code>SFC2004</code> <code>openStateStore</code> / <code>appendEvent</code> / <code>readEvents</code> / <code>writeSnapshot</code> \u662f \u662f\uff08\u4e8b\u4ef6/\u5feb\u7167/\u9501\u6587\u4ef6\uff09 \u5426 \u5426 \u5426 \u4e8b\u4ef6\u65e5\u5fd7 + \u9501\u6587\u4ef6 <code>SFC2004</code>\uff08<code>store-locked</code>/\u94fe\u65ad\u88c2\uff09 <code>inspectStateStoreLock</code> / <code>recoverStateStoreLock</code> \u662f \u662f\uff08\u4ec5\u6062\u590d\u5199\u9501\uff09 \u5426 \u5426 \u5426 \u9501\u6587\u4ef6\uff08\u5355\u8c03 fencing\uff09 <code>SFC2004</code> <p>Harness \u7684 <code>HARNESS_EXCLUSIONS</code> \u660e\u786e\u6392\u9664 release-state\u3001remote-network-access\u3001business-semantics\u3001workflow-orchestration\u3001model-calls\u3001git-writes\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#Engineering-Kit\u5de5\u7a0b\u547d\u4ee4\u5c42","title":"Engineering Kit\uff08\u5de5\u7a0b\u547d\u4ee4\u5c42\uff09","text":"\u5165\u53e3 \u8bfb \u5199 spawn Git \u7f51\u7edc \u6b8b\u4f59\u72b6\u6001 \u7a33\u5b9a\u9519\u8bef\u7801 / \u9000\u51fa\u7801 <code>scaffoldTarget</code> \u5426 \u662f\uff08\u53d7\u6536\u5bb9\u9aa8\u67b6\uff0c\u539f\u5b50 + \u6536\u5bb9\uff09 \u5426 \u5426 \u5426 \u65e0\uff08\u5931\u8d25\u4e0d\u7559\u534a\u6210\u54c1\uff09 <code>SFC2004</code>\uff08<code>target-not-empty</code>\uff09 <code>planAdoption</code> / <code>buildHandoffDraft</code> \u662f \u5426 \u5426 \u53ea\u8bfb\u63a2\u6d4b \u5426 \u65e0\uff08stdout \u8f93\u51fa\uff09 <code>SFC</code> \u5b8c\u6210\u5224\u5b9a false <code>runProjection</code> \u662f\uff08\u8bfb manifest\uff09 \u662f\uff08\u53d7\u7ba1\u8def\u5f84\uff0c\u4e24\u9636\u6bb5\uff09 \u5426 \u5426 \u5426 \u65e0\uff08\u5931\u8d25\u96f6\u5199/\u56de\u6eda\uff09 <code>SFC2004</code>\uff08<code>unauthorized-path</code>/<code>handwritten-overwrite</code>/<code>conflict-drift</code>\uff09 <code>runChecks</code>\uff08<code>check</code>\uff09 \u662f \u5426 \u5426 \u53ea\u8bfb\u767d\u540d\u5355 \u5426 \u65e0 \u9000\u51fa\u7801 1\uff08\u53d1\u73b0\uff09/ 2\uff08\u673a\u5236\uff09 <code>renderReportAction</code> / <code>checkReportAction</code> \u662f \u4ec5 <code>--out</code>/<code>--binding</code> \u5426 \u5426 \u5426 \u9ed8\u8ba4\u53ea\u5199 stdout <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>probeGitState</code> / <code>probeGitFacts</code> \u662f \u5426 \u5426 \u53ea\u8bfb\u767d\u540d\u5355 \u5426 \u65e0 <code>SFC</code>\uff08\u8d8a\u6743\u53c2\u6570\u62d2\u7edd\uff09 <code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code> \u662f build \u5199\uff08\u53d7\u6536\u5bb9\uff09 probe \u9ed8\u8ba4\u5426 \u5426 \u5426 \u65e0 <code>SFC2004</code>\uff1bapply \u7a33\u5b9a\u62d2\u7edd <code>loadLicensingProfile</code> / <code>generateLicenseContent</code> \u7b49 \u5426 \u5426\uff08\u7eaf\u51fd\u6570\u751f\u6210\uff09 \u5426 \u5426 \u5426 \u65e0 <code>SFC</code>\uff08\u975e\u6cd5 Profile\uff09 <code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code> \u662f \u5426 \u5426 \u5426 \u5426 \u65e0 findings <code>cliMain</code> / <code>runCommand</code> \u4f9d\u547d\u4ee4 \u4f9d\u547d\u4ee4 \u4f9d\u547d\u4ee4 \u4f9d\u547d\u4ee4 \u5426 \u4f9d\u547d\u4ee4 \u9000\u51fa\u7801 0/1/2 <p>Kit \u7684 <code>FORBIDDEN_SIDE_EFFECTS</code> \u542b git-init/commit/push/tag\u3001publish\u3001remote-write\uff1b<code>REFUSED_MUTATION_FLAGS</code>\uff08\u542b <code>--apply</code>\uff09\u5728 CLI \u5165\u53e3\u5373\u62d2\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#\u6b8b\u4f59\u72b6\u6001\u5408\u96c6","title":"\u6b8b\u4f59\u72b6\u6001\u5408\u96c6","text":"<ul> <li>\u539f\u5b50\u5199\uff1a\u5931\u8d25\u65f6\u56de\u6eda\u4e34\u65f6\u6587\u4ef6\uff0c\u76ee\u6807\u76ee\u5f55\u4e0d\u7559\u534a\u6210\u54c1\u3002</li> <li>\u4e34\u65f6\u5de5\u4f5c\u533a\uff1a\u9000\u51fa\uff08\u542b\u5f02\u5e38\u8def\u5f84\uff09\u65f6\u6e05\u7406\u3002</li> <li>\u72b6\u6001\u5b58\u50a8\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u662f\u552f\u4e00\u6743\u5a01\uff0csnapshot \u4e3a\u6d3e\u751f\u7f13\u5b58\uff1b\u5d29\u6e83\u9057\u7559\u9501\u9700\u8c03\u7528\u65b9\u5728 Foundation \u5916\u786e\u8ba4\u65e7\u5199\u8005\u7ec8\u6b62\u540e\u663e\u5f0f\u6062\u590d\uff0c\u4e0d\u81ea\u52a8\u5077\u9501\u3002</li> <li>\u6295\u5f71\uff1a\u4efb\u4e00\u6821\u9a8c\u5931\u8d25\u6574\u4f53\u62d2\u7edd\u3001\u96f6\u5199\u5165\uff1b\u8986\u76d6\u65e2\u6709\u6587\u4ef6\u9700\u58f0\u660e <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u3002</li> <li>adopt-plan / check\uff1a\u7ed3\u6784\u6027\u53ea\u8bfb\uff0c\u8fd0\u884c\u524d\u540e\u5b57\u8282\u7ea7\u96f6\u53d8\u5316\u3002</li> </ul>"},{"location":"reference/failure-and-side-effect-matrix/#\u5931\u8d25\u540e\u8c03\u7528\u65b9\u8be5\u505a\u4ec0\u4e48","title":"\u5931\u8d25\u540e\u8c03\u7528\u65b9\u8be5\u505a\u4ec0\u4e48","text":"<ul> <li>\u6821\u9a8c\u5931\u8d25\uff08<code>SFC1001</code>/<code>SFC2002</code>/<code>SFC2003</code>\uff09\uff1a\u68c0\u67e5\u8f93\u5165\u662f\u5426\u6ee1\u8db3\u76ee\u6807 Schema \u6216\u53c2\u6570\u5408\u540c\uff0c\u4e0d\u91cd\u8bd5\u5df2\u88ab\u51bb\u7ed3\u62d2\u7edd\u7684\u767b\u8bb0\u3002</li> <li>\u6536\u5bb9\u5931\u8d25\uff08<code>SFC2004</code> + <code>path-traversal</code> \u7b49\uff09\uff1a\u786e\u8ba4\u6839\u76ee\u5f55\u4e0e\u8def\u5f84\u662f\u5426\u8d8a\u754c\uff0c\u4e0d\u8981\u628a\u4e1a\u52a1\u9009\u62e9\u89c4\u5219\u585e\u8fdb Foundation\u3002</li> <li>\u72b6\u6001\u9501\u51b2\u7a81\uff08<code>store-locked</code>\uff09\uff1a\u5728 Foundation \u4e4b\u5916\u786e\u8ba4\u65e7\u5199\u8005\u5df2\u7ec8\u6b62\uff0c\u518d\u7528\u7cbe\u786e\u5339\u914d\u7684 owner/fencing \u8c03\u7528\u6062\u590d\u3002</li> <li>check \u53d1\u73b0\uff08\u9000\u51fa\u7801 1\uff09\uff1a\u5904\u7f6e\u53d1\u73b0\u9879\uff0cKit \u4e0d\u81ea\u52a8\u4fee\u590d\u3002</li> </ul>"},{"location":"reference/api/","title":"\u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u76ee\u5f55\u4e3a Skill Family Foundation \u4e09\u5305\u5efa\u7acb\u673a\u5668\u53ef\u8bfb\u80fd\u529b\u76ee\u5f55\uff08<code>docs/agents/capability-catalog.json</code>\uff09\u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\u3002\u8303\u56f4\u6309 hand-off \u00a74.3\uff1a\u4f18\u5148\u4ece\u771f\u5b9e\u5bfc\u51fa\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684 API \u5168\u96c6\u3002</p>"},{"location":"reference/api/#\u8986\u76d6\u8303\u56f4","title":"\u8986\u76d6\u8303\u56f4","text":"\u5305 \u9875\u9762 \u516c\u5171\u5165\u53e3\u6027\u8d28 <code>skill-family-contracts</code> contracts.md \u673a\u5668\u5951\u7ea6\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001fixture\u3001\u5ba1\u8ba1\u8868\u9762\uff08\u7eaf\u51fd\u6570\u4e3a\u4e3b\uff09 <code>skill-family-harness-node</code> harness.md \u4e1a\u52a1\u4e2d\u7acb Node \u673a\u5236\uff08\u6536\u5bb9\u3001\u539f\u5b50\u5199\u3001\u95ed\u5305\u3001\u8bf7\u6c42\u3001\u62a5\u544a\u3001\u72b6\u6001\u5e95\u5ea7\uff09 <code>skill-family-engineering-kit</code> engineering-kit.md \u56db\u4e2a\u9876\u5c42\u547d\u4ee4\u4e0e\u53ea\u8bfb/\u53d7\u63a7\u5199\u5b50\u52a8\u4f5c <p>\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 \u00a74.3 \u81f3\u5c11\u8bf4\u660e\uff1a\u7b7e\u540d\u4e0e\u8f93\u5165\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p>"},{"location":"reference/api/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u5173\u7cfb","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u5173\u7cfb","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID\uff08\u5982 <code>foundation.contracts.object-validation</code>\u3001<code>foundation.harness.state-store</code>\uff09\u5b9a\u4e49\u5728 <code>docs/agents/capability-catalog.json</code>\uff0c\u672c\u9875\u4ece\u4e2d\u6295\u5f71\u5e76\u94fe\u63a5\u56de <code>sourceRefs</code> \u4e0e\u6d4b\u8bd5\u5f15\u7528\u3002</li> <li>\u672c\u9875\u7b7e\u540d\u53d6\u81ea\u5404\u5305 <code>src/index.mjs</code> \u4e0e\u6e90\u6a21\u5757\u771f\u5b9e\u5bfc\u51fa\uff1b\u95e8\u7981 <code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code>\uff0c\u62d2\u7edd catalog \u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\u3002</li> <li>catalog \u662f\u6587\u6863\u5c42\u673a\u5668\u4e8b\u5b9e\uff0c\u4e0d\u662f\u65b0\u7684 Contracts \u516c\u5171\u5bf9\u8c61\u6216\u534f\u8bae\uff1b\u672a\u7ecf ADR \u4e0d\u5f97\u4e3a\u5199\u6587\u6863\u65b0\u589e\u7b2c\u56db\u5305\u6216 Contracts \u5bf9\u8c61\u3002</li> </ul>"},{"location":"reference/api/#\u5173\u952e\u7eaa\u5f8b","title":"\u5173\u952e\u7eaa\u5f8b","text":"<ul> <li>\u673a\u5236\u5931\u8d25\u7edf\u4e00 <code>SFC2004</code>\uff08<code>EXECUTION_FAILED</code>\uff09\uff0c\u7531 <code>details.kind</code> \u533a\u5206\uff08<code>HARNESS_ERROR_KINDS</code> \u51bb\u7ed3\u679a\u4e3e\uff09\uff1bContracts \u6821\u9a8c\u5931\u8d25\uff08<code>SFC1001</code> / <code>SFC1002</code>\uff09\u7ecf <code>validateDocument</code> \u8fd4\u56de\u503c\u8868\u8fbe\u3001\u4e0d\u629b\u5f02\u5e38\u3002</li> <li>Kit \u9876\u5c42\u547d\u4ee4\u96c6\u5408\u56fa\u5b9a\u4e3a 4 \u4e2a\uff08<code>scaffold</code> / <code>adopt-plan</code> / <code>projection</code> / <code>check</code>\uff09\uff0c\u4e0d\u6269\u5f20\uff1b<code>host apply</code> / <code>install</code> / <code>update</code> / <code>uninstall</code>\u3001Qoder \u5b8c\u6574 driver\u3001\u4e8c\u8fdb\u5236 adapter source\u3001\u8fdc\u7aef\u53d1\u5e03\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u3001\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\u5747\u660e\u786e unsupported\u3002</li> <li>\u6240\u6709\u7248\u672c\u5b57\u6bb5\u4ece <code>package.json</code> \u4e0e Contracts \u771f\u6e90\u751f\u6210\u6216\u7531 fact-check \u6821\u9a8c\uff1b<code>CONTRACTS_VERSION=1.4.0</code> \u4e0e npm \u5305\u7248\u672c <code>0.3.0</code> \u5e76\u884c\u3002</li> </ul>"},{"location":"reference/api/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p>\u4e09\u4e2a\u5305\u90fd\u901a\u8fc7\u65e2\u6709 candidate \u5b50\u8def\u5f84\u516c\u5f00 Quickstart Profile v2\u3002Contracts \u5b9a\u4e49 <code>execute-method</code> \u4ea4\u6362\u7ed3\u6784\uff0cHarness \u590d\u9a8c\u5b57\u8282\u548c\u7ed1\u5b9a\uff0cKit \u4ece\u663e\u5f0f\u6d88\u8d39\u8005 Schema \u751f\u6210\u79bb\u7ebf Bundle\u3002\u8be5\u80fd\u529b\u4ecd\u6807\u8bb0\u4e3a <code>candidate</code>\uff0c0.3.0 \u7684 v2 \u4e0e 0.2.1 \u7684 v1 \u4e0d\u517c\u5bb9\uff1b\u6d88\u8d39\u8005\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a\u6240\u9009\u5305\u7248\u672c\u3002</p>"},{"location":"reference/api/contracts/","title":"skill-family-contracts \u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u9875\u4ece\u771f\u5b9e\u5bfc\u51fa\uff08<code>src/index.mjs</code> \u4e0e\u5404\u6e90\u6a21\u5757\uff09\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684\u5168\u96c6\u3002\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 hand-off \u00a74.3 \u8bf4\u660e\uff1a\u7b7e\u540d\u3001\u8f93\u5165\u4e0e\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p> <p>\u80fd\u529b\u5206\u7ec4\uff08\u4e0e <code>docs/agents/capability-catalog.json</code> \u5bf9\u5e94\uff09\uff1a</p> <ul> <li>\u5bf9\u8c61\u6821\u9a8c \u2192 <code>validateDocument</code> / <code>compileSchema</code> / <code>detectDialect</code></li> <li>\u767b\u8bb0\u4e0e\u534f\u8bae \u2192 <code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code> / <code>registerSchema</code> / <code>registerProtocol</code></li> <li>\u5185\u6838\u534f\u8bae \u2192 <code>loadKernelProtocol</code> / <code>findOperation</code> / <code>checkOperation</code></li> <li>\u5f3a\u5236\u68c0\u67e5 \u2192 <code>runChecks</code> / <code>collectUnresolvedRefs</code></li> <li>fixture \u6821\u9a8c \u2192 <code>listFixtures</code> / <code>verifyFixture</code> / <code>verifyAllFixtures</code></li> <li>\u9519\u8bef\u7801 \u2192 <code>ContractsError</code> / <code>isRegisteredErrorCode</code> / <code>stableError</code></li> <li>\u5ba1\u8ba1\u8868\u9762 \u2192 <code>canonicalJson</code> / <code>digestDocument</code> / <code>digestAuditSurface</code></li> </ul> <p>\u5305\u7ea7\u5e38\u91cf\uff08\u51bb\u7ed3\uff0c\u4ec5\u4f5c\u4e8b\u5b9e\u6295\u5f71\uff0c\u4e0d\u53e6\u7acb\u6743\u5a01\uff09\uff1a<code>CONTRACT_OBJECTS</code>\uff0818 \u7c7b\u9876\u5c42\u5bf9\u8c61\uff0c\u95ed\u96c6\uff09\u3001<code>CONTRACT_BOUNDARY</code>\u3001<code>CONTRACTS_VERSION = \"1.4.0\"</code>\u3001<code>SUPPORTED_DIALECTS</code>\u3001<code>VALIDATION_POLICIES</code>\u3001<code>CHECK_TYPES</code>\uff089 \u7c7b\u673a\u68b0\u68c0\u67e5\uff09\u3001<code>MANDATORY_RULES</code>\u3001<code>RULE_BUDGET</code>\u3001<code>ERROR_CODES</code>\u3002</p>"},{"location":"reference/api/contracts/#\u5bf9\u8c61\u6821\u9a8c-foundationcontractsobject-validation","title":"\u5bf9\u8c61\u6821\u9a8c (foundation.contracts.object-validation)","text":""},{"location":"reference/api/contracts/#validateDocument","title":"validateDocument","text":"<ul> <li>\u7b7e\u540d\uff1a<code>validateDocument(document, { schemaId, schema, dialect, policy = \"strict\" } = {})</code></li> <li>\u8f93\u5165\uff1a\u4efb\u610f JSON \u6587\u6863\uff1b\u76ee\u6807\u5951\u7ea6\u5bf9\u8c61 <code>$id</code> \u6216 schema \u5bf9\u8c61\uff1b\u65b9\u8a00\uff08<code>draft-07</code> / <code>2020-12</code>\uff09\uff1b\u7b56\u7565\uff08<code>strict</code> \| <code>tolerant</code>\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u6821\u9a8c\u901a\u8fc7\u8fd4\u56de <code>{valid:true}</code>\uff08\u4e0d\u542b <code>errorCode</code>\uff09\uff1b\u5931\u8d25\u8fd4\u56de <code>{valid:false, errorCode, errors}</code>\uff0c\u4e0d\u629b\u51fa\uff08\u5df2\u5b9e\u6d4b\uff1a\u672a\u77e5 <code>$id</code> \u8fd4\u56de <code>SFC1002</code>\uff0c\u6587\u6863\u4e0d\u7b26\u8fd4\u56de <code>SFC1001</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002\u4ec5\u8bfb\u53d6\u8fdb\u7a0b\u5185 Ajv \u7f16\u8bd1\u7f13\u5b58\uff0c\u4e0d\u89e6\u5916\u90e8\u8d44\u6e90\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6/Git/\u7f51\u7edc/\u8fdb\u7a0b\u526f\u4f5c\u7528\uff1b\u9996\u6b21\u7f16\u8bd1\u5199\u5165\u5185\u5b58\u7f16\u8bd1\u7f13\u5b58\uff0c\u540e\u7eed\u540c <code>(schemaId,dialect,policy)</code> \u590d\u7528\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1002</code>\uff08\u672a\u77e5 <code>$id</code>\uff09\u3001<code>SFC1001</code>\uff08\u6587\u6863\u4e0d\u7b26 Schema\uff09\u3002\u4e24\u8005\u5747\u7ecf\u8fd4\u56de\u503c <code>errorCode</code> \u8868\u8fbe\uff0c\u8c03\u7528\u65b9\u4ee5 <code>valid</code> \u5b57\u6bb5\u5224\u65ad\u6210\u8d25\uff0c\u4e0d\u4ee5 <code>try/catch</code> \u6355\u83b7\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5f85\u6821\u9a8c\u6587\u6863\u5e26\u5df2\u767b\u8bb0\u5951\u7ea6\u5bf9\u8c61 <code>$id</code>\uff1bNode >= 22.22.2\uff1b\u6821\u9a8c\u5668\u56fa\u5b9a\u4e3a Ajv 8.20.0\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/validator.mjs</code>\u3002</li> <li>\u6b63\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/validator.test.mjs</code>\u3001<code>schemas.test.mjs</code>\u3001<code>host-contracts.test.mjs</code>\u3001<code>report-contracts.test.mjs</code>\u3002</li> <li>\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c\u4e0a\uff08\u672a\u77e5 <code>$id</code> \u4e0e\u4e0d\u7b26 Schema \u5747\u8fd4\u56de <code>valid:false</code>\uff09\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5177\u4f53\u4e1a\u52a1\u5b57\u6bb5\u7684\u8bed\u4e49\u89e3\u91ca\u3001\u9886\u57df\u7ea7\u6821\u9a8c\u89c4\u5219\u3002</li> </ul>"},{"location":"reference/api/contracts/#compileSchema","title":"compileSchema","text":"<ul> <li>\u7b7e\u540d\uff1a<code>compileSchema(target, { dialect, policy = \"strict\" } = {})</code></li> <li>\u8f93\u5165\uff1aschema \u5bf9\u8c61\u6216 <code>$id</code>\uff1b\u65b9\u8a00\uff1b\u7b56\u7565\u3002</li> <li>\u8f93\u51fa\uff1a\u7f16\u8bd1\u540e\u7684 Ajv <code>validate</code> \u51fd\u6570\uff1b\u6216\u629b <code>ContractsError</code>\uff08<code>SFC1012</code> <code>SCHEMA_COMPILE_FAILED</code>\uff0c\u5f53 schema \u81ea\u8eab\u65e0\u6cd5\u5728\u58f0\u660e\u65b9\u8a00\u4e0b\u7f16\u8bd1\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff0c\u4ec5\u5199\u5165\u7f16\u8bd1\u7f13\u5b58\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1012</code>\uff08\u7f16\u8bd1\u5931\u8d25\uff0c\u629b\u5f02\u5e38\u2014\u2014\u4e0e <code>validateDocument</code> \u7684\u8fd4\u56de\u5f0f\u5931\u8d25\u4e0d\u540c\uff09\u3001<code>SFC1006</code>\uff08\u672a\u77e5\u65b9\u8a00\uff0c\u7531 <code>detectDialect</code> \u629b\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aAjv 8.20.0 \u56fa\u5b9a\uff1b<code>dialect</code> \u5c5e\u51bb\u7ed3\u652f\u6301\u96c6\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/validator.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c <code>validateDocument</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1aschema \u7684\u4e1a\u52a1\u542b\u4e49\u3002</li> </ul>"},{"location":"reference/api/contracts/#detectDialect","title":"detectDialect","text":"<ul> <li>\u7b7e\u540d\uff1a<code>detectDialect(schema)</code></li> <li>\u8f93\u5165\uff1a\u5e26 <code>$schema</code> \u5b57\u6bb5\u7684 schema \u5bf9\u8c61\u3002</li> <li>\u8f93\u51fa\uff1a\u65b9\u8a00\u5b57\u7b26\u4e32\uff08<code>draft-07</code> / <code>2020-12</code>\uff09\uff1b\u672a\u77e5\u65b9\u8a00\u629b <code>ContractsError</code>\uff08<code>SFC1006</code> <code>UNSUPPORTED_DIALECT</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1006</code>\uff08\u58f0\u660e\u65b9\u8a00\u4e0d\u5728\u51bb\u7ed3\u652f\u6301\u96c6\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u65b9\u8a00\u96c6\u51bb\u7ed3\uff08<code>SUPPORTED_DIALECTS</code>\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/validator.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c\u4e0a\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u65b9\u8a00\u9009\u62e9\u7b56\u7565\uff08\u4f55\u65f6\u7528 tolerant\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u767b\u8bb0\u4e0e\u534f\u8bae-foundationcontractsregistry-protocol","title":"\u767b\u8bb0\u4e0e\u534f\u8bae (foundation.contracts.registry-protocol)","text":""},{"location":"reference/api/contracts/#loadRegistry--listSchemas--listProtocols--findSchemaRegistration--findSchemaByObject--findProtocol","title":"loadRegistry / listSchemas / listProtocols / findSchemaRegistration / findSchemaByObject / findProtocol","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>loadRegistry()</code></li> <li><code>listSchemas(registry = REGISTRY)</code></li> <li><code>listProtocols(registry = REGISTRY)</code></li> <li><code>findSchemaRegistration(schemaId, registry = REGISTRY)</code></li> <li><code>findSchemaByObject(object, registry = REGISTRY)</code></li> <li><code>findProtocol(name, version, registry = REGISTRY)</code></li> <li>\u8f93\u5165\uff1a\u5bf9\u8c61\u540d\u3001<code>$id</code>\u3001\u534f\u8bae\u540d/\u7248\u672c\uff08\u5176\u4f59\u9ed8\u8ba4\u8bfb\u51bb\u7ed3 <code>REGISTRY</code>\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u5df2\u767b\u8bb0 schema \u5143\u4fe1\u606f\u6216\u534f\u8bae\u5b9a\u4e49\uff1b\u672a\u547d\u4e2d\u8fd4\u56de <code>undefined</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u767b\u8bb0\u7c7b\u51b2\u7a81\u7ecf <code>registerSchema</code> / <code>registerProtocol</code> \u629b <code>SFC1003</code>\uff08<code>DUPLICATE_SCHEMA_ID</code>\uff09/ <code>SFC1004</code>\uff08<code>DUPLICATE_PROTOCOL_NAME</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>registry.json</code> \u968f\u5305\u53d1\u5e03\uff1b<code>schemaVersion=1</code>\u3001<code>contractsVersion=1.4.0</code> \u4e3a\u552f\u4e00\u6743\u5a01\uff1b18 \u7c7b\u9876\u5c42\u5bf9\u8c61\u96c6\u5408\u56fa\u5b9a\uff0c\u65b0\u589e\u9700 ADR\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/registry.mjs</code>\u3001<code>registry.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/registry.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5bf9\u8c61\u4e1a\u52a1\u542b\u4e49\u7684\u89e3\u91ca\u3002</li> </ul>"},{"location":"reference/api/contracts/#registerSchema--registerProtocol","title":"registerSchema / registerProtocol","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>registerSchema(entry, registry = REGISTRY)</code></li> <li><code>registerProtocol(entry, registry = REGISTRY)</code></li> <li>\u8f93\u5165\uff1aschema/protocol \u767b\u8bb0\u9879\u3002</li> <li>\u8f93\u51fa\uff1a\u5199\u5165\u540e\u7684 registry\uff08\u9ed8\u8ba4\u51bb\u7ed3 <code>REGISTRY</code> \u4e0a\u7684\u526f\u4f5c\u7528\uff09\uff1b\u91cd\u590d <code>$id</code>/\u534f\u8bae\u540d\u629b <code>ContractsError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u9ed8\u8ba4\u5411\u8fdb\u7a0b\u5185\u51bb\u7ed3 registry \u767b\u8bb0\uff0c\u5c5e\u53d7\u63a7\u5185\u5b58\u526f\u4f5c\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u8fdb\u7a0b\u5185 registry \u53d8\u66f4\uff1b\u4e0d\u843d\u76d8\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1003</code>\uff08\u91cd\u590d <code>$id</code>\uff09\u3001<code>SFC1004</code>\uff08\u91cd\u590d\u534f\u8bae\u540d\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a18 \u7c7b\u5bf9\u8c61\u96c6\u4e0e\u534f\u8bae\u540d\u96c6\u51bb\u7ed3\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a\u540c\u4e0a\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c\u4e0a\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u767b\u8bb0\u9879\u7684\u4e1a\u52a1\u7406\u7531\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u5185\u6838\u534f\u8bae-foundationcontractskernel-protocol","title":"\u5185\u6838\u534f\u8bae (foundation.contracts.kernel-protocol)","text":""},{"location":"reference/api/contracts/#loadKernelProtocol--findOperation--checkOperation","title":"loadKernelProtocol / findOperation / checkOperation","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>loadKernelProtocol()</code></li> <li><code>findOperation(name, kernel = KERNEL)</code></li> <li><code>checkOperation(operation, params)</code></li> <li>\u8f93\u5165\uff1a\u534f\u8bae\u540d\u3001\u64cd\u4f5c\u540d\u3001\u64cd\u4f5c\u53c2\u6570\u3002</li> <li>\u8f93\u51fa\uff1a\u534f\u8bae\u5b9a\u4e49\u6216\u64cd\u4f5c\u53c2\u6570\u6821\u9a8c\u7ed3\u679c\uff1b\u5931\u8d25\u65f6\u629b <code>ContractsError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08\u52a0\u8f7d\u4e3a\u53ea\u8bfb\u89e3\u6790\uff0c\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC2002</code>\uff08<code>UNKNOWN_OPERATION</code>\uff0c\u64cd\u4f5c\u540d\u4e0d\u5728\u51bb\u7ed3\u8bcd\u6c47\uff09\u3001<code>SFC2003</code>\uff08<code>INVALID_PARAMS</code>\uff0c\u53c2\u6570\u8fdd\u53cd\u64cd\u4f5c\u53c2\u6570\u5951\u7ea6\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>kernel-protocol.json</code> \u968f\u5305\u53d1\u5e03\uff1b\u5185\u6838\u534f\u8bae\u7248\u672c\u4e0e Contracts \u7248\u672c\u7ed1\u5b9a\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/kernel.mjs</code>\u3001<code>kernel-protocol.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/kernel.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u64cd\u4f5c\u7684\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\uff08\u72b6\u6001\u673a/\u91cd\u8bd5/\u7ec8\u6001\u8f6c <code>loop-agent</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u5f3a\u5236\u68c0\u67e5-foundationcontractsmandatory-checks","title":"\u5f3a\u5236\u68c0\u67e5 (foundation.contracts.mandatory-checks)","text":""},{"location":"reference/api/contracts/#runChecks--collectUnresolvedRefs","title":"runChecks / collectUnresolvedRefs","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runChecks({ schemaEntries, ... } = {})</code></li> <li><code>collectUnresolvedRefs(schemaEntries)</code></li> <li>\u8f93\u5165\uff1a\u5f85\u68c0\u67e5\u5951\u7ea6\u96c6\u6216\u5408\u6210 registry/fixtures\u3002</li> <li>\u8f93\u51fa\uff1a\u68c0\u67e5\u7ed3\u8bba\u4e0e\u672a\u89e3\u6790\u5f15\u7528\u6e05\u5355\uff1b\u8fdd\u53cd\u89c4\u5219\u629b <code>ContractsError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1002</code>/<code>1003</code>/<code>1004</code>/<code>1005</code>/<code>1006</code>/<code>1008</code>/<code>1009</code>/<code>1010</code> \u5bf9\u5e94\u5404\u89c4\u5219 violated\uff1b<code>SFC1005</code>\uff08<code>UNRESOLVED_REF</code>\uff09\u3001<code>SFC1008</code>\uff08<code>RULE_BUDGET_EXCEEDED</code>\uff09\u3001<code>SFC1010</code>\uff08<code>FIXTURE_EXPECTATION_MISMATCH</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aregistry \u4e0e rules \u5df2\u52a0\u8f7d\uff1b<code>CHECK_TYPES</code> \u4e3a 9 \u7c7b\u95ed\u96c6\uff1b<code>RULE_BUDGET</code> \u9650\u5236 <code>firstVersionMax</code> \u4e0e <code>absoluteMax</code>\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/checker.mjs</code>\u3001<code>rules.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/checker.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u89c4\u5219\u4e1a\u52a1\u7406\u7531\u7684\u89e3\u91ca\uff08\u8bed\u4e49\u63a5\u53d7/\u62d2\u7edd\u5c5e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#fixture-\u6821\u9a8c-foundationcontractsfixture-verification","title":"fixture \u6821\u9a8c (foundation.contracts.fixture-verification)","text":""},{"location":"reference/api/contracts/#listFixtures--fixtureClasses--verifyFixture--verifyAllFixtures","title":"listFixtures / fixtureClasses / verifyFixture / verifyAllFixtures","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>listFixtures()</code></li> <li><code>fixtureClasses()</code></li> <li><code>verifyFixture(fixture)</code></li> <li><code>verifyAllFixtures()</code></li> <li>\u8f93\u5165\uff1afixture \u7c7b\u6216\u5355\u4e2a fixture \u6807\u8bc6\u3002</li> <li>\u8f93\u51fa\uff1a\u9010 fixture \u7684\u6821\u9a8c\u7ed3\u679c\uff08\u6b63\u4f8b\u987b\u901a\u8fc7\u3001\u8d1f\u4f8b\u987b\u4ee5\u58f0\u660e\u7a33\u5b9a\u7801\u5931\u8d25\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08\u53ea\u8bfb fixture \u76ee\u5f55\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u8bbf\u95ee fixture\uff0c\u65e0\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1010</code>\uff08<code>FIXTURE_EXPECTATION_MISMATCH</code>\uff0c\u8d1f\u4f8b\u672a\u4ea7\u751f\u9884\u671f\u5931\u8d25\uff09\uff1b<code>SFC1009</code>\uff08<code>UNKNOWN_ERROR_CODE</code>\uff0cfixture \u5f15\u7528\u672a\u767b\u8bb0\u7801\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1afixtures \u76ee\u5f55\u4e3a\u516c\u5f00\u6216\u5b8c\u5168\u865a\u6784\u6570\u636e\uff1bfixture \u4e0e\u5ba1\u8ba1\u5668\u9884\u671f\u7ed3\u679c\u4e0d\u5171\u4eab\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/fixtures.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/fixtures.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1afixture \u80cc\u540e\u7684\u4e1a\u52a1\u610f\u56fe\uff08fixture \u53ea\u8bc1\u7ed3\u6784\u3001\u4e0d\u8bc1\u8bed\u4e49\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u9519\u8bef\u7801-foundationcontractserror-codes","title":"\u9519\u8bef\u7801 (foundation.contracts.error-codes)","text":""},{"location":"reference/api/contracts/#ContractsError--errorCodeRegistry--errorCodeInfo--isRegisteredErrorCode--assertRegisteredErrorCode--stableError","title":"ContractsError / errorCodeRegistry / errorCodeInfo / isRegisteredErrorCode / assertRegisteredErrorCode / stableError","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>class ContractsError extends Error</code>\uff08\u6784\u9020 <code>(code, message, details)</code>\uff09</li> <li><code>errorCodeRegistry()</code></li> <li><code>errorCodeInfo(code)</code></li> <li><code>isRegisteredErrorCode(code)</code></li> <li><code>assertRegisteredErrorCode(code)</code></li> <li><code>stableError(code, message, details)</code></li> <li>\u8f93\u5165\uff1a\u9519\u8bef\u7801\u5b57\u7b26\u4e32\u3001\u9519\u8bef\u4e0a\u4e0b\u6587\u3002</li> <li>\u8f93\u51fa\uff1a\u5e26\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details</code> \u7684\u9519\u8bef\u5bf9\u8c61\uff1b<code>assertRegisteredErrorCode</code> \u5bf9\u672a\u767b\u8bb0\u7801\u629b <code>TypeError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08<code>ContractsError</code> \u6784\u9020\u4e3a\u7eaf\u5bf9\u8c61\uff0c\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u9519\u8bef\u7801\u4f53\u7cfb\u672c\u8eab\u51bb\u7ed3\uff08<code>error-codes.json</code>\uff09\uff0c\u65b0\u589e\u7801\u5c5e Contracts \u53d8\u66f4\uff1b<code>SFC1009</code> \u7528\u4e8e\u672a\u767b\u8bb0\u7801\u65ad\u8a00\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>error-codes.json</code> \u968f\u5305\u53d1\u5e03\uff1b\u51bb\u7ed3\u5bf9\u8c61\u4e0d\u53ef\u53d8\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/errors.mjs</code>\u3001<code>error-codes.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/boundary.test.mjs</code>\u3001<code>immutability.test.mjs</code>\u3001<code>audit-surface.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u9519\u8bef\u7801\u7684\u4e1a\u52a1\u5f52\u56e0\u3002</li> </ul> <p>Contracts \u9519\u8bef\u7801\u4e00\u89c8\uff08\u7a33\u5b9a\u3001append-only\uff09\uff1a</p> \u7801 \u540d\u79f0 \u7c7b\u522b SFC1001 SCHEMA_VALIDATION_FAILED contract SFC1002 UNKNOWN_SCHEMA_ID contract SFC1003 DUPLICATE_SCHEMA_ID contract SFC1004 DUPLICATE_PROTOCOL_NAME contract SFC1005 UNRESOLVED_REF contract SFC1006 UNSUPPORTED_DIALECT contract SFC1007 UNKNOWN_CHECK_TYPE contract SFC1008 RULE_BUDGET_EXCEEDED contract SFC1009 UNKNOWN_ERROR_CODE contract SFC1010 FIXTURE_EXPECTATION_MISMATCH contract SFC1011 UNKNOWN_PROTOCOL contract SFC1012 SCHEMA_COMPILE_FAILED contract SFC2002 UNKNOWN_OPERATION kernel SFC2003 INVALID_PARAMS kernel SFC2004 EXECUTION_FAILED kernel\uff08\u673a\u5236\u5931\u8d25\u7edf\u4e00\u7801\uff0c\u627f\u8f7d <code>details.kind</code>\uff09 SFC3001 REPORT_DIGEST_MISMATCH report SFC3002 REPORT_ELEMENT_MISSING report SFC3003 REPORT_FACT_DRIFT report"},{"location":"reference/api/contracts/#\u5ba1\u8ba1\u8868\u9762-foundationcontractsaudit-surface","title":"\u5ba1\u8ba1\u8868\u9762 (foundation.contracts.audit-surface)","text":""},{"location":"reference/api/contracts/#canonicalJson--digestDocument--describeAuditSurface--digestAuditSurface","title":"canonicalJson / digestDocument / describeAuditSurface / digestAuditSurface","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>canonicalJson(value)</code></li> <li><code>digestDocument(value, { algorithm = \"sha256\" } = {})</code></li> <li><code>describeAuditSurface()</code></li> <li><code>digestAuditSurface(surface = describeAuditSurface())</code></li> <li>\u8f93\u5165\uff1a\u4efb\u610f JSON \u6587\u6863\u3002</li> <li>\u8f93\u51fa\uff1acanonical \u5b57\u7b26\u4e32\u4e0e sha256 \u6458\u8981\uff1b\u5ba1\u8ba1\u8868\u9762\u7ed3\u6784\u63cf\u8ff0\u4e0e\u5176\u6458\u8981\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e JSON \u503c\u3001\u672a\u77e5\u7b97\u6cd5\uff08<code>AUDIT_DIGEST_ALGORITHMS</code> \u4ec5 <code>sha256</code>\uff09\u3001\u51bb\u7ed3\u8fdd\u89c4\u629b <code>ContractsError</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>AUDIT_SURFACE_VERSION=1</code>\uff1b\u6458\u8981\u7b97\u6cd5\u4ec5 <code>sha256</code>\uff1b\u4f9d\u8d56\u65b9\u5411 Audit \u2192 Contracts\uff0c\u672c\u6a21\u5757\u4e0d\u53cd\u5411\u5bfc\u5165\u5ba1\u8ba1\u4ea7\u7269\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/audit-surface.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/audit-surface.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5ba1\u8ba1\u8bed\u4e49\u7ed3\u8bba\uff08\u63a5\u53d7/\u62d2\u7edd\u5c5e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p><code>skill-family-contracts/candidate/quickstart-profile</code> \u5bfc\u51fa v2 \u534f\u8bae\u3001\u6309\u771f\u5b9e <code>$id</code> \u7d22\u5f15\u7684 Resource/Task/Result Schema \u96c6\u5408\uff0c\u4ee5\u53ca <code>validateQuickstartProfileDocument</code>\u3002\u552f\u4e00\u64cd\u4f5c\u540d\u662f\u4e1a\u52a1\u4e2d\u7acb\u7684 <code>execute-method</code>\uff1bFoundation \u4e0d\u767b\u8bb0 method \u8bcd\u8868\uff0c\u4e5f\u4e0d\u89e3\u91ca parameters\u3001evidence \u6216 domainResult \u7684\u9886\u57df\u542b\u4e49\u3002</p> <p>\u8be5\u5165\u53e3\u4ece <code>0.2.1</code> \u8d77\u516c\u5f00\uff0c\u4f46\u7a33\u5b9a\u6027\u4ecd\u4e3a <code>candidate</code>\u30020.3.0 \u5df2\u7528 v2 \u66ff\u6362 v1\uff0c\u4e24\u8005\u4e0d\u517c\u5bb9\uff1a\u65b0\u63a5\u5165\u9700\u7cbe\u786e\u9501\u5b9a <code>0.3.0</code>\uff0c\u4ecd\u9700 v1 \u7684\u63a5\u5165\u7ee7\u7eed\u7cbe\u786e\u9501\u5b9a <code>0.2.1</code>\u3002candidate Schema \u4e0d\u8fdb\u5165\u7a33\u5b9a <code>src/registry.json</code>\u3002</p>"},{"location":"reference/api/contracts/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID \u89c1 <code>docs/agents/capability-catalog.json</code>\uff08<code>foundation.contracts.</code>\uff09\u3002</li> <li>\u673a\u68b0\u6821\u9a8c\uff1a<code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code>\uff0c\u62d2\u7edd\u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\uff1b<code>sourceRefs</code> \u4e0e\u6d4b\u8bd5\u5f15\u7528\u5747\u6307\u5411\u672c\u9875\u6240\u5217\u771f\u5b9e\u6587\u4ef6\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/","title":"skill-family-engineering-kit \u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u9875\u4ece\u771f\u5b9e\u5bfc\u51fa\uff08<code>src/index.mjs</code> \u4e0e\u5404\u6e90\u6a21\u5757\u3001CLI \u5165\u53e3\uff09\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684\u5168\u96c6\u3002\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 hand-off \u00a74.3 \u8bf4\u660e\uff1a\u7b7e\u540d\u3001\u8f93\u5165\u4e0e\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p> <p>Kit \u6d88\u8d39 Contracts \u4e0e Harness\uff0c\u53ea\u62e5\u6709\u56db\u4e2a\u9876\u5c42\u547d\u4ee4\u4e0e\u5b83\u4eec\u7684\u53ea\u8bfb/\u53d7\u63a7\u5199\u8fb9\u754c\u3002\u5305\u7ea7\u5e38\u91cf\uff1a<code>TOP_LEVEL_COMMANDS</code>\uff08\u51bb\u7ed3 4 \u4e2a\uff1a<code>scaffold</code> / <code>adopt-plan</code> / <code>projection</code> / <code>check</code>\uff09\u3001<code>FORBIDDEN_SIDE_EFFECTS</code>\u3001<code>COMMAND_SIDE_EFFECTS</code>\u3001<code>KIT_EXIT_CODES</code>\uff08<code>ok=0</code> / <code>findings=1</code> / <code>rejected=2</code>\uff09\u3002Kit \u6c38\u4e0d\u6267\u884c Git \u5199\u3001\u53d1\u5e03\u3001\u5220\u9664\u7528\u6237\u5185\u5bb9\u6216\u89e6\u7f51\u3002</p> <p>\u80fd\u529b\u5206\u7ec4\uff08\u4e0e <code>docs/agents/capability-catalog.json</code> \u5bf9\u5e94\uff09\uff1a</p> <ul> <li>scaffold \u2192 <code>scaffoldTarget</code></li> <li>adopt-plan \u2192 <code>planAdoption</code> / <code>evaluateMigrationCompletion</code></li> <li>projection \u2192 <code>runProjection</code> / <code>loadProjectionManifest</code></li> <li>check \u2192 <code>runChecks</code> / <code>runCoreCheck</code></li> <li>report \u2192 <code>renderReportAction</code> / <code>checkReportAction</code></li> <li>git-probe \u2192 <code>probeGitState</code> / <code>probeGitFacts</code></li> <li>host \u2192 <code>describeHost</code> / <code>probeHost</code> / <code>refuseHostApply</code> \u2026</li> <li>licensing \u2192 <code>loadLicensingProfile</code> / <code>generateLicenseContent</code> \u2026</li> <li>identity-check \u2192 <code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code></li> <li>CLI \u2192 <code>runCommand</code> / <code>cliMain</code></li> </ul>"},{"location":"reference/api/engineering-kit/#scaffold-foundationkitscaffold","title":"scaffold (foundation.kit.scaffold)","text":""},{"location":"reference/api/engineering-kit/#scaffoldTarget--describeSkeletonFiles--normalizeSkeletonInputs","title":"scaffoldTarget / describeSkeletonFiles / normalizeSkeletonInputs","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>scaffoldTarget({ root, projectId, projectName, profileId, licensingProfile, licensingVariant, licensingProfileData, profilesRoot, identityProjections } = {})</code>\uff08async\uff09</li> <li><code>describeSkeletonFiles(inputs)</code>\uff08async\uff09</li> <li><code>normalizeSkeletonInputs({ projectId, projectName, profileId, licensingProfile, licensingVariant, rootBasename })</code></li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3001\u9aa8\u67b6\u9009\u9879\uff08<code>projectId</code> \u7b49\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u7cbe\u786e\u96c6\u5408\u7684\u6258\u7ba1\u9aa8\u67b6\u6587\u4ef6\uff08\u539f\u5b50 + \u8def\u5f84\u6536\u5bb9\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>normalizeSkeletonInputs</code> \u662f\uff1b<code>scaffoldTarget</code> \u843d\u76d8\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u76ee\u6807\u521b\u5efa\u6587\u4ef6\uff08\u539f\u5b50 + \u6536\u5bb9\uff09\uff1b\u76ee\u6807\u975e\u7a7a\u5219\u62d2\u7edd\u3001\u4e0d\u8986\u76d6\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u6cd5 kebab <code>projectId</code> / \u975e\u7a7a\u76ee\u6807\u629b <code>KitError</code>\uff08<code>KIT_ERROR_KINDS</code> \u7684 <code>invalid-params</code> / <code>rejected</code>\uff09\uff1b\u975e\u6cd5\u53c2\u6570 <code>+ INVALID_PARAMS</code>\uff08<code>SFC2003</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u76ee\u6807\u4e3a\u53ef\u5199\u7a7a\u76ee\u5f55\uff1bNode >= 22.22.2\uff1b\u9aa8\u67b6\u96c6\u5408\u4e0e <code>scaffold-conformance</code> fixture \u4e00\u81f4\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/scaffold.mjs</code>\u3001<code>skeleton.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/scaffold.test.mjs</code>\u3001<code>skeleton-contract.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e1a\u52a1\u9879\u76ee\u5185\u5bb9\uff08\u5b58\u91cf\u4ed3\u6539\u7528 <code>adopt-plan</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#adopt-plan-foundationkitadopt-plan","title":"adopt-plan (foundation.kit.adopt-plan)","text":""},{"location":"reference/api/engineering-kit/#planAdoption--buildHandoffDraft--evaluateMigrationCompletion--validateException--assessLegacyExitList--findNestedRepositories","title":"planAdoption / buildHandoffDraft / evaluateMigrationCompletion / validateException / assessLegacyExitList / findNestedRepositories","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>planAdoption({ root, manifest, ... } = {})</code>\uff08async\uff09</li> <li><code>buildHandoffDraft({ ... })</code></li> <li><code>evaluateMigrationCompletion({ ... })</code></li> <li><code>validateException(exception, index, nowMs)</code></li> <li><code>assessLegacyExitList(root, legacyItems)</code>\uff08async\uff09</li> <li><code>findNestedRepositories(entries)</code></li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3001\u8fc1\u79fb\u6e05\u5355\u8def\u5f84\u3002</li> <li>\u8f93\u51fa\uff1a\u91c7\u7528\u5206\u7c7b\uff08<code>direct-adoption</code> / <code>compatibility-layer</code> / <code>keep-business</code> / <code>foundation-gap</code>\uff09\u3001\u5b8c\u6210\u5224\u5b9a\u3001handoff \u8349\u7a3f\uff08\u4ec5\u8f93\u51fa\uff0c\u4e0d\u843d\u76d8\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5206\u7c7b\u4e0e\u8bc4\u4f30\u51fd\u6570\u4e3a\u7eaf\u51fd\u6570\uff1b<code>planAdoption</code> \u542b\u53ea\u8bfb\u63a2\u6d4b\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u4e25\u683c\u53ea\u8bfb\u2014\u2014\u4e0d\u5199\u6587\u4ef6\uff08\u4e34\u65f6\u6587\u4ef6\u4e5f\u4e0d\u5199\uff09\u3001\u4e0d Git \u5199\u3001\u4e0d rename\u3001\u4e0d\u89e6\u7f51\uff1b\u53ef\u80fd\u89e6\u53d1\u53ea\u8bfb Git \u63a2\u6d4b\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u4f8b\u5916\u7f3a\u5b57\u6bb5 / \u672a\u9000\u51fa\u65e7\u5b9e\u73b0\u5219\u5b8c\u6210\u5224\u5b9a <code>false</code>\uff1b\u786c\u5931\u8d25\u629b <code>KitError</code>\uff08<code>CONTRACTS_VERSION</code> \u4e0d\u4e00\u81f4\u7b49\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u76ee\u6807\u4ed3\u5b58\u5728\u4e14\u53ef\u53ea\u8bfb\u8bbf\u95ee\uff1b<code>MIGRATION_MANIFEST_PATH</code> / <code>MIGRATION_MANIFEST_SCHEMA_ID</code> \u6307\u5411\u5951\u7ea6\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/adopt-plan.mjs</code>\u3001<code>migration.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code>\u3001<code>migration.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5b58\u91cf\u4e1a\u52a1\u4ee3\u7801\u7684\u8fc1\u79fb\u51b3\u7b56\uff08\u771f\u6b63\u8fc1\u79fb\u6267\u884c\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#projection-foundationkitprojection","title":"projection (foundation.kit.projection)","text":""},{"location":"reference/api/engineering-kit/#runProjection--loadProjectionManifest","title":"runProjection / loadProjectionManifest","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runProjection({ root, manifest: manifestRelPath } = {})</code>\uff08async\uff09</li> <li><code>loadProjectionManifest(rootAbs, manifestRelPath)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u6295\u5f71\u6e05\u5355\u3001\u76ee\u6807\u6839\u3002</li> <li>\u8f93\u51fa\uff1a\u6295\u5f71\u6587\u4ef6\uff08\u4ec5\u5728\u6821\u9a8c\u5168\u90e8\u901a\u8fc7\u65f6\u5199\u5165\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>loadProjectionManifest</code> \u662f\uff1b<code>runProjection</code> \u4e24\u9636\u6bb5\uff08\u5168\u6821\u9a8c\u540e\u624d\u5199\uff0c\u5931\u8d25\u56de\u6eda\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u76ee\u6807\u5199\u6295\u5f71\u6587\u4ef6\uff1b\u4e0d\u8986\u76d6 handwritten \u6587\u4ef6\uff1b\u4efb\u4e00\u6821\u9a8c\u5931\u8d25\u96f6\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u672a\u6388\u6743 / \u624b\u5199\u51b2\u7a81 / \u8d8a\u754c / \u5185\u5bb9\u51b2\u7a81\u629b <code>KitError</code>\uff08<code>rejected</code> / <code>unauthorized</code> \u7c7b <code>kind</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u6295\u5f71\u6e05\u5355\u5df2\u767b\u8bb0\uff08<code>PROJECTION_MANIFEST_PATH</code>\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/projection.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/projection.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6295\u5f71\u5185\u5bb9\u7684\u4e1a\u52a1\u542b\u4e49\uff08\u8fdc\u7aef\u53d1\u5e03\u8f6c <code>release-skill</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#check-foundationkitcheck","title":"check (foundation.kit.check)","text":""},{"location":"reference/api/engineering-kit/#runChecks--runCoreCheck--isContainedDeclaration","title":"runChecks / runCoreCheck / isContainedDeclaration","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runChecks({ root, allowGitSpawn = true, only, profilesRoot } = {})</code>\uff08async\uff09</li> <li><code>runCoreCheck({ root, allowGitSpawn = true, profilesRoot } = {})</code>\uff08async\uff09</li> <li><code>isContainedDeclaration(rel)</code></li> <li>\u8f93\u5165\uff1a<code>--only</code> \u53d6\u503c <code>contracts\|drift\|closure\|version\|docs\|git\|identity</code>\u3002</li> <li>\u8f93\u51fa\uff1a\u53d1\u73b0\u6e05\u5355\uff1b\u9000\u51fa\u7801 <code>findings=1</code>\uff08\u6709\u53d1\u73b0\uff09\u3001<code>mechanism=2</code>\uff08\u67d0\u7c7b\u68c0\u67e5\u65e0\u6cd5\u5b8c\u6210\uff09\u3001<code>ok=0</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8bfb\u53d6\u76ee\u6807\u6587\u4ef6\u4e0e\u53ea\u8bfb Git \u72b6\u6001\uff09\uff1b\u4f46\u53ea\u8bca\u65ad\u3001\u4e0d\u4fee\u590d\u3001\u4e0d\u5199\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6\u5199\u5165\uff1b\u53ea\u8bfb Git \u63a2\u6d4b\uff08\u81f3\u591a\u4e00\u6b21\u51bb\u7ed3 <code>status</code> \u67e5\u8be2\uff09\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>CHECK_CLASSES</code> \u4e3a\u4e03\u7c7b\u95ed\u96c6\uff0c\u4e0d\u6269\u5f20\uff1b\u673a\u5236\u5931\u8d25\u629b <code>KitError</code>\uff08<code>mechanism</code> \u7c7b\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>GIT_READ_ONLY_ALLOWLIST</code> \u9650\u5b9a\u53ef\u8c03\u7528\u5b50\u547d\u4ee4\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/check.mjs</code>\u3001<code>core-check.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/check.test.mjs</code>\u3001<code>core-check.test.mjs</code>\u3001<code>check-equivalence.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u53d1\u73b0\u9879\u7684\u4e1a\u52a1\u5904\u7f6e\uff08\u81ea\u52a8\u4fee\u590d\u6267\u884c\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#report-foundationkitreport","title":"report (foundation.kit.report)","text":""},{"location":"reference/api/engineering-kit/#renderReportAction--checkReportAction","title":"renderReportAction / checkReportAction","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>renderReportAction(options = {})</code>\uff08async\uff09</li> <li><code>checkReportAction(options = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a<code>report-model</code>\u3001<code>--out</code> / <code>--binding</code> \u9009\u9879\u3002</li> <li>\u8f93\u51fa\uff1aMarkdown \u6587\u672c\uff1b\u663e\u5f0f <code>--out</code> / <code>--binding</code> \u624d\u843d\u76d8\uff0c\u5426\u5219\u53ea\u5199 stdout\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u9ed8\u8ba4\u53ea\u5199 stdout\uff1b\u663e\u5f0f\u9009\u9879\u624d\u5199\u53d7\u6536\u5bb9\u6587\u4ef6\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u9ed8\u8ba4\u65e0\u6587\u4ef6\u5199\u5165\uff1b\u663e\u5f0f <code>--out</code> / <code>--binding</code> \u624d\u5199\u53d7\u6536\u5bb9\u6587\u4ef6\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u786c\u5931\u8d25\u8ba1\u4e3a\u53d1\u73b0\uff1b\u975e\u6cd5\u53c2\u6570 <code>reject</code>\uff08<code>invalid-params</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5df2\u5b58\u5728 Harness <code>report-model</code>\uff1b\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/report.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/report.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u62a5\u544a\u7ed3\u8bba\u89e3\u8bfb\uff08\u673a\u5236\u5728 Harness <code>report</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#git-probe-foundationkitgit-probe","title":"git-probe (foundation.kit.git-probe)","text":""},{"location":"reference/api/engineering-kit/#probeGitState--probeGitFacts","title":"probeGitState / probeGitFacts","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>probeGitState(root, { allowSpawn = true } = {})</code>\uff08async\uff09</li> <li><code>probeGitFacts(root, candidatePaths, { allowSpawn = true } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3002</li> <li>\u8f93\u51fa\uff1aGit \u72b6\u6001\u4e0e\u4e8b\u5b9e\uff08\u53ea\u8bfb\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8c03\u7528 <code>git</code> \u53ea\u8bfb\u5b50\u547d\u4ee4\uff09\uff1b\u4e0d\u542b\u4efb\u4f55\u5199\u64cd\u4f5c\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u8c03\u7528 <code>git status</code> / <code>ls-files</code> / <code>check-ignore</code>\uff1b\u53c2\u6570\u5411\u91cf\u51bb\u7ed3\u4e8e <code>GIT_STATUS_ARGS</code> / <code>GIT_LS_FILES_ARGS</code> / <code>GIT_CHECK_IGNORE_ARGS</code>\uff0c\u4e0d\u5728\u767d\u540d\u5355\u5373\u62d2\u7edd\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u767d\u540d\u5355\u53c2\u6570\u5411\u91cf\u629b <code>KitError</code>\uff08<code>unauthorized-git</code> \u7c7b\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>GIT_READ_ONLY_ALLOWLIST</code> \u9650\u5b9a\u53ef\u8c03\u7528\u5b50\u547d\u4ee4\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/gitprobe.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/git-probe.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1aGit \u5199\u64cd\u4f5c\u6388\u6743\uff08Git \u5199\u5f52 Git \u751f\u547d\u5468\u671f\u6307\u5357\uff0cFoundation \u4e0d\u62e5\u6709\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#host-foundationkithost","title":"host (foundation.kit.host)","text":""},{"location":"reference/api/engineering-kit/#describeHost--loadHostRegistry--probeHost--buildHostAdapter--materializeHostBuild--planHost--assertPlanConsistency--refuseHostApply--probeTrustedVersionDriver","title":"describeHost / loadHostRegistry / probeHost / buildHostAdapter / materializeHostBuild / planHost / assertPlanConsistency / refuseHostApply / probeTrustedVersionDriver","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff0c\u9664 <code>refuseHostApply</code> \u5916\u5747\u4e3a async\uff09\uff1a</li> <li><code>describeHost({ hostId, hostsRoot, registry } = {})</code></li> <li><code>loadHostRegistry({ hostsRoot, registry } = {})</code></li> <li><code>probeHost({ hostId, hostsRoot, registry, executable, allowSpawn = false, timeoutMs = 5000, runner } = {})</code></li> <li><code>buildHostAdapter({ hostId, pathCategoryId, input, hostsRoot, registry } = {})</code></li> <li><code>materializeHostBuild(options)</code></li> <li><code>planHost({ hostId, pathCategoryId, buildManifest, probeFacts, hostsRoot, registry } = {})</code></li> <li><code>assertPlanConsistency(planInput)</code></li> <li><code>refuseHostApply()</code>\uff08\u76f4\u63a5\u629b\u9519\uff09</li> <li><code>probeTrustedVersionDriver({ hostId, driverId, capabilities = CAPABILITIES, executable, allowSpawn = false, timeoutMs = 5000, runner } = {})</code></li> <li>\u8f93\u5165\uff1a\u5bbf\u4e3b\u6807\u8bc6\u3001probe/plan \u9009\u9879\u3002</li> <li>\u8f93\u51fa\uff1a\u5bbf\u4e3b\u63cf\u8ff0\u3001probe \u7ed3\u679c\u3001\u6784\u5efa\u4ea7\u7269\u3001plan\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>assertPlanConsistency</code> / <code>refuseHostApply</code> \u662f\uff1b\u5176\u4f59\u542b\u843d\u76d8\u6216\u8fdb\u7a0b\u8c03\u7528\u3002</li> <li>\u526f\u4f5c\u7528\uff1a<code>build</code> / <code>materialize</code> \u5728\u53d7\u6536\u5bb9\u76ee\u6807\u5199\u4ea7\u7269\uff1b<code>probe</code> \u9ed8\u8ba4 <code>allowSpawn=false</code>\uff0c\u4e0d\u53d6 PATH\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1aunsupported host\uff08\u5982 <code>qoder</code>\uff09\u629b <code>KitError</code>\uff08<code>unsupported-host</code>\uff09\uff1b<code>apply</code> \u7531 <code>refuseHostApply</code> \u7a33\u5b9a\u62d2\u7edd\uff1b\u7f3a probe facts \u629b <code>KitError</code>\uff08<code>missing-probe-facts</code>\uff09\u3002<code>HOST_DRIVER_IDS</code> \u4ec5\u4e24\u4e2a\u53d7\u4fe1 driver\uff08<code>claude-version-v1</code> / <code>codex-version-v1</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5bbf\u4e3b Profile \u5df2\u5728 <code>profiles/hosts</code> \u767b\u8bb0\uff1b\u53d7\u4fe1 driver \u9650\u5b9a\uff1b<code>apply</code> / <code>install</code> / <code>update</code> / <code>uninstall</code> \u660e\u786e unsupported\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>unstable</code>\uff08host \u80fd\u529b\u6574\u4f53 unstable\uff09\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/host.mjs</code>\u3001<code>host-profiles.mjs</code>\u3001<code>host-drivers.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/host.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5bbf\u4e3b\u4e1a\u52a1\u8bed\u4e49\uff08<code>host apply</code> \u660e\u786e unsupported\uff1bQoder \u5b8c\u6574 driver unsupported\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#licensing-foundationkitlicensing","title":"licensing (foundation.kit.licensing)","text":""},{"location":"reference/api/engineering-kit/#loadLicensingProfile--listLicensingProfiles--validateLicensingProfile--generateLicenseContent--generateNoticeContent--generateIdentityRecord--bundledProfilesRoot","title":"loadLicensingProfile / listLicensingProfiles / validateLicensingProfile / generateLicenseContent / generateNoticeContent / generateIdentityRecord / bundledProfilesRoot","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>loadLicensingProfile({ profilesRoot, profileId, variant } = {})</code>\uff08async\uff09</li> <li><code>listLicensingProfiles(profilesRoot)</code></li> <li><code>validateLicensingProfile(profile)</code></li> <li><code>generateLicenseContent(profile)</code> / <code>generateNoticeContent(profile, { projectName })</code> / <code>generateIdentityRecord(profile, { projectId, projectName, projections } = {})</code></li> <li><code>bundledProfilesRoot()</code></li> <li>\u8f93\u5165\uff1aProfile \u6807\u8bc6\u3001\u53d8\u4f53\u9009\u62e9\u3002</li> <li>\u8f93\u51fa\uff1a\u8bb8\u53ef\u8bc1 / \u58f0\u660e / \u8eab\u4efd\u8bb0\u5f55\u6587\u672c\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>validateLicensingProfile</code> \u4e0e\u5404 <code>generate</code> \u662f\uff1b<code>load</code> \u542b\u53ea\u8bfb\u8bfb\u53d6 Profile \u6570\u636e\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\uff08\u7eaf\u51fd\u6570\u751f\u6210 + \u53ea\u8bfb\u8bfb\u53d6\uff09\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u591a\u53d8\u4f53\u672a\u6307\u5b9a / \u975e\u6cd5 Profile \u629b <code>KitError</code>\uff08<code>invalid-licensing-profile</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>profiles/licensing/registry.json</code> + <code>schema.json</code> \u5b58\u5728\uff1b\u9ed8\u8ba4\u53d6 registry \u7b2c\u4e00\u53d8\u4f53\uff0c\u591a\u53d8\u4f53\u987b\u663e\u5f0f\u9009\u62e9\uff1b\u6240\u6709\u5546\u4e1a\u8f7d\u8377\u5f53\u524d\u5173\u95ed\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/licensing.mjs</code>\u3001<code>profiles/licensing/registry.json</code>\u3001<code>profiles/licensing/schema.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/licensing.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6388\u6743\u4e1a\u52a1\u8bed\u4e49\uff08\u6388\u6743\u6267\u884c\u51b3\u7b56\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#identity-check-foundationkitidentity-check","title":"identity-check (foundation.kit.identity-check)","text":""},{"location":"reference/api/engineering-kit/#loadIdentityRecord--checkIdentityDrift--validateIdentityAgainstProfile","title":"loadIdentityRecord / checkIdentityDrift / validateIdentityAgainstProfile","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>loadIdentityRecord(rootAbs)</code>\uff08async\uff09</li> <li><code>checkIdentityDrift({ rootAbs, identityRecord } = {})</code>\uff08async\uff09</li> <li><code>validateIdentityAgainstProfile(record, profilesRoot)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3001Profile \u6807\u8bc6\u3002</li> <li>\u8f93\u51fa\uff1a\u6f02\u79fb\u53d1\u73b0\u3001\u6821\u9a8c\u7ed3\u8bba\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>validateIdentityAgainstProfile</code> \u662f\uff1b<code>load</code> / <code>check</code> \u542b\u53ea\u8bfb\u8bfb\u53d6\u76ee\u6807\u6587\u4ef6\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u8bfb\u53d6\u76ee\u6807\u6587\u4ef6\uff1b\u4e0d\u4fee\u6539\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6f02\u79fb\u6216\u6821\u9a8c\u5931\u8d25\u4ea7\u51fa findings\uff08\u4e0d\u629b\u9519\uff0c\u7531 <code>check</code> \u9000\u51fa\u7801 <code>1</code> \u8868\u8fbe\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>IDENTITY_RECORD_PATH</code> \u6307\u5411\u8eab\u4efd\u8bb0\u5f55\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/identity-check.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/identity-check.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6f02\u79fb\u4e1a\u52a1\u5904\u7f6e\uff08\u81ea\u52a8\u4fee\u590d\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#CLI-foundationkitcli","title":"CLI (foundation.kit.cli)","text":""},{"location":"reference/api/engineering-kit/#runCommand--cliMain--\u62d2\u7edd\u53d8\u66f4\u65d7\u6807","title":"runCommand / cliMain / \u62d2\u7edd\u53d8\u66f4\u65d7\u6807","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runCommand(command, options = {})</code>\uff08async\uff09\u2014\u2014 \u6309 <code>TOP_LEVEL_COMMANDS</code> \u5206\u6d3e\uff0c\u8fd4\u56de <code>{ exitCode, output }</code></li> <li><code>cliMain(argv)</code>\uff08async\uff09\u2014\u2014 CLI \u5165\u53e3</li> <li>\u8f93\u5165\uff1a<code>argv</code>\u3002</li> <li>\u8f93\u51fa\uff1a\u547d\u4ee4\u7ed3\u679c\uff1b\u9000\u51fa\u7801 <code>ok=0</code> / <code>findings=1</code> / <code>rejected=2</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u4f9d\u547d\u4ee4\u4ea7\u751f\u53d7\u6536\u5bb9\u6587\u4ef6\u5199\u5165\u6216\u53ea\u8bfb\u63a2\u6d4b\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u4f9d\u547d\u4ee4\u800c\u5b9a\uff08scaffold/projection \u53d7\u6536\u5bb9\u5199\uff1badopt-plan/check \u53ea\u8bfb\uff09\uff1b<code>REFUSED_MUTATION_FLAGS</code>\uff08\u5982 <code>--apply</code>\uff09\u5728 <code>parseOptions</code> \u5165\u53e3\u5373\u62d2\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u672a\u77e5\u547d\u4ee4 / \u62d2\u7edd\u65d7\u6807\u9000\u51fa\u7801 <code>2</code>\uff08<code>unknown-command</code> / <code>refused-mutation</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aNode >= 22.22.2\uff1b<code>TOP_LEVEL_COMMANDS</code> \u56fa\u5b9a 4 \u4e2a\uff0c\u7b2c 5 \u4e2a\u547d\u4ee4\u7981\u6b62\u65b0\u589e\uff1b<code>REFUSED_MUTATION_FLAGS</code> \u5728\u89e3\u6790\u5165\u53e3\u5373\u62d2\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/index.mjs</code>\u3001<code>cli.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/cli.test.mjs</code>\u3001<code>boundary.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u547d\u4ee4\u7684\u4e1a\u52a1\u76ee\u6807\uff08\u547d\u4ee4\u96c6\u5408\u4e0d\u6269\u5f20\uff09\u3002</li> </ul> <p>Kit \u9519\u8bef\u7c7b\u578b\uff1a<code>KitError extends ContractsError</code>\uff08\u6784\u9020\u672a\u767b\u8bb0\u7801\u7acb\u5373\u629b <code>TypeError</code>\uff09\uff1b<code>KIT_ERROR_KINDS</code> \u4e3a\u7a33\u5b9a kind \u679a\u4e3e\uff1b<code>kitError</code> / <code>invalidParamsError</code> / <code>unknownCommandError</code> / <code>mutationModeError</code> / <code>refusalError</code> \u4e3a\u6784\u9020\u8f85\u52a9\u3002<code>REFUSED_MUTATION_FLAGS</code> \u5217\u51fa\u5165\u53e3\u5373\u62d2\u7684\u53d8\u66f4\u65d7\u6807\uff08\u5982 <code>--apply</code>\uff09\u3002</p>"},{"location":"reference/api/engineering-kit/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p><code>skill-family-engineering-kit/candidate/quickstart-profile</code> \u5bfc\u51fa <code>buildQuickstartProfileProjection</code> \u4e0e <code>QUICKSTART_PROFILE_TARGET_PREFIX</code>\u3002builder \u63a5\u6536\u663e\u5f0f\u6d88\u8d39\u8005 Schema \u8def\u5f84\u4e0e\u51bb\u7ed3\u6765\u6e90\u8eab\u4efd\uff0c\u751f\u6210\u6309 Schema <code>$id</code> \u67e5\u8be2\u7684 standalone validator\u3001\u673a\u68b0\u6295\u5f71\u7684 Contracts/Harness runtime\u3001\u8bb8\u53ef\u8bc1\u548c\u5b8c\u6574 provenance\u3002</p> <p>Bundle \u79bb\u7ebf\u8fd0\u884c\u65f6\u4e0d\u9700\u8981 Foundation \u5305\u3001<code>node_modules</code> \u6216 Ajv\u3002builder \u53ea\u8fd4\u56de\u7a33\u5b9a projection manifest\uff0c\u4e0d\u5199\u76ee\u6807\u6587\u4ef6\uff0c\u4e5f\u4e0d\u589e\u52a0\u7b2c\u4e94\u4e2a Kit \u9876\u5c42\u547d\u4ee4\uff1b\u8c03\u7528\u65b9\u4ecd\u9700\u628a manifest \u4ea4\u7ed9 <code>runProjection</code> \u5b8c\u6210\u6388\u6743\u5199\u5165\u30020.3.0 \u7684 v2 \u4e0e 0.2.1 \u7684\u4f9d\u8d56\u95ed\u5305 Bundle \u4e0d\u517c\u5bb9\uff0c\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a\u7248\u672c\u3002</p>"},{"location":"reference/api/engineering-kit/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID \u89c1 <code>docs/agents/capability-catalog.json</code>\uff08<code>foundation.kit.</code>\u3001<code>foundation.unsupported.</code>\uff09\u3002</li> <li>\u673a\u68b0\u6821\u9a8c\uff1a<code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code> \u4e0e <code>cli.mjs</code>\uff0c\u62d2\u7edd\u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\uff0c\u5e76\u6821\u9a8c <code>TOP_LEVEL_COMMANDS</code> \u672a\u6269\u5f20\u4e3a\u8d85 4 \u4e2a\u3002</li> </ul>"},{"location":"reference/api/harness/","title":"skill-family-harness-node \u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u9875\u4ece\u771f\u5b9e\u5bfc\u51fa\uff08<code>src/index.mjs</code> \u4e0e\u5404\u6e90\u6a21\u5757\uff09\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684\u5168\u96c6\u3002\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 hand-off \u00a74.3 \u8bf4\u660e\uff1a\u7b7e\u540d\u3001\u8f93\u5165\u4e0e\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p> <p>Harness \u662f\u8584\u8fd0\u884c\u65f6\uff1a\u6d88\u8d39 Contracts\uff0c\u53ea\u5b9e\u73b0\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\uff1b\u4e0d\u62e5\u6709\u4e1a\u52a1\u8bed\u4e49\u3001\u7f16\u6392\u3001Git\u3001\u7f51\u7edc\u4e0e\u7b2c\u4e8c\u8bed\u8a00\u3002\u5305\u7ea7\u5e38\u91cf\uff1a<code>HARNESS_CAPABILITIES</code>\uff0816 \u9879\u80fd\u529b\uff0c\u95ed\u96c6\uff09\u3001<code>HARNESS_EXCLUSIONS</code>\uff08\u660e\u786e\u6392\u9664 <code>business-semantics</code> / <code>workflow-orchestration</code> / <code>git-writes</code> / <code>model-calls</code> / <code>release-state</code> / <code>remote-network-access</code>\uff09\u3002</p> <p>\u80fd\u529b\u5206\u7ec4\uff08\u4e0e <code>docs/agents/capability-catalog.json</code> \u5bf9\u5e94\uff09\uff1a</p> <ul> <li>\u5951\u7ea6\u6821\u9a8c \u2192 <code>validateContractDocument</code> / <code>getValidator</code></li> <li>\u8def\u5f84\u6536\u5bb9 \u2192 <code>classifyPathInput</code> / <code>resolveContained</code> / <code>readFileContained</code></li> <li>\u539f\u5b50\u5199 \u2192 <code>writeFileAtomic</code></li> <li>\u4e34\u65f6\u5de5\u4f5c\u533a \u2192 <code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code></li> <li>\u8d44\u6e90\u95ed\u5305 \u2192 <code>computeResourceClosure</code> / <code>digestBytes</code> / <code>closureContains</code></li> <li>\u8bf7\u6c42\u7ba1\u7ebf \u2192 <code>parseRequest</code> / <code>processRequest</code></li> <li>\u62a5\u544a \u2192 <code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>verifyBinding</code> / <code>checkReport</code></li> <li>\u5bbf\u4e3b\u9002\u914d\u673a\u5236 \u2192 <code>normalizeAdapterSource</code> / <code>buildAdapterClosure</code> / <code>materializeAdapterBuild</code> / <code>probeVersionVector</code></li> <li>\u6301\u4e45\u72b6\u6001\u5e95\u5ea7 \u2192 <code>openStateStore</code> / <code>appendEvent</code> / <code>readSnapshot</code> / <code>verifyStateStore</code> \u2026</li> <li>\u57fa\u7ebf\u7269\u5316 \u2192 <code>computeDirectoryDigest</code> / <code>materializeBaseline</code>\uff08FND-ADR-009\uff09</li> <li>\u53ea\u8bfb chokepoint \u2192 <code>createReadChokepoint</code>\uff08FND-ADR-009\uff09</li> <li>\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf \u2192 <code>scanSurface</code>\uff08FND-ADR-009\uff09</li> <li>token \u4e0a\u754c\u4f30\u7b97 \u2192 <code>estimateTokenUpperBound</code>\uff08FND-ADR-009\uff09</li> <li>\u901a\u7528\u4e0a\u9650\u5b88\u536b \u2192 <code>openUsageGuard</code> / <code>appendUsageEvent</code> / <code>readUsage</code> / <code>closeUsageGuard</code>\uff08FND-ADR-009\uff09</li> <li>\u673a\u5236\u9519\u8bef \u2192 <code>HarnessError</code> / <code>mechanismError</code> / <code>HARNESS_ERROR_KINDS</code></li> </ul>"},{"location":"reference/api/harness/#\u5951\u7ea6\u6821\u9a8c-foundationharnesscontract-validation","title":"\u5951\u7ea6\u6821\u9a8c (foundation.harness.contract-validation)","text":""},{"location":"reference/api/harness/#validateContractDocument--getValidator--resolveSchemaContext--validatorCacheSize","title":"validateContractDocument / getValidator / resolveSchemaContext / validatorCacheSize","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>validateContractDocument(document, { schemaId, dialect, policy = \"strict\" } = {})</code></li> <li><code>getValidator({ schemaId, dialect, policy = \"strict\" } = {})</code></li> <li><code>resolveSchemaContext({ schemaId, dialect, policy = \"strict\" } = {})</code></li> <li><code>validatorCacheSize()</code></li> <li>\u8f93\u5165\uff1aschema \u4e0a\u4e0b\u6587\u6216\u5951\u7ea6\u6587\u6863\u3002</li> <li>\u8f93\u51fa\uff1a\u6821\u9a8c\u7ed3\u679c\uff08\u8bed\u4e49\u540c Contracts <code>validateDocument</code>\uff0c\u4f46\u7ecf Node \u8fd0\u884c\u65f6\u590d\u7528\u7f13\u5b58\uff09\uff1b\u7f13\u5b58\u5927\u5c0f\u67e5\u8be2\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08<code>getValidator</code> / <code>validateContractDocument</code> \u5199\u5165\u8fdb\u7a0b\u5185\u4ee5 schema \u4e3a\u952e\u7684\u6821\u9a8c\u5668\u7f13\u5b58\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u8fdb\u7a0b\u5185\u5185\u5b58\u7f13\u5b58\u6821\u9a8c\u5668\u5b9e\u4f8b\uff1b\u65e0\u6587\u4ef6/Git/\u7f51\u7edc\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6cbf\u7528 Contracts <code>SFC1001</code> / <code>SFC1002</code> / <code>SFC1006</code>\uff1b\u5e95\u5c42\u673a\u5236\u5931\u8d25\u7edf\u4e00 <code>SFC2004</code> + <code>HARNESS_ERROR_KINDS</code> \u7684 <code>kind</code>\uff08\u5982 <code>INVALID_PATH</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5df2\u5b89\u88c5 <code>skill-family-contracts</code>\uff1bAjv 8.20.0\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/validation.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/validation.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5951\u7ea6\u4e1a\u52a1\u5b57\u6bb5\u8bed\u4e49\uff08\u8bed\u4e49\u5b9a\u4e49\u4ecd\u5728 Contracts\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u8def\u5f84\u6536\u5bb9-foundationharnesspath-containment","title":"\u8def\u5f84\u6536\u5bb9 (foundation.harness.path-containment)","text":""},{"location":"reference/api/harness/#classifyPathInput--resolveContained--readFileContained","title":"classifyPathInput / resolveContained / readFileContained","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>classifyPathInput(input, platform = process.platform)</code></li> <li><code>resolveContained(root, relPath)</code></li> <li><code>readFileContained(root, relPath, { encoding } = {})</code></li> <li>\u8f93\u5165\uff1a\u6839\u76ee\u5f55\uff08\u6536\u5bb9\u8fb9\u754c\uff09\u4e0e\u5f85\u89e3\u6790\u7684\u76f8\u5bf9/\u7edd\u5bf9\u8def\u5f84\u3002</li> <li>\u8f93\u51fa\uff1a\u53d7\u6536\u5bb9\u7edd\u5bf9\u8def\u5f84\u6216\u8bfb\u5230\u7684\u6587\u4ef6\u5185\u5bb9\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>classifyPathInput</code> \u662f\uff1b<code>resolveContained</code> / <code>readFileContained</code> \u4e3a <code>async</code>\uff0c\u542b\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\uff08\u8bfb\u53d6/\u89e3\u6790\uff09\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u673a\u5236\u5931\u8d25\u629b <code>HarnessError</code>\uff08<code>SFC2004</code>\uff09+ <code>details.kind</code> \u2208 <code>{PATH_TRAVERSAL, SYMLINK_ESCAPE, REALPATH_ESCAPE, INVALID_ROOT, ABSOLUTE_PATH, WINDOWS_DRIVE_PATH, WINDOWS_PATH, UNC_PATH, INVALID_PATH, READ_FAILED}</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8c03\u7528\u65b9\u63d0\u4f9b\u660e\u786e\u6839\u76ee\u5f55\uff1b\u6240\u6709\u89e3\u6790\u7ed3\u679c\u5fc5\u987b\u843d\u5728\u6839\u76ee\u5f55\u5185\uff1bWindows \u76d8\u7b26/UNC \u9003\u9038\u540c\u6837\u62d2\u7edd\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/paths.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/containment.test.mjs</code>\u3001<code>boundaries.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u54ea\u4e9b\u8def\u5f84\u662f\u4e1a\u52a1\u5141\u8bb8\u7684\u9009\u62e9\u89c4\u5219\uff08\u4e1a\u52a1\u9009\u62e9\u8bed\u4e49\u7559\u5728\u8c03\u7528\u65b9\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u539f\u5b50\u5199-foundationharnessatomic-write","title":"\u539f\u5b50\u5199 (foundation.harness.atomic-write)","text":""},{"location":"reference/api/harness/#writeFileAtomic","title":"writeFileAtomic","text":"<ul> <li>\u7b7e\u540d\uff1a<code>writeFileAtomic(root, relPath, data, { mode = 0o644 } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u5df2\u6536\u5bb9\u76ee\u6807\u8def\u5f84\u3001\u6587\u4ef6\u5185\u5bb9\uff08<code>string</code> \u6216 <code>Buffer</code>\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u5199\u5165\u5b8c\u6210\u7684\u6587\u4ef6\uff0c\u5b57\u8282\u4e0e\u8f93\u5165\u4e00\u81f4\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u843d\u76d8\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u6839\u76ee\u5f55\u5185\u521b\u5efa\u4e34\u65f6\u6587\u4ef6\uff0c\u5148 <code>fsync</code> \u518d <code>rename</code> \u8986\u76d6\u76ee\u6807\uff1b\u5931\u8d25\u65f6\u56de\u6eda\u4e34\u65f6\u6587\u4ef6\u3001\u4e0d\u7559\u6b8b\u5f71\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u8d8a\u754c\u8def\u5f84\u629b <code>SFC2004</code> + <code>PATH_TRAVERSAL</code>/\u8d8a\u754c\u7c7b <code>kind</code>\uff1b\u975e\u6cd5\u6570\u636e\u7c7b\u578b / \u5199\u5931\u8d25 <code>+ ATOMIC_WRITE_FAILED</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u76ee\u6807\u8def\u5f84\u7ecf <code>path-containment</code> \u9a8c\u8bc1\u5728\u6839\u76ee\u5f55\u5185\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/atomic.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/atomic.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5199\u5165\u5185\u5bb9\u7684\u4e1a\u52a1\u6b63\u786e\u6027\u3002</li> </ul>"},{"location":"reference/api/harness/#\u4e34\u65f6\u5de5\u4f5c\u533a-foundationharnesstemporary-workspace","title":"\u4e34\u65f6\u5de5\u4f5c\u533a (foundation.harness.temporary-workspace)","text":""},{"location":"reference/api/harness/#TemporaryWorkspace--createTemporaryWorkspace--withTemporaryWorkspace","title":"TemporaryWorkspace / createTemporaryWorkspace / withTemporaryWorkspace","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>class TemporaryWorkspace</code>\uff08\u6784\u9020 <code>(options)</code>\uff09</li> <li><code>createTemporaryWorkspace(options)</code>\uff08async\uff09</li> <li><code>withTemporaryWorkspace(fn, options)</code>\uff08async\uff0c\u56de\u8c03\u5f0f\u751f\u547d\u5468\u671f\uff09</li> <li>\u8f93\u5165\uff1a\u53ef\u9009\u524d\u7f00/\u6807\u7b7e\u3002</li> <li>\u8f93\u51fa\uff1a\u4e34\u65f6\u5de5\u4f5c\u76ee\u5f55\u53e5\u67c4\uff1b<code>with</code> \u5728\u56de\u8c03\u7ed3\u675f\u540e\u6e05\u7406\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u521b\u5efa\u5e76\u5220\u9664\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u5b50\u76ee\u5f55\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u5bbf\u4e3b\u4e34\u65f6\u76ee\u5f55\u521b\u5efa\u5b50\u76ee\u5f55\uff0c\u9000\u51fa/\u5f02\u5e38\u65f6\u5220\u9664\uff1b\u4e0d\u6301\u4e45\u5316\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u521b\u5efa\u5931\u8d25 <code>+ WORKSPACE_CREATE_FAILED</code>\uff1b\u6e05\u7406\u5931\u8d25 <code>+ WORKSPACE_DISPOSE_FAILED</code>\uff1b\u5df2\u91ca\u653e\u540e\u4f7f\u7528 <code>+ WORKSPACE_DISPOSED</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5bbf\u4e3b\u63d0\u4f9b\u53ef\u5199\u4e34\u65f6\u76ee\u5f55\uff08\u5982 <code>os.tmpdir</code>\uff09\uff1b\u8def\u5f84\u4e0d\u9003\u9038\u51fa\u5bbf\u4e3b\u4e34\u65f6\u6839\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/workspace.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/workspace.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e34\u65f6\u4ea7\u7269\u7684\u6700\u7ec8\u53bb\u5904\uff08\u6301\u4e45\u6001\u8f6c <code>state-store</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u8d44\u6e90\u95ed\u5305-foundationharnessresource-closure","title":"\u8d44\u6e90\u95ed\u5305 (foundation.harness.resource-closure)","text":""},{"location":"reference/api/harness/#computeResourceClosure--digestBytes--closureContains","title":"computeResourceClosure / digestBytes / closureContains","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>computeResourceClosure({ root, resources } = {})</code>\uff08async\uff09</li> <li><code>digestBytes(bytes)</code></li> <li><code>closureContains(closure, relPath)</code></li> <li>\u8f93\u5165\uff1a\u8d44\u6e90\u5217\u8868\uff08\u8def\u5f84 + \u5185\u5bb9\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u786e\u5b9a\u6027\u95ed\u5305\u5bf9\u8c61\u4e0e sha256 \u6458\u8981\uff1b<code>closureContains</code> \u5224\u5b9a\u67d0\u76f8\u5bf9\u8def\u5f84\u662f\u5426\u5728\u95ed\u5305\u5185\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>digestBytes</code> / <code>closureContains</code> \u662f\uff1b<code>computeResourceClosure</code> \u542b\u6309 <code>root</code> \u8bfb\u53d6\u8d44\u6e90\uff0c\u5c5e\u53d7\u63a7\u53ea\u8bfb\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u6309 <code>root</code> \u53ea\u8bfb\u8bfb\u53d6\u8d44\u6e90\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u6cd5/\u91cd\u590d\u8d44\u6e90\u58f0\u660e\u629b <code>SFC2004</code> + <code>CLOSURE_CONFLICT</code> / <code>MISSING_RESOURCE</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8d44\u6e90\u4e3a\u53ef\u5e8f\u5217\u5316\u6587\u672c\u6761\u76ee\uff08\u4e8c\u8fdb\u5236\u6295\u5f71\u660e\u786e unsupported\uff09\uff1b\u53bb\u91cd\u4e0e\u6392\u5e8f\u56fa\u5b9a\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/closure.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/closure.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u8d44\u6e90\u4e1a\u52a1\u542b\u4e49\u3002</li> </ul>"},{"location":"reference/api/harness/#\u8bf7\u6c42\u7ba1\u7ebf-foundationharnessrequest-processing","title":"\u8bf7\u6c42\u7ba1\u7ebf (foundation.harness.request-processing)","text":""},{"location":"reference/api/harness/#parseRequest--processRequest","title":"parseRequest / processRequest","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>parseRequest(raw)</code></li> <li><code>processRequest(raw, { now = () => new Date() } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u539f\u59cb\u8bf7\u6c42\u8d1f\u8f7d\uff08\u5e94\u7b26\u5408 kernel \u534f\u8bae\u7ed3\u6784\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u89c4\u8303\u5316 <code>operation-request</code> \u4e0e\u7ec8\u6001 <code>operation-result</code>\uff08\u7ec8\u6001\u96c6\u5408\u56fa\u5b9a\u4e3a <code>REJECTED</code> / <code>FAILED</code> / <code>SUCCESS</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>parseRequest</code> \u662f\uff1b<code>processRequest</code> \u4e3a\u7eaf\u51fd\u6570\u7ba1\u7ebf\uff08\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff0c\u9ed8\u8ba4 <code>now</code> \u53ef\u6ce8\u5165\u4ee5\u4fdd\u8bc1\u786e\u5b9a\u6027\u6d4b\u8bd5\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6/Git/\u7f51\u7edc\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u89e3\u6790\u5931\u8d25\u8fdb\u5165 <code>REJECTED</code>/<code>FAILED</code> \u7ec8\u6001\u5e76\u5e26 <code>SFC2002</code> / <code>SFC2003</code> / <code>SFC2004</code>\uff1b\u673a\u5236\u5931\u8d25 <code>+ EXECUTION_FAILED</code> <code>kind</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8bf7\u6c42\u7b26\u5408 kernel \u534f\u8bae\u7ed3\u6784\uff1b\u4e1a\u52a1\u8bed\u4e49\u7531\u6d88\u8d39\u8005\u62e5\u6709\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/request.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/request.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u64cd\u4f5c\u7684\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\uff08\u72b6\u6001\u673a/\u91cd\u8bd5\u8f6c <code>loop-agent</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u62a5\u544a-foundationharnessreport","title":"\u62a5\u544a (foundation.harness.report)","text":""},{"location":"reference/api/harness/#validateReportModel--renderReportMarkdown--computeResultDigest--computeModelDigest--digestReport--buildBinding--verifyBinding--checkReport--collectStyleWarnings","title":"validateReportModel / renderReportMarkdown / computeResultDigest / computeModelDigest / digestReport / buildBinding / verifyBinding / checkReport / collectStyleWarnings","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>validateReportModel(reportModel, { resultDocument } = {})</code></li> <li><code>renderReportMarkdown(model)</code></li> <li><code>computeResultDigest(resultDocument)</code> / <code>computeModelDigest(reportModel)</code> / <code>digestReport(reportMarkdown)</code></li> <li><code>buildBinding(reportModel, resultDocument, reportMarkdown)</code></li> <li><code>verifyBinding(binding, { reportModel, resultDocument, reportMarkdown } = {})</code></li> <li><code>checkReport({ reportMarkdown, reportModel, resultDocument, binding } = {})</code></li> <li><code>collectStyleWarnings(reportMarkdown)</code></li> <li>\u8f93\u5165\uff1a<code>report-model</code>\u3001\u6e32\u67d3\u9009\u9879\uff08<code>locale</code> / <code>audience</code> / <code>style</code>\uff09\uff1b<code>SUPPORTED_REPORT_LOCALES = [zh-CN, en-US]</code>\u3002</li> <li>\u8f93\u51fa\uff1aMarkdown \u6587\u672c\u3001\u7ed1\u5b9a\u5bf9\u8c61\u3001\u5206\u7ea7\u68c0\u67e5\u53d1\u73b0\uff1b\u4eba\u7c7b\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u6d3e\u751f\uff0c\u7981\u6b62\u81ea\u7531\u64b0\u5199\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08\u65e0\u65f6\u949f\u3001\u65e0\u73af\u5883\u3001\u65e0\u7f51\u7edc\u3001\u65e0\u6a21\u578b\u8c03\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6/Git/\u7f51\u7edc\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC3001</code>\uff08<code>REPORT_DIGEST_MISMATCH</code>\uff0c\u7ed1\u5b9a\u6458\u8981\u4e0d\u7b26\u6216\u62a5\u544a\u975e\u6a21\u578b\u89c4\u8303\u6e32\u67d3\uff09\u3001<code>SFC3002</code>\uff08<code>REPORT_ELEMENT_MISSING</code>\uff0c\u5f3a\u5236\u5143\u7d20\u7f3a\u5931\uff09\u3001<code>SFC3003</code>\uff08<code>REPORT_FACT_DRIFT</code>\uff0c\u62a5\u544a\u6539\u5199\u7ed1\u5b9a\u7ed3\u679c\u4e8b\u5b9e\u6216\u5b57\u8282\u4e0e\u786e\u5b9a\u6027\u518d\u6e32\u67d3\u4e0d\u4e00\u81f4\uff09\u3002\u98ce\u683c\u544a\u8b66\u7531 <code>collectStyleWarnings</code> \u4ea7\u51fa\uff0c\u4ec5\u5efa\u8bae\u3001\u4e0d\u7f16\u7801\u3001\u4e0d\u963b\u65ad\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>REPORT_RENDERER_NAME</code> / <code>VERSION</code> \u53d6\u81ea\u5404\u81ea package\uff08\u5f53\u524d <code>0.3.0</code>\uff09\uff1b\u53cc\u8f93\u51fa\u6210\u7ec4\u5199\u5165\u5e76\u62d2\u7edd\u8def\u5f84\u522b\u540d\u4e0e\u8f93\u5165\u8986\u76d6\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/report.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/report.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u62a5\u544a\u4e1a\u52a1\u7ed3\u8bba\u7684\u89e3\u8bfb\uff08\u7f16\u6392\u7531 Kit <code>report</code> \u5b50\u52a8\u4f5c\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u5bbf\u4e3b\u9002\u914d\u673a\u5236-foundationharnesshost-adapter","title":"\u5bbf\u4e3b\u9002\u914d\u673a\u5236 (foundation.harness.host-adapter)","text":""},{"location":"reference/api/harness/#normalizeAdapterSource--buildAdapterClosure--verifyAdapterBuildManifest--materializeAdapterBuild--probeVersionVector","title":"normalizeAdapterSource / buildAdapterClosure / verifyAdapterBuildManifest / materializeAdapterBuild / probeVersionVector","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>normalizeAdapterSource(input)</code></li> <li><code>buildAdapterClosure({ hostId, pathCategory, input } = {})</code></li> <li><code>verifyAdapterBuildManifest(manifestInput, { hostId, pathCategory } = {})</code></li> <li><code>materializeAdapterBuild({ targetRoot, build, writer = writeFileAtomic } = {})</code>\uff08async\uff09</li> <li><code>probeVersionVector({ hostId, capabilities, executable, argv, allowSpawn = false, timeoutMs = 5000, runner = spawnSync } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1aadapter source\u3001\u76ee\u6807\u8def\u5f84\u3001probe \u9009\u9879\u3002</li> <li>\u8f93\u51fa\uff1a\u6784\u5efa\u95ed\u5305\u3001\u6821\u9a8c\u540e\u7684\u6e05\u5355\u3001materialize \u4ea7\u7269\u3001\u7248\u672c\u5411\u91cf\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>normalizeAdapterSource</code> / <code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code> \u662f\uff1b<code>materializeAdapterBuild</code> / <code>probeVersionVector</code> \u542b\u843d\u76d8\u6216\u8fdb\u7a0b\u8c03\u7528\u3002</li> <li>\u526f\u4f5c\u7528\uff1a<code>materializeAdapterBuild</code> \u5728\u53d7\u6536\u5bb9\u76ee\u6807\u521b\u5efa sibling staging \u5e76\u5355\u6b21 rename\uff1b<code>probeVersionVector</code> \u9ed8\u8ba4 <code>allowSpawn=false</code>\uff0c\u4e0d\u53d6 PATH\u3001\u4e0d\u81ea\u52a8\u6267\u884c\u5bbf\u4e3b\u4e8c\u8fdb\u5236\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6e05\u5355\u6458\u8981\u4e0d\u7b26 <code>+ MANIFEST_MISMATCH</code>\uff1b\u76ee\u6807\u5df2\u5b58\u5728 <code>+ PORTABLE_PATH_COLLISION</code>\uff1b\u975e\u53d7\u4fe1\u53ef\u6267\u884c\u6587\u4ef6 <code>+ UNTRUSTED_EXECUTABLE</code>\uff1b\u6784\u5efa/\u63a2\u6d4b\u5931\u8d25 <code>+ HOST_BUILD_FAILED</code> / <code>HOST_PROBE_FAILED</code>\uff1b\u5951\u7ea6\u4e0d\u7b26 <code>+ HOST_CONTRACT_INVALID</code>\uff1b\u4ee5\u4e0a\u5747\u5305\u4e8e <code>SFC2004</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aadapter source \u4e3a\u5df2\u58f0\u660e\u6587\u672c\u95ed\u5305\uff08<code>content</code> \u7c7b\u578b\u56fa\u5b9a <code>string</code>\uff0c\u4ec5 utf8\uff1b\u4e8c\u8fdb\u5236\u6295\u5f71 unsupported\uff09\uff1b\u53d7\u4fe1\u53ef\u6267\u884c\u6587\u4ef6\u65b9\u53ef materialize\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/host.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/host.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5bbf\u4e3b\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\uff08<code>host apply</code> \u660e\u786e unsupported\uff0c\u8f6c Profile + Kit <code>host</code> \u5b50\u52a8\u4f5c\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u6301\u4e45\u72b6\u6001\u5e95\u5ea7-foundationharnessstate-store","title":"\u6301\u4e45\u72b6\u6001\u5e95\u5ea7 (foundation.harness.state-store)","text":""},{"location":"reference/api/harness/#openStateStore--appendEvent--readEvents--readSnapshot--writeSnapshot--verifyStateStore--rebuildSnapshot--inspectStateStoreLock--recoverStateStoreLock--closeStateStore--close","title":"openStateStore / appendEvent / readEvents / readSnapshot / writeSnapshot / verifyStateStore / rebuildSnapshot / inspectStateStoreLock / recoverStateStoreLock / closeStateStore / close","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>openStateStore(root, { owner, payloadSchemas, clock } = {})</code>\uff08async\uff09</li> <li><code>appendEvent(store, event)</code>\uff08async\uff09</li> <li><code>readEvents(store, { afterSequence = 0 } = {})</code>\uff08async\uff09</li> <li><code>readSnapshot(store, { reducer, initial = null } = {})</code>\uff08async\uff09</li> <li><code>writeSnapshot(store, state, { hostSessionRef, reducer, initial = null } = {})</code>\uff08async\uff09</li> <li><code>verifyStateStore(store, { reducer, initial = null } = {})</code>\uff08async\uff09</li> <li><code>rebuildSnapshot(store, reducer, { initial = null } = {})</code>\uff08async\uff09</li> <li><code>inspectStateStoreLock(root, { clock } = {})</code>\uff08async\uff09</li> <li><code>recoverStateStoreLock(root, { ... } = {})</code>\uff08async\uff09</li> <li><code>closeStateStore(store)</code> / <code>close(store)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u4e8b\u4ef6\u8d1f\u8f7d\u3001\u5feb\u7167\u3001\u9501\u4ee4\u724c\u3002</li> <li>\u8f93\u51fa\uff1a\u4e8b\u4ef6\u3001hash chain \u6821\u9a8c\u7ed3\u679c\u3001\u5feb\u7167\uff1b<code>STATE_GENESIS_DIGEST</code> \u4f5c\u4e3a\u94fe\u8d77\u70b9\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8bfb\u5199\u4e8b\u4ef6\u65e5\u5fd7\u4e0e\u5feb\u7167\u6587\u4ef6\uff0c\u5199\u534f\u4f5c\u5f0f\u5355\u5199\u8005\u9501\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u8def\u5f84\u8bfb\u5199\u4e8b\u4ef6\u65e5\u5fd7\u4e0e\u5feb\u7167\uff1b\u5199\u9501\u6587\u4ef6\u7528\u4e8e\u672c\u5730\u534f\u4f5c\u5f0f\u5355\u5199\u8005\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1ahash chain \u65ad\u88c2 <code>+ CHAIN_BROKEN</code>\uff1b\u9501 fencing \u51b2\u7a81 <code>+ STORE_LOCKED</code>\uff1b\u9501\u635f\u574f <code>+ LOCK_CORRUPT</code>\uff1b\u6062\u590d\u62d2\u7edd <code>+ LOCK_RECOVERY_REFUSED</code>\uff1b\u975e\u6cd5\u4e8b\u4ef6 <code>+ UNSAFE_STATE_ENTRY</code> / <code>EVENT_SCHEMA_INVALID</code>\uff1b\u91cd\u590d\u5e8f\u53f7 <code>+ DUPLICATE_SEQUENCE</code>\uff1b\u5e42\u7b49\u51b2\u7a81 <code>+ IDEMPOTENCY_CONFLICT</code>\uff1b\u5feb\u7167\u4e0d\u4e00\u81f4 <code>+ SNAPSHOT_MISMATCH</code>\uff1b\u5df2\u5173\u95ed <code>+ STORE_CLOSED</code>\uff1b\u4ee5\u4e0a\u5747\u5305\u4e8e <code>SFC2004</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u4e3a\u552f\u4e00\u6743\u5a01\uff0csnapshot \u4e3a\u6d3e\u751f\u7f13\u5b58\uff1bfencing \u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\uff1b<code>confirmOwnerTerminated</code> \u4fe1\u4efb\u951a\u7531\u8c03\u7528\u65b9\u63d0\u4f9b\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/state-store.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/state-store.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e8b\u4ef6\u4e1a\u52a1\u542b\u4e49\u3001reducer \u8f6c\u79fb\u3001owner-terminated \u4fe1\u4efb\u951a\uff08\u4e1a\u52a1\u72b6\u6001\u673a/\u7ec8\u6001\u8f6c <code>loop-agent</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u673a\u5236\u9519\u8bef-foundationharnesserrors","title":"\u673a\u5236\u9519\u8bef (foundation.harness.errors)","text":""},{"location":"reference/api/harness/#HarnessError--mechanismError--HARNESS_ERROR_KINDS","title":"HarnessError / mechanismError / HARNESS_ERROR_KINDS","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>class HarnessError extends ContractsError</code>\uff08\u6784\u9020 <code>(code, message, details)</code>\uff0c\u672a\u767b\u8bb0\u7801\u7acb\u5373\u629b <code>TypeError</code>\uff09</li> <li><code>mechanismError(kind, message, extraDetails)</code>\uff08\u8fd4\u56de <code>SFC2004</code> + \u7a33\u5b9a <code>details.kind</code>\uff09</li> <li><code>HARNESS_ERROR_KINDS</code>\uff08\u51bb\u7ed3\u5bf9\u8c61\uff09</li> <li>\u8f93\u5165\uff1a\u9519\u8bef <code>kind</code>\u3001\u4e0a\u4e0b\u6587\u3002</li> <li>\u8f93\u51fa\uff1a\u5e26\u7a33\u5b9a <code>kind</code> \u7684\u9519\u8bef\u5bf9\u8c61\uff1b\u975e\u6cd5 <code>kind</code> \u629b <code>TypeError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u672c\u6a21\u5757\u4e0d\u53d1\u660e\u65b0\u7801\u2014\u2014\u673a\u5236\u5931\u8d25\u7edf\u4e00 <code>SFC2004</code>\uff08<code>EXECUTION_FAILED</code>\uff09\uff0c\u5176\u6ce8\u518c\u542b\u4e49\u4e3a\u300c\u673a\u5236\u8fd0\u884c\u65f6\u6267\u884c\u5408\u89c4\u64cd\u4f5c\u65f6\u5931\u8d25\uff1bdetails \u643a\u5e26\u673a\u5236\u8bc1\u636e\u300d\uff1b<code>details.kind</code> \u53d6\u4e0b\u5217\u51bb\u7ed3\u679a\u4e3e\u4e4b\u4e00\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>HARNESS_ERROR_KINDS</code> \u51bb\u7ed3\uff0c\u65b0\u589e SFC \u7801\u5c5e Contracts \u53d8\u66f4\uff08\u4e0d\u5728\u672c\u5305\u5199\u96c6\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/errors.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/boundary.test.mjs</code>\u3001<code>boundaries.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u9519\u8bef\u4e1a\u52a1\u5f52\u56e0\u3002</li> </ul> <p><code>HARNESS_ERROR_KINDS</code> \u51bb\u7ed3\u679a\u4e3e\uff08v1\uff09\uff1a</p> kind \u542b\u4e49 <code>invalid-path</code> / <code>absolute-path</code> / <code>windows-drive-path</code> / <code>windows-path</code> / <code>unc-path</code> \u8def\u5f84\u5f62\u6001\u975e\u6cd5 <code>path-traversal</code> / <code>symlink-escape</code> / <code>realpath-escape</code> \u6536\u5bb9\u9003\u9038 <code>invalid-root</code> \u6839\u76ee\u5f55\u975e\u6cd5 <code>atomic-write-failed</code> / <code>read-failed</code> \u6587\u4ef6\u8bfb\u5199\u5931\u8d25 <code>missing-resource</code> \u8d44\u6e90\u7f3a\u5931 <code>workspace-create-failed</code> / <code>workspace-dispose-failed</code> / <code>workspace-disposed</code> \u4e34\u65f6\u5de5\u4f5c\u533a\u5f02\u5e38 <code>closure-conflict</code> / <code>unsupported-policy</code> \u95ed\u5305/\u7b56\u7565\u51b2\u7a81 <code>execution-failed</code> / <code>invalid-result</code> \u6267\u884c/\u7ed3\u679c\u5f02\u5e38 <code>store-closed</code> / <code>store-locked</code> / <code>lock-corrupt</code> / <code>lock-recovery-refused</code> \u72b6\u6001\u9501\u5f02\u5e38 <code>unsafe-state-entry</code> / <code>event-schema-invalid</code> / <code>duplicate-sequence</code> / <code>idempotency-conflict</code> / <code>chain-broken</code> / <code>snapshot-mismatch</code> \u72b6\u6001\u4e8b\u4ef6\u5f02\u5e38 <code>host-contract-invalid</code> / <code>host-build-failed</code> / <code>host-probe-failed</code> / <code>untrusted-executable</code> / <code>portable-path-collision</code> / <code>manifest-mismatch</code> \u5bbf\u4e3b\u9002\u914d\u5f02\u5e38 <code>baseline-mismatch</code> / <code>content-guard-rejected</code> \u57fa\u7ebf\u7269\u5316\u5931\u8d25\u5173\u95ed <code>read-chokepoint-rejected</code> \u53ea\u8bfb\u51c6\u5165\u62d2\u7edd <code>surface-scan-violation</code> / <code>scan-policy-invalid</code> \u8868\u9762\u626b\u63cf\u5931\u8d25\u5173\u95ed <code>upper-bound-exceeded</code> \u4e0a\u9650\u5b88\u536b\u8d8a\u9650"},{"location":"reference/api/harness/#\u57fa\u7ebf\u7269\u5316-foundationharnessbaseline-materialization","title":"\u57fa\u7ebf\u7269\u5316 (foundation.harness.baseline-materialization)","text":"<p>FND-ADR-009\u3002\u628a\u51bb\u7ed3\u57fa\u7ebf\u7269\u5316\u4e3a\u5b57\u8282\u4fdd\u771f\u7684\u4e34\u65f6\u526f\u672c\uff1a\u7269\u5316\u524d\u6821\u9a8c\u6e90\u6458\u8981\u3001\u7269\u5316\u540e\u540c\u65f6\u6821\u9a8c\u526f\u672c\u6458\u8981\u4e0e\u6e90\u6458\u8981\uff08\u6355\u83b7\u7269\u5316\u4e2d\u9014\u7684\u4efb\u4e00\u4fa7\u53d8\u5316\uff09\uff1b\u526f\u672c\u5185\u7b26\u53f7\u94fe\u63a5\u4e00\u5f8b\u62d2\u7edd\u3002</p>"},{"location":"reference/api/harness/#computeDirectoryDigest--materializeBaseline","title":"computeDirectoryDigest / materializeBaseline","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>computeDirectoryDigest(rootDir)</code>\uff08async\uff0c\u8fd4\u56de 64 \u4f4d\u5c0f\u5199 sha256 \u5341\u516d\u8fdb\u5236\u6458\u8981\uff09</li> <li><code>materializeBaseline({ baselineDir, baselineDigest, prefix = \"sf-baseline-\" } = {})</code>\uff08async\uff0c\u8fd4\u56de\u7269\u5316\u6839\u8def\u5f84\uff09</li> <li>\u8f93\u5165\uff1a\u57fa\u7ebf\u76ee\u5f55\u4e0e\u51bb\u7ed3\u6458\u8981\u3002</li> <li>\u8f93\u51fa\uff1a\u786e\u5b9a\u6027\u76ee\u5f55\u6458\u8981\uff1b\u7269\u5316\u540e\u7684\u4e34\u65f6\u76ee\u5f55\u6839\u8def\u5f84\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8bfb\u6e90\u6811\u3001\u5728\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u521b\u5efa\u526f\u672c\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u6e90\u57fa\u7ebf\uff1b\u5199\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u5e76\u5728\u5931\u8d25\u65f6\u6e05\u7406\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6458\u8981\u4e0d\u7b26\uff08\u7269\u5316\u524d\u6216\u7269\u5316\u540e\uff09\u629b <code>SFC2004</code> + <code>baseline-mismatch</code>\uff08details \u542b <code>phase</code>\uff1a<code>pre-materialization</code> / <code>post-materialization</code>\uff09\uff1b\u76ee\u5f55\u4e0d\u53ef\u7528\u629b <code>invalid-root</code>\uff1b\u5efa\u76ee\u5f55\u5931\u8d25\u629b <code>workspace-create-failed</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8c03\u7528\u65b9\u6301\u6709\u51bb\u7ed3\u6458\u8981\uff1b\u540c\u4e00\u6743\u9650\u7ea7\u8fdb\u7a0b\u53ef\u5728\u7269\u5316\u7a97\u53e3\u5185\u6539\u52a8\u6e90\uff0c\u673a\u5236\u4ee5\u53cc\u7aef\u6458\u8981\u6355\u83b7\u5e76\u5931\u8d25\u5173\u95ed\uff0c\u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/baseline.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/baseline.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6b8b\u7559\u5185\u5bb9\u5224\u5b9a\uff08<code>contentGuard</code> \u8c13\u8bcd\uff09\u4e0e\u526f\u672c\u6700\u7ec8\u53bb\u5904\u3002</li> </ul> <p><code>TemporaryWorkspace.fromBaseline({ baselineDir, baselineDigest, prefix, contentGuard })</code> \u4e0e <code>createTemporaryWorkspace({ baseline: { ... } })</code> \u628a\u7269\u5316\u63a5\u5165\u5de5\u4f5c\u533a\u751f\u547d\u5468\u671f\uff1a<code>contentGuard</code> \u7f3a\u7701\u4e3a\u5141\u8bb8\uff08\u5b57\u8282\u4fdd\u771f\u662f\u673a\u5236\u5951\u7ea6\uff0c\u6b8b\u7559\u5224\u5b9a\u5f52\u6d88\u8d39\u8005\uff09\uff1b\u5b88\u536b\u629b\u9519\u5305\u88c5\u4e3a <code>content-guard-rejected</code> \u5e76 dispose \u526f\u672c\u3002</p>"},{"location":"reference/api/harness/#\u53ea\u8bfb-chokepoint-foundationharnessread-chokepoint","title":"\u53ea\u8bfb chokepoint (foundation.harness.read-chokepoint)","text":"<p>FND-ADR-009\u3002\u628a\u53d7\u4fdd\u62a4\u533a\u57df\u7684\u8bfb\u53d6\u96c6\u4e2d\u5230\u4e00\u4e2a\u51c6\u5165\u5165\u53e3\uff1a\u5141\u8bb8\u6839\u96c6\u5408 + \u53ef\u9009\u8eab\u4efd\u8c13\u8bcd\uff1b\u8d8a\u754c\u3001\u94fe\u63a5\u9003\u9038\u4e0e\u975e\u6388\u6743\u8eab\u4efd\u4e00\u5f8b <code>read-chokepoint-rejected</code>\u3002</p>"},{"location":"reference/api/harness/#createReadChokepoint","title":"createReadChokepoint","text":"<ul> <li>\u7b7e\u540d\uff1a<code>createReadChokepoint({ allowRoots, allowIdentity } = {})</code> \u2192 <code>{ assertReadAllowed, read }</code></li> <li>\u8f93\u5165\uff1a\u975e\u7a7a\u5141\u8bb8\u6839\u96c6\u5408\uff1b\u53ef\u9009\u8eab\u4efd\u8c13\u8bcd <code>(identity) => boolean</code>\u3002</li> <li>\u8f93\u51fa\uff1a\u51c6\u5165\u540e\u7684 <code>{ root, relPath, absolute }</code> \u6216\u53d7\u6536\u5bb9\u8bfb\u53d6\u7ed3\u679c\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08<code>async</code>\uff0c\u542b\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb realpath / \u6536\u5bb9\u8bfb\u53d6\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u8d8a\u754c/\u9003\u9038/\u975e\u6388\u6743\u629b <code>SFC2004</code> + <code>read-chokepoint-rejected</code>\uff1b\u8d44\u6e90\u7f3a\u5931\u629b <code>missing-resource</code>\uff1b\u53c2\u6570\u975e\u6cd5\u629b <code>TypeError</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8c03\u7528\u65b9\u58f0\u660e\u5141\u8bb8\u6839\u96c6\u5408\u4e0e\u8eab\u4efd\u89c4\u5219\uff1b\u673a\u5236\u4e0d\u89e3\u91ca\u4efb\u4f55\u79c1\u6709\u8eab\u4efd\u6216\u8def\u5f84\u8bed\u4e49\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/chokepoint.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/chokepoint.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5141\u8bb8\u6839\u96c6\u5408\u3001\u8eab\u4efd\u8c13\u8bcd\u3001\u51c6\u5165\u540e\u8bfb\u53d6\u8bed\u4e49\u3002</li> </ul> <p>\u5b57\u7b26\u4e32\u8f93\u5165\u4e0e <code>{ root, relPath }</code> \u8f93\u5165\u8d70\u540c\u4e00 <code>resolveContained</code> \u6536\u5bb9\u5206\u7c7b\uff08\u542b macOS <code>/var \u2192 /private/var</code> \u7b49\u7b26\u53f7\u94fe\u63a5\u524d\u7f00\u6839\u7684\u7edf\u4e00\u89c4\u8303\u5316\uff09\u3002</p>"},{"location":"reference/api/harness/#\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf-foundationharnesssurface-scan","title":"\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf (foundation.harness.surface-scan)","text":"<p>FND-ADR-009\u3002\u6309 <code>surface-scan-policy</code> \u5951\u7ea6\u6587\u6863\u5bf9\u58f0\u660e\u8868\u9762\u505a\u8def\u5f84\u4e0e\u5185\u5bb9\u6a21\u5f0f\u626b\u63cf\uff1a\u9996\u4e2a\u547d\u4e2d\u5373\u5931\u8d25\u5173\u95ed\uff1b\u7b56\u7565\u975e\u6cd5\u6216\u6a21\u5f0f\u4e0d\u53ef\u7f16\u8bd1\u540c\u6837\u5931\u8d25\u5173\u95ed\uff1b\u7f3a\u5931\u626b\u63cf\u6587\u4ef6\u4e0d\u9759\u9ed8\u8df3\u8fc7\u3002</p>"},{"location":"reference/api/harness/#scanSurface","title":"scanSurface","text":"<ul> <li>\u7b7e\u540d\uff1a<code>scanSurface({ root, relPaths, policy, encoding = \"utf8\" } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u626b\u63cf\u6839\u3001\u76f8\u5bf9\u8def\u5f84\u6e05\u5355\u3001\u7b56\u7565\u5951\u7ea6\u6587\u6863\u3002</li> <li>\u8f93\u51fa\uff1a<code>{ scanned, bytes, policy }</code>\uff08\u51bb\u7ed3\u5bf9\u8c61\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\uff1b\u8fdb\u7a0b\u5185\u6b63\u5219\u7f16\u8bd1\uff0c\u65e0\u6301\u4e45\u72b6\u6001\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u547d\u4e2d\u629b <code>SFC2004</code> + <code>surface-scan-violation</code>\uff08details \u542b <code>kindOfHit</code>\uff1a<code>path</code> / <code>content</code>\uff09\uff1b\u7b56\u7565\u975e\u6cd5\u6216\u6a21\u5f0f\u4e0d\u53ef\u7f16\u8bd1\u629b <code>scan-policy-invalid</code>\uff1b\u7f3a\u5931\u6587\u4ef6\u629b <code>missing-resource</code>\uff1b\u53c2\u6570\u975e\u6cd5\u629b <code>TypeError</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u7b56\u7565\u6587\u6863\u901a\u8fc7\u5951\u7ea6\u6821\u9a8c\uff1b<code>allowedUses</code> \u53ea\u643a\u5e26\u4e0d\u89e3\u91ca\uff0c\u547d\u4e2d\u4e0d\u88ab\u8c41\u514d\uff08\u8c41\u514d\u7531\u6d88\u8d39\u8005\u5c42\u5b9e\u73b0\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/surface-scan.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/surface-scan.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u7b56\u7565\u5185\u5bb9\u3001\u5141\u8bb8\u7528\u9014\u8bed\u4e49\u4e0e\u547d\u4e2d\u540e\u7684\u5904\u7f6e\u3002</li> </ul> <p>\u6ce8\u5165\u5f0f\u81ea\u6d4b\u7ea6\u5b9a\uff1a\u626b\u63cf\u5668\u65e0\u72b6\u6001\u2014\u2014\u6ce8\u5165\u6a21\u5f0f\u5e76\u626b\u63cf\u540e\u79fb\u9664\u6ce8\u5165\uff0c\u518d\u6b21\u626b\u63cf\u7ed3\u679c\u5b57\u8282\u4e00\u81f4\uff08\u81ea\u6d4b\u89c1\u6d4b\u8bd5\u6587\u4ef6\uff0c\u4e0d\u5192\u5145\u72ec\u7acb\u590d\u6838\uff09\u3002</p>"},{"location":"reference/api/harness/#token-\u4e0a\u754c\u4f30\u7b97-foundationharnesstoken-estimation","title":"token \u4e0a\u754c\u4f30\u7b97 (foundation.harness.token-estimation)","text":"<p>FND-ADR-009\u3002\u786e\u5b9a\u6027\u9886\u57df\u4f30\u7b97\u539f\u8bed\uff1aUTF-8 \u5b57\u8282\u6570\u7eaf\u51fd\u6570\uff0c\u65e0\u6a21\u578b\u3001\u65e0\u7f51\u7edc\u3001\u65e0 tokenizer \u4f9d\u8d56\u3001\u65e0\u6301\u4e45\u72b6\u6001\u5bfc\u5165\uff1b\u7ed3\u679c\u7b26\u5408 <code>token-estimate-result</code> \u5951\u7ea6\uff08\u65e0\u65f6\u95f4\u6233\uff0c<code>guarantees</code> \u4e3a\u5c01\u95ed\u679a\u4e3e\uff09\u3002</p>"},{"location":"reference/api/harness/#estimateTokenUpperBound","title":"estimateTokenUpperBound","text":"<ul> <li>\u7b7e\u540d\uff1a<code>estimateTokenUpperBound(text)</code>\uff08\u7eaf\u51fd\u6570\uff09</li> <li>\u8f93\u5165\uff1a\u6587\u672c\u5b57\u7b26\u4e32\u3002</li> <li>\u8f93\u51fa\uff1a<code>token-estimate-result</code> \u5bf9\u8c61\uff08<code>upperBound === inputBytes</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff1b\u96f6\u4f9d\u8d56\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u5b57\u7b26\u4e32\u8f93\u5165\u629b <code>TypeError</code>\uff08\u65e0 SFC \u7801\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8f93\u5165\u4e3a JavaScript \u5b57\u7b26\u4e32\uff1b\u4f30\u7b97\u53ea\u627f\u8bfa\u4e0a\u754c\uff08\u5b57\u8282\u6570\u5373\u4e0a\u754c\uff09\uff0c\u4e0d\u627f\u8bfa\u771f\u5b9e token \u8ba1\u6570\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/token-estimate.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/token-estimate.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4f30\u7b97\u7ed3\u679c\u7684\u89e3\u91ca\u4e0e\u6d88\u8d39\u4fa7\u6362\u7b97\uff08\u6a21\u578b\u8c03\u7528\u4e0e\u771f\u5b9e token \u8ba1\u6570\u4e0d\u5728 Foundation\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u901a\u7528\u4e0a\u9650\u5b88\u536b-foundationharnessupper-bound-guard","title":"\u901a\u7528\u4e0a\u9650\u5b88\u536b (foundation.harness.upper-bound-guard)","text":"<p>FND-ADR-009\u3002\u590d\u7528 state-store \u4e8b\u4ef6\u8d26\u4e0e token-lock \u663e\u5f0f\u5360\u7528\u5b9e\u73b0\u901a\u7528\u4e0a\u9650\u5b88\u536b\uff1a\u8d8a\u9650\u4e8b\u4ef6\u5931\u8d25\u5173\u95ed\u4e14\u4e0d\u5199\u5165\uff1b\u4e0a\u9650\u503c\u3001\u5355\u4f4d\u7c7b\u522b\u4e0e\u8d85\u9650\u7b56\u7565\u5168\u90e8\u7531\u6d88\u8d39\u8005\u914d\u7f6e\uff0c\u6a21\u5757\u4e0d\u643a\u5e26\u4efb\u4f55\u56fa\u5b9a\u6570\u989d\u6216\u5b9a\u4ef7\u8bcd\u6c47\u3002</p>"},{"location":"reference/api/harness/#openUsageGuard--appendUsageEvent--readUsage--closeUsageGuard","title":"openUsageGuard / appendUsageEvent / readUsage / closeUsageGuard","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>openUsageGuard({ stateRoot, owner, payloadSchemas, reducer, initial = 0, upperBound, lockRoot, lockPath, clock } = {})</code>\uff08async\uff09</li> <li><code>appendUsageEvent(guard, event, { beforeCommit } = {})</code>\uff08async\uff09</li> <li><code>readUsage(guard)</code>\uff08async\uff09</li> <li><code>closeUsageGuard(guard)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u4e8b\u4ef6\u8d1f\u8f7d\u3001\u7eaf\u5f52\u7ea6\u51fd\u6570\u3001\u975e\u8d1f\u4e0a\u9650\u3001\u72b6\u6001\u6839\u4e0e\u9501\u6839/\u9501\u8def\u5f84\u3002</li> <li>\u8f93\u51fa\uff1a\u8ffd\u52a0\u7ed3\u679c\u3001\u5f53\u524d\u7528\u91cf\u8bfb\u6570\u3001\u5b88\u536b\u53e5\u67c4\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u5199\u4e8b\u4ef6\u8d26\u4e0e\u9501\u6587\u4ef6\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u8def\u5f84\u5199\u4e8b\u4ef6\u8d26\u4e0e\u9501\u6587\u4ef6\uff1b\u6253\u5f00\u65f6\u663e\u5f0f\u5360\u7528\u9501\u3001\u5173\u95ed\u65f6\u91ca\u653e\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u8d8a\u9650\u629b <code>SFC2004</code> + <code>upper-bound-exceeded</code>\uff08details \u542b <code>upperBound</code> / <code>projected</code>\uff0c\u4e8b\u4ef6\u4e0d\u5199\u5165\uff09\uff1b\u9501\u88ab\u5360\u7528\u629b <code>store-locked</code>\uff1b\u4e8b\u4ef6\u8d26\u65ad\u94fe\u629b <code>chain-broken</code>\uff1b\u4e8b\u4ef6 schema \u8fdd\u89c4\u629b <code>event-schema-invalid</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>lockRoot</code>/<code>lockPath</code> \u7531\u6d88\u8d39\u8005\u6307\u5b9a\u5728 state store \u6839\u4e4b\u5916\uff1b\u4e8b\u4ef6\u8d26\u662f\u552f\u4e00\u6743\u5a01\uff1bfencing \u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/budget-guard.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/budget-guard.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e8b\u4ef6\u542b\u4e49\u3001\u5f52\u7ea6\u51fd\u6570\u3001\u4e0a\u9650\u6570\u503c\u4e0e\u8d85\u9650\u540e\u7684\u4e1a\u52a1\u5904\u7f6e\uff08\u5b9a\u4ef7\u4e0e\u8ba1\u8d39\u8bed\u4e49\u7559\u5728\u6d88\u8d39\u8005\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p><code>skill-family-harness-node/candidate/quickstart-profile</code> \u8d1f\u8d23\u521b\u5efa observation Resource\u3001Task \u4e0e\u7ec8\u6001 Result\uff0c\u5e76\u590d\u9a8c\u771f\u5b9e\u6587\u4ef6\u5b57\u8282\u3001Resource id \u5168\u5c40\u552f\u4e00\u6027\u3001Task digest\u3001operation \u8eab\u4efd\u3001\u9010\u5b57\u6bb5 <code>run/stage/attempt</code> \u4ee5\u53ca evidence \u7cbe\u786e\u56de\u6307\u3002<code>verifyQuickstartExchange</code> \u628a\u673a\u5236\u62d2\u7edd\u8f6c\u6362\u6210\u7ed3\u6784\u5316\u7ed3\u679c\uff0c\u629b\u51fa\u5f0f\u5165\u53e3\u7ee7\u7eed\u4f7f\u7528\u5df2\u767b\u8bb0\u7684 <code>SFC2004</code> \u4e0e\u7a33\u5b9a <code>details.kind</code>\u3002</p> <p>\u8be5\u5165\u53e3\u4e0d\u9009\u62e9 method\uff0c\u4e0d\u89e3\u91ca domainResult\uff0c\u4e5f\u4e0d\u62e5\u6709\u91cd\u8bd5\u3001\u8c03\u5ea6\u6216\u751f\u547d\u5468\u671f\u30020.3.0 \u7684 v2 \u4e0e 0.2.1 \u7684 v1 \u4e0d\u517c\u5bb9\uff1b\u63a5\u5165\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a\u6240\u9009\u7248\u672c\u3002</p>"},{"location":"reference/api/harness/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID \u89c1 <code>docs/agents/capability-catalog.json</code>\uff08<code>foundation.harness.*</code>\uff09\u3002</li> <li>\u673a\u68b0\u6821\u9a8c\uff1a<code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code>\uff0c\u62d2\u7edd\u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\u3002</li> </ul>"}]}
1	+ {"config":{"lang":["en"],"separator":"[\\s\\u200b\\u3000\\-\u3001\u3002\uff0c\uff0e\uff1f\uff01\uff1b]+","pipeline":["stemmer"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"","title":"\u4e2d\u6587 \u00b7 \u9996\u9875","text":"<p>English</p>"},{"location":"#Skill-Family-Foundation-Workspace","title":"Skill Family Foundation Workspace","text":"<p>Skill Family \u751f\u547d\u5468\u671f\u7684\u516c\u5171\u5de5\u7a0b\u57fa\u7840\u8bbe\u65bd\u7236\u5de5\u4f5c\u533a\u3002\u672c\u4ed3\u63d0\u4f9b\u673a\u5668\u5951\u7ea6\uff08Contracts\uff09\u3001Node \u8584\u8fd0\u884c\u65f6\uff08Harness\uff09\u3001\u5de5\u7a0b\u5de5\u5177\u5305\uff08Engineering Kit\uff09\u3001Profile SPI\u3001\u5b8c\u5168\u865a\u6784\u7684\u901a\u7528\u6837\u4f8b\uff08fixture\uff09\u548c\u5de5\u7a0b\u6587\u6863\u9aa8\u67b6\u3002</p>"},{"location":"#\u5f53\u524d\u72b6\u6001","title":"\u5f53\u524d\u72b6\u6001","text":"<p>\u672c\u4ed3\u662f\u4e00\u5957\u5f00\u53d1\u4e2d\u7684\u9996\u7248\u9aa8\u67b6\u3002\u7248\u672c\u3001\u53d1\u5e03\u3001Pages \u4e0e Git \u7b49\u52a8\u6001\u72b6\u6001\u552f\u4e00\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff1b\u8bb8\u53ef\u8bc1\u5df2\u6279\u51c6\u4e3a Apache License 2.0\uff0c\u7248\u6743\u4e3b\u4f53\u4e3a\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8\uff0c\u89c4\u8303\u5168\u6587\u89c1\u6839\u7ea7 <code>LICENSE</code>\u3002</p> <p>\u672c\u5de5\u4f5c\u533a\u6c38\u4e45 private\uff0c\u662f\u552f\u4e00\u5f00\u53d1\u771f\u6e90\uff1b\u516c\u5f00\u8fb9\u754c\u53ea\u6709\u4e09\u4e2a\u7248\u672c\u5316\u53d1\u5e03\u955c\u50cf\u4e0e npm tarball\uff0c\u9489\u4f4f\u7684\u6d88\u8d39\u5750\u6807\u4e0e\u53d1\u5e03\u72b6\u6001\u552f\u4e00\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u3002</p> <p>\u4ea7\u54c1\u7ea7\u7684\u552f\u4e00\u72b6\u6001\u9875\u662f \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff0c\u7531 <code>node scripts/docs/fact-check.mjs</code> \u5bf9\u7167\u673a\u5668\u771f\u6e90\u673a\u68b0\u6821\u9a8c\uff1b\u5176\u4ed6\u9875\u9762\u4e0d\u627f\u8f7d\u7b2c\u4e8c\u5957\u72b6\u6001\u53e3\u5f84\u3002</p>"},{"location":"#\u9996\u7248\u7ec4\u6210","title":"\u9996\u7248\u7ec4\u6210","text":"\u7ec4\u6210 \u8def\u5f84 \u804c\u8d23 Contracts <code>packages/skill-family-contracts</code> \u673a\u5668\u53ef\u6267\u884c\u5de5\u7a0b\u7ed3\u6784\u548c\u673a\u5236\u534f\u8bae\u7684\u552f\u4e00\u6743\u5a01 Harness <code>packages/skill-family-harness-node</code> \u53ea\u5b9e\u73b0 Contracts \u5b9a\u4e49\u7684\u673a\u5236\u534f\u8bae\uff0c\u4e0d\u62e5\u6709\u4e1a\u52a1\u8bed\u4e49 Engineering Kit <code>packages/skill-family-engineering-kit</code> \u53ea\u63d0\u4f9b <code>scaffold</code>\u3001<code>adopt-plan</code>\u3001<code>projection</code>\u3001<code>check</code> \u56db\u4e2a\u9876\u5c42\u547d\u4ee4 Profile \u79cd\u5b50 <code>profiles/public-plugin</code> \u516c\u5f00\u63d2\u4ef6\u5f62\u6001\u7684 Profile \u79cd\u5b50 \u865a\u6784\u6837\u4f8b <code>fixtures/generic-profile-extension-conformance</code> \u5b8c\u5168\u865a\u6784\u7684\u6269\u5c55\u4e00\u81f4\u6027\u6837\u4f8b <p>\u5305\u6e05\u5355\u3001Profile\u3001fixture \u4e0e\u9876\u5c42\u547d\u4ee4\u4ee5 <code>.foundation/skeleton-manifest.json</code> \u4e3a\u673a\u5668\u771f\u6e90\uff1b\u5de5\u5177\u7248\u672c\u9501\u5b9a\u89c1 <code>.foundation/version-lock.json</code>\u3002</p>"},{"location":"#\u6587\u6863\u5730\u56fe","title":"\u6587\u6863\u5730\u56fe","text":"<ul> <li>\u5b89\u88c5\u4e0e\u73af\u5883\u2014\u2014\u5de5\u5177\u7248\u672c pin\u3001\u5b89\u88c5\u4e0e\u6587\u6863\u7ad9\u70b9\u6784\u5efa</li> <li>\u5feb\u901f\u5f00\u59cb\u2014\u2014\u4ece\u672c\u5730\u9a8c\u8bc1\u5230\u8bd5\u8fd0\u884c\u7684\u6700\u77ed\u8def\u5f84</li> <li>\u80fd\u529b\u4e0e\u8bca\u65ad\u2014\u2014Kit \u56db\u547d\u4ee4\u3001\u9000\u51fa\u7801\u4e0e\u6545\u969c\u6392\u67e5</li> <li>\u67b6\u6784\u8fb9\u754c\u2014\u2014\u5206\u5c42\u3001\u552f\u4e00\u6743\u5a01\u3001\u9884\u7b97\u4e0e\u6587\u6863\u4e8b\u5b9e\u68c0\u67e5</li> <li>\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u2014\u2014\u552f\u4e00\u4ea7\u54c1\u72b6\u6001\u9875</li> <li>Git \u751f\u547d\u5468\u671f\u6307\u5357\u2014\u2014\u5206\u652f\u3001\u63d0\u4ea4\u3001\u63a8\u9001\u4e0e\u53d1\u5e03\u7684\u6388\u6743\u8fb9\u754c</li> </ul>"},{"location":"#\u5199\u4f5c\u8fb9\u754c","title":"\u5199\u4f5c\u8fb9\u754c","text":"<p>\u6587\u6863\u53ea\u6d88\u8d39\u673a\u5668\u771f\u6e90\u6784\u6210\u7684\u51bb\u7ed3\u4e8b\u5b9e\u5305\uff08manifest\u3001package.json\u3001Contracts \u767b\u8bb0\u7b49\uff09\uff0c\u7531 <code>node scripts/docs/fact-check.mjs</code> \u673a\u68b0\u6821\u9a8c\u3002\u6a21\u578b\u540d\u3001\u51ed\u636e\u548c\u8c03\u5ea6\u4fe1\u606f\u4e0d\u8fdb\u5165\u6587\u6863\uff0c\u4e5f\u4e0d\u8fdb\u5165 Contracts\uff1b\u8be6\u89c1 \u67b6\u6784\u8fb9\u754c\u3002</p>"},{"location":"architecture/","title":"\u4e2d\u6587 \u00b7 \u67b6\u6784\u8fb9\u754c","text":"<p>English</p>"},{"location":"architecture/#\u67b6\u6784\u8fb9\u754c","title":"\u67b6\u6784\u8fb9\u754c","text":"<p>\u672c\u9875\u662f Skill Family Foundation \u9762\u5411\u4f7f\u7528\u8005\u7684\u7a33\u5b9a\u67b6\u6784\u6295\u5f71\u3002\u5b83\u53ea\u89e3\u91ca\u7ed3\u6784\u3001\u804c\u8d23\u3001\u8fb9\u754c\u4e0e\u8def\u7531\uff0c\u4e0d\u627f\u8f7d\u52a8\u6001\u53d1\u5e03\u72b6\u6001\uff08\u53d1\u5e03\u72b6\u6001\u53ea\u7531 <code>docs/status/current.md</code> \u8bb0\u5f55\uff0c\u4e14\u7ecf <code>scripts/docs/fact-check.mjs</code> \u673a\u68b0\u6821\u9a8c\uff09\u3002\u6240\u6709\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\u3001\u652f\u6301\u72b6\u6001\u90fd\u4ece\u673a\u5668\u771f\u6e90\u590d\u7b97\u3002</p>"},{"location":"architecture/#\u5206\u5c42","title":"\u5206\u5c42","text":"<p>2026-08-09 \u67b6\u6784 hand-off\uff08FND-ADR-001\uff5e007\uff0cactive\uff0c\u89c1 <code>artifacts/decisions/</code>\uff09\u786e\u7acb\u7684\u5206\u5c42\uff1a\u7eb5\u5411\u4f9d\u8d56\u94fe\u56db\u5c42\uff0c\u6a2a\u5411\u80fd\u529b\u6302\u63a5\uff0c\u4e0d\u65b0\u589e\u7eb5\u5c42\u3002</p> <pre><code>\u6280\u80fd\u65cf\u4e1a\u52a1\uff08\u5404\u4ea7\u54c1\u4ed3\uff1arelease-skill\u3001loop-agent\u3001skill-eval \u7b49\uff09\n \u2502 \u4f9d\u8d56\n \u25bc\nEngineering Kit\uff08scaffold / adopt-plan / projection / check\uff09\n \u2502 \u4f9d\u8d56\n \u25bc\nHarness Node\uff08Contracts \u673a\u5236\u534f\u8bae\u5b9e\u73b0\uff09\n \u2502 \u4f9d\u8d56\n \u25bc\nContracts\uff08\u7ed3\u6784\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001\u534f\u8bae\u540d\u767b\u8bb0\uff09\n \u25b2\n \u2514---------------- independent Audit consumer\n\n\u6a2a\u5411\uff08\u6302\u63a5\u9762\uff0c\u4e0d\u65b0\u589e\u7eb5\u5c42\uff09\uff1a\n- profiles/ \u5bbf\u4e3b\u4e0e\u9879\u76ee\u5f62\u6001\u5dee\u5f02\u58f0\u660e\uff0c\u53ea\u5b9e\u73b0\u7a33\u5b9a SPI\n- \u5bbf\u4e3b \u5916\u90e8 AI \u7f16\u7801\u8fd0\u884c\u73af\u5883\uff1a\u62e5\u6709\u8bed\u4e49\uff0cFoundation \u7edf\u4e00\u7ed3\u6784\u6027\u5dee\u5f02\n- release-skill \u53d1\u5e03\u72b6\u6001\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165\uff0c\u4e0d\u8fdb\u5165 Foundation\n- Artifact Graph `artifacts/` \u67b6\u6784\u5236\u54c1\u4f53\u7cfb\uff0c\u95e8\u7981\u4e3a check:artifacts\n</code></pre> <p>\u7bad\u5934\u6307\u5411\u88ab\u4f9d\u8d56\u65b9\u3002\u516c\u5171\u6838\u5fc3\u4e0d\u5f97\u53cd\u5411\u4f9d\u8d56\u5177\u4f53 Profile \u6216\u5177\u4f53\u6280\u80fd\u65cf\uff1b\u65b0\u80fd\u529b\u7684\u4f9d\u8d56\u65b9\u5411\u843d\u4f4d\u89c1 <code>artifacts/design/FND-DES-001.md</code>\uff0c\u9010\u8d44\u4ea7\u5f52\u5c5e\u89c1 FND-ADR-002\u3002</p>"},{"location":"architecture/#\u804c\u8d23\u77e9\u9635","title":"\u804c\u8d23\u77e9\u9635","text":"<p>\u6bcf\u4e2a\u5206\u5c42\u53ea\u627f\u62c5\u4e0b\u8868\u5217\u51fa\u7684\u804c\u8d23\uff0c\u8d8a\u754c\u80fd\u529b\u4e00\u5f8b\u7531\u5916\u90e8\u9879\u76ee\u6216\u6d88\u8d39\u8005\u62e5\u6709\u3002</p> \u5206\u5c42 \u62e5\u6709 \u4e0d\u62e5\u6709\uff08\u843d\u5728\u522b\u5904\uff09 Contracts \u7ed3\u6784\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001\u534f\u8bae\u540d\u767b\u8bb0\uff1b22 \u7c7b\u9876\u5c42\u5bf9\u8c61\uff1b9 \u6761 mandatory rule \u4e1a\u52a1\u5b57\u6bb5\u8bed\u4e49\u3001\u9886\u57df\u5ba1\u8ba1\u3001\u8fdc\u7aef\u5199\u5165\u3001\u6a21\u578b\u751f\u6210 Harness Contracts \u7684 Node \u673a\u5236\u5b9e\u73b0\uff1b\u8def\u5f84\u6536\u5bb9\u3001\u539f\u5b50\u5199\u3001\u95ed\u5305\u3001\u8bf7\u6c42\u5904\u7406\u3001\u62a5\u544a\u6e32\u67d3\u3001\u5bbf\u4e3b\u63a5\u5165\u673a\u5236\u3001\u72b6\u6001\u5e95\u5ea7 \u4e1a\u52a1\u8bed\u4e49\u3001workflow \u7f16\u6392\u3001\u6a21\u578b\u8c03\u7528\u3001git \u5199\u3001\u7f51\u7edc\u8fdc\u7aef Engineering Kit \u56db\u4e2a\u5de5\u7a0b\u547d\u4ee4\u53ca\u5176\u53ea\u8bfb/\u53d7\u9650\u5199\u5165\u8fb9\u754c\uff1bhost \u5b50\u52a8\u4f5c\u6ce8\u5165\u5177\u4f53 Profile \u81ea\u52a8\u4fee\u590d\u3001\u81ea\u52a8\u8fc1\u79fb\u3001\u8fdc\u7aef\u53d1\u5e03\u3001\u7b2c 5 \u4e2a\u547d\u4ee4 Profile \u5bbf\u4e3b\u4e0e\u9879\u76ee\u5f62\u6001\u5dee\u5f02\u7684\u58f0\u660e\u5f0f SPI\uff1b\u53ea\u5b9e\u73b0\u7a33\u5b9a SPI \u4e1a\u52a1\u8bed\u4e49\u3001\u53ef\u6267\u884c\u811a\u672c\u5165\u53e3\u3001\u516c\u5171\u6838\u5fc3\u53d8\u66f4 release-skill \u53d1\u5e03\u72b6\u6001\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165 Foundation \u4e0d\u542b\u4efb\u4f55 publish/remote-write \u5165\u53e3 loop-agent \u4efb\u52a1\u3001\u91cd\u8bd5\u3001\u8fd4\u5de5\u3001\u9a8c\u6536\u3001\u81ea\u8fed\u4ee3 Foundation \u4e0d\u5b9a\u4e49 workflow \u72b6\u6001\u673a Artifact Graph \u5236\u54c1\u5173\u7cfb\u3001context\u3001packet\u3001version-lock Foundation \u4e0d\u62e5\u6709\u5236\u54c1\u56fe Audit \u72ec\u7acb fixture\u3001\u9884\u671f\u503c\u3001\u88c1\u51b3 \u9886\u57df\u8bed\u4e49\u7ed3\u8bba\u7531\u5916\u90e8\u5ba1\u9605\u62e5\u6709"},{"location":"architecture/#\u80fd\u529b\u5f52\u5c5e\u7b97\u6cd5","title":"\u80fd\u529b\u5f52\u5c5e\u7b97\u6cd5","text":"<p>\u7ed9\u4e00\u4e2a\u67b6\u6784\u9700\u6c42\uff0c\u6309\u4e0b\u9762\u987a\u5e8f\u5224\u5b9a\u5f52\u5c5e\uff0c\u547d\u4e2d\u5373\u505c\uff1a</p> <ol> <li>\u542b\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1 oracle \u2192 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u53ea\u63a5\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\u3002</li> <li>\u662f\u7ed3\u6784\u3001\u534f\u8bae\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u6216\u5bf9\u8c61 Schema \u2192 Contracts\u3002</li> <li>\u662f\u8de8\u6280\u80fd\u65cf\u53ef\u590d\u7528\u7684 Node \u673a\u5236 \u2192 Harness\u3002</li> <li>\u662f scaffold/adopt-plan/projection/check \u6216\u5177\u4f53 host Profile \u6ce8\u5165 \u2192 Kit / Profile\u3002</li> <li>\u6d89\u53ca\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001 \u2192 release-skill\u3002</li> <li>\u6d89\u53ca\u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5/\u9a8c\u6536 \u2192 loop-agent\u3002</li> <li>\u6d89\u53ca\u5236\u54c1\u5173\u7cfb/\u7248\u672c\u9501 \u2192 artifact-graph\u3002</li> <li>\u53ea\u6709\u4e00\u4e2a\u6d88\u8d39\u8005\u6216\u5c1a\u672a\u8bc1\u660e\u8de8\u4e24\u4e2a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d \u2192 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u6269\u5f20 Foundation\u3002</li> </ol> <p>\u7b2c 8 \u6b65\u662f\u6269\u5f20\u95f8\u95e8\uff1a\u65b0\u589e\u7ec4\u4ef6\u5fc5\u987b\u8bf4\u660e\u5220\u9664\u5b83\u4f1a\u8ba9\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\uff0c\u5e76\u7ecf\u72ec\u7acb fixture \u9a8c\u8bc1\uff1b\u8fdb\u5165\u95e8 1 \u53e6\u8981\u6c42\u81f3\u5c11\u4e00\u4e2a\u73b0\u6709\u771f\u5b9e\u6d88\u8d39\u8005\u52a0\u4e00\u4e2a\u7ed3\u6784\u540c\u578b\u7684\u53ef\u9884\u89c1\u6d88\u8d39\u8005\uff08\u7b2c\u4e8c\u6d88\u8d39\u8005\u4e0d\u8981\u6c42\u5df2\u4e0a\u7ebf\uff0c\u4f46\u9700\u6c42\u5fc5\u987b\u80fd\u7528\u540c\u4e00\u7ed3\u6784\u8868\u8fbe\uff0c\u8c03\u6574\u8bb0\u5f55\u89c1 FND-ADR-009\uff09\u3002\u7b2c 9 \u6b65\u662f\u6709\u9650\u5c01\u95ed\u8bed\u4e49\u95f8\u95e8\uff08\u5bf9\u5e94 FND-ADR-001 \u95e8 8\uff09\uff1a\u80fd\u529b\u82e5\u643a\u5e26\u5c11\u91cf\u9886\u57df\u8bed\u4e49\uff0c\u5fc5\u987b\u6ee1\u8db3\u8bed\u4e49\u80fd\u88ab\u5c11\u6570\u7a33\u5b9a\u5c01\u95ed\u679a\u4e3e\u8986\u76d6\uff0c\u6216\u4e3a\u786e\u5b9a\u6027\u4f30\u7b97\u539f\u8bed\u2014\u2014\u7b97\u6cd5\u3001\u9002\u7528\u8303\u56f4\u4e0e\u504f\u5dee\u65b9\u5411\u5df2\u5728\u5951\u7ea6\u4e2d\u58f0\u660e\uff1b\u672c\u95f8\u95e8\u4e0d\u53d6\u6d88\u95e8 2\u300c\u8bed\u4e49\u65e0\u5173\u300d\u4e00\u7968\u5426\u51b3\u3002\u673a\u5668\u53ef\u8bfb\u7248\u89c1 <code>docs/agents/architecture-routing.md</code>\u3002</p>"},{"location":"architecture/#\u4fe1\u4efb\u4e0e\u526f\u4f5c\u7528\u8fb9\u754c","title":"\u4fe1\u4efb\u4e0e\u526f\u4f5c\u7528\u8fb9\u754c","text":"<p>Foundation \u7684\u4fe1\u4efb\u524d\u63d0\u4e0e\u526f\u4f5c\u7528\u7ea6\u5b9a\u6309\u5c42\u56fa\u5316\uff0c\u8c03\u7528\u65b9\u636e\u6b64\u5224\u65ad\u98ce\u9669\uff1a</p> <ul> <li>Contracts\uff1a\u7eaf\u51fd\u6570\uff0c\u65e0\u6587\u4ef6/Git/\u7f51\u7edc/\u8fdb\u7a0b\u526f\u4f5c\u7528\uff1b\u9519\u8bef\u7801\u51bb\u7ed3\u4e0d\u6f02\u79fb\uff08<code>foundation.contracts.error-codes</code>\uff09\u3002</li> <li>Harness\uff1a\u673a\u5236\u5c42\u53ea\u5728\u53d7\u6536\u5bb9\u8def\u5f84\u5185\u8bfb\u5199\uff1b<code>HARNESS_EXCLUSIONS</code> \u6392\u9664 release-state\u3001remote-network-access\u3001business-semantics\u3001workflow-orchestration\u3001model-calls\u3001git-writes\uff08<code>foundation.harness.errors</code>\uff09\u3002</li> <li>Engineering Kit\uff1a<code>FORBIDDEN_SIDE_EFFECTS</code> \u542b git-init/commit/push/tag\u3001publish\u3001remote-write\uff1b<code>REFUSED_MUTATION_FLAGS</code> \u5728 CLI \u5165\u53e3\u5373\u62d2\uff08<code>foundation.kit.cli</code>\uff09\u3002</li> <li>Profile\uff1a\u58f0\u660e\u5f0f\u5dee\u5f02\uff0c\u5165\u53e3\u5fc5\u987b\u4e3a JSON \u6570\u636e\u8d44\u6e90\uff1b<code>coreOwned</code>\uff08packages/commands/namespacePrefixes\uff09\u4e3a\u7981\u5165\u76ee\u6807\uff08<code>foundation.profile.extension-spi</code>\uff09\u3002</li> <li>\u72b6\u6001\u5e95\u5ea7\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u662f\u552f\u4e00\u6743\u5a01\uff0csnapshot \u662f\u6d3e\u751f\u7f13\u5b58\uff1b<code>confirmOwnerTerminated</code> \u662f\u8c03\u7528\u65b9\u63d0\u4f9b\u7684\u5916\u90e8\u4fe1\u4efb\u951a\uff0c\u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\uff08<code>foundation.harness.state-store</code>\uff09\u3002</li> </ul>"},{"location":"architecture/#\u67b6\u6784\u51b3\u7b56\u6811","title":"\u67b6\u6784\u51b3\u7b56\u6811","text":"<pre><code>\u9700\u6c42\u542b\u9886\u57df\u8bed\u4e49/\u72b6\u6001\u673a/\u5ba1\u8ba1? \u2500\u2500\u662f\u2500\u2500\u25b6 \u7559\u5728\u6d88\u8d39\u8005\n \u2502\u5426\n\u662f\u7ed3\u6784/\u534f\u8bae/\u9519\u8bef\u7801/Schema? \u2500\u2500\u662f\u2500\u2500\u25b6 Contracts\n \u2502\u5426\n\u662f\u8de8\u6280\u80fd\u65cf Node \u673a\u5236? \u2500\u2500\u662f\u2500\u2500\u25b6 Harness\n \u2502\u5426\n\u662f scaffold/adopt/projection/check \u6216 Profile \u6ce8\u5165? \u2500\u2500\u662f\u2500\u2500\u25b6 Kit / Profile\n \u2502\u5426\n\u6d89\u53ca\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001? \u2500\u2500\u662f\u2500\u2500\u25b6 release-skill\n \u2502\u5426\n\u6d89\u53ca\u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5/\u9a8c\u6536? \u2500\u2500\u662f\u2500\u2500\u25b6 loop-agent\n \u2502\u5426\n\u6d89\u53ca\u5236\u54c1\u5173\u7cfb/\u7248\u672c\u9501? \u2500\u2500\u662f\u2500\u2500\u25b6 artifact-graph\n \u2502\u5426\n\u53ea\u6709\u4e00\u4e2a\u6d88\u8d39\u8005/\u672a\u8bc1\u660e\u8de8\u4e24\u4e2a\u771f\u5b9e\u6d88\u8d39\u8005? \u2500\u2500\u662f\u2500\u2500\u25b6 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u6269\u5f20\n \u2502\u5426\n\u643a\u5e26\u5c11\u91cf\u9886\u57df\u8bed\u4e49? \u2500\u2500\u662f\u2500\u2500\u25b6 \u6709\u9650\u5c01\u95ed\u8bed\u4e49\uff1a\u7a33\u5b9a\u95ed\u679a\u4e3e\u53ef\u8986\u76d6\uff0c\u6216\u4e3a\u786e\u5b9a\u6027\n \u2502 \u4f30\u7b97\u539f\u8bed\uff08\u7b97\u6cd5/\u9002\u7528\u8303\u56f4/\u504f\u5dee\u65b9\u5411\u5df2\u5951\u7ea6\u58f0\u660e\uff09\u2192 \u53ef\u7eb3\u5165\uff1b\n \u2502 \u5426\u5219\u7559\u5728\u6d88\u8d39\u8005\uff08FND-ADR-001 \u95e8 8\uff0c\u4e0d\u53d6\u6d88\u95e8 2 \u4e00\u7968\u5426\u51b3\uff09\n \u2502\u5426\n \u2500\u2500\u25b6 \u53ef\u7eb3\u5165\n</code></pre>"},{"location":"architecture/#\u4e0e\u5916\u90e8\u9879\u76ee\u7684\u8def\u7531\u5173\u7cfb","title":"\u4e0e\u5916\u90e8\u9879\u76ee\u7684\u8def\u7531\u5173\u7cfb","text":"<p>Foundation \u4e0d\u662f\u5168\u80fd\u5e95\u5ea7\u3002\u4e0b\u5217\u804c\u8d23\u660e\u786e\u5728 Foundation \u4e4b\u5916\uff1a</p> <ul> <li>\u53d1\u5e03\u4e0e\u8fdc\u7aef\u5199\u5165\uff1arelease-skill \u62e5\u6709\uff1bFoundation \u4e0d\u63d0\u4f9b\u4efb\u4f55 publish/remote-write \u5165\u53e3\uff08<code>foundation.unsupported.remote-publish</code>\uff09\u3002</li> <li>\u4efb\u52a1\u751f\u547d\u5468\u671f\uff1aloop-agent \u62e5\u6709\u4efb\u52a1\u3001\u91cd\u8bd5\u3001\u8fd4\u5de5\u3001\u9a8c\u6536\uff1bFoundation \u4e0d\u542b workflow \u72b6\u6001\u673a\uff08<code>foundation.unsupported.business-state-machine</code>\uff09\u3002</li> <li>\u5236\u54c1\u6cbb\u7406\uff1aartifact-graph \u62e5\u6709 <code>artifacts/</code> \u5173\u7cfb\u5408\u540c\u4e0e\u7248\u672c\u9501\uff0c\u95e8\u7981\u4e3a <code>check:artifacts</code>\u3002</li> <li>\u9886\u57df\u5ba1\u8ba1\uff1a\u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\u62e5\u6709\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\uff1bFoundation \u53ea\u63d0\u4f9b\u786e\u5b9a\u6027\u5ba1\u8ba1\u8868\u9762\uff08<code>foundation.unsupported.domain-audit-semantics</code>\uff09\u3002</li> <li>\u5bbf\u4e3b\u5e94\u7528\u4e0e\u751f\u547d\u5468\u671f\uff1ahost apply \u7a33\u5b9a\u62d2\u7edd\uff0cinstall/update/uninstall \u672a\u5b9e\u73b0\uff0cQoder \u5b8c\u6574 driver \u4e3a unsupported\uff08<code>foundation.unsupported.host-apply</code>\u3001<code>foundation.unsupported.host-install-update-uninstall</code>\u3001<code>foundation.unsupported.qoder-driver</code>\uff09\u3002</li> </ul>"},{"location":"architecture/#\u4e0b\u4e00\u9636\u6bb5\u80fd\u529b\u7ebf\u67b6\u6784-hand-off","title":"\u4e0b\u4e00\u9636\u6bb5\u80fd\u529b\u7ebf\uff08\u67b6\u6784 hand-off\uff09","text":"<p>\u4e09\u6761\u80fd\u529b\u7ebf\u5747\u7ecf FND-ADR-001 \u80fd\u529b\u7eb3\u5165\u95e8\u88c1\u51b3\u7eb3\u5165\uff0c\u5168\u90e8\u5728\u65e2\u6709\u5206\u5c42\u5185\u843d\u4f4d\uff1a</p> <ul> <li>\u5bbf\u4e3b\u63a5\u5165\u7ebf\uff08FND-FR-001/FND-FR-002\uff0cFND-ADR-003\uff09\uff1aContracts \u767b\u8bb0 descriptor/source/manifest/probe/plan/receipt\uff1bHarness \u5b9e\u73b0\u901a\u7528 source closure\u3001\u539f\u5b50 build/materialize \u548c probe \u5206\u7c7b\uff1bKit \u6ce8\u5165\u5177\u4f53 Profile \u4e0e\u53d7\u4fe1 driver\u3002\u5f53\u524d\u53ea\u652f\u6301 describe/build/probe/plan\uff0c<code>apply</code> \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u5747\u672a\u5b9e\u73b0\u3002</li> <li>\u6301\u4e45\u72b6\u6001\u5e95\u5ea7\u7ebf\uff08FND-FR-003\uff0cFND-ADR-004\uff09\uff1aappend-only \u4e8b\u4ef6\u3001hash chain\u3001\u5feb\u7167\u4e0e\u6821\u9a8c\u6062\u590d\uff1b\u53ea\u63d0\u4f9b\u72b6\u6001\u5e95\u5ea7\uff0c\u72b6\u6001\u673a\u3001\u4efb\u52a1\u8282\u70b9\u3001\u91cd\u8bd5\u3001\u7ec8\u6001\u3001\u8bb0\u5fc6\u7b49\u4e1a\u52a1\u8bed\u4e49\u4e0d\u7eb3\u5165 Foundation\u3002</li> <li>\u4eba\u7c7b\u62a5\u544a\u7ebf\uff08FND-FR-004\uff0cFND-ADR-005\uff09\uff1a\u53cc\u5c42\u5408\u540c\u2014\u2014\u673a\u5668\u7ed3\u679c\u662f\u552f\u4e00\u771f\u6e90\uff0c\u4eba\u7c7b\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\uff08Markdown + digest \u7ed1\u5b9a + \u5206\u7ea7\u68c0\u67e5\uff09\uff0c\u4e0d\u81ea\u7531\u64b0\u5199\u3002</li> <li>\u6709\u9650\u5c01\u95ed\u8bed\u4e49\u5de5\u5177\u7ebf\uff08FND-ADR-009\uff09\uff1a\u57fa\u7ebf\u7269\u5316 + contentGuard\uff08\u6458\u8981\u4e0d\u7b26\u3001\u7269\u5316\u4e2d\u9014\u53d8\u5316\u3001\u5b88\u536b\u68c0\u51fa\u5747\u5931\u8d25\u5173\u95ed\uff09\u3001\u901a\u7528\u53ea\u8bfb chokepoint\uff08\u5141\u8bb8\u6839\u96c6\u5408 + \u53ef\u9009\u8eab\u4efd\u8c13\u8bcd\uff09\u3001\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf\uff08\u7b56\u7565\u5951\u7ea6 + \u6ce8\u5165\u5f0f\u81ea\u6d4b\uff09\u3001token \u4e0a\u754c\u4f30\u7b97\uff08\u786e\u5b9a\u6027\u9886\u57df\u4f30\u7b97\u539f\u8bed\uff0c\u65e0\u6a21\u578b/\u7f51\u7edc/tokenizer \u4f9d\u8d56\uff09\u3001\u901a\u7528\u4e0a\u9650\u5b88\u536b\uff08\u590d\u7528 state-store \u4e8b\u4ef6\u8d26\u4e0e token-lock\uff0c\u4e0a\u9650\u4e0e\u8d85\u9650\u7b56\u7565\u7531\u6d88\u8d39\u8005\u914d\u7f6e\uff09\u3002</li> </ul> <p>\u4e09\u5305\u7ed3\u6784\u4fdd\u6301\u3001\u4e0d\u62c6\u7b2c\u56db\u5305\uff08FND-ADR-007\uff09\uff1b\u5236\u54c1\u6cbb\u7406\u91c7\u7528 artifact-graph CLI \u4e0e\u7248\u672c\u9501\uff08FND-ADR-006\uff09\u3002</p>"},{"location":"architecture/#\u9996\u7248\u9884\u7b97","title":"\u9996\u7248\u9884\u7b97","text":"<ul> <li>\u9876\u5c42 Contracts \u5bf9\u8c61\uff1a22 \u7c7b\uff08\u5b8c\u6574\u6e05\u5355\u4ee5 <code>packages/skill-family-contracts/src/registry.json</code> \u4e3a\u552f\u4e00\u771f\u6e90\uff09\uff1aproject-manifest\u3001profile-descriptor\u3001managed-file-lock\u3001operation-request\u3001operation-result\u3001migration-manifest\u3001adapter-source\u3001report-model\u3001report-binding\u3001host-descriptor\u3001host-registry\u3001host-capability-fact\u3001host-probe-result\u3001adapter-build-manifest\u3001host-operation-plan\u3001host-operation-receipt\u3001state-event-envelope\u3001state-snapshot-metadata\u3001token-estimate-result\u3001surface-scan-policy\u3001declared-read-surface-result\u3001structured-scan-policy\uff08FND-ADR-010/011\uff09\uff1b</li> <li>Kit \u9876\u5c42\u547d\u4ee4\uff1a4 \u4e2a\uff08scaffold\u3001adopt-plan\u3001projection\u3001check\uff09\uff1b</li> <li>\u5f3a\u5236\u673a\u68b0\u89c4\u5219\uff1a\u5f53\u524d 9 \u6761\uff0c\u9884\u7b97\u4e0d\u8d85\u8fc7 20 \u6761\uff0c\u7edd\u5bf9\u4e0a\u9650 30 \u6761\uff1bCR-001 \u5bf9\u767b\u8bb0\u8868\u5185\u5168\u90e8 Schema \u505a\u7edf\u4e00\u7f16\u8bd1\uff1b</li> <li>\u53f6\u5b50\u5305\uff1a3 \u4e2a\uff08skill-family-contracts\u3001skill-family-harness-node\u3001skill-family-engineering-kit\uff09\uff1b</li> <li>Schema \u6821\u9a8c\u5668\uff1aAjv 8.20.0\uff08\u7cbe\u786e\u7248\u672c pin\uff09\uff0c\u652f\u6301 draft-07 \u4e0e 2020-12 \u53cc\u65b9\u8a00\uff1b</li> <li>kernel \u534f\u8bae\uff1askill-family.kernel.operation\uff08stable\uff09\uff0cContracts \u7248\u672c 1.5.0\uff1b</li> <li>\u9ed8\u8ba4\u8fd0\u884c\u65f6\u8bed\u8a00\uff1aNode\uff1b\u7b2c\u4e8c\u8bed\u8a00\u5b9e\u73b0\u9996\u7248\u4e3a 0\u3002</li> </ul> <p>\u4efb\u4f55\u65b0\u589e\u7ec4\u4ef6\u5fc5\u987b\u8bf4\u660e\u5220\u9664\u5b83\u4f1a\u5bfc\u81f4\u7684\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\uff0c\u5e76\u901a\u8fc7\u72ec\u7acb fixture \u9a8c\u8bc1\u3002</p>"},{"location":"architecture/#\u673a\u5668\u771f\u6e90\u4e0e\u6587\u4ef6\u5206\u7c7b","title":"\u673a\u5668\u771f\u6e90\u4e0e\u6587\u4ef6\u5206\u7c7b","text":"\u771f\u6e90 \u5185\u5bb9 <code>.foundation/skeleton-manifest.json</code> \u5305\u6e05\u5355\u3001Profile\u3001fixture\u3001\u9876\u5c42\u547d\u4ee4 <code>.foundation/version-lock.json</code> projen\u3001pnpm\u3001Node \u7684\u7cbe\u786e\u7248\u672c\u4e0e\u9501\u5b9a\u70b9 <code>.foundation/file-registry.json</code> managed / handwritten / artifact \u4e09\u7c7b\u6587\u4ef6\u767b\u8bb0 <code>package.json</code> \u4e0e <code>packages//package.json</code> \u7248\u672c\u3001\u547d\u4ee4\u3001\u4f9d\u8d56\uff08\u5168\u90e8 projen \u53d7\u7ba1\uff09 <code>packages/skill-family-contracts/src/registry.json</code> \u534f\u8bae\u540d\u4e0e Schema $id \u767b\u8bb0 <code>scripts/release-artifact-contract.json</code> \u56fa\u5b9a\u4e09\u5305\u53d1\u5e03\u5b57\u8282\u5408\u540c\uff08\u6210\u5458\u3001\u5fc5\u9700\u9879\u4e0e\u5185\u5bb9\u6458\u8981\u89c4\u5219\uff09 <p>\u53d7\u7ba1\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7 <code>.projenrc.js</code> \u4fee\u6539\u5e76\u8fd0\u884c <code>pnpm synth</code> \u518d\u751f\u6210\uff1b\u624b\u5199\u6587\u4ef6\uff08\u542b\u5168\u90e8\u6587\u6863\uff09\u4e0d\u4f1a\u88ab synth \u8986\u76d6\u3002\u5206\u7c7b\u6743\u5a01\u89c1 <code>.foundation/file-registry.json</code>\u3002</p>"},{"location":"architecture/#\u6587\u6863\u7cfb\u7edf\u4e0e\u4e8b\u5b9e\u68c0\u67e5","title":"\u6587\u6863\u7cfb\u7edf\u4e0e\u4e8b\u5b9e\u68c0\u67e5","text":"<p>\u6587\u6863\u4f53\u7cfb\u7684\u76ee\u6807\u662f\u7528\u786e\u5b9a\u6027\u68c0\u67e5\u6d88\u9664\u624b\u5de5\u6f02\u79fb\uff1a</p> <ol> <li>\u51bb\u7ed3\u4e8b\u5b9e\u5305\uff1a\u6587\u6863\u5199\u4f5c\u53ea\u6d88\u8d39\u4e0a\u8868\u6240\u5217\u673a\u5668\u771f\u6e90\u3002\u6a21\u578b\u6216\u4f5c\u8005\u4e0d\u5f97\u51ed\u8bb0\u5fc6\u5199\u5165\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\uff1b\u6a21\u578b\u540d\u3001\u51ed\u636e\u548c\u8c03\u5ea6\u4fe1\u606f\u4e0d\u8fdb\u5165\u6587\u6863\uff0c\u4e5f\u4e0d\u8fdb\u5165 Contracts\u3002</li> <li>\u4e8b\u5b9e\u68c0\u67e5\uff1a<code>node scripts/docs/fact-check.mjs</code> \u5bf9\u7167\u771f\u6e90\u6821\u9a8c\u6587\u6863\u4e2d\u7684\u5305\u540d\u3001\u547d\u4ee4\u3001\u95e8\u7981\u4e8b\u5b9e\u3001\u7248\u672c pin \u4e0e\u5173\u952e\u6570\u5b57\uff0c\u5e76\u4ea4\u53c9\u6821\u9a8c\u771f\u6e90\u4e4b\u95f4\u7684\u4e00\u81f4\u6027\uff08manifest \u4e0e package.json\u3001version-lock \u4e0e packageManager\u3001\u89c4\u5219\u6570\u4e0e\u9884\u7b97\u7b49\uff09\u3002</li> <li>\u94fe\u63a5\u68c0\u67e5\uff1a<code>node scripts/docs/link-check.mjs</code> \u89e3\u6790 README \u4e0e\u5168\u90e8 <code>docs//.md</code> \u7684\u7ad9\u5185\u76f8\u5bf9\u94fe\u63a5\u548c\u6807\u9898\u951a\u70b9\uff0c\u5e76\u6821\u9a8c <code>mkdocs.yml</code> nav \u6536\u5f55\u5b8c\u6574\u3002</li> <li>\u65e0\u5de5\u4f5c\u6d41\u8fb9\u754c\u4e0e\u516c\u5f00\u8fb9\u754c\u9a8c\u8bc1\uff1a\u672c\u4ed3\u6ca1\u6709\u4efb\u4f55 CI/CD workflow\uff08\u65e7\u62d3\u6251\u7684 ci/docs/docs-deploy \u4e09\u4e2a Actions \u5df2\u6574\u4f53\u5220\u9664\uff09\uff0c\u5168\u90e8\u95e8\u7981\u5728\u79c1\u6709\u5de5\u4f5c\u533a\u5185\u8fd0\u884c\uff08<code>pnpm check</code>\uff09\uff1b\u516c\u5f00\u8fb9\u754c\u7531 <code>check:public-snapshots</code> \u4e0e\u53d1\u5e03\u5b57\u8282\u5408\u540c\u673a\u68b0\u9a8c\u8bc1\u3002\u516c\u5f00\u9759\u6001\u7ad9\u7531 <code>scripts/render-public-site.mjs</code> \u6e32\u67d3\uff08\u552f\u4e00\u8f93\u51fa <code>docs/public/site/</code> \u4e0e\u786e\u5b9a\u6027\u57fa\u7ebf <code>docs/public/site-baseline.json</code>\uff09\u3002</li> <li>\u7248\u672c\u9501\u5b9a\uff1a\u7ad9\u70b9\u5de5\u5177\u94fe\u9501\u5b9a\u5728 <code>scripts/docs/toolchain.json</code> \u4e0e <code>scripts/docs/requirements.txt</code>\uff0c\u6784\u5efa\u53ea\u4f7f\u7528\u4ed3\u5e93\u5916\u90e8\u7684 Python \u865a\u62df\u73af\u5883\uff0c\u4e0d\u505a\u7cfb\u7edf\u7ea7 pip install\u3002</li> </ol> <p>\u4e24\u4e2a\u68c0\u67e5\u811a\u672c\u90fd\u53ef\u76f4\u63a5 <code>node scripts/docs/<name>.mjs</code> \u8fd0\u884c\uff1a<code>fact-check.mjs</code> \u7ecf\u4ed3\u5185\u6a21\u5757\u6d88\u8d39\u6839\u76ee\u5f55\u7cbe\u786e\u9501\u5b9a\u7684 <code>semver@7.8.5</code>\uff0c\u8fd0\u884c\u524d\u5fc5\u987b\u5148\u5b8c\u6210 <code>pnpm install --frozen-lockfile</code>\uff1b<code>link-check.mjs</code> \u4e3a\u7eaf Node \u5b9e\u73b0\u3002\u804c\u8d23\u8bf4\u660e\u89c1 <code>scripts/docs/README.md</code>\u3002</p>"},{"location":"architecture/#\u7a33\u5b9a\u4ea7\u54c1\u95e8\u7981","title":"\u7a33\u5b9a\u4ea7\u54c1\u95e8\u7981","text":"<p>\u6839 <code>pnpm check</code> \u53ea\u7f16\u6392 11 \u4e2a\u7a33\u5b9a\u4ea7\u54c1 gate ID\uff08<code>check:structure</code>\uff5e<code>check:artifacts</code>\uff0c\u9010 ID \u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff09\uff0c\u4e0d\u518d\u9501\u6b7b\u539f\u59cb\u547d\u4ee4\u6e05\u5355\uff1b\u6bcf\u4e2a\u7a33\u5b9a ID \u5728\u81ea\u5df1\u7684 package script \u5185\u7ec4\u5408\u5c11\u91cf\u4ea7\u54c1\u68c0\u67e5\u3002\u95e8\u7981\u4e8b\u5b9e\u7531 <code>node scripts/docs/fact-check.mjs</code> \u4ece\u6839 <code>package.json</code> \u7684 <code>scripts.check</code> \u673a\u68b0\u63a8\u5bfc\u5e76\u9010\u5b57\u6838\u5bf9\u3002\u6587\u6863\u4e0e setup \u53ea\u8c03\u7528\u6216\u5217\u51fa 11 \u4e2a\u7a33\u5b9a ID \u6216\u6839 <code>pnpm check</code>\uff0c\u4e0d\u590d\u5236\u5e95\u5c42\u547d\u4ee4\u5217\u8868\u3002</p> <p>\u4ed3\u5185\u68c0\u67e5\u7684\u8bda\u5b9e\u8fb9\u754c\uff1a\u7ed3\u6784\u68c0\u67e5\u53ea\u8bc1\u660e\u201c\u5b57\u8282/\u7ed3\u6784\u4e00\u81f4\u6027\uff08\u4ed3\u5185\u53ef\u8bc1\uff09\u201d\uff1b\u4e00\u6b21\u6027\u8fc1\u79fb\u5b8c\u6574\u6027\u3001\u666e\u901a\u6b63\u6587\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\u7ed3\u8bba\u5c5e\u4e8e\u5916\u90e8\u5ba1\u9605\u804c\u8d23\uff0c\u4e0d\u5728\u76ee\u6807\u4ed3\u5185\u7ef4\u62a4\u7b2c\u4e8c\u4efd\u95e8\u7981 registry\u3001baseline \u6216\u547d\u4ee4\u6bd4\u8f83\u5668\u3002</p>"},{"location":"examples-and-fixtures/","title":"\u6837\u4f8b\u4e0e Fixture","text":"<p>\u672c\u9875\u8bf4\u660e Foundation \u4e2d fixture \u7684\u76ee\u7684\u3001\u8fd0\u884c\u5165\u53e3\uff0c\u4ee5\u53ca\u5b83\u80fd\u5426\u4f5c\u4e3a\u4e1a\u52a1 oracle\uff08\u5224\u5b9a\u4f9d\u636e\uff09\u3002\u7ed3\u8bba\u5148\u884c\uff1afixture \u53ea\u8bc1\u660e\u7ed3\u6784\u5951\u7ea6\uff0c\u4e0d\u8bc1\u660e\u4e1a\u52a1\u8bed\u4e49\u3002</p>"},{"location":"examples-and-fixtures/#fixture-\u7684\u76ee\u7684","title":"fixture \u7684\u76ee\u7684","text":"<p>fixture \u56de\u7b54\u4e00\u4e2a\u95ee\u9898\u2014\u2014\u300c\u8fd9\u4efd\u5951\u7ea6\u5bf9\u8c61/SPI \u5728\u7ed9\u5b9a\u8f93\u5165\u4e0b\u662f\u5426\u4ea7\u751f\u58f0\u660e\u7684\u884c\u4e3a\u300d\u3002\u5b83\u5206\u4e09\u7c7b\uff1a</p> <ul> <li>\u6b63\u4f8b\uff08positive\uff09\uff1a\u7ed9\u5b9a\u5408\u6cd5\u8f93\u5165\uff0c\u6821\u9a8c/\u673a\u5236\u5e94\u901a\u8fc7\u3002</li> <li>\u53cd\u4f8b\uff08negative\uff09\uff1a\u7ed9\u5b9a\u975e\u6cd5\u8f93\u5165\uff0c\u5fc5\u987b\u4ea7\u751f\u7a33\u5b9a\u5931\u8d25\u7801\uff08\u5982 <code>SFC1001</code>/<code>SFC1010</code>\uff09\u3002</li> <li>\u65b9\u8a00\u8fb9\u754c\uff08dialect-boundary\uff09\uff1a\u5728 draft-07 \u4e0e 2020-12 \u53cc\u65b9\u8a00\u4ea4\u754c\u5904\u7684\u9884\u671f\u884c\u4e3a\u3002</li> </ul> <p>fixture \u662f\u5b8c\u5168\u865a\u6784\u6570\u636e\uff0c\u4e0d\u542b\u771f\u5b9e\u4e1a\u52a1\u3001\u79c1\u6709 Profile\u3001\u7528\u6237\u8def\u5f84\u6216\u51ed\u636e\u3002</p>"},{"location":"examples-and-fixtures/#\u8fd0\u884c\u5165\u53e3","title":"\u8fd0\u884c\u5165\u53e3","text":"<ul> <li>Contracts fixture\uff1a<code>packages/skill-family-contracts/test/fixtures.test.mjs</code> \u673a\u68b0\u91cd\u653e <code>src/fixtures/<contract>/</code> \u7684\u671f\u671b\uff0c\u884c\u4e3a\u4e0d\u7b26\u62a5 <code>SFC1010</code>\u3002</li> <li>Profile SPI \u7b26\u5408\u6027\uff1a<code>fixtures/generic-profile-extension-conformance/verify.mjs</code>\uff08\u53ea\u8bfb\u6821\u9a8c\uff09\u4e0e <code>leak-scan.mjs</code>\uff08\u6cc4\u6f0f\u626b\u63cf\uff09\u3002</li> <li>\u9aa8\u67b6\u7cbe\u786e\u5408\u540c\uff1a<code>fixtures/scaffold-conformance/verify.mjs</code>\u3002</li> <li>\u91c7\u7528\u5371\u5bb3\u7c7b\uff1a<code>fixtures/adoption/cases/</code> \u4ee5\u5b57\u8282\u7ea7\u524d\u540e\u5feb\u7167\u8bc1\u660e <code>adopt-plan</code> \u53ea\u8bfb\u3002</li> </ul> <p>\u4ee5\u4e0a\u5165\u53e3\u5747\u4e3a\u53ea\u8bfb\u6216\u81ea\u542b\uff0c\u4e0d\u5199\u8c03\u7528\u65b9\u4ed3\u3001\u4e0d\u89e6\u78b0\u8fdc\u7aef\u3002</p>"},{"location":"examples-and-fixtures/#fixture-\u80fd\u5426\u4f5c\u4e3a\u4e1a\u52a1-oracle","title":"fixture \u80fd\u5426\u4f5c\u4e3a\u4e1a\u52a1 oracle","text":"<p>\u4e0d\u80fd\u3002\u539f\u56e0\uff1a</p> <ul> <li>fixture \u53ea\u8986\u76d6\u7ed3\u6784\u5951\u7ea6\u4e0e\u673a\u5236\u8fb9\u754c\uff0c\u4e0d\u8986\u76d6\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1\u7ed3\u8bba\u3002</li> <li>\u5ba1\u8ba1\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\u5c5e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff0cFoundation \u53ea\u63d0\u4f9b\u5ba1\u8ba1\u8868\u9762\uff08canonical JSON + sha256 \u6458\u8981\uff0c\u89c1 <code>foundation.contracts.audit-surface</code>\uff09\u3002</li> <li>\u6587\u6863\u4f53\u7cfb\u660e\u786e\uff1a\u666e\u901a\u6b63\u6587\u8bed\u4e49\u6b63\u786e\u6027\u7531\u5916\u90e8\u5ba1\u9605\u8d1f\u8d23\uff0c\u4ed3\u5185\u95e8\u7981\u53ea\u8bc1\u660e\u673a\u5668\u4e8b\u5b9e\u4e0e\u5b57\u8282/\u7ed3\u6784\u4e00\u81f4\u6027\u3002</li> </ul> <p>\u56e0\u6b64\uff0c\u628a fixture \u5f53\u4f5c\u4e1a\u52a1\u6b63\u786e\u6027\u7684\u5224\u636e\u662f\u8bef\u7528\u3002\u5b83\u8bc1\u660e\u300c\u5951\u7ea6\u88ab\u6ee1\u8db3\u300d\uff0c\u4e0d\u8bc1\u660e\u300c\u4e1a\u52a1\u662f\u5bf9\u7684\u300d\u3002</p>"},{"location":"examples-and-fixtures/#\u516c\u5f00\u8303\u56f4","title":"\u516c\u5f00\u8303\u56f4","text":"<ul> <li>Profile\uff1a<code>profiles/public-plugin</code>\uff08\u516c\u5f00\u6216\u5b8c\u5168\u865a\u6784\u6837\u4f8b\uff09\u3002</li> <li>fixture\uff1a<code>fixtures/generic-profile-extension-conformance</code>\u3001<code>fixtures/scaffold-conformance</code>\u3001<code>fixtures/licensing-profile-conformance</code>\u3001<code>fixtures/adoption</code>\u3001<code>fixtures/m0-consumer</code>\u3002</li> </ul> <p>\u5176\u4f59\u79c1\u6709\u6216\u6d88\u8d39\u8005 fixture \u4e0d\u8fdb\u5165\u516c\u5f00\u6587\u6863\uff1b\u79c1\u6709 Profile\u3001\u4ea7\u54c1\u6570\u636e\u3001\u7528\u6237\u8def\u5f84\u3001\u8d26\u53f7\u3001token \u6216\u8fd0\u884c\u65e5\u5fd7\u4e00\u5f8b\u4e0d\u5199\u5165\u516c\u5f00 fixture\u3002</p>"},{"location":"git-lifecycle/","title":"Git \u751f\u547d\u5468\u671f\u6307\u5357","text":"<p>\u672c\u6587\u662f Skill Family \u5404\u5de5\u4f5c\u533a Git \u751f\u547d\u5468\u671f\u89c4\u5219\u7684\u552f\u4e00\u6743\u5a01\u6587\u6863\u3002\u65b0\u5efa\u9879\u76ee\u9aa8\u67b6 \uff08<code>npx skill-family-engineering-kit scaffold</code>\uff09\u4e2d\u7684 AGENTS.md\u300cMinimal Git lifecycle\u300d\u533a\u5757\u4e0e <code>docs/git-lifecycle.md</code> \u9875\u9762\u90fd\u662f\u5bf9\u672c\u6307\u5357\u540c\u53e3\u5f84\u7684\u6295\u5f71\u4e0e\u6307\u9488\u2014\u2014 \u4efb\u4f55\u5de5\u4f5c\u533a\u90fd\u4e0d\u5f97\u518d\u7ef4\u62a4\u7b2c\u4e8c\u5957 Git \u89c4\u5219\u3002\u6240\u6709\u5de5\u5177\u94fe\uff08projen\u3001engineering kit\u3001 CI \u811a\u672c\uff09\u90fd\u4e0d\u6267\u884c Git \u5199\u64cd\u4f5c\uff1b\u4e0b\u8ff0\u6bcf\u4e00\u7c7b\u5199\u64cd\u4f5c\u90fd\u53ea\u6765\u81ea\u4eba\u7684\u663e\u5f0f\u51b3\u5b9a\u3002</p>"},{"location":"git-lifecycle/#\u5206\u652f\u547d\u540d\u4e0e\u5bff\u547d","title":"\u5206\u652f\u547d\u540d\u4e0e\u5bff\u547d","text":"<ul> <li>\u5206\u652f\u6a21\u578b\uff1a\u4e00\u6761\u957f\u671f\u5206\u652f <code>main</code>\uff0c\u52a0\u77ed\u5bff\u547d\u4efb\u52a1\u5206\u652f <code>task/<\u4efb\u52a1\u53f7>-<\u77ed\u6a2a\u7ebf\u6458\u8981></code> \uff08\u4f8b\u5982 <code>task/0050-git-lifecycle</code>\uff09\u3002</li> <li>\u4efb\u52a1\u5206\u652f\u53ea\u627f\u8f7d\u4e00\u4e2a\u4efb\u52a1\u7684\u4e00\u7ec4\u76f8\u5173\u53d8\u66f4\uff1b\u4efb\u52a1\u9a8c\u6536\u901a\u8fc7\u540e\u5408\u5e76\uff1b\u786e\u8ba4\u6ca1\u6709\u672a\u5408\u5e76 \u63d0\u4ea4\u540e\u53ef\u5220\u9664\u672c\u5730\u5206\u652f\u3002\u8fdc\u7aef\u5206\u652f\u5220\u9664\u5c5e\u4e8e push \u7c7b\u5916\u90e8\u5199\u5165\uff0c\u5fc5\u987b\u53e6\u884c\u53d6\u5f97\u663e\u5f0f \u6388\u6743\uff08\u89c1\u4e0b\u6587\u9010\u9879\u6388\u6743\u8282\uff09\uff0c\u5408\u5e76\u672c\u8eab\u4e0d\u81ea\u52a8\u6388\u6743\u8fdc\u7aef\u5220\u9664\u3002\u4e0d\u5b58\u5728\u957f\u671f\u5b58\u6d3b\u7684 \u7279\u6027\u5206\u652f\uff0c\u4e5f\u4e0d\u5141\u8bb8\u5728\u4efb\u52a1\u5206\u652f\u4e0a\u5806\u79ef\u4e0e\u4efb\u52a1\u65e0\u5173\u7684\u53d8\u66f4\u3002</li> <li><code>main</code> \u6c38\u8fdc\u53ea\u63a5\u6536\u5df2\u901a\u8fc7\u95e8\u7981\u7684\u5408\u5e76\uff1b\u4efb\u4f55\u60c5\u51b5\u4e0b\u90fd\u4e0d\u5f97\u5bf9 <code>main</code> \u76f4\u63a5\u63d0\u4ea4\u6216 force-push\u3002</li> </ul>"},{"location":"git-lifecycle/#\u4fee\u6539\u524d\u72b6\u6001\u68c0\u67e5","title":"\u4fee\u6539\u524d\u72b6\u6001\u68c0\u67e5","text":"<ul> <li>\u63d0\u4ea4\u3001\u8fdc\u7aef\u7b49\u5b9e\u65f6 Git \u72b6\u6001\u4e0d\u5199\u8fdb\u4efb\u4f55\u7248\u672c\u5316\u6587\u6863\uff08\u5305\u62ec\u4ea7\u54c1\u72b6\u6001\u9875\uff09\uff1b\u6267\u884c\u4efb\u4f55 Git \u52a8\u4f5c\u524d\uff0c\u5148\u73b0\u573a\u8fd0\u884c\u4e0b\u5217\u53ea\u8bfb\u547d\u4ee4\u53d1\u73b0\u5f53\u524d\u72b6\u6001\uff1a</li> </ul> <p><code>bash git status --short --branch git rev-parse --verify HEAD git remote -v</code></p> <p>\u8fd9\u4e09\u6761\u547d\u4ee4\u53ea\u662f\u53ea\u8bfb\u63a2\u6d4b\uff1a\u8f93\u51fa\u53ea\u53cd\u6620\u672c\u673a\u5de5\u4f5c\u533a\u5f53\u4e0b\u7684\u72b6\u6001\uff0c\u4e0d\u6388\u4e88\u4efb\u4f55\u5199\u6743\u9650\uff1b \u6267\u884c stage/commit/push/tag/release \u4ecd\u5fc5\u987b\u6309\u4e0b\u6587\u9010\u9879\u6388\u6743\u8282\u5355\u72ec\u53d6\u5f97\u6388\u6743\u3002 - \u5f00\u59cb\u4efb\u4f55\u4fee\u6539\u4e4b\u524d\uff0c\u5148\u8fd0\u884c <code>git status --short --branch</code>\uff0c\u786e\u8ba4\u5f53\u524d\u5206\u652f\u3001\u672a\u63d0\u4ea4 \u53d8\u66f4\u4e0e\u8fdc\u7aef\u8ddf\u8e2a\u72b6\u6001\uff1b\u5de5\u4f5c\u533a\u91cc\u51fa\u73b0\u4e0d\u8ba4\u8bc6\u7684\u5206\u652f\u3001\u672a\u6682\u5b58\u53d8\u66f4\u6216\u964c\u751f\u6587\u4ef6\u65f6\uff0c\u5148 \u8c03\u67e5\u6765\u6e90\u518d\u52a8\u624b\uff0c\u90a3\u662f\u522b\u4eba\u6b63\u5728\u8fdb\u884c\u7684\u5de5\u4f5c\uff0c\u4e0d\u662f\u53ef\u4ee5\u968f\u624b\u6e05\u7406\u7684\u566a\u58f0\u3002 - \u7981\u6b62\u7528 <code>git checkout .</code>\u3001<code>git restore .</code>\u3001<code>git clean -f</code>\u3001<code>git reset --hard</code> \u4e4b\u7c7b\u7684\u7834\u574f\u6027\u547d\u4ee4\u201c\u987a\u624b\u201d\u6e05\u7a7a\u5de5\u4f5c\u533a\u6765\u7ed5\u8fc7\u969c\u788d\uff1b\u786e\u9700\u4e22\u5f03\u672a\u63d0\u4ea4\u53d8\u66f4\u65f6\uff0c\u5fc5\u987b \u9010\u6761\u5217\u51fa\u5c06\u88ab\u4e22\u5f03\u7684\u5185\u5bb9\u5e76\u83b7\u5f97\u663e\u5f0f\u786e\u8ba4\u3002</p>"},{"location":"git-lifecycle/#\u539f\u5b50-commit-\u6761\u4ef6","title":"\u539f\u5b50 commit \u6761\u4ef6","text":"<p>\u4e00\u4e2a commit \u5fc5\u987b\u540c\u65f6\u6ee1\u8db3\uff1a</p> <ol> <li>\u53ea\u5305\u542b\u4e00\u4e2a\u903b\u8f91\u53d8\u66f4\uff08\u4e00\u4e2a\u4efb\u52a1\u7684\u63a8\u8fdb\uff0c\u6216\u4e00\u6b21\u660e\u786e\u62c6\u5206\u7684\u4fee\u6b63\uff09\uff1b</li> <li>\u53d7\u7ba1\u751f\u6210\u7269\u4e0e\u5176\u6e90\uff08<code>.projenrc.js</code>\u3001\u6295\u5f71\u811a\u672c\uff09\u5728\u540c\u4e00\u6b21\u63d0\u4ea4\u5185\u6210\u5bf9\u51fa\u73b0\uff1b</li> <li>\u63d0\u4ea4\u524d <code>pnpm check</code>\uff08\u6216\u4efb\u52a1\u6307\u5b9a\u7684\u6700\u5c0f\u9a8c\u8bc1\u5165\u53e3\uff09\u9000\u51fa\u7801\u4e3a 0\u2014\u2014\u4e0d\u5f97\u628a\u7ea2\u7684 \u72b6\u6001\u63d0\u4ea4\u8fdb\u4efb\u4f55\u5206\u652f\u540e\u518d\u201c\u56de\u5934\u4fee\u201d\uff1b</li> <li>\u63d0\u4ea4\u4fe1\u606f\u8bf4\u660e\u201c\u4e3a\u4ec0\u4e48\u201d\uff0c\u5f15\u7528\u4efb\u52a1\u53f7\uff1b\u4e0d\u5f97\u5305\u542b\u51ed\u636e\u3001\u79c1\u6709\u6570\u636e\u6216\u4e0d\u53ef\u516c\u5f00\u7684 \u5185\u90e8\u6807\u8bc6\u3002</li> </ol> <p>\u4e0d\u6ee1\u8db3\u4ee5\u4e0a\u4efb\u4e00\u6761\u4ef6\u7684\u53d8\u66f4\u4e0d\u5f97\u63d0\u4ea4\uff1b\u5b81\u53ef\u62c6\u6210\u591a\u4e2a commit\uff0c\u4e5f\u4e0d\u5408\u5e76\u6210\u4e00\u4e2a\u6df7\u5408 \u53d8\u66f4\u3002</p>"},{"location":"git-lifecycle/#stagecommitpushtagrelease-\u7684\u9010\u9879\u6388\u6743","title":"stage\u3001commit\u3001push\u3001tag\u3001release \u7684\u9010\u9879\u6388\u6743","text":"<ul> <li>\u4fee\u6539\u6388\u6743\u4e0d\u5305\u542b stage \u4e0e commit\uff1a\u83b7\u5f97\u67d0\u4efb\u52a1\u7684\u4fee\u6539\u6388\u6743\uff0c\u53ea\u8868\u793a\u53ef\u4ee5\u5728\u5de5\u4f5c\u533a \u91cc\u6539\u52a8\u6587\u4ef6\uff1bstage\uff08<code>git add</code>\uff09\u4e0e commit \u4ecd\u662f\u4e24\u4e2a\u72ec\u7acb\u7684\u5199\u64cd\u4f5c\uff0c\u5fc5\u987b\u5206\u522b \u6309\u98ce\u9669\u9010\u9879\u53d6\u5f97\u660e\u786e\u6388\u6743\uff0c\u4e0d\u5b58\u5728\u201c\u6388\u6743\u4fee\u6539\u5373\u9ed8\u8ba4\u6388\u6743\u63d0\u4ea4\u201d\u3002</li> <li>stage \u4e0e commit\uff1a\u9ed8\u8ba4\u53ea\u5728\u672c\u5730\u3001\u6309\u539f\u5b50\u6761\u4ef6\u6267\u884c\uff1b\u4e00\u6b21 commit \u6388\u6743\u53ea\u8986\u76d6\u88ab \u660e\u786e\u58f0\u660e\u7684\u90a3\u4e00\u6b21\u672c\u5730\u63d0\u4ea4\uff0c\u4e0d\u8986\u76d6\u4efb\u52a1\u4e4b\u5916\u7684\u6e05\u7406\u3001\u6539\u5199\uff08\u542b amend/rebase \u6539\u5199\u5df2\u63d0\u4ea4\u5185\u5bb9\uff09\u6216\u540e\u7eed\u63d0\u4ea4\u3002</li> <li>push\uff1a\u628a\u4efb\u52a1\u5206\u652f\u63a8\u9001\u5230\u8fdc\u7aef\u3001\u5f00 PR\uff0c\u4ee5\u53ca\u5220\u9664\u8fdc\u7aef\u5206\u652f \uff08<code>git push --delete</code> / <code>git push origin :<branch></code>\uff09\u540c\u5c5e push \u7c7b\u5916\u90e8 \u5199\u5165\uff0c\u90fd\u9700\u8981\u5728\u5f53\u524d\u4efb\u52a1\u91cc\u5355\u72ec\u6388\u6743\uff1b\u7981\u6b62\u76f4\u63a5 push <code>main</code>\u3002\u5408\u5e76\u540e\u7684\u6e05\u7406\u8bf4\u660e \u4e0d\u6784\u6210\u5bf9\u8fdc\u7aef\u5220\u9664\u7684\u81ea\u52a8\u6388\u6743\u3002</li> <li>tag \u4e0e release\uff1a\u6bcf\u4e00\u6b21\u6253 tag\u3001\u53d1\u5e03 release\uff08\u5305\u62ec npm publish\u3001Pages \u90e8\u7f72\u3001 \u5efa\u8fdc\u7aef\u4ed3\u5e93\uff09\u90fd\u662f\u72ec\u7acb\u7684\u9ad8\u98ce\u9669\u52a8\u4f5c\uff0c\u5fc5\u987b\u9010\u9879\u5355\u72ec\u6388\u6743\uff1b\u4e00\u6b21 push \u6388\u6743\u4e0d\u6784\u6210 \u4efb\u4f55 tag/release \u6388\u6743\u3002</li> <li>\u81ea\u52a8\u5316\u5de5\u5177\uff08\u542b AI \u52a9\u624b\u4e0e CI\uff09\u5728\u672a\u83b7\u5f97\u9488\u5bf9\u5f53\u524d\u4efb\u52a1\u7684\u663e\u5f0f\u4eba\u5de5\u6388\u6743\u524d\uff0c\u4e0d\u5f97 \u6267\u884c <code>git add</code>\uff08stage\uff09\u3001<code>git commit</code>\u3001<code>git push</code>\u3001<code>git tag</code> \u6216\u4efb\u4f55\u5efa \u8fdc\u7aef/\u53d1\u5e03/\u5220\u9664\u8fdc\u7aef\u5f15\u7528\u7684\u547d\u4ee4\u3002</li> <li>\u6388\u6743\u53ea\u5bf9\u58f0\u660e\u8005\u7684\u90a3\u4e00\u6b21\u64cd\u4f5c\u6709\u6548\uff0c\u4e0d\u6784\u6210\u5bf9\u540c\u7c7b\u540e\u7eed\u64cd\u4f5c\u7684\u957f\u671f\u653e\u884c\u3002</li> </ul>"},{"location":"git-lifecycle/#\u53d7\u7ba1\u6295\u5f71\u4e0e\u6e90\u540c\u63d0\u4ea4","title":"\u53d7\u7ba1\u6295\u5f71\u4e0e\u6e90\u540c\u63d0\u4ea4","text":"<ul> <li>projen \u53d7\u7ba1\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7\u4fee\u6539 <code>.projenrc.js</code> \u540e\u8fd0\u884c <code>pnpm synth</code> \u4ea7\u751f\uff1b\u751f\u6210\u7269 \u5fc5\u987b\u4e0e\u5176\u6e90\u53d8\u66f4\u5728\u540c\u4e00\u4e2a commit \u5185\u63d0\u4ea4\uff0c\u4e0d\u5f97\u5148\u63d0\u4ea4\u6e90\u3001\u540e\u8865\u751f\u6210\u7269\uff0c\u66f4\u4e0d\u5f97\u53ea \u63d0\u4ea4\u5176\u4e2d\u4e00\u4fa7\u3002</li> <li>\u6587\u6863\u53d7\u7ba1\u6295\u5f71\uff08\u5982 setup.md \u7684\u7a33\u5b9a\u95e8\u7981\u9636\u6bb5\u533a\u5757\uff09\u540c\u7406\uff1a\u6295\u5f71\u811a\u672c\u91cd\u8dd1 \u7684\u8f93\u51fa\u4e0e\u89e6\u53d1\u5b83\u7684\u771f\u6e90\u53d8\u66f4\u540c\u63d0\u4ea4\uff1bCI \u7684\u6f02\u79fb\u68c0\u67e5\uff08synth-drift / synth-idempotency\uff09 \u4f1a\u673a\u68b0\u62e6\u622a\u53ea\u63d0\u4ea4\u4e00\u4fa7\u7684\u53d8\u66f4\u3002</li> </ul>"},{"location":"git-lifecycle/#gitignore-\u5206\u7c7b","title":".gitignore \u5206\u7c7b","text":"<ul> <li>\u6bcf\u4e2a\u88ab\u5ffd\u7565\u7684\u8def\u5f84\u90fd\u5fc5\u987b\u5f52\u5165 <code>.foundation/file-registry.json</code> \u7684\u4e00\u4e2a\u7c7b\u522b\uff1a \u5de5\u5177\u751f\u6210\u7269\uff08artifacts\uff0c\u5982 <code>node_modules/</code>\u3001<code>site/</code>\u3001<code>.cache/</code>\u3001\u65e5\u5fd7\uff09\u8d70 <code>.gitignore</code>\uff1b\u4f9d\u8d56\u9501\u6587\u4ef6\uff08trackedToolLocks\uff0c\u5982 <code>pnpm-lock.yaml</code>\uff09\u88ab\u663e\u5f0f\u8ddf\u8e2a\u3001 \u4e0d\u5f97\u5ffd\u7565\uff1b\u624b\u5199\u6e90\u4e8b\u5b9e\u4e0e\u53d7\u7ba1\u6587\u4ef6\u4e00\u5f8b\u8ddf\u8e2a\u3002</li> <li><code>.gitignore</code> \u7684\u5ffd\u7565\u6a21\u5f0f\u96c6\u5408\u4e0e file-registry \u7684 artifacts \u6a21\u5f0f\u96c6\u5408\u5fc5\u987b\u9010\u5b57 \u4e00\u81f4\uff08<code>scripts/check-structure.mjs</code> \u673a\u68b0\u6838\u5bf9\uff09\uff1b\u65b0\u589e\u5ffd\u7565\u9879\u5fc5\u987b\u5148\u767b\u8bb0\u7c7b\u522b\uff0c \u4e0d\u5141\u8bb8\u51fa\u73b0\u201c\u8ddf\u8e2a\u4f46\u88ab\u5ffd\u7565\u201d\u6216\u201c\u5ffd\u7565\u4f46\u672a\u767b\u8bb0\u201d\u7684\u4e2d\u95f4\u6001\u3002</li> </ul>"},{"location":"git-lifecycle/#\u5220\u9664\u524d\u6838\u5bf9\u4e0e\u53ef\u6062\u590d\u5904\u7f6e","title":"\u5220\u9664\u524d\u6838\u5bf9\u4e0e\u53ef\u6062\u590d\u5904\u7f6e","text":"<ul> <li>\u5220\u9664\u4efb\u4f55\u6587\u4ef6\u3001\u5206\u652f\u6216\u5386\u53f2\u5185\u5bb9\u4e4b\u524d\uff0c\u5148\u6838\u5bf9\u5176\u662f\u5426\u4ecd\u88ab\u5f15\u7528\uff08\u95e8\u7981\u3001\u6587\u6863\u94fe\u63a5\u3001 \u51bb\u7ed3\u8bc1\u636e\u5f15\u7528\uff09\uff1b\u88ab\u51bb\u7ed3\u9a8c\u6536\u8f93\u5165\u5f15\u7528\u7684\u8bc1\u636e\u4e00\u5f8b\u4e0d\u5f97\u5220\u9664\u3002</li> <li>\u4f18\u5148\u53ef\u6062\u590d\u5904\u7f6e\uff1a\u80fd\u6539\u5c31\u4e0d\u5220\uff0c\u80fd\u505c\u7528\uff08\u5982 <code>if: false</code> \u786c\u95e8\u7981\uff09\u5c31\u4e0d\u79fb\u9664\uff1b\u786e\u9700 \u5220\u9664\u65f6\u4fdd\u7559\u53ef\u8ffd\u6eaf\u7684\u66ff\u4ee3\u7269\uff08\u7eed\u63a5\u8bb0\u5f55\u3001\u51b3\u5b9a\u8bb0\u5f55\u3001\u5f52\u6863\u9875\uff09\u3002</li> <li>\u5206\u652f\u9000\u51fa\uff1a\u4efb\u52a1\u5206\u652f\u5408\u5e76\u540e\uff0c\u5148\u786e\u8ba4\u6ca1\u6709\u672a\u5408\u5e76\u7684\u63d0\u4ea4\uff0c\u518d\u5220\u9664\u672c\u5730\u5206\u652f\uff1b\u8fdc\u7aef \u5206\u652f\u5220\u9664\u5c5e\u4e8e push \u7c7b\u5916\u90e8\u5199\u5165\uff0c\u5408\u5e76\u540e\u7684\u6e05\u7406\u8bf4\u660e\u4e0d\u5f97\u81ea\u52a8\u6388\u6743\u8fdc\u7aef\u5220\u9664\uff0c\u987b\u6309 \u9010\u9879\u6388\u6743\u8282\u53e6\u884c\u53d6\u5f97\u663e\u5f0f\u6388\u6743\u3002</li> <li>\u4efb\u4f55\u201c\u5220\u9664\u540e\u91cd\u653e\u201d\u90fd\u5fc5\u987b\u6709\u5148\u7ea2\u540e\u7eff\u7684\u673a\u5668\u8bc1\u636e\uff0c\u8bc1\u660e\u5220\u9664\u4e0d\u662f\u9759\u9ed8\u4e22\u5931\u3002</li> </ul>"},{"location":"git-lifecycle/#\u751f\u6210\u7269\u7981\u6b62\u624b\u6539","title":"\u751f\u6210\u7269\u7981\u6b62\u624b\u6539","text":"<ul> <li>\u5e26 projen \u751f\u6210\u6807\u8bb0\u7684\u6587\u4ef6\u3001\u6295\u5f71\u811a\u672c\u5199\u5165\u7684\u53d7\u7ba1\u533a\u5757\u3001<code>.foundation/</code> \u4e0b\u7684\u673a\u5668 \u771f\u6e90\u4e00\u5f8b\u7981\u6b62\u624b\u6539\uff1b\u624b\u6539\u4f1a\u88ab synth \u6f02\u79fb\u68c0\u67e5\u68c0\u51fa\u5e76\u62e6\u622a\u3002</li> <li>\u9700\u8981\u53d8\u66f4\u53d7\u7ba1\u5185\u5bb9\u65f6\uff0c\u552f\u4e00\u5408\u6cd5\u8def\u5f84\u662f\u4fee\u6539\u5bf9\u5e94\u7684\u6e90\uff08<code>.projenrc.js</code> \u6216\u6295\u5f71\u811a\u672c \u7684\u771f\u6e90\u8f93\u5165\uff09\u518d\u91cd\u65b0\u751f\u6210\uff1b\u201c\u624b\u6539\u540e\u518d\u91cd\u65b0\u751f\u6210\u628a\u5dee\u5f02\u6d17\u767d\u201d\u5c5e\u4e8e\u88ab\u95e8\u7981\u660e\u786e\u62d2\u7edd \u7684\u7be1\u6539\u6a21\u5f0f\u3002</li> </ul>"},{"location":"help/","title":"\u4e2d\u6587 \u00b7 \u80fd\u529b\u4e0e\u8bca\u65ad","text":"<p>English</p>"},{"location":"help/#\u5e2e\u52a9\u4e0e\u5206\u8bca","title":"\u5e2e\u52a9\u4e0e\u5206\u8bca","text":"<p>\u672c\u9875\u6309\u9519\u8bef\u7801\u3001\u8fdb\u7a0b\u9000\u51fa\u7801\u4e0e\u73b0\u8c61\u7ed9\u5206\u8bca\u8def\u5f84\u3002Foundation \u7684\u9519\u8bef\u7801\u4f53\u7cfb\u51bb\u7ed3\u5728 Contracts\uff08<code>src/error-codes.json</code>\uff09\uff0c\u4e0d\u6f02\u79fb\uff1b\u673a\u5236\u5931\u8d25\u7edf\u4e00\u4e3a <code>SFC2004</code> \u52a0\u7a33\u5b9a <code>details.kind</code>\u3002</p>"},{"location":"help/#\u6309\u7a33\u5b9a\u9519\u8bef\u7801\u5206\u8bca","title":"\u6309\u7a33\u5b9a\u9519\u8bef\u7801\u5206\u8bca","text":"\u9519\u8bef\u7801 \u540d\u79f0 \u542b\u4e49 \u5904\u7f6e SFC1001 SCHEMA_VALIDATION_FAILED \u6587\u6863\u672a\u901a\u8fc7\u76ee\u6807 Schema \u9a8c\u8bc1 \u68c0\u67e5\u6587\u6863\u5fc5\u586b\u5b57\u6bb5\u4e0e\u7c7b\u578b\u7ea6\u675f SFC1002 UNKNOWN_SCHEMA_ID <code>$id</code> \u672a\u5728\u767b\u8bb0\u8868\u6ce8\u518c \u786e\u8ba4 <code>$id</code> \u62fc\u5199\u4e0e Contracts \u7248\u672c SFC1003 DUPLICATE_SCHEMA_ID \u91cd\u590d <code>$id</code> \u6ce8\u518c\u88ab\u62d2 \u4e0d\u91cd\u590d\u6ce8\u518c\uff0c\u590d\u7528\u5df2\u6709\u767b\u8bb0 SFC1004 DUPLICATE_PROTOCOL_NAME \u91cd\u590d\u534f\u8bae\u540d/\u7248\u672c\u88ab\u62d2 \u4e0d\u91cd\u590d\u767b\u8bb0\u534f\u8bae SFC1005 UNRESOLVED_REF <code>$ref</code> \u76ee\u6807\u65e0\u6cd5\u89e3\u6790 \u68c0\u67e5 <code>$ref</code> \u6307\u5411 SFC1006 UNSUPPORTED_DIALECT \u65b9\u8a00\u4e0d\u5728\u652f\u6301\u96c6 \u4ec5\u7528 draft-07 / 2020-12 SFC1007 UNKNOWN_CHECK_TYPE \u89c4\u5219\u7528\u4e5d\u7c7b\u5916\u68c0\u67e5\u7c7b\u578b \u4e0d\u81ea\u5b9a\u4e49\u68c0\u67e5\u7c7b\u578b SFC1008 RULE_BUDGET_EXCEEDED \u5f3a\u5236\u89c4\u5219\u8d85\u9884\u7b97/\u4e0a\u9650 \u4e0d\u8d85 20\uff08\u7edd\u5bf9 30\uff09 SFC1009 UNKNOWN_ERROR_CODE \u5f15\u7528\u672a\u767b\u8bb0\u9519\u8bef\u7801 \u53ea\u5f15\u7528\u51bb\u7ed3\u767b\u8bb0\u8868 SFC1010 FIXTURE_EXPECTATION_MISMATCH fixture \u884c\u4e3a\u4e0e\u671f\u671b\u4e0d\u7b26 \u67e5 fixture \u58f0\u660e SFC1011 UNKNOWN_PROTOCOL \u5f15\u7528\u672a\u767b\u8bb0\u534f\u8bae \u786e\u8ba4\u534f\u8bae\u540d/\u7248\u672c SFC1012 SCHEMA_COMPILE_FAILED Schema \u672c\u8eab\u65e0\u6cd5\u7f16\u8bd1 \u67e5 Schema \u8bed\u6cd5 SFC2002 UNKNOWN_OPERATION \u64cd\u4f5c\u540d\u4e0d\u5728\u51bb\u7ed3\u8bcd\u6c47\u8868 \u53ea\u7528 <code>validate</code> SFC2003 INVALID_PARAMS \u53c2\u6570\u4e0d\u6ee1\u8db3 params \u5408\u540c \u68c0\u67e5\u53c2\u6570 SFC2004 EXECUTION_FAILED \u673a\u5236\u6267\u884c\u5931\u8d25 \u770b <code>details.kind</code> \u7ec6\u5206 SFC3001 REPORT_DIGEST_MISMATCH \u62a5\u544a/\u7ed3\u679c\u6458\u8981\u4e0e\u7ed1\u5b9a\u4e0d\u4e00\u81f4 \u91cd\u7b97 model/result SFC3002 REPORT_ELEMENT_MISSING \u62a5\u544a\u7f3a\u5f3a\u5236\u5143\u7d20 \u8865\u5168\u62a5\u544a\u5b57\u6bb5 SFC3003 REPORT_FACT_DRIFT \u62a5\u544a\u5b57\u8282\u504f\u79bb\u786e\u5b9a\u6027\u91cd\u6e32\u67d3 \u7528\u673a\u5668\u7ed3\u679c\u91cd\u6e32\u67d3"},{"location":"help/#\u6309\u8fdb\u7a0b\u9000\u51fa\u7801\u5206\u8bcaEngineering-Kit","title":"\u6309\u8fdb\u7a0b\u9000\u51fa\u7801\u5206\u8bca\uff08Engineering Kit\uff09","text":"\u9000\u51fa\u7801 \u542b\u4e49 \u5904\u7f6e 0 \u6210\u529f / \u65e0\u53d1\u73b0 \u65e0\u9700\u5904\u7f6e 1 <code>check</code> \u6709\u53d1\u73b0 \u5904\u7f6e\u53d1\u73b0\u9879\uff0cKit \u4e0d\u81ea\u52a8\u4fee\u590d 2 \u62d2\u7edd / \u7528\u6cd5 / \u673a\u5236\u9519\u8bef \u68c0\u67e5\u547d\u4ee4\u540d\u3001\u53c2\u6570\u4e0e <code>--fix</code> \u7b49\u88ab\u62d2\u65d7\u6807"},{"location":"help/#\u6309\u73b0\u8c61\u5206\u8bca","title":"\u6309\u73b0\u8c61\u5206\u8bca","text":"<ul> <li>\u6821\u9a8c\u4e00\u76f4\u62a5 SFC1002\uff1a<code>$id</code> \u672a\u6ce8\u518c\uff0c\u5148\u786e\u8ba4 Contracts \u7248\u672c\u4e0e <code>$id</code> \u547d\u540d\u7a7a\u95f4\u3002</li> <li>\u8def\u5f84\u64cd\u4f5c\u62a5 SFC2004 + <code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>\uff1a\u8def\u5f84\u8d8a\u51fa\u53d7\u6536\u5bb9\u6839\uff0c\u786e\u8ba4\u6839\u76ee\u5f55\u8fb9\u754c\uff0c\u4e0d\u8981\u628a\u4e1a\u52a1\u9009\u62e9\u89c4\u5219\u585e\u8fdb Foundation\u3002</li> <li>\u539f\u5b50\u5199\u62a5 SFC2004 + <code>atomic-write-failed</code>\uff1a\u76ee\u6807\u8d8a\u754c\u6216\u5185\u5bb9\u7c7b\u578b\u975e\u6cd5\uff0c\u68c0\u67e5\u8def\u5f84\u6536\u5bb9\u4e0e\u5185\u5bb9\u7c7b\u578b\u3002</li> <li>\u72b6\u6001\u5b58\u50a8\u62a5 <code>store-locked</code>\uff1a\u65e7\u5199\u8005\u53ef\u80fd\u4ecd\u6301\u6709\u9501\uff1b\u5728 Foundation \u5916\u786e\u8ba4\u65e7\u5199\u8005\u5df2\u7ec8\u6b62\uff0c\u518d\u7528\u7cbe\u786e owner/fencing \u8c03\u7528 <code>recoverStateStoreLock</code>\u3002</li> <li>host apply \u76f4\u63a5\u5931\u8d25\uff1a<code>apply</code> \u5728\u53ea\u8bfb Phase D \u5207\u7247\u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u66f4\u65b0/\u5378\u8f7d\u672a\u5b9e\u73b0\uff0cQoder \u5b8c\u6574 driver \u4e3a unsupported\u3002</li> <li>\u6587\u6863\u7248\u672c/\u547d\u4ee4\u5bf9\u4e0d\u4e0a\u771f\u6e90\uff1a\u4ee5 <code>scripts/docs/fact-check.mjs</code> \u590d\u7b97\u7ed3\u679c\u4e3a\u51c6\uff0c\u4e0d\u51ed\u8bb0\u5fc6\u4fee\u8ba2\u3002</li> </ul>"},{"location":"help/#\u9879\u76ee\u8def\u7531","title":"\u9879\u76ee\u8def\u7531","text":"<ul> <li>\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001 / npm \u53d1\u5e03 \u2192 release-skill\u3002</li> <li>\u4efb\u52a1 / \u91cd\u8bd5 / \u8fd4\u5de5 / \u9a8c\u6536 \u2192 loop-agent\u3002</li> <li>\u5236\u54c1\u5173\u7cfb / \u7248\u672c\u9501 \u2192 artifact-graph\u3002</li> <li>\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49 \u2192 \u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\u3002</li> <li>\u901a\u7528\u7ed3\u6784 / \u673a\u5236\u95ee\u9898 \u2192 \u672c\u4ed3 <code>docs/architecture.md</code> \u4e0e <code>docs/agents/</code>\u3002</li> </ul>"},{"location":"help/#\u547d\u4ee4\u901f\u67e5\u4e0e\u6743\u5a01\u4e8b\u5b9e","title":"\u547d\u4ee4\u901f\u67e5\u4e0e\u6743\u5a01\u4e8b\u5b9e","text":"<p>Engineering Kit \u53ea\u6709\u56db\u4e2a\u9876\u5c42\u547d\u4ee4\uff1a<code>scaffold</code>\u3001<code>adopt-plan</code>\u3001<code>projection</code>\u3001<code>check</code>\u3002\u5176\u4e2d <code>check</code> \u53ea\u8bca\u65ad\u4e0d\u4fee\u590d\uff0c\u53d1\u73b0\u9879\u4ea4\u8c03\u7528\u65b9\u5904\u7f6e\u3002</p> <ul> <li>\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u7248\u672c\u3001\u5305\u96c6\u5408\u3001\u955c\u50cf\u5750\u6807\u3001\u95e8\u7981\uff09\uff1a\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u552f\u4e00\u72b6\u6001\u9875\uff09\u3002</li> <li>\u5f00\u53d1\u4e0e\u63d0\u4ea4\u89c4\u8303\uff1aGit \u751f\u547d\u5468\u671f\u6307\u5357\u3002</li> </ul>"},{"location":"licensing/","title":"\u4e2d\u6587 \u00b7 \u8bb8\u53ef\u4e0e\u7f72\u540d","text":"<p>English</p>"},{"location":"licensing/#\u8bb8\u53ef\u8bc1\u4e0e\u8eab\u4efd\u8bf4\u660e","title":"\u8bb8\u53ef\u8bc1\u4e0e\u8eab\u4efd\u8bf4\u660e","text":"<p>\u672c\u9875\u8bf4\u660e Skill Family Foundation \u7684\u8bb8\u53ef\u8bc1\u91c7\u7528\u65b9\u5f0f\u3001\u5404\u8eab\u4efd\u4e3b\u4f53\u7684\u533a\u522b\uff0c\u4ee5\u53ca NOTICE \u4e0e\u7b2c\u4e09\u65b9\u7f72\u540d\u7684\u5f53\u524d\u72b6\u6001\u3002\u5b83\u4e0d\u662f Apache License 2.0 \u7684\u5b98\u65b9\u8bd1\u6587\uff1bApache-2.0 \u7684\u6cd5\u5f8b\u6b63\u6587\u4ee5\u4ed3\u5e93\u6839\u76ee\u5f55\u7684 <code>LICENSE</code> \u4e3a\u51c6\uff0c\u5982\u6709\u6b67\u4e49\u4ee5\u8be5\u82f1\u6587\u6b63\u672c\u4e3a\u51c6\u3002</p>"},{"location":"licensing/#\u8bb8\u53ef\u8bc1","title":"\u8bb8\u53ef\u8bc1","text":"<ul> <li>\u8bb8\u53ef\u8bc1\uff1a<code>Apache-2.0</code>\uff08SPDX \u6807\u8bc6\u4fdd\u6301\u4e0d\u53d8\uff09\u3002</li> <li>\u6cd5\u5f8b\u6b63\u6587\uff1a\u6839\u76ee\u5f55 <code>LICENSE</code> \u4e3a Apache License 2.0 \u5168\u6587\uff08\u82f1\u6587\u6743\u5a01\uff09\u3002\u672c\u9875\u4e0e\u4efb\u4f55\u4e2d\u6587\u6750\u6599\u53ea\u89e3\u91ca\u91c7\u7528\u65b9\u5f0f\uff0c\u4e0d\u66ff\u4ee3\u3001\u4e0d\u91cd\u8ff0\u6cd5\u5f8b\u6b63\u6587\uff0c\u4e5f\u4e0d\u58f0\u79f0\u5177\u6709\u540c\u7b49\u6cd5\u5f8b\u6548\u529b\u3002</li> <li>\u4e09\u4e2a\u53f6\u5b50\u5305\u968f\u5305\u5206\u53d1\u6839 <code>LICENSE</code> \u526f\u672c\u3002</li> </ul>"},{"location":"licensing/#\u8eab\u4efd\u4e3b\u4f53\u533a\u5206","title":"\u8eab\u4efd\u4e3b\u4f53\u533a\u5206","text":"<p>\u4ee5\u4e0b\u56db\u7c7b\u8eab\u4efd\u76f8\u4e92\u72ec\u7acb\uff0c\u4e0d\u5f97\u76f8\u4e92\u63a8\u5bfc\u6216\u5408\u5e76\uff1a</p> \u8eab\u4efd \u53d6\u503c \u8bf4\u660e \u4f5c\u8005 / \u7248\u6743\u4e3b\u4f53\uff08author / copyright holder\uff09 \u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8 \u7248\u6743\u5f52\u5c5e\u65b9\uff0c\u5199\u5165 <code>package.json</code> \u7684 <code>author</code> \u4e0e <code>LICENSE</code> \u9644\u5f55\u7f72\u540d \u4ed3\u5e93 owner\uff08GitHub owner\uff09 <code>ifoohoo</code> GitHub \u7ec4\u7ec7/\u8d26\u53f7\uff0c\u4e0e\u4f5c\u8005\u65e0\u63a8\u5bfc\u5173\u7cfb npm \u53d1\u5e03\u8005\uff08npm publisher\uff09 \u5f53\u524d\u53d1\u5e03\u914d\u7f6e\u4e2d\u7684\u8d26\u53f7 npm \u53d1\u5e03\u8eab\u4efd\uff0c\u4e0e\u4f5c\u8005/owner \u65e0\u63a8\u5bfc\u5173\u7cfb \u8d21\u732e\u8005\u7248\u6743\u884c \u6839 <code>LICENSE</code> \u9644\u5f55\u4e2d\u7684 contributors \u7f72\u540d \u4fdd\u7559\u7684\u5386\u53f2/\u8d21\u732e\u8005\u7f72\u540d\uff0c\u4e0d\u4f5c\u4e3a\u9879\u76ee\u4f5c\u8005\u6216\u7248\u6743\u4e3b\u4f53 <p><code>author</code>\u3001<code>repository.owner</code>\u3001<code>npm publisher</code> \u4e09\u8005\u5206\u522b\u8bb0\u5f55\uff0c\u4e0d\u5f97\u4ece\u4efb\u4e00\u63a8\u5bfc\u5176\u4f59\u3002</p>"},{"location":"licensing/#\u9879\u76ee\u7ea7-NOTICE","title":"\u9879\u76ee\u7ea7 NOTICE","text":"<p>FND-ADR-008 \u5df2\u6839\u636e 2026-08-10 \u7684\u7528\u6237\u88c1\u51b3\u91c7\u7528\u65b9\u6848 B\u3002Foundation \u73b0\u5728\u7ef4\u62a4\u6839 <code>NOTICE</code>\uff0c\u5176\u4e2d\u8bb0\u5f55\u9879\u76ee\u540d\u79f0\u3001\u5e74\u4efd 2026 \u548c\u7248\u6743\u4e3b\u4f53\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8\u3002\u4ece 0.2.1 \u8d77\uff0c\u4e09\u4e2a public unit \u7684\u955c\u50cf\u3001\u51bb\u7ed3\u5feb\u7167\u4e0e npm tarball \u90fd\u5fc5\u987b\u5206\u53d1\u8be5\u6587\u4ef6\u3002</p> <p><code>open-source</code> Profile \u7ee7\u7eed\u58f0\u660e <code>noticeRequired: true</code>\u3002Engineering Kit \u7ee7\u7eed\u628a Apache-2.0 \u4e0e NOTICE \u8981\u6c42\u7ed1\u5b9a\u4e3a\u673a\u5236\u4e0d\u53d8\u91cf\uff1b<code>checkIdentityDrift</code> \u5728 NOTICE \u7f3a\u5931\u65f6\u7ee7\u7eed\u62a5\u544a <code>notice-missing</code>\u3002\u8fd9\u9879\u6536\u53e3\u53ea\u6539\u53d8 Foundation \u7684\u53d1\u5e03\u6210\u5458\uff0c\u4e0d\u6539 Kit \u5bf9\u5176\u4ed6\u6d88\u8d39\u8005\u7684\u884c\u4e3a\u3002</p> <p>\u6839\u636e\u6839 <code>LICENSE</code> \u4e2d Apache License 2.0 \u7684\u7b2c 4(d) \u6761\uff0cNOTICE \u4e2d\u7684\u5185\u5bb9\u7528\u4e8e\u4fe1\u606f\u4e0e\u7f72\u540d\uff0c\u4e0d\u4fee\u6539 Apache License 2.0 \u7684\u8bb8\u53ef\u6761\u6b3e\u3002</p>"},{"location":"licensing/#\u7b2c\u4e09\u65b9\u7f72\u540dTHIRD_PARTY_NOTICES","title":"\u7b2c\u4e09\u65b9\u7f72\u540d\uff08THIRD_PARTY_NOTICES\uff09","text":"<p>Engineering Kit \u7684 public unit \u5206\u53d1 MkDocs Material\u3001lunr \u4e0e lunr-languages \u8d44\u4ea7\uff0c\u5df2\u5305\u542b <code>packages/skill-family-engineering-kit/THIRD_PARTY_NOTICES</code> \u4e0e\u5bf9\u5e94\u7b2c\u4e09\u65b9\u8bb8\u53ef\u8bc1\u6750\u6599\u3002\u7b2c\u4e09\u65b9\u7f72\u540d\u7531 <code>THIRD_PARTY_NOTICES</code> \u4e0e\u5bf9\u5e94\u8bb8\u53ef\u8bc1\u95ed\u5305\u8986\u76d6\uff0c\u4e0d\u5f97\u7528\u9879\u76ee\u7ea7 <code>NOTICE</code> \u66ff\u4ee3\u3002<code>NOTICE</code> \u53ea\u627f\u8f7d Foundation \u81ea\u8eab\u7684\u9879\u76ee\u7f72\u540d\uff0c\u4e0d\u590d\u5236\u7b2c\u4e09\u65b9\u8bb8\u53ef\u8bc1\u5168\u6587\u3002</p>"},{"location":"licensing/#private-\u5de5\u4f5c\u533a\u4e0e-public-\u955c\u50cf\u7684\u8bb8\u53ef\u8bc1\u8fb9\u754c","title":"private \u5de5\u4f5c\u533a\u4e0e public \u955c\u50cf\u7684\u8bb8\u53ef\u8bc1\u8fb9\u754c","text":"<ul> <li>\u672c\u5de5\u4f5c\u533a\u6c38\u4e45 private\uff0c\u662f\u552f\u4e00\u5f00\u53d1\u771f\u6e90\uff1b\u672c\u4f53\u4e0d\u8fdb\u5165\u516c\u5f00\u8fb9\u754c\u3002</li> <li>\u516c\u5f00\u8fb9\u754c\u53ea\u6709\u4e09\u4e2a\u7248\u672c\u5316\u53d1\u5e03\u955c\u50cf\u4e0e npm tarball\uff1b\u5b83\u4eec\u5206\u53d1\u6839 <code>LICENSE</code>\uff08Apache-2.0\uff09\u4e0e <code>NOTICE</code>\u3002Engineering Kit \u8fd8\u5206\u53d1 <code>THIRD_PARTY_NOTICES</code> \u53ca\u5bf9\u5e94\u7b2c\u4e09\u65b9\u8bb8\u53ef\u8bc1\u6750\u6599\u3002</li> <li>\u79c1\u6709\u5de5\u4f5c\u533a\u5185\u7684 Profile\u3001fixture\u3001\u5185\u90e8\u6587\u6863\u4e0e\u8fd0\u884c\u8bc1\u636e\u4e0d\u8fdb\u5165\u516c\u5f00\u5305\uff1b\u516c\u5f00\u6587\u6863\u53ea\u6d88\u8d39\u7ecf allowlist \u4e0e\u53d1\u5e03\u5408\u540c\u673a\u68b0\u9a8c\u8bc1\u7684\u53d1\u5e03\u7269\u3002</li> <li>\u53d1\u5e03\u72b6\u6001\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165\u5f52 release-skill\uff1b\u672c\u6587\u4e0d\u590d\u5236\u5b9e\u65f6\u53d1\u5e03\u72b6\u6001\u3002</li> </ul>"},{"location":"quickstart/","title":"\u4e2d\u6587 \u00b7 \u5feb\u901f\u5f00\u59cb","text":"<p>English</p>"},{"location":"quickstart/#\u5feb\u901f\u5f00\u59cb","title":"\u5feb\u901f\u5f00\u59cb","text":"<p>\u672c\u9875\u7ed9\u4e09\u7c7b\u8bfb\u8005\u5404\u7ed9\u4e00\u6761\u6700\u77ed\u6210\u529f\u8def\u5f84\uff1a\u65b0\u9879\u76ee\u3001\u5b58\u91cf\u9879\u76ee\u3001\u67b6\u6784\u8bbe\u8ba1\u8005\u3002\u6bcf\u6761\u8def\u5f84\u53ea\u5217\u5fc5\u505a\u52a8\u4f5c\u4e0e\u9a8c\u8bc1\u547d\u4ee4\uff0c\u6df1\u5165\u7ec6\u8282\u8f6c\u5230\u5bf9\u5e94\u6587\u6863\u3002</p>"},{"location":"quickstart/#\u65b0\u9879\u76ee\u751f\u6210\u9aa8\u67b6","title":"\u65b0\u9879\u76ee\uff1a\u751f\u6210\u9aa8\u67b6","text":"<p>\u76ee\u6807\u662f\u4ece\u96f6\u62ff\u5230\u4e00\u4e2a\u7b26\u5408 Foundation \u5951\u7ea6\u7684\u9879\u76ee\u9aa8\u67b6\u3002</p> <pre><code>npm install --save-dev skill-family-engineering-kit\nnpm exec -- skill-family-kit scaffold --root ./my-project --project-id my-project\nnpm exec -- skill-family-kit check --root ./my-project\n</code></pre> <p>\u4ee5\u4e0a\u547d\u4ee4\u5148\u751f\u6210\u9aa8\u67b6\uff0c\u518d\u5bf9\u751f\u6210\u7ed3\u679c\u505a\u5de5\u7a0b\u8bca\u65ad\u3002<code>scaffold</code> \u53ea\u5199\u7a7a\u76ee\u6807\u76ee\u5f55\uff0c\u975e\u7a7a\u6216\u51b2\u7a81\u76ee\u6807\u4f1a\u88ab\u62d2\u7edd\u4e14\u4e0d\u88ab\u89e6\u78b0\uff1b<code>check</code> \u53ea\u8bca\u65ad\u4e0d\u4fee\u590d\u3002\u9a8c\u8bc1\u4ee5 <code>check</code> \u9000\u51fa\u7801 0 \u4e3a\u901a\u8fc7\u3002</p>"},{"location":"quickstart/#\u5b58\u91cf\u9879\u76ee\u53ea\u8bfb\u76d8\u70b9","title":"\u5b58\u91cf\u9879\u76ee\uff1a\u53ea\u8bfb\u76d8\u70b9","text":"<p>\u76ee\u6807\u662f\u5148\u770b\u6e05\u5b58\u91cf\u4ed3\u80fd\u5426\u91c7\u7528\uff0c\u4e0d\u6539\u52a8\u4efb\u4f55\u5b57\u8282\u3002</p> <pre><code>npm exec -- skill-family-kit adopt-plan --root ./existing-repo\nnpm exec -- skill-family-kit check --root ./existing-repo\n</code></pre> <p><code>adopt-plan</code> \u8f93\u51fa\u73b0\u72b6\u3001\u76ee\u6807 Profile\u3001\u7cbe\u786e\u5199\u96c6\u3001\u51b2\u7a81\u4e0e\u65e7\u5b9e\u73b0\u9000\u51fa\u6e05\u5355\uff0c\u4e14\u5bf9\u8f93\u5165\u4ed3\u5b57\u8282\u96f6\u53d8\u5316\u3002<code>check</code> \u53ea\u505a\u53ea\u8bfb\u8bca\u65ad\u3002\u786e\u8ba4\u76d8\u70b9\u7ed3\u679c\u540e\u518d\u51b3\u5b9a\u662f\u5426\u6267\u884c\u5199\u5165\u3002</p>"},{"location":"quickstart/#\u67b6\u6784\u8bbe\u8ba1\u8005\u5224\u5b9a\u5f52\u5c5e","title":"\u67b6\u6784\u8bbe\u8ba1\u8005\uff1a\u5224\u5b9a\u5f52\u5c5e","text":"<p>\u76ee\u6807\u662f\u5224\u65ad\u4e00\u4e2a\u67b6\u6784\u9700\u6c42\u8be5\u843d\u5728 Foundation \u54ea\u4e00\u5c42\uff0c\u8fd8\u662f\u7559\u5728\u6d88\u8d39\u8005\u3002</p> <ol> <li>\u8bfb <code>docs/agents/architecture-routing.md</code> \u7684\u516b\u6b65\u51b3\u7b56\u987a\u5e8f\u3002</li> <li>\u5728 <code>docs/agents/capability-catalog.json</code> \u6309 <code>layer</code> \u4e0e <code>intent</code> \u627e\u5230\u80fd\u529b\uff0c\u8bfb\u5b83\u7684 <code>entrypoints</code>\u3001<code>sideEffects</code>\u3001<code>failureSemantics</code>\u3001<code>ownedByCaller</code>\u3002</li> <li>\u9700\u8981\u53d1\u5e03\u3001\u4efb\u52a1\u751f\u547d\u5468\u671f\u6216\u5236\u54c1\u5173\u7cfb\u65f6\uff0c\u5206\u522b\u8f6c release-skill\u3001loop-agent\u3001artifact-graph\u3002</li> </ol> <p>\u8def\u7531\u7684\u786c\u8fb9\u754c\uff1aFoundation \u4e0d\u62e5\u6709\u8fdc\u7aef\u5199\u5165\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u4e0e\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\u3002\u843d\u5165 <code>keep-business</code> \u6216 <code>foundation-gap</code> \u7684\u80fd\u529b\u4e0d\u5f3a\u884c\u6269\u5f20 Foundation\u3002</p>"},{"location":"quickstart/#\u6743\u5a01\u4e8b\u5b9e\u4e0e\u89c4\u8303","title":"\u6743\u5a01\u4e8b\u5b9e\u4e0e\u89c4\u8303","text":"<ul> <li>\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u7248\u672c\u3001\u5305\u96c6\u5408\u3001\u955c\u50cf\u5750\u6807\u3001\u95e8\u7981\uff09\uff1a\u5f53\u524d\u4ea7\u54c1\u72b6\u6001\uff08\u552f\u4e00\u72b6\u6001\u9875\uff0c\u672c\u9875\u4e0d\u590d\u5236\uff09\u3002</li> <li>\u5f00\u53d1\u4e0e\u63d0\u4ea4\u89c4\u8303\uff1aGit \u751f\u547d\u5468\u671f\u6307\u5357\u3002</li> </ul>"},{"location":"quickstart/#\u8def\u5f84\u5bf9\u7167","title":"\u8def\u5f84\u5bf9\u7167","text":"\u8bfb\u8005 \u8d77\u70b9 \u4e0b\u4e00\u6b65 \u65b0\u9879\u76ee <code>scaffold</code> <code>check</code> \u2192 \u63a5\u5165 Profile \u5b58\u91cf\u9879\u76ee <code>adopt-plan</code> \u5206\u7c7b\uff08direct-adoption / compatibility-layer / keep-business / foundation-gap\uff09\u2192 \u91c7\u7528 \u67b6\u6784\u8bbe\u8ba1\u8005 \u8def\u7531\u51b3\u7b56 \u80fd\u529b\u76ee\u5f55 \u2192 \u771f\u5b9e\u5bfc\u51fa\u4e0e\u6d4b\u8bd5"},{"location":"setup/","title":"\u5b89\u88c5\u4e0e\u73af\u5883","text":""},{"location":"setup/#\u5fc5\u9700\u73af\u5883","title":"\u5fc5\u9700\u73af\u5883","text":"\u5de5\u5177 \u7248\u672c \u9501\u5b9a\u70b9 Node.js 22.22.2\uff08\u9501\u5b9a major 22 \u5e76\u7cbe\u786e\u63d0\u9ad8 floor\uff1a<code>>=22.22.2 <23</code>\uff09 <code>.node-version</code>\uff08\u53d6\u7cbe\u786e floor\uff09\u3001\u6839\u4e0e\u5404\u53f6\u5b50\u5305 <code>package.json</code> \u7684 <code>engines.node</code>\uff1bfloor \u7531 <code>scripts/engine-floor-check.mjs</code> \u4ece\u56fa\u5b9a\u6839 devDependencies \u7684 engines \u5b9e\u65f6\u91cd\u7b97\uff0cfact-check J \u8282\u7ed1\u5b9a\u6587\u6863\u8868\u9762 pnpm 10.30.0 <code>package.json</code> \u7684 <code>packageManager</code> projen 0.101.23 <code>package.json</code> \u7684 <code>devDependencies.projen</code>\uff08\u7cbe\u786e\u7248\u672c\uff0c\u65e0\u8303\u56f4\u7b26\u53f7\uff09 Git \u8fd1\u5e74\u7248\u672c\u5373\u53ef \u4ec5\u5f00\u53d1\u8005\u81ea\u884c\u7ba1\u7406\u7248\u672c\uff1b\u672c\u4ed3\u811a\u672c\u4e0d\u6267\u884c Git \u5199\u64cd\u4f5c <p>\u5de5\u5177\u7248\u672c\u4e0e\u9501\u5b9a\u70b9\u767b\u8bb0\u5728 <code>.foundation/version-lock.json</code>\uff08projen \u751f\u6210\u7684\u673a\u5668\u771f\u6e90\uff0c\u7981\u6b62\u624b\u6539\uff09\u3002\u5347\u7ea7\u6d41\u7a0b\u89c1 <code>scripts/README.md</code>\u3002</p>"},{"location":"setup/#\u5b89\u88c5\u4f9d\u8d56","title":"\u5b89\u88c5\u4f9d\u8d56","text":"<pre><code>pnpm install\n</code></pre> <p><code>.npmrc</code> \u542f\u7528 <code>save-exact=true</code>\uff0c\u65b0\u589e\u4f9d\u8d56\u4e5f\u4f1a\u4ee5\u7cbe\u786e\u7248\u672c\u5199\u5165\u3002</p>"},{"location":"setup/#\u5408\u6210\u4e0e\u68c0\u67e5","title":"\u5408\u6210\u4e0e\u68c0\u67e5","text":"<pre><code>pnpm synth\npnpm check\n</code></pre> <ul> <li><code>pnpm synth</code> \u518d\u751f\u6210 projen \u53d7\u7ba1\u6587\u4ef6\u3002\u53d7\u7ba1\u6587\u4ef6\u53ea\u80fd\u901a\u8fc7\u4fee\u6539 <code>.projenrc.js</code> \u95f4\u63a5\u53d8\u66f4\uff1b\u624b\u5199\u6e90\u7801\u3001\u6587\u6863\u548c fixture \u4e0d\u4f1a\u88ab synth \u8986\u76d6\u3002</li> <li><code>pnpm check</code> \u662f\u5f53\u524d\u7edf\u4e00\u6839\u95e8\u7981\uff1a11 \u4e2a\u7a33\u5b9a\u95e8\u7981 ID \u6309\u56fa\u5b9a\u987a\u5e8f\u4e32\u8054\u6267\u884c\uff0c\u4efb\u4e00\u6b65\u9aa4\u975e 0 \u5373\u6574\u4f53\u5931\u8d25\uff1b\u672c\u4ed3\u6ca1\u6709\u4efb\u4f55 CI/CD workflow\uff0c\u5168\u90e8\u95e8\u7981\u90fd\u5728\u79c1\u6709\u5de5\u4f5c\u533a\u5185\u8fd0\u884c\u3002\u4e0b\u65b9\u533a\u5757\u7531\u6839 <code>package.json</code> \u7684 <code>scripts.check</code> \u673a\u68b0\u6295\u5f71\uff08<code>node scripts/docs/fact-check.mjs</code> \u9010\u5b57\u6838\u5bf9\uff0c\u7981\u6b62\u624b\u5199\u6e05\u5355\u518d\u6b21\u6ede\u540e\uff09\uff1a</li> </ul> <ol> <li>pnpm run check:structure</li> <li>pnpm run check:packages</li> <li>pnpm run check:profiles</li> <li>pnpm run check:public-boundary</li> <li>pnpm run check:scaffold</li> <li>pnpm run check:docs</li> <li>pnpm run check:public-snapshots</li> <li>pnpm run check:release-artifacts</li> <li>pnpm run check:projen</li> <li>pnpm run check:integration</li> <li>pnpm run check:artifacts</li> </ol> <ul> <li>\u53d1\u5e03\u5b57\u8282\u5408\u540c\u7531\u4e24\u4e2a\u56fa\u5b9a\u5165\u53e3\u627f\u8f7d\uff1a<code>pnpm run release-artifacts:build</code>\uff08\u6784\u5efa\u5019\u9009\u4ea7\u7269\uff09\u4e0e <code>pnpm run release-artifacts:verify</code>\uff08\u6309\u5408\u540c\u6821\u9a8c\uff09\uff0c\u63a5\u53e3\u4e0e\u62d2\u7edd\u77e9\u9635\u8be6\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u3002</li> <li>\u8017\u65f6\u7684 Python \u6587\u6863\u77e9\u9635\u4e0d\u5c5e\u4e8e <code>pnpm check</code>\uff1a\u5b83\u6709\u72ec\u7acb\u5165\u53e3 <code>node scripts/docs/verify-matrix.mjs</code>\uff08\u77e9\u9635\u7248\u672c\u8986\u76d6\u7531\u8be5\u811a\u672c\u5bf9\u7167 <code>scripts/docs/toolchain.json</code> \u673a\u68b0\u6838\u5bf9\uff1b\u672c\u4ed3\u65e0 CI\uff0c\u77e9\u9635\u4e0d\u58f0\u660e\u5728\u4efb\u4f55\u5de5\u4f5c\u6d41\u91cc\uff09\u3002</li> </ul> <p>\u5176\u4f59\u547d\u4ee4\uff1a<code>pnpm test</code>\uff08\u4ec5\u6d4b\u8bd5\uff09\u3001<code>pnpm drift</code>\uff08\u53ea\u8bfb synth \u6f02\u79fb\u68c0\u67e5\uff09\u3001<code>pnpm synth-idempotency</code>(\u5e42\u7b49\u6027\u9a8c\u8bc1)\u3001<code>pnpm fixtures-projen</code>\uff08projen \u53cd\u4f8b fixture\uff09\u3002</p>"},{"location":"setup/#\u6587\u6863\u7ad9\u70b9Material-for-MkDocs","title":"\u6587\u6863\u7ad9\u70b9\uff08Material for MkDocs\uff09","text":"<p>\u6587\u6863\u7ad9\u70b9\u9501\u5b9a mkdocs 1.6.1 \u4e0e Material for MkDocs 9.7.7\u3002\u4f9d\u8d56\u9501\u662f <code>pip-compile --generate-hashes</code> \u751f\u6210\u7684\u5b8c\u6574\u5185\u5bb9\u9501\uff08\u5168\u90e8\u9876\u5c42\u4e0e\u4f20\u9012\u4f9d\u8d56\u90fd\u5e26 SHA-256 hash\uff09\uff0c\u89c1 <code>scripts/docs/requirements.txt</code>\uff08\u4eba\u5de5\u8f93\u5165\u53ea\u6709\u540c\u76ee\u5f55\u7684 <code>requirements.in</code>\uff09\uff1b\u5de5\u5177\u94fe\u771f\u6e90\u89c1 <code>scripts/docs/toolchain.json</code>\u3002Python 3.10 \u6216\u66f4\u9ad8\u5373\u53ef\uff08<code>node scripts/docs/verify-matrix.mjs</code> \u5728\u6700\u4f4e\u7248 3.10 \u4e0e tested 3.14 \u4e0a\u90fd\u4f1a\u7528\u5168\u65b0\u865a\u62df\u73af\u5883\u590d\u73b0\u5b89\u88c5\u4e0e\u4e25\u683c\u6784\u5efa\uff09\u3002</p> <p>\u7ea6\u5b9a\uff1a\u4e0d\u505a\u7cfb\u7edf\u7ea7 pip install\uff0c\u865a\u62df\u73af\u5883\u5fc5\u987b\u5efa\u5728\u4ed3\u5e93\u5916\u90e8\u3002\u539f\u56e0\u662f\u6839 <code>pnpm check</code> \u4f1a\u5bf9\u5168\u4ed3\u505a\u672c\u5730\u7edd\u5bf9\u8def\u5f84\u5b57\u8282\u626b\u63cf\uff08\u89c1 <code>node scripts/check-structure.mjs</code>\uff09\uff0c\u800c macOS/Windows \u4e0a\u7684\u865a\u62df\u73af\u5883\u5185\u90e8\u5d4c\u6709\u672c\u673a\u7edd\u5bf9\u8def\u5f84\uff0c\u653e\u8fdb\u4ed3\u5e93\u4f1a\u9020\u6210\u8bef\u62a5\u3002</p> <p>\u5b89\u88c5\u547d\u4ee4\u7edf\u4e00\u4f7f\u7528 <code>--require-hashes</code>\uff08\u5185\u5bb9\u9501\u8981\u6c42\u9010\u6761\u6821\u9a8c hash\uff09\uff1a</p> <pre><code># \u5728\u4ed3\u5e93\u5916\u90e8\u521b\u5efa\u865a\u62df\u73af\u5883\uff08\u8def\u5f84\u53ef\u6309\u9700\u66ff\u6362\uff0c\u793a\u4f8b\u7528\u7236\u76ee\u5f55\uff09\npython3 -m venv ../docs-site-venv\n\n# \u7528\u54c8\u5e0c\u9501\u5b89\u88c5\u9501\u5b9a\u7248\u672c\uff08\u5b57\u8282\u4e0d\u7b26\u4f1a\u76f4\u63a5\u5931\u8d25\uff09\n../docs-site-venv/bin/pip install --require-hashes -r scripts/docs/requirements.txt\n\n# \u4e25\u683c\u6a21\u5f0f\u6784\u5efa\uff08\u4efb\u4f55\u8b66\u544a\u90fd\u4f1a\u5931\u8d25\uff09\uff0c\u8f93\u51fa\u5230 site/\uff08\u5df2\u88ab .gitignore \u5ffd\u7565\uff09\n../docs-site-venv/bin/mkdocs build --strict\n\n# \u672c\u5730\u9884\u89c8\uff08\u53ef\u9009\uff09\n../docs-site-venv/bin/mkdocs serve\n</code></pre> <p>\u79bb\u7ebf\u73af\u5883\u5b89\u88c5\uff08\u56fa\u5b9a\u6d41\u7a0b\uff09\uff1a\u5728\u7ebf\u673a\u5668\u53ea\u4e0b\u8f7d wheelhouse\uff0c\u79bb\u7ebf\u5b89\u88c5\u5fc5\u987b\u8fdb\u5165\u4e00\u4e2a\u4ece\u672a\u5728\u7ebf\u5b89\u88c5\u8fc7\u7684\u65b0 offline venv\u2014\u2014\u590d\u7528\u5728\u7ebf venv \u65e0\u6cd5\u8bc1\u660e\u79bb\u7ebf\u94fe\u8def\u53ef\u7528\uff1a</p> <pre><code># 1. \u5728\u7ebf\u673a\u5668\uff1a\u4e0b\u8f7d wheelhouse\uff08\u4e0b\u8f7d\u540c\u6837\u9010\u6761\u6821\u9a8c hash\uff1b\u672c\u6b65\u4e0d\u5b89\u88c5\u5230\u4efb\u4f55 venv\uff09\npython3 -m pip download --require-hashes -r scripts/docs/requirements.txt -d ../docs-wheels\n\n# 2. \u79bb\u7ebf\u673a\u5668\uff1a\u65b0\u5efa\u4e00\u4e2a\u4ece\u672a\u5728\u7ebf\u5b89\u88c5\u8fc7\u7684 offline venv\uff08\u8def\u5f84\u53ef\u6309\u9700\u66ff\u6362\uff0c\u4e0d\u5f97\u590d\u7528 ../docs-site-venv\uff09\npython3 -m venv ../docs-site-offline-venv\n\n# 3. \u5b8c\u5168\u79bb\u7ebf\u5b89\u88c5\uff1a\u4e0d\u8bbf\u95ee\u4efb\u4f55\u7d22\u5f15\uff0c\u53ea\u4ece wheelhouse \u89e3\u6790\uff0c\u7ee7\u7eed\u9010\u6761\u6821\u9a8c hash\uff08\u5b57\u8282\u4e0d\u7b26\u76f4\u63a5\u5931\u8d25\uff09\n../docs-site-offline-venv/bin/pip install --no-index --find-links ../docs-wheels --require-hashes -r scripts/docs/requirements.txt\n\n# 4. \u4e25\u683c\u6a21\u5f0f\u6784\u5efa\uff08\u4efb\u4f55\u8b66\u544a\u90fd\u4f1a\u5931\u8d25\uff09\n../docs-site-offline-venv/bin/mkdocs build --strict\n</code></pre>"},{"location":"setup/#\u516c\u5f00\u9759\u6001\u7ad9render-public-sitemjs","title":"\u516c\u5f00\u9759\u6001\u7ad9\uff08render-public-site.mjs\uff09","text":"<p>\u516c\u5f00\u9759\u6001\u7ad9\u662f\u672c\u4ed3\u6587\u6863\u7ad9\u7684\u516c\u5f00\u5b50\u96c6\uff0c\u552f\u4e00\u7531 <code>scripts/render-public-site.mjs</code> \u7528\u4e0a\u8ff0\u51bb\u7ed3 MkDocs \u73af\u5883\u6e32\u67d3\uff1a</p> <ul> <li>\u811a\u672c\u53ea\u53d1\u73b0\u5e76\u6821\u9a8c\u51bb\u7ed3\u865a\u62df\u73af\u5883\uff08<code>SKILL_FAMILY_DOCS_VENV</code>\uff0c\u6216\u6309\u672c\u8282\u6b65\u9aa4\u5efa\u7684 <code>../docs-site-venv</code> / <code>../docs-site-offline-venv</code>\uff09\uff0c\u81ea\u8eab\u4e0d\u505a\u4efb\u4f55\u5b89\u88c5\uff1b</li> <li>\u6267\u884c\u4e24\u6b21 strict \u6784\u5efa\u5e76\u8981\u6c42\u6811\u54c8\u5e0c\u4e00\u81f4\uff08\u786e\u5b9a\u6027\uff09\uff0c\u968f\u540e\u590d\u7528 <code>scripts/leak-scan.mjs</code> \u6838\u5fc3\u4e0e <code>scripts/leak-policy.json</code> \u505a\u5185\u5bb9\u6cc4\u6f0f\u626b\u63cf\uff1b</li> <li><code>--write</code> \u53ea\u5199 <code>docs/public/site/</code> \u4e0e <code>docs/public/site-baseline.json</code>\uff1b<code>--check</code> \u96f6\u5199\u5165\u91cd\u7b97\u5e76\u6bd4\u5bf9\u57fa\u7ebf\uff1b<code>--self-test</code> \u8fd0\u884c\u4e3b\u52a8\u53cd\u4f8b\u81ea\u6d4b\uff1b</li> <li>symlink\u3001\u7279\u6b8a\u6587\u4ef6\u3001\u8d8a\u754c realpath\u3001\u5355\u6587\u4ef6\u8d85\u9650\u4e0e\u4e0d\u786e\u5b9a\u8f93\u51fa\u4e00\u5f8b\u62d2\u7edd\uff1b\u57fa\u7ebf\u7981\u6b62\u624b\u6539\uff08\u6e32\u67d3\u5668\u662f\u552f\u4e00\u5199\u5165\u9762\uff09\u3002</li> </ul> <pre><code>node scripts/render-public-site.mjs --write\nnode scripts/render-public-site.mjs --check\n</code></pre> <p>\u7ad9\u70b9\u6587\u4ef6\u4e0e engineering-kit public \u53d1\u5e03\u955c\u50cf\u4ed3\u7684 <code>docs/*</code> \u9010\u6587\u4ef6\u5bf9\u5e94\uff08\u6620\u5c04\u7531\u53d1\u5e03\u914d\u7f6e\u6267\u884c\uff0c\u672c\u4ed3\u4e0d\u76f4\u63a5\u5199\u955c\u50cf\uff09\uff1bPages \u5b9e\u4f8b\u662f\u5426\u5728\u7ebf\u662f\u53d1\u5e03\u540e\u9a8c\u8bc1\u4e8b\u5b9e\uff0c\u53e3\u5f84\u552f\u4e00\u89c1 \u5f53\u524d\u4ea7\u54c1\u72b6\u6001\u3002</p>"},{"location":"setup/#\u6587\u6863\u4e8b\u5b9e\u4e0e\u94fe\u63a5\u68c0\u67e5","title":"\u6587\u6863\u4e8b\u5b9e\u4e0e\u94fe\u63a5\u68c0\u67e5","text":"<p>\u6587\u6863\u4e2d\u7684\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\u4e0e\u95e8\u7981\u4e8b\u5b9e\u7531\u786e\u5b9a\u6027\u811a\u672c\u5bf9\u7167\u673a\u5668\u771f\u6e90\u6821\u9a8c\uff0c\u94fe\u63a5\u7531\u72ec\u7acb\u811a\u672c\u89e3\u6790\uff1a</p> <pre><code>node scripts/docs/fact-check.mjs\nnode scripts/docs/link-check.mjs\n</code></pre> <p><code>fact-check.mjs</code> \u662f Node \u811a\u672c\uff0c\u7ecf\u4ed3\u5185\u6a21\u5757\uff08<code>scripts/engine-floor-check.mjs</code>\uff09\u6d88\u8d39\u6839\u76ee\u5f55\u7cbe\u786e\u9501\u5b9a\u7684 <code>semver@7.8.5</code>\uff0c\u8fd0\u884c\u524d\u5fc5\u987b\u5148\u5b8c\u6210 <code>pnpm install --frozen-lockfile</code>\uff1b<code>link-check.mjs</code> \u4e3a\u7eaf Node \u5b9e\u73b0\uff08\u65e0\u7b2c\u4e09\u65b9\u4f9d\u8d56\uff09\u3002\u4e24\u8005\u9000\u51fa\u7801 0 \u8868\u793a\u901a\u8fc7\u3002\u811a\u672c\u804c\u8d23\u89c1 <code>scripts/docs/README.md</code>\u3002</p>"},{"location":"agents/","title":"\u4e2d\u6587 \u00b7 \u667a\u80fd\u4f53\u5165\u53e3","text":"<p>English</p>"},{"location":"agents/#\u9762\u5411\u667a\u80fd\u4f53\u7684\u6587\u6863\u5165\u53e3","title":"\u9762\u5411\u667a\u80fd\u4f53\u7684\u6587\u6863\u5165\u53e3","text":"<p>\u672c\u76ee\u5f55\u662f Skill Family Foundation \u7ed9\u667a\u80fd\u4f53\uff08Agent\uff09\u7528\u7684\u51b3\u7b56\u5165\u53e3\u3002\u4eba\u7c7b\u8bfb\u8005\u4ece\u6839 <code>README.md</code> \u8fdb\u5165\uff1b\u667a\u80fd\u4f53\u5728\u6709\u9650\u4e0a\u4e0b\u6587\u91cc\u5148\u8bfb\u8fd9\u91cc\uff0c\u518d\u6309\u610f\u56fe\u8df3\u5230\u5177\u4f53\u80fd\u529b\uff0c\u907f\u514d\u901a\u8bfb\u5168\u90e8\u6e90\u7801\u3002</p> <p>Foundation \u4e0d\u62e5\u6709\u4e1a\u52a1\u8bed\u4e49\u3002\u5b83\u53ea\u63d0\u4f9b\u4e09\u4ef6\u4e8b\uff1a\u673a\u5668\u5951\u7ea6\uff08Contracts\uff09\u3001Node \u8584\u673a\u5236\u8fd0\u884c\u65f6\uff08Harness\uff09\u3001\u5de5\u7a0b\u9636\u6bb5\u7684\u56db\u4e2a\u547d\u4ee4\uff08Engineering Kit\uff09\uff0c\u4ee5\u53ca\u6a2a\u5411\u58f0\u660e\u5dee\u5f02\u7684 Profile\u3002\u9886\u57df\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u3001\u53d1\u5e03\u8fdc\u7aef\u5199\u5165\u3001\u5ba1\u8ba1\u8bed\u4e49\u90fd\u7559\u5728\u8c03\u7528\u65b9\u6216\u5176\u4ed6\u9879\u76ee\u3002</p>"},{"location":"agents/#\u9605\u8bfb\u987a\u5e8f","title":"\u9605\u8bfb\u987a\u5e8f","text":"<p>\u667a\u80fd\u4f53\u6309\u4e0b\u9762\u7684\u987a\u5e8f\u53d6\u7528\uff0c\u4e0d\u5fc5\u4ece\u5934\u8bfb\u5230\u5c3e\uff1a</p> <ol> <li><code>capability-catalog.json</code> \u2014\u2014 \u5168\u90e8\u7a33\u5b9a\u80fd\u529b\u7684\u673a\u5668\u4e8b\u5b9e\u76ee\u5f55\uff0c\u662f\u5224\u65ad\u300c\u8be5\u9700\u6c42\u662f\u5426\u5c5e\u4e8e Foundation\u3001\u843d\u5728\u54ea\u4e00\u5c42\u3001\u7528\u54ea\u4e2a\u5165\u53e3\u300d\u7684\u8d77\u70b9\u3002</li> <li><code>architecture-routing.md</code> \u2014\u2014 \u4ece\u67b6\u6784\u610f\u56fe\u5230\u5c42/\u80fd\u529b/\u5165\u53e3/\u5916\u90e8\u9879\u76ee\u7684\u51b3\u7b56\u8868\u4e0e\u51b3\u7b56\u6811\u3002</li> <li><code>capability-catalog.schema.json</code> \u2014\u2014 \u76ee\u5f55\u81ea\u8eab\u7684\u7ed3\u6784\u5408\u540c\uff0c\u6821\u9a8c\u5668\u4e0e\u6295\u5f71\u90fd\u4f9d\u8d56\u5b83\u3002</li> <li>\u6839 <code>README.md</code> \u7684 Agent Quick Reference \u2014\u2014 \u53ea\u505a\u8def\u7531\uff0c\u4e0d\u590d\u5236 API\u3002</li> <li>\u4e09\u4e2a\u5305 README \u7684 Agent Quick Reference \u2014\u2014 \u7cbe\u786e\u5230\u5305\u7ea7\u80fd\u529b\u548c\u5931\u8d25\u8fb9\u754c\u3002</li> <li><code>../reference/failure-and-side-effect-matrix.md</code> \u2014\u2014 \u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u7684\u8bfb\u5199/spawn/Git/\u7f51\u7edc/\u6b8b\u4f59\u72b6\u6001/\u9519\u8bef\u7801\u3002</li> <li><code>../reference/api/README.md</code> \u2014\u2014 \u4e09\u5305\u516c\u5171 API \u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\uff0c\u6309\u5165\u53e3\u7ed9\u51fa\u7b7e\u540d\u3001\u8f93\u5165/\u8f93\u51fa\u3001\u7eaf\u51fd\u6570\u6027\u3001\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code>/<code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1b\u4e0e catalog \u80fd\u529b ID \u4e92\u94fe\u3002</li> </ol> <p>\u4e8b\u5b9e\u4f18\u5148\u7ea7\uff1a\u672c\u6587\u6863\u53ea\u6d88\u8d39\u673a\u5668\u771f\u6e90\uff08package.json\u3001src/index.mjs\u3001CLI\u3001registry.json\u3001profile descriptor\uff09\u3002\u7248\u672c\u3001\u547d\u4ee4\u3001\u5305\u6570\u3001\u652f\u6301\u72b6\u6001\u90fd\u4ece\u771f\u6e90\u590d\u7b97\uff0c\u4e0d\u4ece\u8bb0\u5fc6\u6216\u65e7\u6587\u6863\u7167\u642c\u3002</p>"},{"location":"agents/#\u76ee\u5f55\u5408\u540c","title":"\u76ee\u5f55\u5408\u540c","text":"<p><code>docs/agents/</code> \u4e0b\u7684\u6587\u4ef6\u627f\u62c5\u4e0d\u540c\u804c\u8d23\uff0c\u4e0d\u4e92\u76f8\u91cd\u590d\uff1a</p> \u6587\u4ef6 \u89d2\u8272 \u8c01\u8be5\u6539 <code>capability-catalog.json</code> \u673a\u5668\u53ef\u8bfb\u7684\u80fd\u529b\u4e8b\u5b9e\uff0c\u6587\u6863\u5c42\u552f\u4e00\u4e8b\u5b9e\u9762 \u80fd\u529b\u53d8\u5316\u65f6\u6539\uff0c\u5e76\u7ecf <code>capability-catalog-check.mjs</code> \u6821\u9a8c <code>capability-catalog.schema.json</code> \u76ee\u5f55\u7ed3\u6784\u5408\u540c \u7ed3\u6784\u53d8\u5316\u65f6\u624d\u6539 <code>architecture-routing.md</code> \u610f\u56fe \u2192 \u5c42/\u80fd\u529b/\u5165\u53e3/\u5916\u90e8\u9879\u76ee\u7684\u51b3\u7b56 \u8def\u7531\u88c1\u51b3\u53d8\u5316\u65f6\u6539 <code>README.md</code>\uff08\u672c\u6587\u4ef6\uff09 \u667a\u80fd\u4f53\u603b\u5165\u53e3\u4e0e\u9605\u8bfb\u987a\u5e8f \u5165\u53e3\u7ed3\u6784\u53d8\u5316\u65f6\u6539 <code>../reference/api/README.md</code> \u53ca\u4e09\u5305\u9875 \u516c\u5171 API \u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\uff0ccatalog \u80fd\u529b\u7684\u7b7e\u540d\u7ea7\u5c55\u5f00 \u771f\u5b9e\u5bfc\u51fa\u53d8\u5316\u65f6\u6539\uff0c\u5e76\u4e0e <code>capability-catalog-check.mjs</code> \u540c\u6b65 <p>capability catalog \u4e0d\u662f Contracts \u7684\u65b0\u516c\u5171\u5bf9\u8c61\uff0c\u4e5f\u4e0d\u662f\u7b2c\u56db\u7c7b\u767b\u8bb0\u8868\u3002\u5b83\u53ea\u662f\u6587\u6863\u5c42\u7684\u673a\u5668\u4e8b\u5b9e\uff0c\u907f\u514d README \u5f62\u6210\u7b2c\u4e8c\u5957\u4f1a\u6f02\u79fb\u7684\u624b\u5199\u6743\u5a01\u3002</p>"},{"location":"agents/#\u67b6\u6784\u8bbe\u8ba1\u5de5\u4f5c\u6cd5","title":"\u67b6\u6784\u8bbe\u8ba1\u5de5\u4f5c\u6cd5","text":"<p>\u667a\u80fd\u4f53\u5904\u7406\u4e00\u4e2a Foundation \u76f8\u5173\u9700\u6c42\u65f6\uff0c\u6309\u4e0b\u9762\u56db\u6b65\u63a8\u8fdb\uff1a</p> <ol> <li>\u5148\u5224\u5f52\u5c5e\u3002\u8be5\u9700\u6c42\u662f\u5426\u542b\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1 oracle\uff1f\u82e5\u662f\uff0c\u7559\u5728\u6d88\u8d39\u8005\uff0c\u53ea\u628a\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\u63a5 Foundation\u3002</li> <li>\u518d\u5224\u5206\u5c42\u3002\u7ed3\u6784/\u534f\u8bae/\u7a33\u5b9a\u9519\u8bef\u7801/\u5bf9\u8c61 Schema \u843d Contracts\uff1b\u8de8\u6280\u80fd\u65cf\u53ef\u590d\u7528\u7684 Node \u673a\u5236\u843d Harness\uff1bscaffold/adopt/projection/check \u6216\u5177\u4f53 Profile \u6ce8\u5165\u843d Kit/Profile\u3002</li> <li>\u67e5\u76ee\u5f55\u5b9a\u5165\u53e3\u3002\u5728 <code>capability-catalog.json</code> \u6309 <code>layer</code> \u4e0e <code>intent</code> \u627e\u5230\u80fd\u529b\uff0c\u8bfb\u5b83\u7684 <code>entrypoints</code>\u3001<code>sideEffects</code>\u3001<code>failureSemantics</code>\u3001<code>ownedByCaller</code>\u3001<code>routeElsewhere</code>\u3002</li> <li>\u9a8c\u8bc1\u636e\u518d\u4e0b\u7ed3\u8bba\u3002\u76ee\u5f55\u6bcf\u6761\u80fd\u529b\u90fd\u5e26 <code>sourceRefs</code> \u4e0e <code>positiveTestRefs</code>/<code>negativeTestRefs</code>\uff0c\u6539\u52a8\u5224\u65ad\u524d\u5148\u56de\u5230\u8fd9\u4e9b\u771f\u6e90\u786e\u8ba4\uff0c\u4e0d\u51ed\u76ee\u5f55\u6563\u6587\u63a8\u65ad\u3002</li> </ol> <p>\u8def\u7531\u8fb9\u754c\u7684\u786c\u89c4\u5219\uff1aFoundation \u4e0d\u62e5\u6709\u8fdc\u7aef\u5199\u5165\uff08\u5f52 release-skill\uff09\u3001\u4e0d\u62e5\u6709\u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5\uff08\u5f52 loop-agent\uff09\u3001\u4e0d\u62e5\u6709\u5236\u54c1\u5173\u7cfb\u4e0e context\uff08\u5f52 artifact-graph\uff09\u3001\u4e0d\u62e5\u6709\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\uff08\u5f52\u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\uff09\u3002\u8be6\u60c5\u89c1 <code>architecture-routing.md</code> \u7684\u8def\u7531\u8868\u3002</p>"},{"location":"agents/#\u4e0e\u673a\u68b0\u95e8\u7981\u7684\u5173\u7cfb","title":"\u4e0e\u673a\u68b0\u95e8\u7981\u7684\u5173\u7cfb","text":"<p>\u4e24\u4e2a\u68c0\u67e5\u811a\u672c\u5b88\u62a4\u76ee\u5f55\u4e0e README \u4e0d\u6f02\u79fb\uff1a</p> <ul> <li><code>scripts/docs/capability-catalog-check.mjs</code> \u6821\u9a8c\u7ed3\u6784\u3001\u552f\u4e00 ID\u3001\u6e90/\u6d4b\u8bd5\u5f15\u7528\u5b58\u5728\u3001unsupported \u8fb9\u754c\u3001Kit \u56db\u547d\u4ee4\u672a\u6269\u5f20\u3002</li> <li><code>scripts/docs/agent-section-check.mjs</code> \u6821\u9a8c\u6839 README \u4e0e\u4e09\u4e2a\u5305 README \u7684\u56fa\u5b9a Agent Quick Reference \u7ae0\u8282\u3001\u5fc5\u542b\u5b50\u6807\u9898\u4e0e\u80fd\u529b ID \u94fe\u63a5\u3002</li> </ul> <p>\u4e8c\u8005\u90fd\u53ea\u62a5\u5f62\u72b6\u4e0d\u81ea\u52a8\u6539\u6587\uff1b\u8b66\u544a\u9879\u9700\u56de\u5230\u771f\u6e90\u4e0e\u58f0\u97f3\u4eba\u5de5\u5224\u65ad\u3002</p>"},{"location":"agents/architecture-routing/","title":"\u4e2d\u6587 \u00b7 \u67b6\u6784\u8def\u7531","text":"<p>English</p>"},{"location":"agents/architecture-routing/#\u67b6\u6784\u8def\u7531\u4ece\u610f\u56fe\u5230\u5c42\u80fd\u529b\u4e0e\u5916\u90e8\u9879\u76ee","title":"\u67b6\u6784\u8def\u7531\uff1a\u4ece\u610f\u56fe\u5230\u5c42\u3001\u80fd\u529b\u4e0e\u5916\u90e8\u9879\u76ee","text":"<p>\u672c\u9875\u628a\u300c\u4e00\u4e2a\u67b6\u6784\u9700\u6c42\u8be5\u843d\u5728\u54ea\u91cc\u300d\u6536\u655b\u6210\u53ef\u673a\u68b0\u590d\u7528\u7684\u51b3\u7b56\u987a\u5e8f\u4e0e\u8def\u7531\u8868\u3002\u5b83\u670d\u52a1\u4e8e\u65b0\u667a\u80fd\u4f53\u5728\u4e0d\u901a\u8bfb\u6e90\u7801\u7684\u524d\u63d0\u4e0b\uff0c\u5feb\u901f\u5f97\u5230\u53ef\u9a8c\u8bc1\u7b54\u6848\uff1a\u8be5\u9700\u6c42\u662f\u5426\u5c5e\u4e8e Foundation\u3001\u5e94\u843d\u5728 Contracts/Harness/Kit/Profile \u54ea\u4e00\u5c42\u3001\u7528\u54ea\u4e2a\u7a33\u5b9a\u5165\u53e3\u3001\u4ec0\u4e48\u8bed\u4e49\u4ecd\u7531\u8c03\u7528\u65b9\u62e5\u6709\u3001\u4f55\u65f6\u5e94\u8f6c\u4ea4\u5916\u90e8\u9879\u76ee\u3002</p>"},{"location":"agents/architecture-routing/#\u51b3\u7b56\u987a\u5e8f","title":"\u51b3\u7b56\u987a\u5e8f","text":"<p>\u6309\u7f16\u53f7\u4f9d\u6b21\u5224\u65ad\uff0c\u547d\u4e2d\u5373\u505c\uff1a</p> <ol> <li>\u662f\u5426\u542b\u9886\u57df\u8bed\u4e49\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u6216\u5ba1\u8ba1 oracle\uff1f \u82e5\u662f\uff0c\u7559\u5728\u6d88\u8d39\u8005\uff1bFoundation \u53ea\u63a5\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\u3002</li> <li>\u662f\u5426\u662f\u7ed3\u6784\u3001\u534f\u8bae\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u6216\u5bf9\u8c61 Schema\uff1f \u843d Contracts\uff08\u5951\u7ea6\u6743\u5a01\uff09\u3002</li> <li>\u662f\u5426\u662f\u8de8\u6280\u80fd\u65cf\u53ef\u590d\u7528\u7684 Node \u673a\u5236\uff1f \u843d Harness\uff08Contracts \u673a\u5236\u534f\u8bae\u7684 Node \u5b9e\u73b0\uff09\u3002</li> <li>\u662f\u5426\u662f\u5de5\u7a0b\u9636\u6bb5\u7684 scaffold/adopt-plan/projection/check\uff0c\u6216\u5177\u4f53 host Profile \u6ce8\u5165\uff1f \u843d Kit / Profile\u3002</li> <li>\u662f\u5426\u6d89\u53ca\u53d1\u5e03\u8fdc\u7aef\u72b6\u6001\uff1f \u8f6c release-skill\u3002</li> <li>\u662f\u5426\u6d89\u53ca\u4efb\u52a1\u3001\u91cd\u8bd5\u3001\u8fd4\u5de5\u3001\u9a8c\u6536\u6216\u81ea\u8fed\u4ee3\uff1f \u8f6c loop-agent\u3002</li> <li>\u662f\u5426\u6d89\u53ca\u5236\u54c1\u5173\u7cfb\u3001context\u3001packet \u6216 version-lock\uff1f \u8f6c artifact-graph\u3002</li> <li>\u662f\u5426\u53ea\u6709\u4e00\u4e2a\u6d88\u8d39\u8005\uff0c\u6216\u5c1a\u672a\u8bc1\u660e\u8de8\u4e24\u4e2a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\uff1f \u9ed8\u8ba4\u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u6269\u5f20 Foundation\u3002</li> </ol> <p>\u7b2c 8 \u6b65\u662f\u6269\u5f20\u95f8\u95e8\u3002\u4efb\u4f55\u65b0\u589e\u7ec4\u4ef6\u90fd\u5fc5\u987b\u8bf4\u660e\uff1a\u5220\u9664\u5b83\u4f1a\u8ba9\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\uff0c\u5e76\u7ecf\u72ec\u7acb fixture \u9a8c\u8bc1\u3002\u5426\u5219\u7559\u5728\u6d88\u8d39\u8005\u4fa7\u3002</p>"},{"location":"agents/architecture-routing/#\u8def\u7531\u8868","title":"\u8def\u7531\u8868","text":"<p>\u4e0b\u8868\u7ed9\u51fa\u5e38\u89c1\u67b6\u6784\u610f\u56fe\u7684\u9996\u9009\u80fd\u529b\u4e0e\u7981\u6b62\u8bef\u7528\u3002\u6bcf\u6761\u9996\u9009\u80fd\u529b\u90fd\u53ef\u5728 <code>capability-catalog.json</code> \u6309 id \u67e5\u5230\u5165\u53e3\u3001\u526f\u4f5c\u7528\u4e0e\u5931\u8d25\u8bed\u4e49\u3002</p> \u67b6\u6784\u610f\u56fe \u9996\u9009\u80fd\u529b \u7981\u6b62\u8bef\u7528 \u9a8c\u8bc1 Foundation \u5408\u540c\u5bf9\u8c61 Contracts / Harness validation\uff08<code>foundation.contracts.object-validation</code>\u3001<code>foundation.harness.contract-validation</code>\uff09 \u4e0d\u53d6\u4ee3\u6d88\u8d39\u8005\u4e1a\u52a1 Schema \u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u548c\u539f\u5b50\u5199 Harness path / atomic API\uff08<code>foundation.harness.path-containment</code>\u3001<code>foundation.harness.atomic-write</code>\uff09 \u4e0d\u628a\u6587\u4ef6\u9009\u62e9\u4e1a\u52a1\u89c4\u5219\u653e\u5165 Harness \u751f\u6210\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a Harness report \u6216 Kit report \u5b50\u52a8\u4f5c\uff08<code>foundation.harness.report</code>\u3001<code>foundation.kit.report</code>\uff09 \u4e0d\u4ece\u5f00\u653e\u4e1a\u52a1 outputs \u81ea\u7531\u7f16\u62a5\u544a \u6301\u4e45\u4e8b\u4ef6\u548c\u6d3e\u751f snapshot Harness state-store\uff08<code>foundation.harness.state-store</code>\uff09 \u4e0d\u5728 Foundation \u5b9a\u4e49 workflow \u72b6\u6001\u673a \u65b0\u9879\u76ee\u9aa8\u67b6 Kit scaffold\uff08<code>foundation.kit.scaffold</code>\uff09 \u4e0d\u8986\u76d6\u975e\u7a7a\u5b58\u91cf\u4ed3 \u5b58\u91cf\u91c7\u7528\u76d8\u70b9 Kit adopt-plan\uff08<code>foundation.kit.adopt-plan</code>\uff09 \u4e0d\u5199\u6587\u4ef6\u3001\u4e0d\u81ea\u52a8\u8fc1\u79fb \u53d7\u7ba1\u6295\u5f71 Kit projection + Profile\uff08<code>foundation.kit.projection</code>\uff09 \u4e0d\u8986\u76d6 handwritten \u6587\u4ef6 \u5de5\u7a0b\u8bca\u65ad Kit check\uff08<code>foundation.kit.check</code>\uff09 \u4e0d\u81ea\u52a8\u4fee\u590d \u53d1\u5e03 release-skill Foundation \u4e0d\u62e5\u6709\u8fdc\u7aef\u5199\u5165 \u4efb\u52a1/\u91cd\u8bd5/\u8fd4\u5de5 loop-agent Foundation \u4e0d\u62e5\u6709\u4e1a\u52a1\u72b6\u6001\u673a \u5236\u54c1\u5173\u7cfb/\u7248\u672c\u9501 artifact-graph Foundation \u4e0d\u62e5\u6709\u5236\u54c1\u56fe"},{"location":"agents/architecture-routing/#\u5206\u5c42\u5b9a\u4f4d\u901f\u67e5","title":"\u5206\u5c42\u5b9a\u4f4d\u901f\u67e5","text":"<p>\u4f9d\u8d56\u65b9\u5411\u56fa\u5b9a\u4e3a Contracts \u2192 Harness \u2192 Engineering Kit\uff1bProfile \u6a2a\u5411\u58f0\u660e\uff0c\u516c\u5171\u6838\u5fc3\u4e0d\u53cd\u5411\u4f9d\u8d56\u5177\u4f53 Profile\u3002</p> <ul> <li>Contracts\uff1a\u7ed3\u6784\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001\u534f\u8bae\u540d\u767b\u8bb0\uff1b18 \u7c7b\u9876\u5c42\u5bf9\u8c61\u30019 \u6761 mandatory rule\u3002</li> <li>Harness\uff1aContracts \u7684 Node \u8584\u673a\u5236\u8fd0\u884c\u65f6\uff1b\u53ea\u5b9e\u73b0\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\uff0c\u4e0d\u62e5\u6709\u8bed\u4e49\u3002</li> <li>Engineering Kit\uff1a\u56db\u4e2a\u5de5\u7a0b\u547d\u4ee4\uff08scaffold\u3001adopt-plan\u3001projection\u3001check\uff09\u53ca\u5176\u53ea\u8bfb/\u53d7\u9650\u5199\u5165\u8fb9\u754c\u3002</li> <li>Profile\uff1a\u5bbf\u4e3b\u4e0e\u9879\u76ee\u5f62\u6001\u5dee\u5f02\u7684\u58f0\u660e\u5f0f SPI\uff1b\u53ea\u5b9e\u73b0\u7a33\u5b9a SPI\uff0c\u4e0d\u6ce8\u5165\u4e1a\u52a1\u8bed\u4e49\u3002</li> <li>\u5916\u90e8\u9879\u76ee\uff1arelease-skill\uff08\u53d1\u5e03\uff09\u3001loop-agent\uff08\u4efb\u52a1\u751f\u547d\u5468\u671f\uff09\u3001artifact-graph\uff08\u5236\u54c1\u5173\u7cfb\uff09\u3001\u72ec\u7acb\u5ba1\u8ba1\u6d88\u8d39\u8005\uff08\u9886\u57df\u8bed\u4e49\uff09\u3002</li> </ul>"},{"location":"agents/architecture-routing/#\u5178\u578b\u8bef\u8def\u7531\u4e0e\u7ea0\u6b63","title":"\u5178\u578b\u8bef\u8def\u7531\u4e0e\u7ea0\u6b63","text":"<ul> <li>\u8bef\u628a\u9886\u57df Schema \u8def\u7531\u5230 Foundation\uff1a\u9886\u57df Schema \u7531\u6d88\u8d39\u8005\u62e5\u6709\uff0cFoundation \u53ea\u63d0\u4f9b\u901a\u7528\u6821\u9a8c\u673a\u5236\uff08<code>foundation.contracts.object-validation</code>\uff09\u3002</li> <li>\u8bef\u628a workflow \u72b6\u6001\u673a\u8def\u7531\u5230 Foundation\uff1astate-store \u53ea\u63d0\u4f9b\u4e8b\u4ef6\u65e5\u5fd7\u4e0e\u5feb\u7167\u5e95\u5ea7\uff0creducer \u8f6c\u79fb\u4e0e\u7ec8\u6001\u7531\u8c03\u7528\u65b9\u62e5\u6709\uff08<code>foundation.unsupported.business-state-machine</code>\uff09\u3002</li> <li>\u8bef\u628a\u53d1\u5e03\u5199\u5165\u8def\u7531\u5230 Foundation\uff1a\u8fdc\u7aef\u5199\u5165\u5f52 release-skill\uff0cFoundation \u4e0d\u542b\u4efb\u4f55 publish/remote-write \u5165\u53e3\uff08<code>foundation.unsupported.remote-publish</code>\uff09\u3002</li> <li>\u8bef\u628a\u5ba1\u8ba1 oracle \u8def\u7531\u5230 Foundation\uff1a\u5ba1\u8ba1\u8868\u9762\u53ea\u505a\u786e\u5b9a\u6027\u5e8f\u5217\u5316\uff0c\u9886\u57df\u7ed3\u8bba\u5c5e\u5916\u90e8\u5ba1\u9605\uff08<code>foundation.unsupported.domain-audit-semantics</code>\uff09\u3002</li> </ul> <p>\u8def\u7531\u5224\u65ad\u7684\u8bda\u5b9e\u8fb9\u754c\uff1a\u7ed3\u6784\u68c0\u67e5\u53ea\u8bc1\u660e\u5b57\u8282/\u7ed3\u6784\u4e00\u81f4\u6027\uff08\u4ed3\u5185\u53ef\u8bc1\uff09\uff1b\u666e\u901a\u6b63\u6587\u8bed\u4e49\u4e0e\u6700\u7ec8\u63a5\u53d7/\u62d2\u7edd\u7ed3\u8bba\u5c5e\u4e8e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff0c\u4e0d\u5728\u76ee\u6807\u4ed3\u5185\u7ef4\u62a4\u7b2c\u4e8c\u4efd\u95e8\u7981\u3002</p>"},{"location":"en/","title":"English \u00b7 Home","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/#Skill-Family-Foundation-Workspace","title":"Skill Family Foundation Workspace","text":"<p>The shared engineering-infrastructure parent workspace for the Skill Family lifecycle. This repository provides the machine contracts (Contracts), the thin Node runtime (Harness), the engineering kit (Engineering Kit), the Profile SPI, fully fictional generic sample fixtures, and the engineering documentation skeleton.</p>"},{"location":"en/#Current-Status","title":"Current Status","text":"<p>This repository is a first-version skeleton under development. Dynamic state such as versions, releases, Pages, and Git is recorded solely in Current Product Status; the license is approved as Apache License 2.0, with the copyright holder being \u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8 (Guangzhou Fenghe Technology Co., Ltd.). The full text is in the root-level <code>LICENSE</code>.</p> <p>This workspace is permanently private and is the single source of truth for development; the only public boundary consists of three versioned release mirrors and the npm tarball. The pinned consumer coordinates and release status are recorded solely in Current Product Status.</p> <p>The single product-level status page is Current Product Status, mechanically verified by <code>node scripts/docs/fact-check.mjs</code> against the machine source of truth; other pages do not carry a second status caliber.</p>"},{"location":"en/#First-Version-Composition","title":"First-Version Composition","text":"Component Path Responsibility Contracts <code>packages/skill-family-contracts</code> Sole authority for machine-executable engineering structure and mechanism protocols Harness <code>packages/skill-family-harness-node</code> Implements only the mechanism protocols defined by Contracts; owns no business semantics Engineering Kit <code>packages/skill-family-engineering-kit</code> Provides only the four top-level commands <code>scaffold</code>, <code>adopt-plan</code>, <code>projection</code>, <code>check</code> Profile seed <code>profiles/public-plugin</code> Profile seed in the form of a public plugin Fictional sample <code>fixtures/generic-profile-extension-conformance</code> A fully fictional extension-conformance sample <p>The package manifest, Profiles, fixtures, and top-level commands use <code>.foundation/skeleton-manifest.json</code> as the machine source of truth; tool version locks are in <code>.foundation/version-lock.json</code>.</p>"},{"location":"en/#Documentation-Map","title":"Documentation Map","text":"<ul> <li>Setup and Environment \u2014 tool version pinning, installation, and documentation site build</li> <li>Quickstart \u2014 the shortest path from local verification to a trial run</li> <li>Capabilities and Diagnostics \u2014 the Kit's four commands, exit codes, and troubleshooting</li> <li>Architecture Boundaries \u2014 layering, single source of truth, budget, and documentation fact-check</li> <li>Current Product Status \u2014 the single product status page</li> <li>Git Lifecycle Guide \u2014 authorized boundaries for branches, commits, pushes, and releases</li> </ul>"},{"location":"en/#Writing-Boundaries","title":"Writing Boundaries","text":"<p>Documentation consumes only a frozen fact package composed of the machine source of truth (manifest, package.json, Contracts registry, etc.), mechanically verified by <code>node scripts/docs/fact-check.mjs</code>. Model names, credentials, and scheduling information do not enter documentation, nor do they enter Contracts; see Architecture Boundaries.</p>"},{"location":"en/architecture/","title":"English \u00b7 Architecture","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/architecture/#Architecture-Boundaries","title":"Architecture Boundaries","text":"<p>This page is the stable architecture projection of Skill Family Foundation for users. It explains only structure, responsibilities, boundaries, and routing; it does not carry dynamic release state (release state is recorded solely in <code>docs/status/current.md</code> and mechanically verified by <code>scripts/docs/fact-check.mjs</code>). All versions, commands, package counts, and support states are recomputed from the machine source of truth.</p>"},{"location":"en/architecture/#Layers","title":"Layers","text":"<p>The layering established by the 2026-08-09 architecture hand-off (FND-ADR-001~007, active, see <code>artifacts/decisions/</code>): a vertical dependency chain of four layers, with horizontal capability attachments, and no new vertical layers added.</p> <pre><code>Skill Family business (per-product repositories: release-skill, loop-agent, skill-eval, etc.)\n \u2502 depends on\n \u25bc\nEngineering Kit (scaffold / adopt-plan / projection / check)\n \u2502 depends on\n \u25bc\nHarness Node (Contracts mechanism-protocol implementation)\n \u2502 depends on\n \u25bc\nContracts (structure, protocols, error codes, protocol-name registry)\n \u25b2\n \u2514---------------- independent Audit consumer\n\nHorizontal (attachment surfaces, no new vertical layers):\n- profiles/ declarations of host and project-shape differences; implements only the stable SPI\n- host external AI coding runtime environment: owns semantics; Foundation unifies structural differences\n- release-skill release state and all remote writes; does not enter Foundation\n- Artifact Graph the `artifacts/` architecture artifact system; its gate is check:artifacts\n</code></pre> <p>Arrows point to the depended-upon party. The public core must not depend in reverse on a concrete Profile or a concrete skill family; where a new capability's dependency direction lands is specified in <code>artifacts/design/FND-DES-001.md</code>, and asset-by-asset ownership is in FND-ADR-002.</p>"},{"location":"en/architecture/#Responsibility-Matrix","title":"Responsibility Matrix","text":"<p>Each layer assumes only the responsibilities listed below; out-of-scope capabilities are owned by external projects or consumers.</p> Layer Owns Does not own (lands elsewhere) Contracts Structure, protocols, error codes, protocol-name registry; 20 top-level object kinds; 9 mandatory rules Business-field semantics, domain auditing, remote writes, model generation Harness Node mechanism implementation of Contracts; path containment, atomic write, closures, request handling, report rendering, host-access mechanism, state substrate Business semantics, workflow orchestration, model invocation, git writes, network remotes Engineering Kit The four engineering commands and their read-only / restricted-write boundaries; host sub-action injection of concrete Profiles Auto-fix, auto-migration, remote release, a fifth command Profile Declarative SPI for host and project-shape differences; implements only the stable SPI Business semantics, executable-script entry points, public-core changes release-skill Release state and all remote writes Foundation contains no publish/remote-write entry point loop-agent Tasks, retries, rework, acceptance, self-iteration Foundation does not define a workflow state machine Artifact Graph Artifact relationships, context, packet, version-lock Foundation does not own the artifact graph Audit Independent fixtures, expected values, adjudication Domain-semantic conclusions are owned by external review"},{"location":"en/architecture/#Capability-Ownership-Algorithm","title":"Capability Ownership Algorithm","text":"<p>Given an architecture requirement, decide ownership in the following order, stopping at the first match:</p> <ol> <li>Contains domain semantics, a business state machine, or an audit oracle \u2192 keep it with the consumer; connect only business-neutral mechanisms.</li> <li>Is structure, a protocol, a stable error code, or an object Schema \u2192 Contracts.</li> <li>Is a Node mechanism reusable across skill families \u2192 Harness.</li> <li>Is scaffold/adopt-plan/projection/check or a concrete host Profile injection \u2192 Kit / Profile.</li> <li>Involves publishing remote state \u2192 release-skill.</li> <li>Involves tasks/retries/rework/acceptance \u2192 loop-agent.</li> <li>Involves artifact relationships / version-lock \u2192 artifact-graph.</li> <li>Has only one consumer, or has not been proven to repeat across two real consumers \u2192 keep it with the consumer; do not expand Foundation.</li> </ol> <p>Step 8 is the expansion gate: a new component must justify that deleting it would force two or more real consumers to re-implement it, and this must be verified by an independent fixture; admission gate 1 additionally requires at least one existing real consumer plus one structurally isomorphic foreseeable consumer (the second consumer need not be live, but its need must be expressible with the same structure; adjustment record in FND-ADR-009). Step 9 is the finite-closed-semantics gate (FND-ADR-001 gate 8): a capability carrying limited domain semantics must satisfy either \u2014 its semantics are covered by a small stable closed enumeration, or it is a deterministic estimation primitive whose algorithm, scope, and bias direction are declared in the contract; this gate does not cancel gate 2's \"semantics-free\" veto. The machine-readable version is in <code>docs/agents/architecture-routing.md</code>.</p>"},{"location":"en/architecture/#Trust-and-Side-Effect-Boundaries","title":"Trust and Side-Effect Boundaries","text":"<p>Foundation's trust assumptions and side-effect conventions are solidified per layer; callers judge risk accordingly:</p> <ul> <li>Contracts: pure functions, no file/Git/network/process side effects; error codes are frozen and do not drift (<code>foundation.contracts.error-codes</code>).</li> <li>Harness: the mechanism layer reads and writes only within contained paths; <code>HARNESS_EXCLUSIONS</code> excludes release-state, remote-network-access, business-semantics, workflow-orchestration, model-calls, git-writes (<code>foundation.harness.errors</code>).</li> <li>Engineering Kit: <code>FORBIDDEN_SIDE_EFFECTS</code> includes git-init/commit/push/tag, publish, remote-write; <code>REFUSED_MUTATION_FLAGS</code> are refused at the CLI entry point (<code>foundation.kit.cli</code>).</li> <li>Profile: declarative differences; the entry point must be a JSON data resource; <code>coreOwned</code> (packages/commands/namespacePrefixes) is a forbidden target (<code>foundation.profile.extension-spi</code>).</li> <li>State substrate: the event log is the sole authority, and the snapshot is a derived cache; <code>confirmOwnerTerminated</code> is an external trust anchor provided by the caller, and does not promise resistance against same-privilege malicious processes (<code>foundation.harness.state-store</code>).</li> </ul>"},{"location":"en/architecture/#Architecture-Decision-Tree","title":"Architecture Decision Tree","text":"<pre><code>Requirement contains domain semantics/state machine/audit? \u2500\u2500yes\u2500\u2500\u25b6 keep with consumer\n \u2502no\nIs it structure/protocol/error code/Schema? \u2500\u2500yes\u2500\u2500\u25b6 Contracts\n \u2502no\nIs it a Node mechanism across skill families? \u2500\u2500yes\u2500\u2500\u25b6 Harness\n \u2502no\nIs it scaffold/adopt/projection/check or Profile injection? \u2500\u2500yes\u2500\u2500\u25b6 Kit / Profile\n \u2502no\nInvolves publishing remote state? \u2500\u2500yes\u2500\u2500\u25b6 release-skill\n \u2502no\nInvolves tasks/retries/rework/acceptance? \u2500\u2500yes\u2500\u2500\u25b6 loop-agent\n \u2502no\nInvolves artifact relationships/version-lock? \u2500\u2500yes\u2500\u2500\u25b6 artifact-graph\n \u2502no\nOnly one consumer / not proven across two real consumers? \u2500\u2500yes\u2500\u2500\u25b6 keep with consumer, do not expand\n \u2502no\nCarries limited domain semantics? \u2500\u2500yes\u2500\u2500\u25b6 finite closed semantics: covered by a\n \u2502 stable closed enumeration, or a deterministic estimation\n \u2502 primitive (algorithm/scope/bias declared in the contract)\n \u2502 \u2192 admissible; otherwise keep with consumer\n \u2502 (FND-ADR-001 gate 8; does not cancel gate 2's veto)\n \u2502no\n \u2500\u2500\u25b6 admissible\n</code></pre>"},{"location":"en/architecture/#Routing-Relationships-with-External-Projects","title":"Routing Relationships with External Projects","text":"<p>Foundation is not an all-powerful base. The following responsibilities are explicitly outside Foundation:</p> <ul> <li>Release and remote writes: owned by release-skill; Foundation provides no publish/remote-write entry point (<code>foundation.unsupported.remote-publish</code>).</li> <li>Task lifecycle: owned by loop-agent (tasks, retries, rework, acceptance); Foundation contains no workflow state machine (<code>foundation.unsupported.business-state-machine</code>).</li> <li>Artifact governance: artifact-graph owns the <code>artifacts/</code> relationship contract and version-lock; its gate is <code>check:artifacts</code>.</li> <li>Domain auditing: an independent audit consumer owns the semantics and final accept/reject; Foundation provides only a deterministic audit surface (<code>foundation.unsupported.domain-audit-semantics</code>).</li> <li>Host apply and lifecycle: host apply is stably refused, install/update/uninstall are unimplemented, and the full Qoder driver is unsupported (<code>foundation.unsupported.host-apply</code>, <code>foundation.unsupported.host-install-update-uninstall</code>, <code>foundation.unsupported.qoder-driver</code>).</li> </ul>"},{"location":"en/architecture/#Next-Phase-Capability-Lines-Architecture-Hand-off","title":"Next-Phase Capability Lines (Architecture Hand-off)","text":"<p>All three capability lines were included via the FND-ADR-001 capability admission-gate adjudication and all land within the existing layers:</p> <ul> <li>Host-access line (FND-FR-001/FND-FR-002, FND-ADR-003): Contracts registers descriptor/source/manifest/probe/plan/receipt; Harness implements generic source closure, atomic build/materialize, and probe classification; Kit injects the concrete Profile and trusted driver. Currently only describe/build/probe/plan are supported; <code>apply</code> is stably refused; install/uninstall/update are unimplemented.</li> <li>Durable state-substrate line (FND-FR-003, FND-ADR-004): append-only events, hash chain, snapshots, and verification recovery; provides only the state substrate, not business semantics such as state machines, task nodes, retries, terminal states, or memory.</li> <li>Human-report line (FND-FR-004, FND-ADR-005): a two-layer contract \u2014 machine results are the sole source of truth, and the human report is deterministically rendered from machine results (Markdown + digest binding + graded checks), not freely authored.</li> <li>Finite-closed-semantics tools line (FND-ADR-009): baseline materialization + contentGuard (digest mismatch, mid-materialization change, and guard rejection all fail closed), generic read chokepoint (allowed-root set + optional identity predicate), strategy-driven surface scan (policy contract + injection self-test), token upper-bound estimation (deterministic estimation primitive with no model/network/tokenizer dependency), and a generic upper-bound guard (reusing the state-store event ledger and token-lock; the bound and over-limit policy are consumer-configured).</li> </ul> <p>The three-package structure is preserved and a fourth package is not split out (FND-ADR-007); artifact governance uses the artifact-graph CLI and version-lock (FND-ADR-006).</p>"},{"location":"en/architecture/#First-Version-Budget","title":"First-Version Budget","text":"<ul> <li>Top-level Contracts objects: 20 kinds (the complete list uses <code>packages/skill-family-contracts/src/registry.json</code> as the sole source of truth): project-manifest, profile-descriptor, managed-file-lock, operation-request, operation-result, migration-manifest, adapter-source, report-model, report-binding, host-descriptor, host-registry, host-capability-fact, host-probe-result, adapter-build-manifest, host-operation-plan, host-operation-receipt, state-event-envelope, state-snapshot-metadata, token-estimate-result, surface-scan-policy;</li> <li>Kit top-level commands: 4 (scaffold, adopt-plan, projection, check);</li> <li>Mandatory mechanical rules: currently 9, budget not exceeding 20, absolute ceiling 30; CR-001 uniformly compiles all Schemas within the registry;</li> <li>Leaf packages: 3 (skill-family-contracts, skill-family-harness-node, skill-family-engineering-kit);</li> <li>Schema validator: Ajv 8.20.0 (exact version pin), supporting both draft-07 and 2020-12 dialects;</li> <li>kernel protocol: skill-family.kernel.operation (stable), Contracts version 1.4.0;</li> <li>Default runtime language: Node; first-version implementations in a second language: 0.</li> </ul> <p>Any new component must justify the two-or-more real-consumer re-implementation that deleting it would cause, and be verified by an independent fixture.</p>"},{"location":"en/architecture/#Machine-Source-of-Truth-and-File-Classification","title":"Machine Source of Truth and File Classification","text":"Source of truth Content <code>.foundation/skeleton-manifest.json</code> Package manifest, Profiles, fixtures, top-level commands <code>.foundation/version-lock.json</code> Exact versions and lock points for projen, pnpm, Node <code>.foundation/file-registry.json</code> Registration of managed / handwritten / artifact file classes <code>package.json</code> and <code>packages//package.json</code> Versions, commands, dependencies (all projen-managed) <code>packages/skill-family-contracts/src/registry.json</code> Protocol-name and Schema $id registry <code>scripts/release-artifact-contract.json</code> Fixed three-package release byte contract (members, required items, and content-digest rules) <p>Managed files can only be modified via <code>.projenrc.js</code> and regenerated by running <code>pnpm synth</code>; handwritten files (including all documentation) are not overwritten by synth. The authoritative classification is in <code>.foundation/file-registry.json</code>.</p>"},{"location":"en/architecture/#Documentation-System-and-Fact-Check","title":"Documentation System and Fact-Check","text":"<p>The documentation system aims to eliminate manual drift through deterministic checks:</p> <ol> <li>Frozen fact package: documentation writing consumes only the machine sources of truth listed in the table above. Models or authors must not write versions, commands, or package counts from memory; model names, credentials, and scheduling information do not enter documentation, nor do they enter Contracts.</li> <li>Fact-check: <code>node scripts/docs/fact-check.mjs</code> verifies package names, commands, gate facts, version pins, and key numbers in the documentation against the source of truth, and cross-checks consistency across sources (manifest vs package.json, version-lock vs packageManager, rule count vs budget, etc.).</li> <li>Link-check: <code>node scripts/docs/link-check.mjs</code> resolves in-repo relative links and heading anchors across the README and all <code>docs/*/.md</code>, and verifies that <code>mkdocs.yml</code> nav is complete.</li> <li>No-workflow boundary and public-boundary verification: this repository has no CI/CD workflow at all (the old topology's three Actions \u2014 ci/docs/docs-deploy \u2014 have been entirely deleted); all gates run within the private workspace (<code>pnpm check</code>); the public boundary is mechanically verified by <code>check:public-snapshots</code> and the release byte contract. The public static site is rendered by <code>scripts/render-public-site.mjs</code> (with the sole output <code>docs/public/site/*</code> and the deterministic baseline <code>docs/public/site-baseline.json</code>).</li> <li>Version lock: the site toolchain is locked in <code>scripts/docs/toolchain.json</code> and <code>scripts/docs/requirements.txt</code>; the build uses only an out-of-repo Python virtual environment, with no system-level pip install.</li> </ol> <p>Both check scripts can be run directly via <code>node scripts/docs/<name>.mjs</code>: <code>fact-check.mjs</code> consumes the root-pinned <code>semver@7.8.5</code> via in-repo modules and requires <code>pnpm install --frozen-lockfile</code> to be completed first; <code>link-check.mjs</code> is a pure Node implementation. See <code>scripts/docs/README.md</code> for responsibilities.</p>"},{"location":"en/architecture/#Stable-Product-Gates","title":"Stable Product Gates","text":"<p>The root <code>pnpm check</code> orchestrates only the 11 stable product gate IDs (<code>check:structure</code>~<code>check:artifacts</code>, each ID listed in Current Product Status), and no longer hard-pins the original command list; each stable ID composes a few product checks within its own package script. Gate facts are mechanically derived by <code>node scripts/docs/fact-check.mjs</code> from the root <code>package.json</code>'s <code>scripts.check</code> and verified verbatim. Documentation and setup invoke or list only the 11 stable IDs or the root <code>pnpm check</code>, and do not duplicate the underlying command list.</p> <p>The honest boundary of in-repo checks: structural checks only prove \"byte/structural consistency (provable in-repo)\"; one-time migration completeness, ordinary prose semantics, and the final accept/reject conclusion belong to the responsibility of external review; no second gate registry, baseline, or command comparator is maintained within the target repository.</p>"},{"location":"en/examples-and-fixtures/","title":"English \u00b7 Examples and fixtures","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/examples-and-fixtures/#Examples-and-Fixtures","title":"Examples and Fixtures","text":"<p>Foundation fixtures prove structural contracts and mechanism boundaries. They do not serve as an oracle for business correctness.</p>"},{"location":"en/examples-and-fixtures/#Fixture-Classes","title":"Fixture Classes","text":"<ul> <li>Positive fixtures provide valid input and must pass the declared contract or mechanism.</li> <li>Negative fixtures provide invalid input and must produce the stable failure code required by the contract.</li> <li>Dialect-boundary fixtures freeze expected behavior where draft-07 and 2020-12 JSON Schema handling differs.</li> </ul> <p>All published fixtures use fictional data. They must not contain a private Profile, real business data, credentials, user-specific paths, or consumer evidence.</p>"},{"location":"en/examples-and-fixtures/#Verification-Entry-Points","title":"Verification Entry Points","text":"Scope Verification entry point What it proves Contracts fixtures <code>packages/skill-family-contracts/test/fixtures.test.mjs</code> Registered fixture inputs and expected structural results still match; mismatch uses <code>SFC1010</code> Profile SPI conformance <code>fixtures/generic-profile-extension-conformance/verify.mjs</code> and <code>leak-scan.mjs</code> A fictional extension follows the stable SPI and public-data boundary Scaffold contract <code>fixtures/scaffold-conformance/verify.mjs</code> Generated skeleton bytes match the frozen contract Adoption hazards <code>fixtures/adoption/cases/</code> <code>adopt-plan</code> preserves its read-only boundary through before/after byte snapshots <p>These entry points are read-only or self-contained. They do not write a caller repository or access a remote service.</p>"},{"location":"en/examples-and-fixtures/#Oracle-Boundary","title":"Oracle Boundary","text":"<p>A fixture can prove that a contract was satisfied. It cannot prove that a business decision was correct. Domain state transitions, business acceptance, and audit conclusions remain with the consumer or an independent reviewer.</p> <p>The audit surface illustrates this boundary: Foundation can produce canonical JSON and a SHA-256 digest, while the caller still owns the meaning of the evidence and the final accept/reject decision.</p>"},{"location":"en/examples-and-fixtures/#Published-Example-Scope","title":"Published Example Scope","text":"<p>The public example surface includes the fictional <code>profiles/public-plugin</code> Profile and the generic conformance, scaffold, licensing, adoption, and minimal-consumer fixtures listed by the workspace manifest. Any private consumer fixture or real operational evidence remains outside the public release boundary.</p> <p>For capability selection, start with the agent documentation entry. For the exact machine facts behind an example, inspect the core capability catalog and its English overlay.</p>"},{"location":"en/help/","title":"English \u00b7 Capabilities and diagnostics","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/help/#Help-and-Triage","title":"Help and Triage","text":"<p>This page provides triage paths by error code, process exit code, and symptom. Foundation's error-code system is frozen in Contracts (<code>src/error-codes.json</code>) and does not drift; mechanism failures are unified as <code>SFC2004</code> with a stable <code>details.kind</code>.</p>"},{"location":"en/help/#Triage-by-Stable-Error-Code","title":"Triage by Stable Error Code","text":"Error code Name Meaning Handling SFC1001 SCHEMA_VALIDATION_FAILED Document failed target Schema validation Check the document's required fields and type constraints SFC1002 UNKNOWN_SCHEMA_ID <code>$id</code> is not registered in the registry Confirm the <code>$id</code> spelling and Contracts version SFC1003 DUPLICATE_SCHEMA_ID Duplicate <code>$id</code> registration refused Do not re-register; reuse the existing registration SFC1004 DUPLICATE_PROTOCOL_NAME Duplicate protocol name/version refused Do not re-register a protocol SFC1005 UNRESOLVED_REF <code>$ref</code> target cannot be resolved Check the <code>$ref</code> target SFC1006 UNSUPPORTED_DIALECT Dialect is not in the supported set Use only draft-07 / 2020-12 SFC1007 UNKNOWN_CHECK_TYPE Rule uses a check type outside the nine classes Do not define custom check types SFC1008 RULE_BUDGET_EXCEEDED Mandatory rule exceeded budget/ceiling Do not exceed 20 (absolute 30) SFC1009 UNKNOWN_ERROR_CODE Referenced an unregistered error code Reference only the frozen registry SFC1010 FIXTURE_EXPECTATION_MISMATCH Fixture behavior does not match expectation Check the fixture declaration SFC1011 UNKNOWN_PROTOCOL Referenced an unregistered protocol Confirm protocol name/version SFC1012 SCHEMA_COMPILE_FAILED The Schema itself cannot be compiled Check Schema syntax SFC2002 UNKNOWN_OPERATION Operation name is not in the frozen vocabulary Use only <code>validate</code> SFC2003 INVALID_PARAMS Parameters do not satisfy the params contract Check parameters SFC2004 EXECUTION_FAILED Mechanism execution failed See <code>details.kind</code> for the sub-classification SFC3001 REPORT_DIGEST_MISMATCH Report/result digest is inconsistent with the binding Recompute model/result SFC3002 REPORT_ELEMENT_MISSING Report is missing a mandatory element Complete the report fields SFC3003 REPORT_FACT_DRIFT Report bytes deviated from deterministic re-render Re-render from machine results"},{"location":"en/help/#Triage-by-Process-Exit-Code-Engineering-Kit","title":"Triage by Process Exit Code (Engineering Kit)","text":"Exit code Meaning Handling 0 Success / no findings No handling needed 1 <code>check</code> found findings Address the findings; Kit does not auto-fix 2 Refused / usage / mechanism error Check command name, parameters, and refused flags such as <code>--fix</code>"},{"location":"en/help/#Triage-by-Symptom","title":"Triage by Symptom","text":"<ul> <li>Validation keeps reporting SFC1002: <code>$id</code> is unregistered; first confirm the Contracts version and <code>$id</code> namespace.</li> <li>Path operation reports SFC2004 + <code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>: the path escaped the contained root; confirm the root-directory boundary, and do not cram business-selection rules into Foundation.</li> <li>Atomic write reports SFC2004 + <code>atomic-write-failed</code>: the target is out of bounds or the content type is illegal; check path containment and content type.</li> <li>State storage reports <code>store-locked</code>: an old writer may still hold the lock; confirm outside Foundation that the old writer has terminated, then call <code>recoverStateStoreLock</code> with the exact owner/fencing.</li> <li>host apply fails immediately: <code>apply</code> is stably refused in the read-only Phase D slice; install/update/uninstall are unimplemented; the full Qoder driver is unsupported.</li> <li>Document versions/commands do not match the source of truth: rely on the recomputation result of <code>scripts/docs/fact-check.mjs</code>; do not revise from memory.</li> </ul>"},{"location":"en/help/#Project-Routing","title":"Project Routing","text":"<ul> <li>Publishing remote state / npm publish \u2192 release-skill.</li> <li>Tasks / retries / rework / acceptance \u2192 loop-agent.</li> <li>Artifact relationships / version-lock \u2192 artifact-graph.</li> <li>Domain-audit semantics \u2192 independent audit consumer.</li> <li>General structure / mechanism issues \u2192 this repository's <code>docs/architecture.md</code> and <code>docs/agents/</code>.</li> </ul>"},{"location":"en/help/#Command-Quick-Reference-and-Authoritative-Facts","title":"Command Quick Reference and Authoritative Facts","text":"<p>The Engineering Kit has only four top-level commands: <code>scaffold</code>, <code>adopt-plan</code>, <code>projection</code>, <code>check</code>. Of these, <code>check</code> only diagnoses and does not fix; the caller handles the findings.</p> <ul> <li>Current product status (versions, package set, mirror coordinates, gates): Current Product Status (the single status page).</li> <li>Development and commit specifications: Git Lifecycle Guide.</li> </ul>"},{"location":"en/licensing/","title":"English \u00b7 Licensing","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/licensing/#Licensing-and-identity","title":"Licensing and identity","text":"<p>This page explains how Skill Family Foundation adopts its license, the distinction between identity roles, and the current status of NOTICE and third-party attribution. It is not an official translation of the Apache License 2.0; the legal text of Apache-2.0 is the root-level <code>LICENSE</code>, and in case of any ambiguity the English original prevails.</p>"},{"location":"en/licensing/#License","title":"License","text":"<ul> <li>License: <code>Apache-2.0</code> (the SPDX identifier is unchanged).</li> <li>Legal text: the root-level <code>LICENSE</code> is the full Apache License 2.0 text (authoritative in English). This page and any Chinese material only explain how the license is adopted; they do not replace or restate the legal text and do not claim equal legal effect.</li> <li>The three leaf packages distribute a copy of the root <code>LICENSE</code> with the package.</li> </ul>"},{"location":"en/licensing/#Distinction-between-identity-roles","title":"Distinction between identity roles","text":"<p>The following four identities are independent; none may be inferred from or merged with another:</p> Role Value Notes Author / copyright holder Guangzhou Fenghe Technology Co., Ltd. (\u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8) The copyright owner; written into <code>package.json</code>'s <code>author</code> and the <code>LICENSE</code> appendix attribution Repository owner (GitHub owner) <code>ifoohoo</code> The GitHub organization/account; no inference relationship with the author npm publisher The account in the current publish configuration The npm publish identity; no inference relationship with author/owner Contributor copyright line The contributors attribution in the root <code>LICENSE</code> appendix A retained historical/contributor attribution, not the project author or copyright holder <p><code>author</code>, <code>repository.owner</code>, and <code>npm publisher</code> are recorded separately; none may be derived from another.</p>"},{"location":"en/licensing/#Project-level-NOTICE","title":"Project-level NOTICE","text":"<p>FND-ADR-008 adopts Option B following the user's explicit ruling on 2026-08-10. Foundation now maintains a root <code>NOTICE</code> containing the project name, the year 2026, and the copyright holder, \u5e7f\u5dde\u5e02\u98ce\u8377\u79d1\u6280\u6709\u9650\u516c\u53f8 (Guangzhou Fenghe Technology Co., Ltd.). Starting with 0.2.1, the three public-unit mirrors, frozen snapshots, and npm tarballs must all distribute that file.</p> <p>The <code>open-source</code> Profile continues to declare <code>noticeRequired: true</code>. Engineering Kit continues to enforce the invariant between Apache-2.0 and the NOTICE requirement, and <code>checkIdentityDrift</code> continues to report <code>notice-missing</code> when the file is absent. This closure changes only Foundation's publish members; it does not alter the Kit's behavior for other consumers.</p> <p>Under Section 4(d) of the Apache License 2.0 in the root <code>LICENSE</code>, NOTICE content is informational and attributional; it does not modify the terms of the Apache License 2.0.</p>"},{"location":"en/licensing/#Third-party-attribution-THIRD_PARTY_NOTICES","title":"Third-party attribution (THIRD_PARTY_NOTICES)","text":"<p>The Engineering Kit public unit distributes MkDocs Material, lunr, and lunr-languages assets and already includes <code>packages/skill-family-engineering-kit/THIRD_PARTY_NOTICES</code> with the corresponding third-party license material. Third-party attribution remains covered by <code>THIRD_PARTY_NOTICES</code> and the corresponding license closure; the project-level <code>NOTICE</code> must not replace them. The <code>NOTICE</code> carries only Foundation's own project attribution and does not copy full third-party license texts.</p>"},{"location":"en/licensing/#License-boundary-between-the-private-workspace-and-public-mirrors","title":"License boundary between the private workspace and public mirrors","text":"<ul> <li>This workspace is permanently private and is the single source of development truth; the workspace itself never enters the public boundary.</li> <li>The public boundary consists only of three versioned publish mirrors and npm tarballs; they distribute the root <code>LICENSE</code> (Apache-2.0) and <code>NOTICE</code>. Engineering Kit additionally distributes <code>THIRD_PARTY_NOTICES</code> and the corresponding third-party license material.</li> <li>Profiles, fixtures, internal docs, and run evidence inside the private workspace do not enter the public packages; public docs only consume artifacts mechanically verified by the allowlist and release contract.</li> <li>Publish state and all remote writes belong to release-skill; this page does not duplicate live publish state.</li> </ul>"},{"location":"en/quickstart/","title":"English \u00b7 Quickstart","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/quickstart/#Quickstart","title":"Quickstart","text":"<p>This page gives each of three reader types a shortest path to success: new projects, existing projects, and architecture designers. Each path lists only the required actions and verification commands; follow the corresponding documentation for deeper detail.</p>"},{"location":"en/quickstart/#New-Project-Generate-a-Skeleton","title":"New Project: Generate a Skeleton","text":"<p>The goal is to obtain a Foundation-compliant project skeleton from scratch.</p> <pre><code>npm install --save-dev skill-family-engineering-kit\nnpm exec -- skill-family-kit scaffold --root ./my-project --project-id my-project\nnpm exec -- skill-family-kit check --root ./my-project\n</code></pre> <p>The commands above first generate a skeleton, then run engineering diagnostics on the generated result. <code>scaffold</code> writes only to an empty target directory; a non-empty or conflicting target is refused and not touched; <code>check</code> diagnoses only, it does not fix. Verification passes when <code>check</code> exits with code 0.</p>"},{"location":"en/quickstart/#Existing-Project-Read-Only-Inventory","title":"Existing Project: Read-Only Inventory","text":"<p>The goal is to first see whether the existing repository can be adopted, without changing any bytes.</p> <pre><code>npm exec -- skill-family-kit adopt-plan --root ./existing-repo\nnpm exec -- skill-family-kit check --root ./existing-repo\n</code></pre> <p><code>adopt-plan</code> outputs the current state, target Profile, exact write set, conflicts, and the legacy-implementation exit list, with zero change to the input repository's bytes. <code>check</code> performs read-only diagnostics only. Decide whether to perform a write after confirming the inventory results.</p>"},{"location":"en/quickstart/#Architecture-Designer-Decide-Ownership","title":"Architecture Designer: Decide Ownership","text":"<p>The goal is to determine which Foundation layer an architecture requirement should land in, or whether it should stay with the consumer.</p> <ol> <li>Read the eight-step decision order in <code>docs/agents/architecture-routing.md</code>.</li> <li>In <code>docs/agents/capability-catalog.json</code>, find the capability by <code>layer</code> and <code>intent</code>, and read its <code>entrypoints</code>, <code>sideEffects</code>, <code>failureSemantics</code>, <code>ownedByCaller</code>.</li> <li>When publishing, task lifecycle, or artifact relationships are involved, route to release-skill, loop-agent, and artifact-graph respectively.</li> </ol> <p>The hard boundary of routing: Foundation does not own remote writes, business state machines, model orchestration, or domain-audit semantics. Capabilities that fall into <code>keep-business</code> or <code>foundation-gap</code> do not forcibly expand Foundation.</p>"},{"location":"en/quickstart/#Authoritative-Facts-and-Specifications","title":"Authoritative Facts and Specifications","text":"<ul> <li>Current product status (versions, package set, mirror coordinates, gates): Current Product Status (the single status page; not duplicated here).</li> <li>Development and commit specifications: Git Lifecycle Guide.</li> </ul>"},{"location":"en/quickstart/#Path-Reference","title":"Path Reference","text":"Reader Starting point Next step New project <code>scaffold</code> <code>check</code> \u2192 integrate Profile Existing project <code>adopt-plan</code> classify (direct-adoption / compatibility-layer / keep-business / foundation-gap) \u2192 adopt Architecture designer routing decision capability catalog \u2192 real exports and tests"},{"location":"en/agents/","title":"English \u00b7 Agent entry","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/agents/#Documentation-Entry-for-Agents","title":"Documentation Entry for Agents","text":"<p>This directory is the decision entry point of Skill Family Foundation for agents (Agents). Human readers enter from the root <code>README.md</code>; agents, within a limited context, read here first, then jump to the specific capability by intent, avoiding reading all the source code end-to-end.</p> <p>Foundation does not own business semantics. It provides only three things: machine contracts (Contracts), the thin Node mechanism runtime (Harness), the four engineering-phase commands (Engineering Kit), and the horizontally-declared-difference Profile. Domain state machines, model orchestration, remote publish writes, and audit semantics all stay with the caller or other projects.</p>"},{"location":"en/agents/#Reading-Order","title":"Reading Order","text":"<p>Agents consume the following in order, without needing to read from start to finish:</p> <ol> <li><code>../../agents/capability-catalog.json</code> \u2014 the language-neutral machine-fact catalog of stable and candidate capabilities; the starting point for judging \"does this requirement belong to Foundation, in which layer, and with which entry point.\"</li> <li><code>architecture-routing.md</code> \u2014 the decision table and decision tree from architecture intent to layer/capability/entry-point/external-project.</li> <li><code>../../agents/capability-catalog.en.json</code> \u2014 English intent, use conditions, inputs, outputs, failure semantics, caller ownership, and external routing for exactly the same capability IDs.</li> <li><code>../../agents/capability-catalog.schema.json</code> \u2014 the closed structural contract for the core catalog and locale overlays.</li> <li>The root <code>README.md</code>'s Agent Quick Reference \u2014 routing only, no API duplication.</li> <li>The three packages' README Agent Quick References \u2014 down to package-level capabilities and failure boundaries.</li> <li><code>../reference/failure-and-side-effect-matrix.md</code> \u2014 read/write/spawn/Git/network/residual-state/error-code for each public entry point.</li> <li><code>../reference/api/README.md</code> \u2014 the English API route across the three packages, including key capabilities, failure rules, evidence paths, and caller-owned semantics.</li> </ol> <p>Fact priority: this documentation consumes only the machine source of truth (package.json, src/index.mjs, CLI, registry.json, profile descriptor). Versions, commands, package counts, and support states are recomputed from the source of truth, never copied from memory or old docs.</p>"},{"location":"en/agents/#Catalog-Contract","title":"Catalog Contract","text":"<p>Files under <code>docs/agents/</code> assume different responsibilities and do not duplicate each other:</p> File Role Who should change it <code>../../agents/capability-catalog.json</code> Language-neutral machine-readable capability facts; the documentation layer's sole fact surface Change when capabilities change, validated by <code>capability-catalog-check.mjs</code> <code>../../agents/capability-catalog.en.json</code> English explanation overlay for every core capability ID Change when the English intent or behavior explanation changes <code>../../agents/capability-catalog.zh-CN.json</code> Simplified Chinese explanation overlay for every core capability ID Change when the Chinese intent or behavior explanation changes <code>../../agents/capability-catalog.schema.json</code> Closed catalog and overlay structural contract Change only when structure changes <code>architecture-routing.md</code> Intent \u2192 layer/capability/entry-point/external-project decisions Change when routing adjudication changes <code>README.md</code> (this file) Agent total entry point and reading order Change when entry-point structure changes <code>../reference/api/README.md</code> and the three Chinese package detail pages Human-readable routing and signature-level expansion of catalog capabilities Change when real exports change, and sync with <code>capability-catalog-check.mjs</code> <p>The capability catalog is not a new public object of Contracts, nor a fourth registry class. It is only the documentation layer's machine facts, avoiding the README becoming a second drifting handwritten authority.</p>"},{"location":"en/agents/#Architecture-Design-Method","title":"Architecture Design Method","text":"<p>When an agent handles a Foundation-related requirement, it proceeds in the following four steps:</p> <ol> <li>Decide ownership first. Does this requirement contain domain semantics, a business state machine, or an audit oracle? If so, keep it with the consumer, connecting only business-neutral mechanisms to Foundation.</li> <li>Then decide the layer. Structure/protocol/stable error code/object Schema \u2192 Contracts; cross-skill-family reusable Node mechanism \u2192 Harness; scaffold/adopt/projection/check or concrete Profile injection \u2192 Kit/Profile.</li> <li>Check the catalog to determine the entry point. Find the capability by <code>layer</code> in the core catalog, then read the matching <code>intent</code>, <code>sideEffects</code>, <code>failureSemantics</code>, <code>ownedByCaller</code>, and <code>routeElsewhere</code> in the English overlay.</li> <li>Verify evidence before concluding. Each catalog capability carries <code>sourceRefs</code> and <code>positiveTestRefs</code>/<code>negativeTestRefs</code>; before changing a judgment, return to these sources of truth to confirm, rather than inferring from the catalog's prose.</li> </ol> <p>The hard rule of routing boundaries: Foundation does not own remote writes (\u2192 release-skill), does not own tasks/retries/rework (\u2192 loop-agent), does not own artifact relationships and context (\u2192 artifact-graph), does not own domain-audit semantics (\u2192 independent audit consumer). See the routing table in <code>architecture-routing.md</code> for details.</p>"},{"location":"en/agents/#Relationship-with-Mechanical-Gates","title":"Relationship with Mechanical Gates","text":"<p>Two check scripts guard the catalog and README against drift:</p> <ul> <li><code>scripts/docs/capability-catalog-check.mjs</code> validates structure, unique IDs, existence of source/test references, unsupported boundaries, and that the Kit's four commands are not expanded.</li> <li><code>scripts/docs/agent-section-check.mjs</code> validates the fixed Agent Quick Reference sections of the root README and the three packages' READMEs, the required subheadings, and capability-ID links.</li> </ul> <p>Neither only reports shape and does not auto-edit; warnings require returning to the source of truth and human judgment.</p>"},{"location":"en/agents/architecture-routing/","title":"English \u00b7 Architecture routing","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/agents/architecture-routing/#Architecture-Routing-From-Intent-to-Layer-Capability-and-External-Project","title":"Architecture Routing: From Intent to Layer, Capability, and External Project","text":"<p>This page converges \"where should an architecture requirement land\" into a mechanically-reusable decision order and routing table. It serves new agents who, without reading the source code end-to-end, quickly obtain a verifiable answer: does this requirement belong to Foundation, in which layer (Contracts/Harness/Kit/Profile), with which stable entry point, what semantics remain owned by the caller, and when should it be handed off to an external project.</p>"},{"location":"en/agents/architecture-routing/#Decision-Order","title":"Decision Order","text":"<p>Judge in order by number, stopping at the first match:</p> <ol> <li>Does it contain domain semantics, a business state machine, or an audit oracle? If yes, keep it with the consumer; Foundation connects only business-neutral mechanisms.</li> <li>Is it structure, a protocol, a stable error code, or an object Schema? \u2192 Contracts (contract authority).</li> <li>Is it a cross-skill-family reusable Node mechanism? \u2192 Harness (Node implementation of the Contracts mechanism protocol).</li> <li>Is it the engineering-phase scaffold/adopt-plan/projection/check, or a concrete host Profile injection? \u2192 Kit / Profile.</li> <li>Does it involve publishing remote state? \u2192 release-skill.</li> <li>Does it involve tasks, retries, rework, acceptance, or self-iteration? \u2192 loop-agent.</li> <li>Does it involve artifact relationships, context, packet, or version-lock? \u2192 artifact-graph.</li> <li>Does it have only one consumer, or has cross-two-real-consumer duplication not been proven? Keep it with the consumer by default; do not expand Foundation.</li> </ol> <p>Step 8 is the expansion gate. Any new component must justify: deleting it would force two or more real consumers to re-implement it, and this is verified by an independent fixture. Otherwise keep it on the consumer side.</p>"},{"location":"en/agents/architecture-routing/#Routing-Table","title":"Routing Table","text":"<p>The table below gives the preferred capability and the forbidden misuse for common architecture intents. Each preferred capability can be looked up in <code>capability-catalog.json</code> by id for its entry points, side effects, and failure semantics.</p> Architecture intent Preferred capability Forbidden misuse Validate a Foundation contract object Contracts / Harness validation (<code>foundation.contracts.object-validation</code>, <code>foundation.harness.contract-validation</code>) Do not replace the consumer's business Schema Safe file access and atomic write Harness path / atomic API (<code>foundation.harness.path-containment</code>, <code>foundation.harness.atomic-write</code>) Do not put file-selection business rules into Harness Generate a deterministic human report Harness report or Kit report sub-action (<code>foundation.harness.report</code>, <code>foundation.kit.report</code>) Do not freely author reports from open business outputs Durable events and derived snapshot Harness state-store (<code>foundation.harness.state-store</code>) Do not define a workflow state machine in Foundation New-project skeleton Kit scaffold (<code>foundation.kit.scaffold</code>) Do not overwrite a non-empty existing repository Existing-repository adoption inventory Kit adopt-plan (<code>foundation.kit.adopt-plan</code>) Do not write files, do not auto-migrate Managed projection Kit projection + Profile (<code>foundation.kit.projection</code>) Do not overwrite handwritten files Engineering diagnostics Kit check (<code>foundation.kit.check</code>) Do not auto-fix Publishing release-skill Foundation does not own remote writes Tasks/retries/rework loop-agent Foundation does not own a business state machine Artifact relationships/version-lock artifact-graph Foundation does not own the artifact graph"},{"location":"en/agents/architecture-routing/#Layer-Location-Quick-Reference","title":"Layer-Location Quick Reference","text":"<p>The dependency direction is fixed as Contracts \u2192 Harness \u2192 Engineering Kit; Profile declares horizontally, and the public core does not depend in reverse on a concrete Profile.</p> <ul> <li>Contracts: structure, protocols, error codes, protocol-name registry; 18 top-level object kinds, 9 mandatory rules.</li> <li>Harness: the thin Node mechanism runtime of Contracts; implements only business-neutral mechanisms, owning no semantics.</li> <li>Engineering Kit: the four engineering commands (scaffold, adopt-plan, projection, check) and their read-only / restricted-write boundaries.</li> <li>Profile: the declarative SPI for host and project-shape differences; implements only the stable SPI, injecting no business semantics.</li> <li>External projects: release-skill (publishing), loop-agent (task lifecycle), artifact-graph (artifact relationships), independent audit consumer (domain semantics).</li> </ul>"},{"location":"en/agents/architecture-routing/#Typical-Misrouting-and-Correction","title":"Typical Misrouting and Correction","text":"<ul> <li>Misrouting a domain Schema to Foundation: the domain Schema is owned by the consumer; Foundation provides only a generic validation mechanism (<code>foundation.contracts.object-validation</code>).</li> <li>Misrouting a workflow state machine to Foundation: state-store provides only the event-log and snapshot substrate; reducer transitions and terminal states are owned by the caller (<code>foundation.unsupported.business-state-machine</code>).</li> <li>Misrouting a publish write to Foundation: remote writes belong to release-skill; Foundation contains no publish/remote-write entry point (<code>foundation.unsupported.remote-publish</code>).</li> <li>Misrouting an audit oracle to Foundation: the audit surface only performs deterministic serialization; domain conclusions belong to external review (<code>foundation.unsupported.domain-audit-semantics</code>).</li> </ul> <p>The honest boundary of routing judgment: structural checks only prove byte/structural consistency (provable in-repo); ordinary prose semantics and the final accept/reject conclusion belong to external independent review; no second gate is maintained within the target repository.</p>"},{"location":"en/migration/","title":"English \u00b7 Migration","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/migration/#Existing-Repository-Adoption-and-Migration-FND-070","title":"Existing-Repository Adoption and Migration (FND-070)","text":"<p>This page describes how an existing project adopts the Skill Family infrastructure, and the gate for judging migration completion. It serves two reader types: a human owner uses it to judge the adoption path and risks; an agent uses it to run a read-only inventory via <code>adopt-plan</code>, without duplicating write actions on this page.</p>"},{"location":"en/migration/#Classification-Method","title":"Classification Method","text":"<p>Before an existing repository connects to Foundation, classify it into one of the four categories below. The classification determines which path to take, whether files are written, and how the legacy implementation is handled.</p> Category Meaning Handling path Writes files? <code>direct-adoption</code> The repository already has a capability that can be replaced by Foundation as-is, with no business-semantic coupling Direct adoption: <code>adopt-plan</code> inventory \u2192 <code>scaffold</code>/<code>projection</code> writes to disk Yes (contained) <code>compatibility-layer</code> The repository's existing implementation differs from the Foundation interface and needs a compatibility adaptation layer Write a compatibility layer, then adopt; the legacy implementation exits via the compatibility layer Yes (compatibility layer contained) <code>keep-business</code> The capability contains domain semantics or a business state machine, belongs to the caller, and Foundation does not take it Keep with the consumer; connect only business-neutral mechanisms No (on the Foundation side) <code>foundation-gap</code> A needed capability is not yet provided by Foundation (e.g., host apply, Qoder driver) Keep with the consumer or a later version; do not forcibly expand Foundation No <p>Classification is a prerequisite for the adoption decision. Capabilities that fall into <code>keep-business</code> or <code>foundation-gap</code> should not be stuffed into Foundation just to \"complete adoption\"; this is exactly the concrete instantiation of architecture-routing steps 1 and 8.</p>"},{"location":"en/migration/#Principles","title":"Principles","text":"<ol> <li>Plan first: any existing repository first runs the read-only <code>adopt-plan</code>, obtaining the current state, target Profile, exact write set, conflicts, legacy-implementation exit list, and acceptance commands, before deciding whether to perform a write.</li> <li>Read-only plan, zero change: <code>adopt-plan</code> writes no files (including temporary files), runs no git write commands, renames nothing, and touches no remotes; zero change to the input repository's bytes (provable by before/after hash walk-through).</li> <li>Adoption and rename are separate: infrastructure adoption never drags along a repository rename or remote-coordinate change; the two are independent decisions, and the tool provides no rename capability.</li> <li>Dual-track does not count as complete: the migration-completion judgment requires the legacy duplicate implementation to have been deleted; connecting the new infrastructure while the legacy implementation still remains is permanently judged false.</li> </ol>"},{"location":"en/migration/#adopt-plan-Output-Structure","title":"adopt-plan Output Structure","text":"Section Content <code>target</code> Current state: entry-point count, target's own managed declarations <code>project</code> / <code>traceability</code> Target Profile and the source of truth for each write (Contracts version, skeleton generation function, license Profile and variant) <code>git</code> Read-only Git pre-state (repository, HEAD, clean) <code>writeSet</code> Exact write set: per-path action (only <code>create</code>/<code>unchanged</code>), fileClass, sha256 <code>conflicts</code> Handwritten conflicts, managed drift, symlink placeholders, temporary exceptions for missing fields <code>risks</code> dirty, nested repository, tracked-but-ignored, expired exceptions, etc. <code>migration</code> Migration state machine: binding, on-disk proof (adoptionProof), pending-write count, check gate, four-class verification evidence, state and completion judgment <code>verificationPlan</code> Acceptance command sequence (check \u2192 projection \u2192 re-check)"},{"location":"en/migration/#Migration-Manifest-skill-familymigrationjson","title":"Migration Manifest (skill-family.migration.json)","text":"<p>The target repository declares its own migration state in the root directory:</p> <pre><code>{\n \"kind\": \"skill-family.migration-manifest\",\n \"legacyInfra\": [\n { \"path\": \"scripts/old-validator.mjs\", \"replacedBy\": \"sf-kit check\" }\n ],\n \"exceptions\": [\n {\n \"owner\": \"owner\",\n \"reason\": \"specific reason\",\n \"deadline\": \"2026-12-31\",\n \"migrationTarget\": \"wave-m1\"\n }\n ],\n \"targetProfile\": \"generic\",\n \"foundationPackages\": [\n { \"name\": \"skill-family-contracts\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 hex digits>\" },\n { \"name\": \"skill-family-harness-node\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 hex digits>\" },\n { \"name\": \"skill-family-engineering-kit\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 hex digits>\" }\n ],\n \"verification\": {\n \"unit\": \"docs/evidence/unit.json\",\n \"integration\": \"docs/evidence/integration.json\",\n \"consumer\": \"docs/evidence/consumer.json\",\n \"independentAudit\": \"docs/evidence/independent-audit.json\"\n }\n}\n</code></pre> <p>The structure above shows the core fields of the migration manifest; each <code>legacyInfra</code> entry gives the legacy-implementation path and its replacement; the tool only read-only evaluates existence and never deletes on its behalf.</p> <p>The Quickstart Profile candidate moves to v2 in 0.3.0. A migration manifest that binds candidate capabilities must pin all three Foundation packages to exactly 0.3.0; an existing integration that still requires v1 must keep all three packages pinned to exactly 0.2.1 and must not mix the two sets.</p> <ul> <li><code>legacyInfra</code>: each entry gives the legacy-implementation path and its replacement; the tool only read-only evaluates existence and never deletes on its behalf.</li> <li><code>exceptions</code> are temporary exceptions: must simultaneously contain all four fields \u2014 owner, reason, deadline, and migrationTarget \u2014 and missing any field counts as a conflict (plan failure); expired exceptions are not auto-renewed and persistently block the completion judgment.</li> <li><code>targetProfile</code> / <code>foundationPackages</code>: adoption binding. The target Profile must be consistent with the plan Profile; the three Foundation packages (contracts, harness-node, engineering-kit) must each bind an exact version number (floating ranges not accepted) and a <code>sha256:</code> digest.</li> <li><code>verification</code>: paths to the four classes of verification-evidence documents (unit, integration, consumer, independentAudit). Each piece of evidence must be parseable JSON whose <code>projectId</code> matches the target project's identity to count as proven; out-of-bounds paths, missing, unparseable, or identity-mismatched evidence are all unproven, fail-closed.</li> </ul>"},{"location":"en/migration/#Migration-State-Machine","title":"Migration State Machine","text":"<p>States advance monotonically and are derived only from read-only evidence; no tool advances state by writing.</p> <pre><code>not-declared \u2192 declared \u2192 adopted \u2192 verified \u2192 complete\n</code></pre> State Meaning <code>not-declared</code> No contract-valid migration manifest exists <code>declared</code> The manifest contract is valid, but the adoption-proof facts are incomplete <code>adopted</code> Foundation bytes are on disk and the legacy implementation has exited, but the check gate is not green <code>verified</code> The check gate is green, but not all verification evidence is proven <code>complete</code> All eight completion conditions are satisfied; <code>complete</code> is true if and only if the state is <code>complete</code>"},{"location":"en/migration/#Completion-Gate","title":"Completion Gate","text":"<p><code>migration.completion.complete</code> is true if and only if all eight hold:</p> <ol> <li>A contract-valid migration manifest has been declared (kind/fields validated by the Contracts schema);</li> <li>The adoption binding is proven: the target Profile is consistent with the plan, and the three Foundation packages each bind an exact version and a sha256 digest;</li> <li>The Project Manifest, managed lock, identity, and all managed skeleton files are on disk and their digests are consistent with the plan (<code>adoptionProof.missing</code>/<code>mismatched</code> are empty);</li> <li>The write set has no pending create/replace/project actions (<code>pendingWrites</code> is 0);</li> <li>The Foundation check gate is green;</li> <li>Each legacy implementation has exited (absent) \u2014 containment refusal or malformed entries fail-closed identically to present;</li> <li>No missing fields, no unparseable deadline, no expired temporary exceptions; no unresolved adoption conflicts;</li> <li>All four classes of verification evidence (unit/integration/consumer/independentAudit) are proven and identity (projectId) matches.</li> </ol> <p>An unevaluated input is equivalent to unproven: the gate advances only on presented evidence. The blocking reason (<code>blockers</code>) is a stable, readable string that can go directly into the migration review record.</p>"},{"location":"en/migration/#Mandatory-Negative-Cases-completion-must-be-false-in-any-scenario","title":"Mandatory Negative Cases (completion must be false in any scenario)","text":"<ul> <li>Empty repository + empty manifest (no contract-valid manifest \u2192 <code>not-declared</code>);</li> <li>Manifest with wrong kind (schema-invalid \u2192 treated as undeclared);</li> <li>9 skeleton files still pending create (<code>declared</code>, all missing paths listed);</li> <li>Managed lock drift (<code>mismatched</code> non-empty);</li> <li>Only the new implementation connected, legacy still present (dual-track \u2192 <code>declared</code>);</li> <li>Consumer verification evidence missing or identity mismatched (<code>verified</code>, must not complete);</li> <li>Temporary exception expired (the tool never renews).</li> </ul>"},{"location":"en/migration/#Legacy-Removal-and-Rollback-Contract","title":"Legacy-Removal and Rollback Contract","text":"<ul> <li>Removal is the caller's responsibility: <code>adopt-plan</code> only evaluates legacy-implementation existence and lists the exit manifest, never deleting on its behalf; <code>foundation-gap</code> and <code>keep-business</code> capabilities do not require removal.</li> <li>Rollback relies on evidence: before adoption writes to disk, a dual-digest binding of <code>adoptionProof</code> and <code>foundationPlanDigest</code> must exist first; on rollback, the plan write set's <code>expect.sha256</code> pre-state is used to restore; an overwrite action that does not declare its pre-state is refused at the <code>projection</code> stage.</li> <li>fail-closed default: any unparseable, out-of-bounds, identity-mismatched, or evidence-missing input makes the corresponding judgment unproven; success is not assumed.</li> </ul>"},{"location":"en/migration/#Ten-Field-Hand-off-Draft","title":"Ten-Field Hand-off Draft","text":"<p><code>adopt-plan</code> output carries a <code>handoffDraft</code> sub-block (kind=<code>skill-family.handoff-draft</code>, schemaVersion=1), providing structured data draft for the planner-side ten-field hand-off. Field sources are only two kinds: <code>derived</code> (mechanically derivable from read-only evidence) and <code>INCOMPLETE</code> (not mechanically derivable, never guessed). The ten fields correspond one-to-one with the source constant <code>HANDOFF_FIELDS</code>:</p> id Field name Source 1 <code>project-identity</code> derived 2 <code>repository-state</code> derived 3 <code>foundation-binding</code> derived (manifest declared binding) / INCOMPLETE (no manifest declared) 4 <code>write-set-policy</code> derived 5 <code>legacy-exits</code> derived 6 <code>business-logic-to-keep</code> always INCOMPLETE 7 <code>plan-summary</code> derived 8 <code>verification-entries</code> derived (all four classes of evidence proven) / INCOMPLETE (any unproven) 9 <code>legacy-removal-recovery</code> always INCOMPLETE 10 <code>authorization-status</code> derived (commit/push/tag/publish always false)"},{"location":"en/migration/#INCOMPLETE-Blocking-Rules","title":"INCOMPLETE Blocking Rules","text":"<ul> <li>Any INCOMPLETE field makes <code>ready=false</code>: a draft with gaps must not enter the hand-off.</li> <li>The tool never guesses mechanically-undeterminable fields:</li> <li><code>business-logic-to-keep</code> and <code>legacy-removal-recovery</code> are always INCOMPLETE and must be provided by a human owner; the tool has no basis to derive them;</li> <li><code>foundation-binding</code> is INCOMPLETE when no migration manifest declares (<code>foundationPackages</code>) it, counting only the manifest-declared binding;</li> <li><code>verification-entries</code> is INCOMPLETE when any of the four classes of evidence (unit/integration/consumer/independentAudit) is not proven.</li> </ul>"},{"location":"en/migration/#Binding","title":"Binding","text":"<p>The draft carries a dual sha256 digest (the <code>binding</code> block): <code>targetSetDigest</code> summarizes the target repository's file set, and <code>foundationPlanDigest</code> summarizes the Foundation plan write set. Two plans for the same target yield the same digest, precisely binding the draft and the target state at plan time.</p>"},{"location":"en/migration/#Rendering-Boundary","title":"Rendering Boundary","text":"<ul> <li>The renderer writes only the planner-side hand-off draft, never the consumer repository;</li> <li>No fifth Kit top-level command is added: Kit top-level commands are permanently the four \u2014 scaffold, adopt-plan, projection, check \u2014 and <code>handoffDraft</code> is only a sub-block of <code>adopt-plan</code> output.</li> </ul>"},{"location":"en/migration/#Hazard-Class-Fixtures","title":"Hazard-Class Fixtures","text":"<p><code>fixtures/adoption/cases/</code> covers seven hazard classes: dirty repository, nested repository, tracked-but-ignored, symlink placeholder, generated-artifact drift, legacy-implementation exit gate, and temporary-exception fields. Each case proves the plan is read-only via byte-level before/after snapshots; see the in-repo <code>fixtures/adoption/README.md</code> for case descriptions.</p>"},{"location":"en/recipes/","title":"English \u00b7 Recipes","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/#Recipe-Index","title":"Recipe Index","text":"<p>This directory provides the minimal, copy-paste-runnable approach for common architecture requirements. Each recipe follows a fixed nine-section structure: scenario and non-scenario, architecture choice and capability ID, preconditions and trust boundary, minimal code or command, expected output and evidence, safety/failure negative case, copy-paste verification command, business logic the caller continues to own, and upgrade/rollback notes.</p>"},{"location":"en/recipes/#Selection-Rules","title":"Selection Rules","text":"<ul> <li>Requirement contains domain semantics / state machine / audit oracle \u2192 keep with the consumer; do not look for a Foundation capability here.</li> <li>Need structure or protocol validation \u2192 see <code>domain-schema-validation</code>.</li> <li>Need safe file access or atomic write \u2192 see <code>safe-filesystem-and-atomic-write</code>.</li> <li>Need a deterministic human report \u2192 see <code>deterministic-human-report</code>.</li> <li>Need durable events and derived snapshots \u2192 see <code>durable-local-state</code>.</li> <li>Need an existing-repository adoption inventory \u2192 see <code>adopt-existing-repository</code>.</li> <li>Need a text-resource closure or host access \u2192 see <code>adapter-text-closure</code> / <code>host-profile-integration</code>.</li> <li>Need to trial Quickstart Profile v2 \u2192 pin the 0.3.0 candidate subpaths of all three packages exactly; remain on exactly 0.2.1 when v1 is still required.</li> </ul>"},{"location":"en/recipes/#Common-Verification-Conventions","title":"Common Verification Conventions","text":"<ul> <li>All examples run in a new system temp directory, leaving no personal paths or credentials.</li> <li>Examples contain no enterprise identifiers, private Profiles, real business data, or personal paths.</li> <li>Each recipe gives at least one positive case and one negative case; the negative case must produce a stable failure code or refusal.</li> <li>Verification commands can be copied and run directly; when a package is needed, first <code>npm install</code> the corresponding <code>@0.3.0</code>.</li> </ul>"},{"location":"en/recipes/#Capability-ID-Overview","title":"Capability ID Overview","text":"Recipe Preferred capability ID adopt-existing-repository <code>foundation.kit.adopt-plan</code> safe-filesystem-and-atomic-write <code>foundation.harness.path-containment</code>, <code>foundation.harness.atomic-write</code> domain-schema-validation <code>foundation.contracts.object-validation</code> adapter-text-closure <code>foundation.harness.resource-closure</code>, <code>foundation.harness.host-adapter</code> deterministic-human-report <code>foundation.harness.report</code>, <code>foundation.kit.report</code> durable-local-state <code>foundation.harness.state-store</code> host-profile-integration <code>foundation.kit.host</code>, <code>foundation.profile.extension-spi</code>"},{"location":"en/recipes/adapter-text-closure/","title":"English \u00b7 Adapter text closure","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/adapter-text-closure/#Recipe-Text-Resource-Closure-and-Host-Build","title":"Recipe: Text Resource Closure and Host Build","text":""},{"location":"en/recipes/adapter-text-closure/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to normalize a set of text resources into a recomputable closure, and based on it materialize a host-adapter build at a contained location, with the build manifest fully digest-verifiable.</p> <p>Not applicable: needs to include binary resources in the adapter projection (text closure only); needs host apply/install/update/uninstall (explicitly unsupported).</p>"},{"location":"en/recipes/adapter-text-closure/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.harness.resource-closure</code> (deterministic closure and sha256 digest) and <code>foundation.harness.host-adapter</code> (adapter source closure / build / manifest verification / materialize).</p>"},{"location":"en/recipes/adapter-text-closure/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The adapter source is a declared text closure (<code>content</code> accepts only string, utf8).</li> <li>Trust boundary: materialize uses sibling staging + a single rename, and refuses if the target already exists; probe does not spawn by default and does not walk PATH.</li> </ul>"},{"location":"en/recipes/adapter-text-closure/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import {\n computeResourceClosure,\n buildAdapterClosure,\n verifyAdapterBuildManifest,\n materializeAdapterBuild,\n} from \"skill-family-harness-node\";\n\nconst closure = computeResourceClosure([\n { path: \"skill.json\", content: \"{}\" },\n { path: \"readme.md\", content: \"# demo\" },\n]);\nconst built = buildAdapterClosure(closure);\nverifyAdapterBuildManifest(built.manifest); // fully digest-verifiable\nawait materializeAdapterBuild(built, { outDir: \"./out\" }); // contained write to disk\n</code></pre> <p>The code above shows the order of first computing the closure, then verifying the manifest, then atomically materializing.</p>"},{"location":"en/recipes/adapter-text-closure/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>computeResourceClosure</code> returns a deterministic closure object and a sha256 digest; <code>materializeAdapterBuild</code> writes the artifact at the contained target. Evidence: <code>packages/skill-family-harness-node/test/closure.test.mjs</code> and <code>test/host.test.mjs</code>.</p>"},{"location":"en/recipes/adapter-text-closure/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: binary content unsupported -> verification/build refusal\nbuildAdapterClosure({ path: \"x.bin\", content: Buffer.from([0, 1, 2]) });\n// throws HarnessError: adapter source content supports string (utf8) only\n</code></pre> <p>A manifest-digest mismatch, an already-existing target, or a non-trusted executable file also throw.</p>"},{"location":"en/recipes/adapter-text-closure/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/closure.test.mjs \\\n packages/skill-family-harness-node/test/host.test.mjs\n</code></pre>"},{"location":"en/recipes/adapter-text-closure/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>The host's concrete business semantics.</li> <li>Host-difference declarations are injected via Profile + Kit host sub-action.</li> </ul>"},{"location":"en/recipes/adapter-text-closure/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>host apply is stably refused, and install/uninstall/update are unimplemented; the full Qoder driver is unsupported.</li> <li>materialize is an atomic sibling + rename, and on failure does not affect the existing target; upgrade follows the <code>skill-family-harness-node</code> version.</li> </ul>"},{"location":"en/recipes/adopt-existing-repository/","title":"English \u00b7 Adopt an existing repository","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/adopt-existing-repository/#Recipe-Existing-Repository-Read-Only-Adoption-Inventory","title":"Recipe: Existing-Repository Read-Only Adoption Inventory","text":""},{"location":"en/recipes/adopt-existing-repository/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to judge whether an existing repository can adopt Foundation, and obtain the exact write set, conflicts, and legacy-implementation exit list, without changing any bytes.</p> <p>Not applicable: needs to auto-rewrite the existing repository (writing files is forbidden, auto-migration is forbidden); needs to publish to a remote (\u2192 release-skill).</p>"},{"location":"en/recipes/adopt-existing-repository/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capability: <code>foundation.kit.adopt-plan</code> (strictly read-only inventory and completion judgment). It only outputs, writes no files, runs no git write commands.</p>"},{"location":"en/recipes/adopt-existing-repository/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The target repository exists and is read-only accessible.</li> <li>Trust boundary: <code>adopt-plan</code> makes zero byte changes to the input repository; legacy-implementation deletion is the caller's responsibility, and the tool never deletes on its behalf.</li> </ul>"},{"location":"en/recipes/adopt-existing-repository/#4-Minimal-Command","title":"4. Minimal Command","text":"<pre><code>npm install --save-dev skill-family-engineering-kit@0.3.0\nnpm exec -- skill-family-kit adopt-plan --root <repo>\n</code></pre>"},{"location":"en/recipes/adopt-existing-repository/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p>The output includes the current state (<code>target</code>), target Profile and traceability (<code>project</code>/<code>traceability</code>), read-only Git pre-state (<code>git</code>), exact write set (<code>writeSet</code>), conflicts (<code>conflicts</code>), risks (<code>risks</code>), migration state machine (<code>migration</code>), and acceptance command sequence (<code>verificationPlan</code>). Evidence from <code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code> and <code>test/migration.test.mjs</code>.</p>"},{"location":"en/recipes/adopt-existing-repository/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<p>Before and after running <code>adopt-plan</code> on a dirty repository, the input repository's bytes must be exactly identical (provable by hash walk-through); the tool writes no temp files and touches no remote. If the migration manifest is missing a required <code>exceptions</code> field, the plan fails directly (completion false), and the tool does not renew.</p>"},{"location":"en/recipes/adopt-existing-repository/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code># Positive case: read-only inventory of a public fixture existing-repository\nnpm exec -- skill-family-kit adopt-plan --root fixtures/m0-consumer\n\n# Read-only diagnostics, no fix\nnpm exec -- skill-family-kit check --root fixtures/m0-consumer\n</code></pre>"},{"location":"en/recipes/adopt-existing-repository/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Whether the legacy implementation exits, and when to delete it (the tool only evaluates existence and lists the exit manifest).</li> <li><code>business-logic-to-keep</code> and <code>legacy-removal-recovery</code> are always INCOMPLETE and must be provided by a human owner.</li> </ul>"},{"location":"en/recipes/adopt-existing-repository/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li><code>adopt-plan</code> is read-only, has no write risk, and needs no rollback.</li> <li>Actual disk writes are performed by <code>scaffold</code>/<code>projection</code>; rollback relies on the dual-digest binding of <code>adoptionProof</code> and <code>foundationPlanDigest</code>; an overwrite action that does not declare the <code>expect.sha256</code> pre-state is refused at the <code>projection</code> stage.</li> <li>When adopting the Quickstart Profile candidate, pin all three packages to one profile: 0.3.0 for v2 or 0.2.1 for v1. Do not mix them.</li> </ul>"},{"location":"en/recipes/deterministic-human-report/","title":"English \u00b7 Deterministic human report","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/deterministic-human-report/#Recipe-Deterministic-Human-Report","title":"Recipe: Deterministic Human Report","text":""},{"location":"en/recipes/deterministic-human-report/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to deterministically render machine results into a human-readable report (Markdown + digest binding + graded checks), writing the paired dual outputs as a group and refusing path aliases and input overwrites.</p> <p>Not applicable: needs to freely author a report from open business outputs (forbidden); needs model invocation or business orchestration.</p>"},{"location":"en/recipes/deterministic-human-report/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.harness.report</code> (validate \u2192 render \u2192 bind \u2192 check, pure functions) and <code>foundation.kit.report</code> (CLI sub-action orchestrating rendering and grading).</p>"},{"location":"en/recipes/deterministic-human-report/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>A Contracts-validated report-model and operation-result already exist.</li> <li>Trust boundary: deterministic Markdown escaping; a three-digest binding of model/result/report; the caller must first construct a valid model, and Kit does not derive facts from business outputs.</li> </ul>"},{"location":"en/recipes/deterministic-human-report/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import {\n validateReportModel,\n renderReportMarkdown,\n buildBinding,\n checkReport,\n} from \"skill-family-harness-node\";\n\nvalidateReportModel(model);\nconst markdown = renderReportMarkdown(model, { locale: \"zh-CN\" });\nconst binding = buildBinding(model, result, markdown);\nconst graded = checkReport(model, result, markdown, binding); // graded check findings\n</code></pre> <p>The code above shows the four-step order of model validation, rendering, binding, and graded check.</p>"},{"location":"en/recipes/deterministic-human-report/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>renderReportMarkdown</code> returns deterministic Markdown; <code>buildBinding</code> produces the three-digest binding; <code>checkReport</code> returns graded check findings. Evidence: <code>packages/skill-family-harness-node/test/report.test.mjs</code> and <code>packages/skill-family-engineering-kit/test/report.test.mjs</code>.</p>"},{"location":"en/recipes/deterministic-human-report/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: report bytes deviate from deterministic re-render -> SFC3003 (REPORT_FACT_DRIFT)\n// after manually editing markdown then bind/check, the digest mismatch fails\ncheckReport(model, result, tamperedMarkdown, binding);\n// throws HarnessError, errorCode = \"SFC3003\"\n</code></pre> <p><code>SFC3001</code> (digest mismatch) and <code>SFC3002</code> (missing mandatory element) are likewise hard failures.</p>"},{"location":"en/recipes/deterministic-human-report/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/report.test.mjs \\\n packages/skill-family-engineering-kit/test/report.test.mjs\n</code></pre>"},{"location":"en/recipes/deterministic-human-report/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Interpretation of the report's business conclusions.</li> <li>The caller must first construct a valid report-model (Kit does not derive facts from business outputs).</li> </ul>"},{"location":"en/recipes/deterministic-human-report/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The report is deterministically rendered from machine results, not freely authored; upgrade follows the <code>skill-family-harness-node</code> and <code>skill-family-engineering-kit</code> versions.</li> <li>The paired dual outputs are written as a group, refusing path aliases and input overwrites; rollback restores from the <code>expect.sha256</code> pre-state written before the write.</li> </ul>"},{"location":"en/recipes/domain-schema-validation/","title":"English \u00b7 Domain Schema validation","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/domain-schema-validation/#Recipe-Domain-Agnostic-Contract-Object-Validation","title":"Recipe: Domain-Agnostic Contract Object Validation","text":""},{"location":"en/recipes/domain-schema-validation/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to validate whether a document conforms to a Foundation-registered contract object (e.g., project-manifest), choosing a validation strategy by dialect.</p> <p>Not applicable: needs to validate the consumer's own business Schema (the consumer should hold it itself; Foundation does not replace it); needs to mix domain-semantic validation into the generic contract.</p> <p>Quickstart Profile v2 is a separate candidate path. The consumer still owns its business schemas; Engineering Kit only compiles an explicit schema collection into offline validators selected by <code>$id</code>, and does not own the method-to-schema choice.</p>"},{"location":"en/recipes/domain-schema-validation/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capability: <code>foundation.contracts.object-validation</code> (<code>validateDocument</code> / <code>compileSchema</code> / <code>detectDialect</code>). A pure Ajv implementation, supporting draft-07 and 2020-12.</p>"},{"location":"en/recipes/domain-schema-validation/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The document to be validated carries the <code>$id</code> of a registered contract object.</li> <li>Trust boundary: <code>validateDocument</code> never modifies the caller's input; a normalized copy is returned only in the result's <code>data</code> field.</li> </ul>"},{"location":"en/recipes/domain-schema-validation/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import { validateDocument } from \"skill-family-contracts\";\n\nconst document = {\n schemaVersion: 1,\n kind: \"skill-family.project-manifest\",\n project: { id: \"my-project\", name: \"My Project\", description: \"Example\" },\n contracts: { version: \"1.0.0\", profile: \"generic\" },\n managedFiles: [\"package.json\"],\n updatedAt: \"2026-01-01T00:00:00Z\",\n};\n\nconst result = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/project-manifest.json\",\n dialect: \"2020-12\",\n});\nif (!result.valid) console.error(result.errorCode);\n</code></pre> <p>The code above shows using <code>$id</code> to specify the target Schema and retrieving <code>{ valid, errorCode, errors, data }</code>.</p>"},{"location":"en/recipes/domain-schema-validation/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p>On successful validation <code>result.valid</code> is true; on failure <code>errorCode</code> is a stable code such as <code>SFC1001</code>. Evidence: <code>packages/skill-family-contracts/test/validator.test.mjs</code> and <code>test/schemas.test.mjs</code>.</p>"},{"location":"en/recipes/domain-schema-validation/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: unknown $id -> returns valid:false, errorCode = SFC1002 (UNKNOWN_SCHEMA_ID)\nconst bad = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/does-not-exist.json\",\n dialect: \"2020-12\",\n});\n// does not throw, returns a structured result:\n// { valid: false, errorCode: \"SFC1002\",\n// errors: [{ message: \"unknown schema $id: https://contracts.skill-family.example/v1/does-not-exist.json\" }] }\nif (!bad.valid) console.error(bad.errorCode); // SFC1002\n</code></pre>"},{"location":"en/recipes/domain-schema-validation/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-contracts/test/validator.test.mjs \\\n packages/skill-family-contracts/test/schemas.test.mjs\n</code></pre>"},{"location":"en/recipes/domain-schema-validation/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Semantic interpretation of specific business fields.</li> <li>Domain-level validation rules (not within the Foundation generic contract).</li> </ul>"},{"location":"en/recipes/domain-schema-validation/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The contract authority version <code>CONTRACTS_VERSION = 1.4.0</code>, and the npm package version <code>0.3.0</code> run in parallel and are not mixed.</li> <li>Error codes are frozen and do not drift; Schema changes are handled as a new contract-version task, not by modifying frozen content in place.</li> <li>Candidate v2 must be pinned to exactly 0.3.0; integrations that still require v1 must remain pinned to exactly 0.2.1.</li> </ul>"},{"location":"en/recipes/durable-local-state/","title":"English \u00b7 Durable local state","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/durable-local-state/#Recipe-Durable-Local-State-Substrate","title":"Recipe: Durable Local State Substrate","text":""},{"location":"en/recipes/durable-local-state/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to persist an event log while guaranteeing order and integrity, rebuild or verify a derived snapshot, and inspect or recover a cooperative single-writer lock.</p> <p>Not applicable: needs to define a workflow state machine in Foundation (forbidden); needs to resist same-privilege malicious processes (fencing does not promise this scenario).</p>"},{"location":"en/recipes/durable-local-state/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capability: <code>foundation.harness.state-store</code> (append-only events, hash chain, snapshot, and lock inspect/recover). Event meaning and reducer transitions are owned by the caller.</p>"},{"location":"en/recipes/durable-local-state/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li><code>STATE_GENESIS_DIGEST</code> as the chain starting point.</li> <li>Trust boundary: the event log is the sole authority, and the snapshot is a derived cache; <code>confirmOwnerTerminated</code> is an external trust anchor provided by the caller and does not promise resistance against same-privilege malicious processes.</li> </ul>"},{"location":"en/recipes/durable-local-state/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n openStateStore,\n appendEvent,\n readEvents,\n writeSnapshot,\n readSnapshot,\n inspectStateStoreLock,\n recoverStateStoreLock,\n} from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-state-\"));\nconst store = openStateStore(root, { owner: \"writer-a\", expectedSchemas: [] });\nappendEvent(store, { eventType: \"demo\", payload: { n: 1 } });\nwriteSnapshot(store, readEvents(store));\nconst snap = readSnapshot(store);\nconst lock = inspectStateStoreLock(root); // { owner, fencing, ageMs, recovering }\nawait recoverStateStoreLock(root, {\n expectedOwner: lock.owner,\n expectedFencing: lock.fencing,\n confirmOwnerTerminated: true,\n});\n</code></pre> <p>The code above shows the order of opening the store, appending events, writing a snapshot, inspecting the lock, and explicitly recovering.</p>"},{"location":"en/recipes/durable-local-state/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>readEvents</code> returns the appended events, <code>readSnapshot</code> returns the derived snapshot, and <code>inspectStateStoreLock</code> returns <code>owner</code>/<code>fencing</code>/<code>ageMs</code>/<code>recovering</code>. Evidence: <code>packages/skill-family-harness-node/test/state-store.test.mjs</code> (with 34 assertions).</p>"},{"location":"en/recipes/durable-local-state/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: a second writer immediately receives store-locked\nconst other = openStateStore(root, { owner: \"writer-b\", expectedSchemas: [] });\n// throws HarnessError: details.kind = \"store-locked\"\n</code></pre> <p>A broken hash chain, a mismatched lock fencing, or recovery missing <code>confirmOwnerTerminated</code> all fail-closed.</p>"},{"location":"en/recipes/durable-local-state/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/state-store.test.mjs\n</code></pre>"},{"location":"en/recipes/durable-local-state/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Event business meaning, reducer transitions.</li> <li>The <code>confirmOwnerTerminated</code> trust anchor (confirm outside Foundation that the old writer has terminated).</li> </ul>"},{"location":"en/recipes/durable-local-state/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The state substrate provides only the mechanism; the business state machine / terminal state belongs to loop-agent.</li> <li>A crash-left lock requires external evidence-gathering before explicit recovery, with no silent lock-stealing; the system stays diagnosable as a lock-out rather than silently overwriting.</li> </ul>"},{"location":"en/recipes/host-profile-integration/","title":"English \u00b7 Host Profile integration","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/host-profile-integration/#Recipe-Host-Access-and-Profile-Injection","title":"Recipe: Host Access and Profile Injection","text":""},{"location":"en/recipes/host-profile-integration/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to describe a registered host (claude/codex), probe or plan host access, and inject a concrete host Profile and trusted driver into Foundation.</p> <p>Not applicable: needs host apply/install/update/uninstall (explicitly unsupported); needs the full Qoder driver (that host is unsupported).</p>"},{"location":"en/recipes/host-profile-integration/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.kit.host</code> (<code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code>) and <code>foundation.profile.extension-spi</code> (<code>verifyProfile</code>). Host-difference declarations are in <code>foundation.profile.hosts</code>.</p>"},{"location":"en/recipes/host-profile-integration/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The host Profile is registered in <code>profiles/hosts</code>; the only trusted drivers are <code>claude-version-v1</code> / <code>codex-version-v1</code>.</li> <li>Trust boundary: the Profile entry point must be a JSON data resource, and the public core does not import <code>profiles/</code>; <code>coreOwned</code> is a forbidden target.</li> </ul>"},{"location":"en/recipes/host-profile-integration/#4-Minimal-Command-and-Code","title":"4. Minimal Command and Code","text":"<pre><code># Describe a registered host\nnpm exec -- skill-family-kit adopt-plan host-describe --host claude --hosts-root profiles/hosts\n\n# Read-only probe (no spawn by default)\nnpm exec -- skill-family-kit adopt-plan host-probe --host claude --hosts-root profiles/hosts\n</code></pre> <pre><code>import { describeHost, probeHost, planHost } from \"skill-family-engineering-kit\";\nimport { verifyProfile } from \"profiles/spi/index.mjs\";\n\nconst desc = describeHost(\"claude\"); // supported host description\nconst facts = probeHost(\"claude\", { allowSpawn: false });\nconst plan = planHost(desc, facts);\nconst spi = verifyProfile({ profileRoot: \"profiles/public-plugin\" }); // SPE0000\n</code></pre> <p>The command and code above show the read-only describe/probe/plan mechanism, and using <code>verifyProfile</code> to validate the Profile declaration.</p>"},{"location":"en/recipes/host-profile-integration/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>describeHost</code> returns the host description, <code>probeHost</code> returns read-only probe facts, <code>planHost</code> returns the access plan, and <code>verifyProfile</code> returns result codes such as <code>SPE0000</code>. Evidence: <code>packages/skill-family-engineering-kit/test/host.test.mjs</code> and <code>fixtures/generic-profile-extension-conformance/verify.mjs</code>.</p>"},{"location":"en/recipes/host-profile-integration/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code># Negative case: apply stably refused\nnpm exec -- skill-family-kit adopt-plan host-apply --host claude --hosts-root profiles/hosts\n# exit code 2: host apply is not implemented in the read-only Phase D slice\n</code></pre> <pre><code>// Negative case: qoder is unsupported\ndescribeHost(\"qoder\"); // throws: support = \"unsupported\"\n</code></pre>"},{"location":"en/recipes/host-profile-integration/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-engineering-kit/test/host.test.mjs \\\n fixtures/generic-profile-extension-conformance/verify.mjs\n</code></pre>"},{"location":"en/recipes/host-profile-integration/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>The host's concrete business semantics.</li> <li>The final landing of host apply (currently outside Foundation's scope).</li> </ul>"},{"location":"en/recipes/host-profile-integration/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>The host-access line supports only describe/build/probe/plan; apply is stably refused, and install/uninstall/update are unimplemented.</li> <li>The full Qoder driver is unsupported; only its structure is referenced, and it is not claimed to have been run on Qoder; adding a supported host on upgrade requires registering a descriptor and binding a trusted driver.</li> </ul>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/","title":"English \u00b7 Safe filesystem and atomic write","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#Recipe-Safe-File-Access-and-Atomic-Write","title":"Recipe: Safe File Access and Atomic Write","text":""},{"location":"en/recipes/safe-filesystem-and-atomic-write/#1-Scenario-and-Non-Scenario","title":"1. Scenario and Non-Scenario","text":"<p>Applicable: you need to constrain, within Node, an externally-provided path to within some root directory, and atomically write an ordinary file to a contained path, rolling back on failure without leaving residue.</p> <p>Not applicable: needs to put file-selection business rules into Foundation (business rules are owned by the caller); needs to write to an uncontained path.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#2-Architecture-Choice-and-Capability-ID","title":"2. Architecture Choice and Capability ID","text":"<p>Preferred capabilities: <code>foundation.harness.path-containment</code> (path classification and contained resolution) and <code>foundation.harness.atomic-write</code> (atomic write within contained paths). Both implement only the mechanism, owning no semantics.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#3-Preconditions-and-Trust-Boundary","title":"3. Preconditions and Trust Boundary","text":"<ul> <li>The caller provides an explicit root directory (containment boundary).</li> <li>Trust boundary: all resolution results must fall within the root directory; out-of-bounds, symlink escape, and realpath escape are all refused.</li> </ul>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#4-Minimal-Code","title":"4. Minimal Code","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { resolveContained, writeFileAtomic } from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-safe-\"));\nconst target = resolveContained(root, \"nested/config.json\"); // contained absolute path\nawait writeFileAtomic(target, JSON.stringify({ ok: true }));\n</code></pre> <p>The code above shows the basic order of first containing the path, then atomically writing; <code>writeFileAtomic</code> uses temp-file + fsync + rename, rolling back on failure.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#5-Expected-Output-and-Evidence","title":"5. Expected Output and Evidence","text":"<p><code>resolveContained</code> returns an absolute path within the root; <code>writeFileAtomic</code> writes the completed file, whose bytes are consistent with the input. Evidence: <code>packages/skill-family-harness-node/test/containment.test.mjs</code> and <code>test/atomic.test.mjs</code>.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#6-Safety--Failure-Negative-Case","title":"6. Safety / Failure Negative Case","text":"<pre><code>// Negative case: attempting to escape the root -> SFC2004 (path-traversal)\nimport { resolveContained } from \"skill-family-harness-node\";\nresolveContained(root, \"../escape.json\"); // throws HarnessError, details.kind = \"path-traversal\"\n</code></pre> <p>Out-of-bounds, symlink-escape, and realpath-escape all map to <code>SFC2004</code> with a stable <code>details.kind</code>; atomic write throws on an out-of-bounds path or illegal data type and rolls back the temp file.</p>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#7-Copy-Paste-Verification-Command","title":"7. Copy-Paste Verification Command","text":"<pre><code>node --test packages/skill-family-harness-node/test/containment.test.mjs \\\n packages/skill-family-harness-node/test/atomic.test.mjs\n</code></pre>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#8-Business-Logic-the-Caller-Continues-to-Own","title":"8. Business Logic the Caller Continues to Own","text":"<ul> <li>Which paths are business-allowed selection rules (not within Foundation).</li> <li>The business correctness of the written content.</li> </ul>"},{"location":"en/recipes/safe-filesystem-and-atomic-write/#9-Upgrade-and-Rollback-Notes","title":"9. Upgrade and Rollback Notes","text":"<ul> <li>Path containment and atomic write are contained mechanisms; on failure they roll back without leaving half-products, so no external rollback is needed.</li> <li>Upgrade follows the <code>skill-family-harness-node</code> version; <code>HARNESS_EXCLUSIONS</code> introduces no remote or git writes.</li> </ul>"},{"location":"en/reference/compatibility/","title":"English \u00b7 Compatibility","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/reference/compatibility/#Compatibility-and-Support-Matrix","title":"Compatibility and Support Matrix","text":"<p>This page gives the support matrix and upgrade rules for packages, Contracts, Node, and hosts. All version numbers are recomputed from the machine source of truth, not from memory.</p>"},{"location":"en/reference/compatibility/#Package-Version-Matrix","title":"Package Version Matrix","text":"Package Version (package.json) Role Release status <code>skill-family-contracts</code> 0.3.0 Contracts 1.4.0 machine contracts Public release target (private: false) <code>skill-family-harness-node</code> 0.3.0 Node thin-mechanism runtime of Contracts Public release target <code>skill-family-engineering-kit</code> 0.3.0 Four engineering commands (CLI <code>skill-family-kit</code>) Public release target Workspace repository 0.3.0 Private parent workspace (private: true) Development source of truth only <p>The contract authority version (<code>CONTRACTS_VERSION</code>) is <code>1.4.0</code>, and the npm package version is <code>0.3.0</code>; the two version lines run in parallel and are not mixed.</p>"},{"location":"en/reference/compatibility/#Quickstart-Profile-Candidate-Compatibility","title":"Quickstart Profile Candidate Compatibility","text":"Package version Candidate profile Compatibility rule 0.2.1 v1 Existing integrations may remain pinned to exactly 0.2.1 0.3.0 v2 Uses <code>execute-method</code>, real <code>$id</code> schema resolution, and the offline Bundle; pin exactly 0.3.0 <p>Version 2 replaces v1 and provides no dual-track compatibility layer. Stable Contracts 1.4.0, the 18 object classes, the kernel protocol, and the error-code registry do not change with the candidate profile.</p>"},{"location":"en/reference/compatibility/#Node-Support-Matrix","title":"Node Support Matrix","text":"<ul> <li>Engine requirement: <code>>=22.22.2 <23</code> (major 22 locked).</li> <li>Exact floor: <code>.node-version</code> takes <code>22.22.2</code>, as the mechanical source of truth for runtime version determination.</li> <li>pnpm: <code>10.30.0</code> (the <code>packageManager</code> in <code>package.json</code>).</li> <li>projen: <code>0.101.23</code> (the sole generation entry point for managed engineering files).</li> </ul> <p>A Node version below the floor cannot substitute for the authoritative result; first-version implementations in a second language: 0.</p>"},{"location":"en/reference/compatibility/#Contracts-Version-and-Stability","title":"Contracts Version and Stability","text":"<ul> <li>Top-level objects: 18 kinds (with <code>packages/skill-family-contracts/src/registry.json</code> as the sole source of truth).</li> <li>Mandatory mechanical rules: 9, budget ceiling 20, absolute ceiling 30.</li> <li>kernel protocol: <code>skill-family.kernel.operation</code> (stable), Contracts 1.4.0.</li> <li>Schema validator: Ajv 8.20.0 (exact pin), supporting draft-07 and 2020-12.</li> <li>Error codes: a frozen registry; codes only increase, never change or get reused.</li> </ul>"},{"location":"en/reference/compatibility/#Host-Support-Matrix","title":"Host Support Matrix","text":"Host support driver Notes claude supported claude-version-v1 Skill path is determined by the Profile codex supported codex-version-v1 Skill path fixed at <code>.agents/skills</code> qoder unsupported none No auditable non-interactive host driver is frozen <p>The host-access line currently supports only <code>describe</code>/<code>build</code>/<code>probe</code>/<code>plan</code>; <code>apply</code> is stably refused, and install/uninstall/update are unimplemented.</p>"},{"location":"en/reference/compatibility/#Upgrade-Rules","title":"Upgrade Rules","text":"<ul> <li>Package version: the three leaf packages must synchronize versions; single-package drift is forbidden; a new component must justify that deleting it would force two or more real consumers to re-implement it.</li> <li>Contracts: the object set is fixed at 18 kinds; additions require an ADR; error codes are frozen and do not drift; Schema changes are handled as a new contract-version task.</li> <li>Kit commands: top-level commands are fixed at 4 (scaffold/adopt-plan/projection/check), not expanded; <code>REFUSED_MUTATION_FLAGS</code> are refused at the CLI entry point.</li> <li>Node/pnpm/projen: follow the exact locks in <code>.foundation/version-lock.json</code> and <code>package.json</code>; upgrades require re-generating the managed projection via <code>pnpm synth</code>.</li> <li>Host: adding a supported host requires registering a descriptor and binding a trusted driver; unsupported hosts (e.g., qoder) are only referenced structurally and not claimed to have been run on.</li> <li>Candidate: a later minor version may change or remove a candidate subpath; do not mix the 0.2.1 v1 packages with the 0.3.0 v2 packages, and pin all three package versions exactly.</li> </ul>"},{"location":"en/reference/compatibility/#Anti-Compatibility-Boundaries-Explicitly-Unsupported","title":"Anti-Compatibility Boundaries (Explicitly Unsupported)","text":"<ul> <li>host apply / install / update / uninstall (unsupported).</li> <li>Full Qoder driver (unsupported).</li> <li>Binary adapter source (text closure only).</li> <li>Remote publishing and all remote writes (\u2192 release-skill).</li> <li>Business state machine, model orchestration, domain-audit semantics (\u2192 consumer / loop-agent / independent audit respectively).</li> </ul>"},{"location":"en/reference/failure-and-side-effect-matrix/","title":"English \u00b7 Failures and side effects","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Failure-and-Side-Effect-Matrix","title":"Failure and Side-Effect Matrix","text":"<p>This page lists, per public entry point, read/write, spawn, Git, network, residual state, and stable error codes. It serves callers judging risk before integrating, and is the human-readable projection of the <code>sideEffects</code> and <code>failureSemantics</code> fields in <code>capability-catalog.json</code>. All facts are based on the real implementation and negative tests.</p> <p>Symbol convention: read = reads the filesystem; write = writes the filesystem; spawn = launches a subprocess; Git = reads/writes Git; network = accesses a remote; residual = state still left on disk/in-process after the call ends.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Contracts-Pure-Function-Layer","title":"Contracts (Pure-Function Layer)","text":"Entry read write spawn Git network residual state stable error code <code>validateDocument</code> no no no no no none (compile cache memory-resident only) <code>SFC1001</code>/<code>SFC1002</code>/<code>SFC1006</code> <code>compileSchema</code> / <code>detectDialect</code> no no no no no none <code>SFC1006</code>/<code>SFC1012</code> <code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code> no no no no no none <code>SFC1003</code>/<code>SFC1004</code> <code>runChecks</code> / <code>collectUnresolvedRefs</code> no no no no no none <code>SFC1002</code>\u2013<code>SFC1010</code> <code>verifyAllFixtures</code> / <code>verifyFixture</code> no no no? no no no none <code>SFC1010</code> <code>ERROR_CODES</code> / <code>stableError</code> no no no no no none frozen registry, no additions <p>Contracts are all pure functions, with no file/Git/network/process side effects; error objects contain <code>stableError</code> and <code>details.kind</code> for easy caller classification.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Harness-Mechanism-Layer-Contained","title":"Harness (Mechanism Layer, Contained)","text":"Entry read write spawn Git network residual state stable error code <code>validateContractDocument</code> no no no no no none (validator cache in memory) <code>SFC</code> validation failure <code>resolveContained</code> / <code>readFileContained</code> yes (read-only) no no no no none <code>SFC2004</code> (<code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>) <code>writeFileAtomic</code> no yes (contained) no no no failed rollback temp file <code>SFC2004</code> (<code>atomic-write-failed</code>) <code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code> no yes (temp directory) no no no temp directory cleaned on exit <code>SFC2004</code> (<code>workspace-disposed</code>) <code>computeResourceClosure</code> / <code>digestBytes</code> no no no no no none <code>SFC</code> (declaration/content violation) <code>parseRequest</code> / <code>processRequest</code> no no no no no none (pure-function pipeline) <code>SFC2004</code> <code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>checkReport</code> no no no no no none (pure function) <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code> no no no no no none <code>SFC2004</code> (<code>missing-resource</code>) <code>materializeAdapterBuild</code> no yes (contained, sibling + rename) no no no none (atomic rename) <code>SFC2004</code> <code>probeVersionVector</code> no no default no (requires explicit <code>--allow-host-spawn</code>) no no none <code>SFC2004</code> <code>openStateStore</code> / <code>appendEvent</code> / <code>readEvents</code> / <code>writeSnapshot</code> yes yes (event/snapshot/lock files) no no no event log + lock file <code>SFC2004</code> (<code>store-locked</code>/chain broken) <code>inspectStateStoreLock</code> / <code>recoverStateStoreLock</code> yes yes (recovery write-lock only) no no no lock file (monotonic fencing) <code>SFC2004</code> <p>Harness's <code>HARNESS_EXCLUSIONS</code> explicitly excludes release-state, remote-network-access, business-semantics, workflow-orchestration, model-calls, git-writes.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Engineering-Kit-Engineering-Command-Layer","title":"Engineering Kit (Engineering Command Layer)","text":"Entry read write spawn Git network residual state stable error code / exit code <code>scaffoldTarget</code> no yes (contained skeleton, atomic + contained) no no no none (no half-product on failure) <code>SFC2004</code> (<code>target-not-empty</code>) <code>planAdoption</code> / <code>buildHandoffDraft</code> yes no no read-only probe no none (stdout output) <code>SFC</code> completion false <code>runProjection</code> yes (reads manifest) yes (managed path, two-phase) no no no none (zero write/rollback on failure) <code>SFC2004</code> (<code>unauthorized-path</code>/<code>handwritten-overwrite</code>/<code>conflict-drift</code>) <code>runChecks</code> (<code>check</code>) yes no no read-only allowlist no none exit code 1 (findings) / 2 (mechanism) <code>renderReportAction</code> / <code>checkReportAction</code> yes only <code>--out</code>/<code>--binding</code> no no no default stdout only <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>probeGitState</code> / <code>probeGitFacts</code> yes no no read-only allowlist no none <code>SFC</code> (over-privileged parameter refused) <code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code> yes build writes (contained) probe default no no no none <code>SFC2004</code>; apply stably refused <code>loadLicensingProfile</code> / <code>generateLicenseContent</code> etc. no no (pure-function generation) no no no none <code>SFC</code> (illegal Profile) <code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code> yes no no no no none findings <code>cliMain</code> / <code>runCommand</code> per command per command per command per command no per command exit code 0/1/2 <p>Kit's <code>FORBIDDEN_SIDE_EFFECTS</code> includes git-init/commit/push/tag, publish, remote-write; <code>REFUSED_MUTATION_FLAGS</code> (including <code>--apply</code>) are refused at the CLI entry point.</p>"},{"location":"en/reference/failure-and-side-effect-matrix/#Residual-State-Collection","title":"Residual-State Collection","text":"<ul> <li>Atomic write: on failure, rolls back the temp file, leaving no half-product in the target directory.</li> <li>Temporary workspaces are cleaned on exit, including exception paths.</li> <li>State store: the event log is the sole authority, and the snapshot is a derived cache; a crash-left lock requires the caller, outside Foundation, to confirm the old writer has terminated before explicitly recovering; no silent lock-stealing.</li> <li>Projection: any validation failure rejects wholesale, zero writes; overwriting an existing file requires declaring the <code>expect.sha256</code> pre-state.</li> <li>adopt-plan / check: structurally read-only, byte-level zero change before and after running.</li> </ul>"},{"location":"en/reference/failure-and-side-effect-matrix/#What-the-Caller-Should-Do-After-Failure","title":"What the Caller Should Do After Failure","text":"<ul> <li>Validation failure (<code>SFC1001</code>/<code>SFC2002</code>/<code>SFC2003</code>): check whether the input satisfies the target Schema or parameter contract; do not retry a registration that has been frozen-refused.</li> <li>Containment failure (<code>SFC2004</code> + <code>path-traversal</code>, etc.): confirm whether the root directory and path are out of bounds; do not cram business-selection rules into Foundation.</li> <li>State-lock conflict (<code>store-locked</code>): outside Foundation, confirm the old writer has terminated, then call recovery with the exactly-matching owner/fencing.</li> <li>check findings (exit code 1): address the findings; Kit does not auto-fix.</li> </ul>"},{"location":"en/reference/api/","title":"English \u00b7 API reference","text":"<p>\u7b80\u4f53\u4e2d\u6587</p>"},{"location":"en/reference/api/#Public-API-Reference","title":"Public API Reference","text":"<p>This page is the English entry point for the public APIs of the three Foundation packages. It is a human-readable route into the machine facts in the capability catalog; package exports, schemas, protocols, and stable error codes remain authoritative.</p>"},{"location":"en/reference/api/#Choose-the-Owning-Layer","title":"Choose the Owning Layer","text":"Package Use it for Start with <code>skill-family-contracts</code> Object schemas, protocol registries, validation, stable error codes, fixtures, and deterministic audit surfaces <code>foundation.contracts.object-validation</code>, <code>foundation.contracts.registry-protocol</code>, <code>foundation.contracts.audit-surface</code> <code>skill-family-harness-node</code> Business-neutral Node mechanisms such as contained paths, atomic writes, subprocess requests, durable local state, and deterministic reports <code>foundation.harness.path-containment</code>, <code>foundation.harness.atomic-write</code>, <code>foundation.harness.state-store</code>, <code>foundation.harness.report</code> <code>skill-family-engineering-kit</code> The four engineering commands and controlled host/Profile integration <code>foundation.kit.scaffold</code>, <code>foundation.kit.adopt-plan</code>, <code>foundation.kit.projection</code>, <code>foundation.kit.check</code>, <code>foundation.kit.host-integration</code> <p>The dependency direction is Contracts \u2192 Harness \u2192 Engineering Kit. A Profile declares host or project-shape differences horizontally; public core code does not depend on a concrete Profile.</p>"},{"location":"en/reference/api/#Verified-Capability-Details","title":"Verified Capability Details","text":"<p>Use the following public data files before selecting an entry point:</p> <ol> <li>Core capability facts contain stable IDs, packages, layers, entry points, stability, source references, and test references.</li> <li>English capability explanations add intent, use and non-use conditions, inputs, outputs, failure semantics, caller ownership, and external routing for the same IDs.</li> <li>Catalog schema defines the closed structure of both files.</li> </ol> <p>The failure and side-effect matrix compares filesystem, process, Git, network, residual-state, and error behavior across public entry points. The architecture routing guide starts from design intent when the package or capability is not yet known.</p>"},{"location":"en/reference/api/#Key-Failure-Rules","title":"Key Failure Rules","text":"<ul> <li>Contracts document validation returns <code>{ valid: false, errorCode, errors }</code> for ordinary validation failures. Callers inspect <code>valid</code>; <code>validateDocument</code> does not turn those failures into exceptions.</li> <li>Harness mechanism failures use <code>SFC2004</code> (<code>EXECUTION_FAILED</code>) and distinguish the failure with a frozen <code>details.kind</code> value.</li> <li>Engineering Kit keeps exactly four top-level commands: <code>scaffold</code>, <code>adopt-plan</code>, <code>projection</code>, and <code>check</code>. Each command retains its documented read-only or controlled-write boundary.</li> <li>Candidate capabilities are marked <code>stability: candidate</code> in the catalog. Their presence in the public package does not promote them to the stable surface.</li> </ul>"},{"location":"en/reference/api/#Quickstart-Profile-v2-Candidate","title":"Quickstart Profile v2 Candidate","text":"<p>All three packages expose v2 through their existing candidate subpaths. Contracts defines the business-neutral <code>execute-method</code> exchange, Harness verifies bytes and bindings, and Kit turns explicit consumer schemas into an offline Bundle with standalone validators selected by schema <code>$id</code>. Version 0.3.0 candidate v2 is incompatible with the 0.2.1 candidate v1; consumers must pin the selected package versions exactly.</p>"},{"location":"en/reference/api/#Detailed-Package-Pages","title":"Detailed Package Pages","text":"<p>The current signature-level package pages are maintained in Chinese because they enumerate every verified export and test reference:</p> <ul> <li>Contracts API details</li> <li>Harness API details</li> <li>Engineering Kit API details</li> </ul> <p>These pages are part of the same public site and link to source and test evidence. The English catalog overlay provides the complete English intent and failure semantics for every capability, so an agent can route and design against Foundation without inferring meaning from the Chinese prose.</p>"},{"location":"en/reference/api/#Boundary","title":"Boundary","text":"<p>Foundation does not own domain schemas, business state machines, audit conclusions, task/retry orchestration, artifact relationships, or remote publishing. Keep those semantics with the caller, or route them to the external project named by the capability catalog.</p>"},{"location":"integration/audit/","title":"\u72ec\u7acb\u5ba1\u8ba1\u96c6\u6210\uff08FND-060\uff09","text":"<p>\u672c\u76ee\u5f55\u662f\u72ec\u7acb\u5ba1\u8ba1\uff08Audit\uff09\u6d88\u8d39\u5df2\u53d1\u5e03 Contracts \u7684\u6700\u5c0f\u96c6\u6210\u9762\u3002\u5ba1\u8ba1\u7684\u804c\u8d23\u662f\uff1a\u4ee5\u72ec\u7acb\u4e8e\u751f\u6210\u5668\u4e0e oracle \u7684 fixture\u3001\u9884\u671f\u503c\u548c\u88c1\u51b3\uff0c\u9a8c\u8bc1\u88ab\u6d88\u8d39\u7684 <code>skill-family-contracts</code> \u5305\u6ca1\u6709\u88ab\u7be1\u6539\u3001\u524a\u5f31\u6216\u6f0f\u68c0\u3002</p>"},{"location":"integration/audit/#\u6743\u5a01\u8fb9\u754c","title":"\u6743\u5a01\u8fb9\u754c","text":"<ul> <li>\u5ba1\u8ba1\u53ea\u6d88\u8d39 Contracts \u7684\u516c\u5f00\u63a5\u53e3\uff08<code>describeAuditSurface</code>\u3001<code>validateDocument</code>\u3001<code>checkOperation</code>\u3001<code>findProtocol</code>\u3001<code>isRegisteredErrorCode</code>\u3001<code>digestDocument</code> \u7b49\uff09\uff0c\u4f9d\u8d56\u65b9\u5411\u6052\u4e3a Audit \u2192 Contracts\uff1b</li> <li>\u5ba1\u8ba1\u4e0d\u4f9d\u8d56 engineering-kit\uff0c\u4e5f\u4e0d\u4f9d\u8d56 harness\uff08\u89c1 independence.md \u7684\u673a\u68b0\u8bc1\u660e\uff09\uff1b</li> <li>Contracts \u4e0d\u53cd\u5411\u4f9d\u8d56\u5ba1\u8ba1\uff1aContracts \u4fa7\u53ea\u65b0\u589e\u4e86\u53ea\u8bfb\u6295\u5f71\u6a21\u5757 <code>src/audit-surface.mjs</code>\uff0c\u4e0d\u63a5\u53d7\u4efb\u4f55\u56de\u8c03\u3001\u6ce8\u518c\u6216\u5ba1\u8ba1\u4fa7\u8f93\u5165\uff1b</li> <li>\u5ba1\u8ba1 fixture\u3001\u9884\u671f\u4e0e\u88c1\u51b3\u5168\u90e8\u7531\u4ea7\u54c1\u4fa7\u7ef4\u62a4\uff08\u5939\u5177 provenance <code>product-fixture</code>\uff0cpin provenance <code>product-compatibility-fixture</code>\uff09\uff0c\u4e0d\u590d\u7528\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\uff0c\u4e5f\u4e0d\u8bfb\u53d6 oracle \u5224\u636e\uff08\u8be5\u9694\u79bb\u7531 independence.md \u7684\u673a\u68b0\u8bc1\u660e\u5f3a\u5236\uff09\u3002</li> </ul>"},{"location":"integration/audit/#\u76ee\u5f55\u7ed3\u6784","title":"\u76ee\u5f55\u7ed3\u6784","text":"<pre><code>docs/integration/audit/\n README.md \u672c\u6587\u4ef6\n mutation-taxonomy.md \u4e94\u7c7b\u53d8\u5f02\u5206\u7c7b\u5b66\uff08\u51bb\u7ed3\uff09\n failure-evidence.md \u5931\u8d25\u8bc1\u636e\u683c\u5f0f\u4e0e AUD \u7801\u767b\u8bb0\u8868\n version-compatibility.md \u7248\u672c\u517c\u5bb9\u5b9a\u4e49\n isolation-and-lockfile.md \u9694\u79bb\u5b89\u88c5\u4e0e\u5305\u9501\u9a8c\u8bc1\u8bbe\u8ba1\n independence.md \u72ec\u7acb\u6027\u58f0\u660e\u4e0e\u673a\u68b0\u8bc1\u660e\n schemas/audit-evidence.schema.json \u8bc1\u636e\u6587\u6863\u7684 JSON Schema\uff08\u5ba1\u8ba1\u81ea\u6709\uff09\n baseline/contracts-1.5.0.pin.json Contracts 1.5.0 \u73b0\u884c\u57fa\u7ebf pin\uff08\u6458\u8981+\u4e8b\u5b9e\uff09\n baseline/contracts-1.1.1.pin.json Contracts 1.1.1 \u53ea\u8bfb\u517c\u5bb9\u5b58\u6863 pin\n baseline/contracts-1.1.0.pin.json Contracts 1.1.0 \u53ea\u8bfb\u517c\u5bb9\u5b58\u6863 pin\n baseline/contracts-1.0.0.pin.json Contracts 1.0.0 \u53ea\u8bfb\u517c\u5bb9\u5b58\u6863 pin\n baseline/audit-codes.json AUD \u7801\u767b\u8bb0\u8868\uff08append-only\uff09\n fixtures/{structure,semantics,digest,omission,engine}/ 18 \u4e2a\u53d8\u5f02 fixture\n runner/ \u5ba1\u8ba1\u8fd0\u884c\u5668\uff08\u53ea\u8bfb\uff0c\u8bc1\u636e\u8f93\u51fa\u5230 stdout\uff09\n</code></pre>"},{"location":"integration/audit/#\u8fd0\u884c","title":"\u8fd0\u884c","text":"<pre><code># \u5b8c\u6574\u7ba1\u7ebf\uff1a\u72ec\u7acb\u6027\u8bc1\u660e \u2192 \u5305\u9501\u9a8c\u8bc1 \u2192 \u53d8\u5f02\u91cd\u653e \u2192 \u6f0f\u62a5\u8d1f\u4f8b\u81ea\u68c0\nnode docs/integration/audit/runner/run-all.mjs\n\n# \u5206\u6b65\u8fd0\u884c\nnode docs/integration/audit/runner/proof-independence.mjs # \u72ec\u7acb\u6027\u673a\u68b0\u8bc1\u660e\nnode docs/integration/audit/runner/verify-lock.mjs # \u6d88\u8d39\u5305 pin/\u9501\u9a8c\u8bc1\nnode docs/integration/audit/runner/run-audit.mjs # \u53d8\u5f02\u91cd\u653e + \u8bc1\u636e\nnode docs/integration/audit/runner/selftest-negative.mjs # \u6f0f\u62a5\u8d1f\u4f8b\u63a7\u5236\n</code></pre> <p>\u9000\u51fa\u7801\u7ea6\u5b9a\uff1a<code>0</code> \u901a\u8fc7\uff1b<code>1</code> \u6709\u53d1\u73b0\uff08verdict fail\uff09\uff1b<code>2</code> \u7528\u6cd5\u6216\u673a\u5236\u9519\u8bef\u3002\u6240\u6709\u62a5\u544a\u4ee5 JSON \u8f93\u51fa\u5230 stdout\uff0c\u8fd0\u884c\u5668\u5bf9\u4ed3\u5e93\u96f6\u5199\u5165\u3002</p>"},{"location":"integration/audit/#\u88c1\u51b3\u89c4\u5219","title":"\u88c1\u51b3\u89c4\u5219","text":"<ul> <li>\u4e94\u7c7b\u53d8\u5f02\uff08\u7ed3\u6784\u3001\u8bed\u4e49\u3001\u6458\u8981\u3001\u9057\u6f0f\u3001\u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31\uff09\u6bcf\u7c7b\u81f3\u5c11 3 \u4e2a fixture\uff0c\u4e14\u81f3\u5c11\u68c0\u51fa 1 \u4e2a\uff1b</li> <li>\u4efb\u4e00\u7c7b\u6f0f\u62a5\u5373\u5931\u8d25\uff1a\u8986\u76d6\u95e8\uff08AUD-MISS-001\uff09\u673a\u68b0\u5f3a\u5236\uff0c\u6f0f\u62a5\u7c7b\u7684\u5b58\u5728\u4f7f\u6574\u4f53 verdict \u5fc5\u4e3a fail\uff1b</li> <li>\u4efb\u4e00 fixture \u672a\u88ab\u5982\u9884\u671f\u68c0\u51fa\u3001\u57fa\u7ebf pin \u6f02\u79fb\u3001fixture \u4fe1\u5c01\u4e0d\u5408\u6cd5\uff0c\u90fd\u4ea7\u751f mandatory \u7ea7\u53d1\u73b0\u5e76\u4f7f verdict fail\u3002</li> </ul>"},{"location":"integration/audit/failure-evidence/","title":"\u5931\u8d25\u8bc1\u636e\u683c\u5f0f\u4e0e AUD \u7801\u767b\u8bb0\u8868","text":"<p>\u5ba1\u8ba1\u53d1\u73b0\u5fc5\u987b\u4ee5\u673a\u5668\u53ef\u8bfb\u7684\u8bc1\u636e\u6587\u6863\u8bb0\u5f55\u3002\u8bc1\u636e\u6587\u6863\u7531 <code>runner/run-audit.mjs</code> \u8f93\u51fa\u5230 stdout\uff0c\u683c\u5f0f\u7531 schemas/audit-evidence.schema.json \u51bb\u7ed3\uff0c\u5e76\u901a\u8fc7\u88ab\u6d88\u8d39 Contracts \u7684 <code>validateDocument</code>\uff082020-12 \u65b9\u8a00\u3001strict \u7b56\u7565\uff09\u81ea\u6821\u9a8c\u2014\u2014\u8bc1\u636e\u6587\u6863\u672c\u8eab\u4e0d\u5408\u683c\u662f\u673a\u5236\u9519\u8bef\uff08\u9000\u51fa\u7801 2\uff09\u3002</p>"},{"location":"integration/audit/failure-evidence/#\u8bc1\u636e\u6587\u6863\u5f62\u72b6","title":"\u8bc1\u636e\u6587\u6863\u5f62\u72b6","text":"<pre><code>{\n \"schemaVersion\": 1,\n \"kind\": \"skill-family.audit.evidence\",\n \"auditId\": \"fnd-060-independent-audit\",\n \"generatedAt\": \"RFC 3339 date-time\",\n \"consumer\": {\n \"contractsVersion\": \"1.0.0\",\n \"auditSurfaceVersion\": 1,\n \"surfaceDigest\": { \"algorithm\": \"sha256\", \"value\": \"64 \u4f4d\u5341\u516d\u8fdb\u5236\" }\n },\n \"verdict\": \"pass \| fail\",\n \"classCoverage\": {\n \"<class>\": { \"fixtures\": 0, \"detected\": 0, \"required\": 3, \"satisfied\": false }\n },\n \"fixtureResults\": [\n { \"fixtureId\": \"AUD-M1-01\", \"mutationClass\": \"structure\", \"expectedAuditCode\": \"AUD-M1-STRUCT\", \"detected\": true, \"observed\": {} }\n ],\n \"findings\": [\n {\n \"findingId\": \"F-0001\",\n \"auditCode\": \"AUD-BASE-001\",\n \"severity\": \"mandatory\",\n \"mutationClass\": null,\n \"fixtureId\": null,\n \"detected\": true,\n \"summary\": \"\u4eba\u7c7b\u53ef\u8bfb\u6458\u8981\",\n \"details\": {}\n }\n ]\n}\n</code></pre> <p>\u8981\u70b9\uff1a</p> <ul> <li><code>consumer</code> \u7528\u7248\u672c\u5750\u6807 + surface \u6458\u8981\u9489\u6b7b\u88ab\u6d88\u8d39\u7684 Contracts \u5305\uff0c\u8bc1\u636e\u56e0\u6b64\u53ef\u56de\u6eaf\u5230\u7cbe\u786e\u5b57\u8282\uff1b</li> <li><code>fixtureResults</code> \u662f\u5168\u90e8 fixture \u7684\u91cd\u653e\u8bb0\u5f55\uff08\u542b\u901a\u8fc7\u9879\uff09\uff0c<code>findings</code> \u53ea\u6536\u8fdd\u89c4\u9879\uff1b</li> <li>v1 \u51bb\u7ed3\u5355\u4e00\u4e25\u91cd\u7ea7 <code>mandatory</code>\uff1a\u4efb\u4f55\u53d1\u73b0\u90fd\u4f7f <code>verdict</code> \u4e3a <code>fail</code>\uff1b</li> <li><code>classCoverage</code> \u4e94\u7c7b\u9f50\u5168\uff1b<code>satisfied = fixtures \u2265 3 \u4e14 detected \u2265 1</code>\u3002</li> </ul>"},{"location":"integration/audit/failure-evidence/#\u88c1\u51b3\u89c4\u5219","title":"\u88c1\u51b3\u89c4\u5219","text":"<ol> <li><code>findings</code> \u4e3a\u7a7a \u2192 <code>verdict = pass</code>\uff0c\u9000\u51fa\u7801 0\uff1b</li> <li>\u4efb\u4e00\u53d1\u73b0\u5b58\u5728 \u2192 <code>verdict = fail</code>\uff0c\u9000\u51fa\u7801 1\uff1b</li> <li>\u7528\u6cd5\u6216\u673a\u5236\u9519\u8bef\uff08\u542b\u8bc1\u636e\u81ea\u6821\u9a8c\u5931\u8d25\uff09\u2192 \u9000\u51fa\u7801 2\uff0c\u4e0d\u4ea7\u751f\u8bc1\u636e\u6216\u4ea7\u751f\u4f5c\u5e9f\u8bc1\u636e\uff1b</li> <li>\u6f0f\u62a5\u5f8b\uff1a\u4efb\u4e00\u7c7b <code>satisfied = false</code> \u5fc5\u987b\u4ea7\u751f AUD-MISS-001 \u53d1\u73b0\uff0c\u6574\u4f53 verdict \u5fc5\u4e3a fail\u3002</li> </ol>"},{"location":"integration/audit/failure-evidence/#AUD-\u7801\u767b\u8bb0\u8868append-only","title":"AUD \u7801\u767b\u8bb0\u8868\uff08append-only\uff09","text":"<p>\u5ba1\u8ba1\u7801\u5c5e\u4e8e\u5ba1\u8ba1\u81ea\u6709\u547d\u540d\u7a7a\u95f4 <code>AUD-</code>\uff0c\u4e0d\u8fdb\u5165 Contracts \u7684 SFC \u767b\u8bb0\uff1b\u5ba1\u8ba1\u5bf9 SFC \u7801\u53ea\u8bfb\u6d88\u8d39\u3002\u673a\u5668\u53ef\u8bfb\u526f\u672c\u89c1 baseline/audit-codes.json\u3002</p> \u7801 \u540d\u79f0 \u542b\u4e49 AUD-M1-STRUCT STRUCTURE_MUTATION_DETECTED \u7ed3\u6784\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u89c2\u5bdf\u7801\u7b49\u4e8e\u9884\u671f\u7a33\u5b9a\u7801\uff09 AUD-M2-SEM SEMANTIC_MUTATION_DETECTED \u8bed\u4e49\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa AUD-M3-DIGEST DIGEST_MISMATCH_DETECTED \u6458\u8981\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u89c4\u8303\u5316\u6458\u8981\u4e0e pin \u4e0d\u4e00\u81f4\uff09 AUD-M4-OMIT OMISSION_DETECTED \u9057\u6f0f\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u7f3a\u5931\u6e05\u5355\u4e0e\u9884\u671f\u4e00\u81f4\uff09 AUD-M5-ENGINE ENGINE_WEAKENING_DETECTED \u5f15\u64ce\u524a\u5f31\u7c7b\u53d8\u5f02\u88ab\u68c0\u51fa\uff08\u88ab\u524a\u5f31\u5b57\u6bb5\u4e0e\u9884\u671f\u4e00\u81f4\uff09 AUD-MISS-001 MUTATION_CLASS_MISSED \u67d0\u7c7b fixture \u6570\u4f4e\u4e8e\u51bb\u7ed3\u4e0b\u9650\u6216\u96f6\u68c0\u51fa\uff1b\u6f0f\u62a5\u5373\u6574\u4f53\u5931\u8d25 AUD-BASE-001 BASELINE_DRIFT \u6d88\u8d39\u7684 Contracts \u6d3b\u8dc3 surface \u4e0e\u51bb\u7ed3\u57fa\u7ebf pin \u4e0d\u4e00\u81f4 AUD-FMT-001 EVIDENCE_OR_FIXTURE_FORMAT_INVALID fixture \u4fe1\u5c01\u6216\u8bc1\u636e\u6587\u6863\u683c\u5f0f\u975e\u6cd5 AUD-LOCK-001 LOCK_VERIFICATION_FAILED \u6d88\u8d39\u5305\u7684\u8eab\u4efd\u3001\u4f9d\u8d56\u95ed\u5305\u6216 pin \u5bf9\u6bd4\u5931\u8d25 AUD-IND-001 INDEPENDENCE_VIOLATION \u5ba1\u8ba1\u8bfb\u53d6\u6216\u5bfc\u5165\u8d8a\u51fa\u5141\u8bb8\u96c6\u5408 <p>\u767b\u8bb0\u7eaa\u5f8b\uff1a\u7801\u53ea\u589e\u4e0d\u6539\u4e0d\u590d\u7528\uff1b\u65b0\u589e\u7801\u5fc5\u987b\u540c\u6b65\u66f4\u65b0\u672c\u8868\u4e0e <code>baseline/audit-codes.json</code>\uff0c\u4e14\u4e0d\u5f97\u4e0e SFC \u547d\u540d\u7a7a\u95f4\u4ea7\u751f\u4efb\u4f55\u4ea4\u53c9\u62e5\u6709\u3002</p>"},{"location":"integration/audit/independence/","title":"\u72ec\u7acb\u6027\u58f0\u660e\u4e0e\u673a\u68b0\u8bc1\u660e","text":"<p>FND-060 \u7684\u9a8c\u6536\u8981\u6c42\uff1a\u5ba1\u8ba1 fixture\u3001\u9884\u671f\u503c\u548c\u88c1\u51b3\u4e0d\u6765\u81ea\u751f\u6210\u5668\uff1bAudit \u4e0d\u4f9d\u8d56 Kit\u3002\u672c\u9875\u7684\u73b0\u884c\u4e8b\u5b9e\u662f\uff1a\u672c\u4ed3\u5e93\u4e0d\u5b58\u5728\u72ec\u7acb\u7684\u7b2c\u4e8c\u5ba1\u9605\u4f1a\u8bdd\uff0c\u5ba1\u8ba1\u6811\u662f\u4ea7\u54c1\u4fa7\u7684\u673a\u68b0\u9a8c\u8bc1\u8bbe\u65bd\u3002\u673a\u68b0\u8bc1\u660e\u80fd\u591f\u8bc1\u660e\u7684\u662f\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u4e0e\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\uff1b\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002</p>"},{"location":"integration/audit/independence/#provenance-\u73b0\u884c\u4e8b\u5b9e","title":"provenance \u73b0\u884c\u4e8b\u5b9e","text":"<ul> <li>\u5168\u90e8 18 \u4e2a\u53d8\u5f02 fixture \u7684 provenance \u4e3a <code>product-fixture</code>\uff1a\u4ea7\u54c1\u4fa7\u7ef4\u62a4\u7684\u6d4b\u8bd5\u8bed\u6599\u3002\u9884\u671f\u7531\u4ea7\u54c1\u4fa7\u5bf9\u7167\u5408\u540c\u6587\u6863\u63a8\u5bfc\uff08schema \u7ea6\u675f required/pattern/additionalProperties\u3001\u767b\u8bb0\u8868\u6210\u5458\u8d44\u683c\u3001kernel \u8bcd\u8868\u4e0e params \u5951\u7ea6\u3001\u9519\u8bef\u7801 append-only \u8bed\u4e49\uff09\uff0c\u4e0d\u590d\u7528\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\uff0c\u4e0d\u8bfb\u53d6 oracle \u5224\u636e\uff1b\u8fd9\u4e00\u8f93\u5165\u9694\u79bb\u7531\u4e0b\u65b9 P4/P5/P6 \u673a\u68b0\u5f3a\u5236\u3002</li> <li>\u57fa\u7ebf pin \u7684 provenance \u4e3a <code>product-compatibility-fixture</code>\uff1a\u4ea7\u54c1\u4fa7\u7ef4\u62a4\u7684\u517c\u5bb9\u57fa\u7ebf\u3002\u6458\u8981\u6765\u81ea\u5bf9\u5df2\u51bb\u7ed3\u4ea7\u7269\u7684 <code>digestAuditSurface()</code> \u673a\u68b0\u8ba1\u7b97\uff0c\u4e8b\u5b9e\u6e05\u5355\u76f4\u63a5\u5bf9\u7167\u5408\u540c\u6587\u6863\u63a8\u5bfc\u3002</li> <li>\u5b83\u4eec\u8bc1\u660e\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u548c\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\u3002fixture \u4e0e pin \u80cc\u540e\u7684\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u8fc7\u7a0b\u662f\u5426\u72ec\u7acb\u4e8e\u5176\u4ed6\u9879\u76ee\u53c2\u4e0e\u8005\uff0c\u4e0d\u662f\u4ed3\u5185\u673a\u68b0\u68c0\u67e5\u53ef\u4ee5\u8bc1\u660e\u7684\u5bf9\u8c61\u3002</li> <li>\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\uff1a\u5b9e\u73b0\u8005\u81ea\u6d4b\u4e0e\u672c\u9875\u673a\u68b0\u8bc1\u660e\u90fd\u53ea\u5f62\u6210\u5f85\u5ba1\u8bc1\u636e\uff0c\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002</li> <li>\u8bda\u5b9e\u6027\u7ea0\u9519\uff1a\u65e7 fixture \u4e0e pin \u66fe\u643a\u5e26 <code>independent-r2</code> provenance \u548c\u72ec\u7acb\u4f5c\u8005\u53d9\u4e8b\uff08\u542b\u4f5c\u8005\u9605\u8bfb\u53f2\u58f0\u660e\uff09\uff0c\u4e0e\u672c\u4ed3\u4e8b\u5b9e\u4e0d\u7b26\uff1bprovenance \u5df2\u4fee\u6b63\u4e3a\u4e0a\u8ff0\u5982\u5b9e\u8bcd\u6c47\uff0c\u672c\u9875\u968f\u4e4b\u91cd\u5199\u3002\u7ea0\u9519\u53ea\u89e6\u53ca provenance\u3001note \u4e0e\u6587\u6848\u7b49\u8bda\u5b9e\u6027\u5b57\u6bb5\uff0c\u4e0d\u6539\u53d8\u4efb\u4f55 digest\u3001facts\u3001fixture \u5185\u5bb9\u6216\u673a\u68b0\u8bc1\u660e\u884c\u4e3a\u3002</li> </ul>"},{"location":"integration/audit/independence/#\u673a\u68b0\u8bc1\u660e\u5165\u53e3","title":"\u673a\u68b0\u8bc1\u660e\u5165\u53e3","text":"<pre><code>node docs/integration/audit/runner/proof-independence.mjs\n</code></pre> <p>\u8bc1\u660e\u68c0\u67e5\u4e0e\u7ed3\u8bba\uff1a</p> \u68c0\u67e5 \u7ed3\u8bba P0-modules \u6536\u96c6\u5230\u5168\u90e8\u5ba1\u8ba1\u6a21\u5757\uff08\u8bc1\u660e\u8303\u56f4\u5b8c\u5907\uff09 P1-imports \u5168\u90e8 import \u53ea\u5141\u8bb8 <code>node:</code> \u5185\u5efa\u4e0e\u76f8\u5bf9\u8def\u5f84\uff0c\u4e14\u76f8\u5bf9\u8bf4\u660e\u7b26\u7684\u89e3\u6790\u57df\u88ab\u9650\u5236\u5728\u5ba1\u8ba1\u6811\u6216 contracts \u5305\u5185\uff08\u675c\u7edd\u76f8\u5bf9\u8def\u5f84\u7ed5\u5230\u751f\u6210\u5668/oracle \u6a21\u5757\uff09\uff1b\u7981\u6b62 engineering-kit / harness / \u7b2c\u4e09\u65b9\u5305 \u2192 Audit \u4e0d\u4f9d\u8d56 Kit P2-contracts-site Contracts \u53ea\u5728\u552f\u4e00\u58f0\u660e\u70b9\uff08<code>lib/contracts-client.mjs</code>\uff09\u88ab\u5bfc\u5165 P3-chokepoint \u6587\u4ef6\u8bfb\u53d6\u53ea\u7ecf\u8fc7\u4e24\u4e2a\u58f0\u660e\u8bfb\u53d6\u70b9\uff1a<code>lib/guard.mjs</code>\uff08\u5ba1\u8ba1\u6811\u5185\uff0c\u88c1\u51b3\u8f93\u5165\uff09\u4e0e <code>lib/consumed-package.mjs</code>\uff08\u88ab\u6d88\u8d39\u5305\u6839\u5185\uff0c\u9501\u9a8c\u8bc1\uff09\uff1b\u53ea\u8bfb API\uff1b\u5168\u6811\u65e0\u4efb\u4f55\u5199 API P4-refusal \u73b0\u573a\u62d2\u8bfb\u6f14\u793a\uff1a\u5bf9\u751f\u6210\u5668\u81ea\u6d4b\u8fd0\u884c\u5668\u3001oracle \u5224\u636e\u3001oracle \u8fd0\u884c\u5668\u3001fixture README\u3001profiles\u3001kit \u5165\u53e3\u3001harness \u5165\u53e3\u9010\u4e00\u5c1d\u8bd5\u8bfb\u53d6\uff0c\u5168\u90e8\u88ab guard \u4ee5 AUD-IND-001 \u62d2\u7edd P5-provenance \u5168\u90e8\u53d8\u5f02 fixture \u7684 provenance \u4e3a <code>product-fixture</code>\uff0c\u57fa\u7ebf pin \u7684 provenance \u5728\u58f0\u660e\u8bcd\u6c47\u8868\u5185\uff08\u5f53\u524d\u552f\u4e00\u6210\u5458 <code>product-compatibility-fixture</code>\uff09\uff1b\u4efb\u4f55\u6cbf\u7528\u65e7\u72ec\u7acb\u89d2\u8272 provenance \u8bcd\u6c47\u7684\u5de5\u4ef6\u90fd\u4f1a\u88ab\u5224\u8fdd\u89c4 P6-literals \u9664\u8bc1\u660e\u811a\u672c\u81ea\u8eab\uff08\u62d2\u8bfb\u6f14\u793a\u8005\uff0c\u53d7 P4 \u7ea6\u675f\uff09\u5916\uff0c\u4efb\u4f55\u5ba1\u8ba1\u6a21\u5757\u7684\u5b57\u7b26\u4e32\u5b57\u9762\u91cf\u90fd\u4e0d\u5f97\u70b9\u540d\u751f\u6210\u5668\u81ea\u6d4b\u8868\u6216 oracle \u5224\u636e\u6587\u4ef6 <p>\u63a8\u7406\u94fe\u4e0e\u80fd\u529b\u8fb9\u754c\uff1aP3 \u4fdd\u8bc1\u88c1\u51b3\u8f93\u5165\u53ea\u80fd\u6765\u81ea\u5ba1\u8ba1\u6811\uff1bP4 \u8bc1\u660e\u751f\u6210\u5668/oracle \u5de5\u4ef6\u5728\u8fd0\u884c\u65f6\u4e0d\u53ef\u8bfb\uff1bP6 \u8bc1\u660e\u5176\u6587\u4ef6\u540d\u5728\u4ee3\u7801\u4e2d\u4e0d\u53ef\u5f15\u7528\uff1bP5 \u673a\u68b0\u7981\u6b62\u65e7\u72ec\u7acb\u89d2\u8272 provenance \u8bcd\u6c47\u56de\u6f6e\u3002\u56e0\u6b64\u8fd0\u884c\u65f6\u4e0d\u5b58\u5728\u4efb\u4f55\u628a\u751f\u6210\u5668\u9884\u671f\u53d8\u6210\u5ba1\u8ba1\u5224\u636e\u7684\u8def\u5f84\u2014\u2014\u8fd9\u8bc1\u660e\u7684\u662f\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u3002\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u662f\u5426\u72ec\u7acb\u4e0d\u5728\u673a\u68b0\u8bc1\u660e\u80fd\u529b\u4e4b\u5185\uff0c\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u6700\u7ec8\u63a5\u53d7\u3002</p>"},{"location":"integration/audit/independence/#\u53cd\u5411\u62e5\u6709\u7981\u4ee4","title":"\u53cd\u5411\u62e5\u6709\u7981\u4ee4","text":"<p>Contracts \u4fa7\u65b0\u589e\u7684 <code>src/audit-surface.mjs</code> \u662f\u7eaf\u53ea\u8bfb\u6295\u5f71\uff1a\u4e0d\u63a5\u6536\u56de\u8c03\u3001\u4e0d\u6ce8\u518c\u4efb\u4f55\u4e1c\u897f\u3001\u4e0d import \u4efb\u4f55\u5ba1\u8ba1\u5de5\u4ef6\uff1b<code>packages/skill-family-contracts/test/audit-surface.test.mjs</code> \u542b\u4e00\u6761\u673a\u68b0\u6d4b\u8bd5\uff0c\u65ad\u8a00\u8be5\u6a21\u5757\u7684 import \u5168\u90e8\u4e3a <code>node:</code> \u6216\u672c\u5730\u76f8\u5bf9\u6a21\u5757\uff0c\u4e14\u6e90\u7801\u4e0d\u51fa\u73b0 integration/audit\u3001engineering-kit\u3001harness \u5b57\u6837\u3002\u4f9d\u8d56\u65b9\u5411\u6052\u4e3a Audit \u2192 Contracts\u3002</p>"},{"location":"integration/audit/independence/#\u517c\u5bb9\u6027\u8bc1\u660e\u5165\u53e3","title":"\u517c\u5bb9\u6027\u8bc1\u660e\u5165\u53e3","text":"<p>\u53d8\u5f02\u91cd\u653e\u4e0e\u57fa\u7ebf pin \u7684\u6bd4\u5bf9\uff08\u6458\u8981\u3001\u4e8b\u5b9e\u6e05\u5355\u3001\u5f15\u64ce\u53c2\u6570\u5b8c\u6574\u6027\uff09\u89c1 version-compatibility.md \u4e0e isolation-and-lockfile.md\uff1b\u5206\u7c7b\u5b66\u89c1 mutation-taxonomy.md\u3002pin \u662f\u4ea7\u54c1\u4fa7\u517c\u5bb9\u57fa\u7ebf\uff08<code>product-compatibility-fixture</code>\uff09\uff0c\u8bc1\u660e\u88ab\u6d88\u8d39\u7684 Contracts \u5305\u4e0e\u51bb\u7ed3\u57fa\u7ebf\u5b57\u8282\u4e00\u81f4\u3001\u6821\u9a8c\u8bed\u4e49\u4e00\u81f4\uff0c\u540c\u6837\u4e0d\u4f5c\u4efb\u4f55\u72ec\u7acb\u89d2\u8272\u58f0\u79f0\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/","title":"\u53d8\u5f02\u5206\u7c7b\u5b66\uff08\u51bb\u7ed3\uff09","text":"<p>FND-060 \u51bb\u7ed3\u4e94\u7c7b\u53d8\u5f02\u3002\u6bcf\u4e00\u7c7b\u90fd\u6709\u72ec\u7acb\u7684\u68c0\u6d4b\u673a\u5236\u4e0e\u6bcf\u7c7b \u22653 \u4f8b\u7684\u53d8\u5f02 fixture\uff1bfixture \u4e0e\u9884\u671f\u662f\u4ea7\u54c1\u4fa7\u7ef4\u62a4\u7684\u6d4b\u8bd5\u8bed\u6599\uff08provenance <code>product-fixture</code>\uff0c\u89c1\u4e0b\u65b9 fixture \u4fe1\u5c01\uff09\uff0c\u4e0d\u590d\u7528\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\uff0c\u4e0d\u8bfb\u53d6 oracle \u5224\u636e\uff08\u8be5\u8f93\u5165\u9694\u79bb\u7531 independence.md \u7684\u673a\u68b0\u8bc1\u660e\u5f3a\u5236\uff09\u3002\u5b83\u4eec\u8bc1\u660e\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u548c\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\uff1b\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002\u5206\u7c7b\u96c6\u5408\u662f\u95ed\u5408\u7684\uff1a\u65b0\u589e\u7c7b\u522b\u5c5e\u4e8e\u5ba1\u8ba1\u5206\u7c7b\u5b66\u53d8\u66f4\uff0c\u5fc5\u987b\u8d70\u65b0\u7684\u88c1\u51b3\u5e76\u66f4\u65b0\u672c\u6587\u4ef6\u4e0e <code>runner/lib/paths.mjs</code> \u7684 <code>MUTATION_CLASSES</code>\u3002</p> \u7c7b\u522b \u679a\u4e3e\u503c \u68c0\u6d4b\u673a\u5236 \u6d88\u8d39\u63a5\u53e3 \u5ba1\u8ba1\u7801 \u7ed3\u6784 <code>structure</code> \u4e25\u683c\u65b9\u8a00\u4e0b\u7684 schema \u6821\u9a8c\u62d2\u7edd <code>validateDocument</code>\uff08strict, 2020-12\uff09 AUD-M1-STRUCT \u8bed\u4e49 <code>semantics</code> \u7ed3\u6784\u5408\u6cd5\u4f46\u8fdd\u53cd\u51bb\u7ed3\u8bed\u4e49\uff08\u534f\u8bae\u767b\u8bb0\u3001\u64cd\u4f5c\u8bcd\u8868\u3001params \u5951\u7ea6\u3001\u9519\u8bef\u7801\u6210\u5458\u8d44\u683c\uff09 <code>findProtocol</code>\u3001<code>checkOperation</code>\u3001<code>isRegisteredErrorCode</code> AUD-M2-SEM \u6458\u8981 <code>digest</code> \u89c4\u8303\u5316 JSON \u7684 SHA-256 \u4e0e\u51bb\u7ed3 pin \u4e0d\u4e00\u81f4 <code>digestDocument</code> AUD-M3-DIGEST \u9057\u6f0f <code>omission</code> \u51bb\u7ed3\u5fc5\u5907\u90e8\u4ef6\u7f3a\u5931\uff08\u767b\u8bb0\u3001\u89c4\u5219\u8986\u76d6\u3001\u9519\u8bef\u7801\u6210\u5458\uff09 \u57fa\u7ebf pin \u4e8b\u5b9e\u6e05\u5355\u5bf9\u6bd4 AUD-M4-OMIT \u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31 <code>engine</code> \u5f15\u64ce\u53c2\u6570\u5b8c\u6574\u6027\u5bf9\u6bd4\uff08\u9884\u7b97\u3001\u6821\u9a8c\u7b56\u7565\u3001\u68c0\u67e5\u7c7b\u578b\u95ed\u96c6\u3001\u7a33\u5b9a\u6027\u653f\u7b56\uff09 <code>describeAuditSurface</code> + \u57fa\u7ebf pin AUD-M5-ENGINE"},{"location":"integration/audit/mutation-taxonomy/#\u5404\u7c7b\u522b\u5b9a\u4e49\u4e0e\u5224\u636e","title":"\u5404\u7c7b\u522b\u5b9a\u4e49\u4e0e\u5224\u636e","text":""},{"location":"integration/audit/mutation-taxonomy/#M1-\u7ed3\u6784structure","title":"M1 \u7ed3\u6784\uff08structure\uff09","text":"<p>\u53d8\u5f02\u6539\u53d8\u6587\u6863\u7684\u5f62\u72b6\uff1a\u7f3a\u5fc5\u586b\u6210\u5458\u3001\u7c7b\u578b\u6f02\u79fb\u3001\u672a\u58f0\u660e\u6210\u5458\u3001\u6a21\u5f0f\u8fdd\u89c4\u3002\u5224\u636e\uff1a\u5728 <code>2020-12</code> \u65b9\u8a00\u3001<code>strict</code> \u7b56\u7565\u4e0b\uff0c\u6587\u6863\u5fc5\u987b\u88ab\u62d2\u7edd\uff0c\u4e14\u7a33\u5b9a\u7801\u7b49\u4e8e fixture \u58f0\u660e\u7684 <code>expect.observedErrorCode</code>\uff08\u672c\u7c7b\u5168\u90e8\u4e3a SFC1001\uff09\u3002\u9884\u671f\u7531\u4ea7\u54c1\u4fa7\u5bf9\u7167\u76f8\u5e94 schema \u7684 required/pattern/additionalProperties \u63a8\u5bfc\uff0c\u4e0d\u53d6\u81ea\u751f\u6210\u5668\u81ea\u6d4b\u9884\u671f\u8868\u6216 oracle \u5224\u636e\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#M2-\u8bed\u4e49semantics","title":"M2 \u8bed\u4e49\uff08semantics\uff09","text":"<p>\u53d8\u5f02\u4fdd\u6301 schema \u5408\u6cd5\u6027\uff0c\u4f46\u8fdd\u53cd\u51bb\u7ed3\u7684\u767b\u8bb0\u8bed\u4e49\u3002\u4e09\u4e2a\u8bed\u4e49\u68c0\u67e5\u70b9\uff08fixture \u7528 <code>expect.semanticCheck</code> \u58f0\u660e\uff09\uff1a</p> <ul> <li><code>protocol-registered</code>\uff1a\u534f\u8bae\u540d/\u7248\u672c\u5fc5\u987b\u5728\u767b\u8bb0\u8868\u4e2d\uff0c\u5426\u5219 SFC1011\uff1b</li> <li><code>operation-vocabulary</code>\uff1a\u64cd\u4f5c\u540d\u5fc5\u987b\u5728\u534f\u8bae\u7248\u672c\u7684\u51bb\u7ed3\u8bcd\u8868\u5185\uff08\u5426\u5219 SFC2002\uff09\uff0cparams \u5fc5\u987b\u6ee1\u8db3\u8be5\u64cd\u4f5c\u7684\u51bb\u7ed3 params \u5951\u7ea6\uff08\u5426\u5219 SFC2003\uff09\uff1b</li> <li><code>error-code-registered</code>\uff1aoperation-result \u4e2d\u7684\u9519\u8bef\u7801\u5fc5\u987b\u662f\u51bb\u7ed3\u767b\u8bb0\u8868\u6210\u5458\uff08\u5f62\u72b6\u5408\u6cd5\u4f46\u672a\u767b\u8bb0 \u2192 SFC1009\uff09\u3002</li> </ul>"},{"location":"integration/audit/mutation-taxonomy/#M3-\u6458\u8981digest","title":"M3 \u6458\u8981\uff08digest\uff09","text":"<p>\u53d8\u5f02\u4fdd\u6301\u7ed3\u6784\u4e0e\u8bed\u4e49\uff0c\u4ec5\u6539\u53d8\u89c4\u8303\u5316\u5b57\u8282\uff08\u63aa\u8f9e\u6539\u5199\u3001\u540c\u4e49\u66ff\u6362\uff09\u3002\u5224\u636e\uff1a<code>digestDocument(input)</code> \u5fc5\u987b\u4e0d\u7b49\u4e8e\u57fa\u7ebf pin \u4e2d <code>documentDigests[expect.pinField]</code>\u3002\u8fd9\u662f\u552f\u4e00\u80fd\u6355\u83b7\"\u542b\u4e49\u4e0d\u53d8\u3001\u5b57\u8282\u6539\u53d8\"\u7684\u7c7b\u522b\u3002\u89c4\u8303\u5316\u89c4\u5219\u7531 Contracts \u7684 <code>canonicalJson</code> \u51bb\u7ed3\uff1a\u5bf9\u8c61\u952e\u9010\u7ea7\u5b57\u5178\u5e8f\u6392\u5e8f\u3001\u6570\u7ec4\u4fdd\u5e8f\u3001\u53ea\u63a5\u53d7 JSON \u6570\u636e\u7c7b\u578b\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#M4-\u9057\u6f0fomission","title":"M4 \u9057\u6f0f\uff08omission\uff09","text":"<p>\u53d8\u5f02\u4ece\u51bb\u7ed3\u6587\u6863\u4e2d\u5220\u9664\u5fc5\u5907\u90e8\u4ef6\u3002\u4e09\u4e2a\u8986\u76d6\u68c0\u67e5\uff08fixture \u7528 <code>expect.check</code> \u58f0\u660e\uff09\uff1a</p> <ul> <li><code>registry-schema-coverage</code>\uff1a\u4e94\u4e2a\u9876\u5c42\u5bf9\u8c61\u7684 schema \u767b\u8bb0\u7f3a\u4e00\u4e0d\u53ef\uff1b</li> <li><code>rules-checktype-coverage</code>\uff1a\u4e5d\u4e2a\u68c0\u67e5\u7c7b\u578b\u6bcf\u4e2a\u90fd\u5fc5\u987b\u88ab\u81f3\u5c11\u4e00\u6761 mandatory \u89c4\u5219\u8986\u76d6\uff1b</li> <li><code>error-code-coverage</code>\uff1a\u51bb\u7ed3\u9519\u8bef\u7801\u6e05\u5355\u4e00\u4e2a\u4e0d\u80fd\u5c11\u3002</li> </ul> <p>\u5224\u636e\uff1a\u89c2\u5bdf\u5230\u7684\u7f3a\u5931\u6e05\u5355\u5fc5\u987b\u4e0e <code>expect.missing</code> \u5b8c\u5168\u4e00\u81f4\uff08\u591a\u62a5\u3001\u6f0f\u62a5\u90fd\u7b97 fixture \u5931\u8d25\uff09\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#M5-\u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31engine","title":"M5 \u68c0\u67e5\u5f15\u64ce\u88ab\u524a\u5f31\uff08engine\uff09","text":"<p>\u53d8\u5f02\u4e0d\u5220\u9664\u90e8\u4ef6\uff0c\u800c\u662f\u653e\u5bbd\u5f15\u64ce\u53c2\u6570\u3002\u56db\u4e2a\u5b8c\u6574\u6027\u68c0\u67e5\uff08fixture \u7528 <code>expect.check</code> \u58f0\u660e\uff09\uff1a</p> <ul> <li><code>rules-budget</code>\uff1a\u9884\u7b97\u6570\u503c\uff08firstVersionMax=20\u3001absoluteMax=30\uff09\u4e0d\u5f97\u53d8\u5316\uff1b</li> <li><code>validation-policies</code>\uff1astrict \u7b56\u7565\u5fc5\u987b\u4fdd\u6301 coerceTypes=false\u3001useDefaults=false\u3001allErrors=true\u3001validateFormats=true\uff1btolerant \u7b56\u7565\u9010\u952e\u5bf9\u6bd4\uff1b</li> <li><code>check-type-set</code>\uff1a\u4e5d\u4e2a\u68c0\u67e5\u7c7b\u578b\u662f\u95ed\u96c6\uff0c\u7f3a\u4e00\u4e0d\u53ef\uff1b</li> <li><code>error-code-stability</code>\uff1a\u9519\u8bef\u7801 append-only \u7a33\u5b9a\u6027\u653f\u7b56\u539f\u6587\u4e0d\u5f97\u6539\u5199\u3002</li> </ul> <p>\u5224\u636e\uff1a\u89c2\u5bdf\u5230\u7684\u88ab\u524a\u5f31\u5b57\u6bb5\u6e05\u5355\u5fc5\u987b\u4e0e <code>expect.weakened</code> \u5b8c\u5168\u4e00\u81f4\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#fixture-\u4fe1\u5c01\u51bb\u7ed3","title":"fixture \u4fe1\u5c01\uff08\u51bb\u7ed3\uff09","text":"<p>\u6bcf\u4e2a fixture \u662f\u4e00\u4e2a JSON \u6587\u4ef6\uff1a</p> \u5b57\u6bb5 \u8981\u6c42 <code>schemaVersion</code> \u5e38\u91cf <code>1</code> <code>kind</code> \u5e38\u91cf <code>skill-family.audit.mutation-fixture</code> <code>fixtureId</code> <code>^AUD-M[1-5]-[0-9]{2}$</code>\uff0c\u7b2c 6 \u4f4d\u6570\u5b57\u5fc5\u987b\u4e0e\u7c7b\u522b\u4e00\u81f4 <code>mutationClass</code> \u4e94\u7c7b\u4e4b\u4e00\uff0c\u4e14\u5fc5\u987b\u4e0e\u6240\u5728\u76ee\u5f55\u4e00\u81f4 <code>provenance</code> \u5fc5\u987b\u4e3a <code>product-fixture</code>\uff08\u673a\u68b0\u68c0\u67e5 P5\uff09 <code>description</code> \u53d8\u5f02\u610f\u56fe\u8bf4\u660e <code>target</code> \u88ab\u6d4b\u5bf9\u8c61\uff08schema/\u6587\u4ef6/\u6295\u5f71\uff09 <code>input</code> \u53d8\u5f02\u540e\u7684\u5b8c\u6574\u6587\u6863\u6216\u6295\u5f71 <code>expect.detected</code> \u5fc5\u987b\u4e3a <code>true</code>\uff08\u53d8\u5f02\u5fc5\u987b\u88ab\u68c0\u51fa\uff09 <code>expect.auditCode</code> \u5fc5\u987b\u7b49\u4e8e\u8be5\u7c7b\u522b\u7684\u5ba1\u8ba1\u7801 <p>provenance \u73b0\u884c\u4e8b\u5b9e\uff1a\u53d8\u5f02 fixture \u662f\u4ea7\u54c1\u4fa7\u6d4b\u8bd5\u8bed\u6599\uff08<code>product-fixture</code>\uff09\uff0c\u57fa\u7ebf pin \u662f\u4ea7\u54c1\u4fa7\u517c\u5bb9\u57fa\u7ebf\uff08<code>product-compatibility-fixture</code>\uff0c\u89c1 version-compatibility.md\uff09\uff1b\u5b83\u4eec\u8bc1\u660e\u4ea7\u54c1\u4fa7\u8f93\u5165\u9694\u79bb\u548c\u517c\u5bb9\u6027\uff0c\u4e0d\u8bc1\u660e\u4f5c\u8005\u3001\u6a21\u578b\u6216\u8ba4\u77e5\u72ec\u7acb\u3002\u5916\u90e8\u6700\u7ec8\u63a5\u53d7\u7531\u4ed3\u5916\u72ec\u7acb\u590d\u5ba1\u627f\u62c5\u3002\u5386\u53f2\u7ea0\u9519\uff1afixture \u4e0e pin \u66fe\u643a\u5e26\u65e7\u503c <code>independent-r2</code> \u4e0e\u72ec\u7acb\u4f5c\u8005\u53d9\u4e8b\uff0c\u8be5\u58f0\u79f0\u4e0e\u672c\u4ed3\u4e8b\u5b9e\u4e0d\u7b26\uff0c\u5df2\u4fee\u6b63\u4e3a\u4e0a\u8ff0\u5982\u5b9e\u8bcd\u6c47\uff1b\u7ea0\u9519\u4e0d\u6539\u53d8\u4efb\u4f55 fixture \u7684 <code>input</code>/<code>expect</code>\u3001digest \u6216 facts \u5b57\u6bb5\u3002</p>"},{"location":"integration/audit/mutation-taxonomy/#\u6570\u91cf\u51bb\u7ed3\u4e0e\u6f0f\u62a5\u5f8b","title":"\u6570\u91cf\u51bb\u7ed3\u4e0e\u6f0f\u62a5\u5f8b","text":"<ul> <li>\u6bcf\u7c7b fixture \u2265 3\uff08\u5f53\u524d\u5b9e\u9645\uff1a\u7ed3\u6784 4\u3001\u8bed\u4e49 4\u3001\u6458\u8981 3\u3001\u9057\u6f0f 3\u3001\u5f15\u64ce 4\uff0c\u5171 18\uff09\uff1b</li> <li>\u8986\u76d6\u95e8\u8981\u6c42\u6bcf\u7c7b <code>fixtures \u2265 3 \u4e14 detected \u2265 1</code>\uff0c\u4e0d\u6ee1\u8db3\u4ea7\u751f AUD-MISS-001 \u5e76\u5f3a\u5236 verdict fail\uff1b</li> <li>\u6f0f\u62a5\u5f8b\u7684\u8d1f\u4f8b\u9a8c\u8bc1\u7531 <code>runner/selftest-negative.mjs</code> \u6267\u884c\uff1a\u9010\u7c7b\u7981\u7528\u68c0\u6d4b\u5668\uff0c\u65ad\u8a00\u6bcf\u6b21\u7834\u574f\u90fd\u4f7f\u8fd0\u884c\u5931\u8d25\u3002</li> </ul>"},{"location":"integration/audit/version-compatibility/","title":"\u7248\u672c\u517c\u5bb9\u5b9a\u4e49","text":"<p>\u5ba1\u8ba1\u6d88\u8d39 Contracts \u4ee5\u4e24\u4e2a\u7248\u672c\u5750\u6807 + \u4e00\u4e2a\u6458\u8981\u4e3a\u51c6\uff1a</p> \u5750\u6807 \u6765\u6e90 \u542b\u4e49 <code>contractsVersion</code> Contracts \u51bb\u7ed3\u7248\u672c\uff08\u5f53\u524d <code>1.5.0</code>\uff09 \u673a\u5668\u5951\u7ea6\u5185\u5bb9\u7684\u7248\u672c <code>auditSurfaceVersion</code> \u5ba1\u8ba1\u6d88\u8d39\u63a5\u53e3\u81ea\u8eab\u7684\u7248\u672c\uff08\u5f53\u524d <code>1</code>\uff09 \u6d88\u8d39\u9762\u5f62\u72b6\u7684\u7248\u672c <code>surfaceDigest</code> <code>digestAuditSurface()</code>\uff08SHA-256\uff09 \u6d88\u8d39\u9762\u7684\u7cbe\u786e\u5b57\u8282\u6307\u7eb9 <p>\u4e09\u8005\u90fd\u7531 <code>describeAuditSurface()</code> \u4e00\u6b21\u6027\u7ed9\u51fa\uff0c\u5ba1\u8ba1\u4fa7\u628a\u5b83\u4eec\u4e0e\u57fa\u7ebf pin\uff08\u5f53\u524d\u4e3a <code>baseline/contracts-1.5.0.pin.json</code>\uff09\u6bd4\u5bf9\u3002</p>"},{"location":"integration/audit/version-compatibility/#\u517c\u5bb9\u89c4\u5219","title":"\u517c\u5bb9\u89c4\u5219","text":"<p>\u4e00\u4e2a\u88ab\u6d88\u8d39\u7684 Contracts \u5305\u4e0e\u67d0\u4e2a\u57fa\u7ebf pin \u517c\u5bb9\uff0c\u5f53\u4e14\u4ec5\u5f53\u540c\u65f6\u6ee1\u8db3\uff1a</p> <ol> <li><code>contractsVersion</code> \u4e0e pin \u76f8\u540c\uff1b</li> <li><code>auditSurfaceVersion</code> \u4e0e pin \u76f8\u540c\uff1b</li> <li><code>digestAuditSurface()</code> \u4e0e pin \u7684 <code>surfaceDigest</code> \u76f8\u540c\u3002</li> </ol> <p>\u7531\u4e8e surface \u6458\u8981\u8986\u76d6\u4e86\u767b\u8bb0\u8868\u3001\u9519\u8bef\u7801\u3001\u89c4\u5219\u3001kernel \u534f\u8bae\u3001\u5168\u90e8 schema \u6587\u6863\u4e0e\u5f15\u64ce\u53c2\u6570\uff0c\u6458\u8981\u76f8\u540c\u8574\u542b\u5185\u5bb9\u9010\u5b57\u8282\u7b49\u4ef7\uff08\u89c4\u8303\u5316\u610f\u4e49\u4e0b\uff09\u3002\u4e09\u4e2a\u6761\u4ef6\u4efb\u4e00\u4e0d\u6ee1\u8db3\u5373\u4e0d\u517c\u5bb9\uff1a\u5ba1\u8ba1\u5fc5\u987b\u62a5\u544a AUD-BASE-001\uff08\u8fd0\u884c\u671f\u57fa\u7ebf\u68c0\u67e5\uff09\u6216 AUD-LOCK-001\uff08\u5305\u9501\u9a8c\u8bc1\uff09\uff0c\u5e76\u62d2\u7edd\u7ed9\u51fa\u901a\u8fc7\u88c1\u51b3\u3002</p>"},{"location":"integration/audit/version-compatibility/#\u53d8\u66f4\u5206\u7ea7","title":"\u53d8\u66f4\u5206\u7ea7","text":"\u53d8\u66f4 \u5206\u7ea7 \u9700\u8981\u7684\u52a8\u4f5c \u4e0d\u6539\u53d8 surface \u5b57\u8282\u7684\u53d8\u66f4\uff08\u5982\u6ce8\u91ca\u3001\u6d4b\u8bd5\uff09 \u65e0\u5f71\u54cd \u65e0\u9700\u65b0 pin \u6539\u53d8 surface \u5b57\u8282\u4f46\u4e0d\u6539\u53d8\u542b\u4e49\u7684\u53d8\u66f4 \u4e0d\u517c\u5bb9 \u7981\u6b62\u4ee5\"\u540c\u4e49\"\u4e3a\u7531\u514d\u68c0\uff1b\u5fc5\u987b\u8d70\u5408\u540c\u53d8\u66f4\u5e76\u91cd\u65b0\u6279\u51c6 pin \u65b0\u589e\u5ba1\u8ba1\u6d88\u8d39\u63a5\u53e3\uff08\u53ea\u8bfb\u3001\u589e\u91cf\uff09 auditSurfaceVersion \u9012\u589e \u65b0 pin + \u672c\u6587\u4ef6\u66f4\u65b0 \u6539\u53d8\u65e2\u6709\u6d88\u8d39\u63a5\u53e3\u542b\u4e49 auditSurfaceVersion \u9012\u589e + \u5408\u540c\u53d8\u66f4 \u65b0 pin\uff1b\u65e7 pin \u5b58\u6863\u4e0d\u5220 Contracts \u7248\u672c\u6f14\u8fdb\uff081.0.0 \u2192 \u4e0b\u4e00\u7248\u672c\uff09 contractsVersion \u53d8\u5316 \u65b0\u7684\u57fa\u7ebf pin \u6587\u4ef6\uff1b\u65e7 pin \u6587\u4ef6\u53ea\u8bfb\u5b58\u6863"},{"location":"integration/audit/version-compatibility/#pin-\u751f\u547d\u5468\u671f","title":"pin \u751f\u547d\u5468\u671f","text":"<ul> <li>\u6bcf\u4e2a\u7ecf\u7248\u672c\u5316\u6279\u51c6\u7684 Contracts \u53d1\u5e03\u5bf9\u5e94\u4e00\u4e2a pin \u6587\u4ef6\uff1a<code>baseline/contracts-<version>.pin.json</code>\uff1b</li> <li>pin \u662f append-only\uff1a\u6279\u51c6\u540e\u4e0d\u518d\u539f\u5730\u7f16\u8f91\uff0c\u4f5c\u5e9f\u4ee5\u65b0 pin \u53d6\u4ee3\u5e76\u5728 <code>note</code> \u4e2d\u8bf4\u660e\uff1b</li> <li>pin \u7531\u4ea7\u54c1\u4fa7\u5728\u51bb\u7ed3\u65f6\u523b\u6784\u9020\uff08provenance <code>product-compatibility-fixture</code>\uff09\uff1a\u6458\u8981\u6765\u81ea\u5bf9\u5df2\u51bb\u7ed3\u4ea7\u7269\u7684 <code>digestAuditSurface()</code> \u673a\u68b0\u8ba1\u7b97\uff0c\u4e8b\u5b9e\u6e05\u5355\u76f4\u63a5\u5bf9\u7167\u5408\u540c\u6587\u6863\u63a8\u5bfc\uff0c\u4e0d\u53d6\u81ea\u751f\u6210\u5668\u6216 oracle\uff1b\u672c\u4ed3\u5e93\u4e0d\u5b58\u5728\u72ec\u7acb\u7684\u7b2c\u4e8c\u5ba1\u9605\u4f1a\u8bdd\uff0cpin \u4e0d\u4f5c\u4efb\u4f55\u72ec\u7acb\u89d2\u8272\u58f0\u79f0\uff1b</li> <li>\u8bda\u5b9e\u6027\u4fee\u6b63\uff082026-08-05\uff09\uff1a\u65e7 pin\uff081.0.0\u30011.1.0\uff09\u66fe\u643a\u5e26 <code>independent-r2</code> provenance \u4e0e\u72ec\u7acb\u91cd\u7b7e\u53d9\u4e8b\uff0c\u8be5\u58f0\u79f0\u4e0e\u672c\u4ed3\u4e8b\u5b9e\u4e0d\u7b26\uff0c\u5df2\u5c31\u5730\u4fee\u6b63 provenance \u4e0e note\uff1b\u4fee\u6b63\u53ea\u89e6\u53ca provenance/note \u4e24\u5904\u8bda\u5b9e\u6027\u5b57\u6bb5\uff0c\u4e0d\u6539\u53d8\u4efb\u4f55 digest \u6216 facts \u5b57\u6bb5\uff0c\u65e7 pin \u7ee7\u7eed\u4f5c\u4e3a\u53ea\u8bfb\u517c\u5bb9\u5b58\u6863\uff1b</li> <li>Contracts 1.1.1\uff082026-08-05\uff09\uff1a\u4ec5\u63cf\u8ff0\u8865\u4e01\uff08migration-manifest schema \u4e09\u5904 description \u6539\u5199\u4e3a\u7a33\u5b9a\u4ea7\u54c1\u8bed\u4e49\uff1b\u65e0\u4efb\u4f55\u6821\u9a8c\u5173\u952e\u5b57\u3001\u516c\u5f00 API\u3001\u9519\u8bef\u7801\u3001\u89c4\u5219\u6216\u5f15\u64ce\u53c2\u6570\u53d8\u5316\uff09\u3002\u6309\u672c\u751f\u547d\u5468\u671f\u65b0\u589e <code>contracts-1.1.1.pin.json</code> \u4e3a\u73b0\u884c\u57fa\u7ebf\uff0c<code>contracts-1.1.0.pin.json</code> \u8f6c\u4e3a\u53ea\u8bfb\u517c\u5bb9\u5b58\u6863\u30021.1.1 pin \u76f8\u5bf9 1.1.0 pin \u7684\u51c6\u786e\u4e8b\u5b9e\uff1a\u6821\u9a8c\u8bed\u4e49\u548c\u4e8b\u5b9e\u6e05\u5355\u4e0d\u53d8\uff08<code>facts</code> \u9010\u9879\u4e00\u81f4\uff09\uff1b\u56db\u4e2a Contracts \u6587\u6863\uff08registry\u3001error-codes\u3001rules\u3001kernel-protocol\uff09\u56e0\u5185\u5d4c <code>contractsVersion</code> \u4ece <code>1.1.0</code> \u66f4\u65b0\u5230 <code>1.1.1</code> \u800c\u6539\u53d8\u6458\u8981\uff1bmigration-manifest Schema \u56e0\u4e0a\u8ff0\u4e09\u5904 description \u66f4\u65b0\u800c\u6539\u53d8\u6458\u8981\uff1b\u5176\u4f59\u4e94\u4e2a Schema\uff08project-manifest\u3001profile-descriptor\u3001managed-file-lock\u3001operation-request\u3001operation-result\uff09\u6458\u8981\u4e0d\u53d8\u3002<code>proof-independence.mjs</code> \u7684 P5 \u5f3a\u5236\u8fd9\u5957\u5982\u5b9e\u58f0\u660e\u7684 provenance \u8bcd\u6c47\uff08pin\uff1a<code>product-compatibility-fixture</code>\uff1b\u53d8\u5f02\u5939\u5177\uff1a<code>product-fixture</code>\uff09\uff1b</li> <li>Contracts 1.2.0\uff082026-08-09\uff09\uff1a\u62a5\u544a\u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>report-model</code>\u3001<code>report-binding</code> \u4e24\u4e2a\u9876\u5c42\u5951\u7ea6\u548c SFC3001\uff5eSFC3003 \u62a5\u544a\u9519\u8bef\u7801\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002</li> <li>Contracts 1.3.0\uff082026-08-09\uff09\uff1a\u5bbf\u4e3b\u63a5\u5165\u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>host-descriptor</code>\u3001<code>host-capability-fact</code>\u3001<code>adapter-build-manifest</code>\u3001<code>host-operation-plan</code>\u3001<code>host-operation-receipt</code> \u4e94\u4e2a\u9876\u5c42\u5951\u7ea6\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002</li> <li>Contracts 1.4.0\uff082026-08-09\uff09\uff1a\u6301\u4e45\u72b6\u6001\u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>state-event-envelope</code>\u3001<code>state-snapshot-metadata</code> \u4e24\u4e2a\u9876\u5c42\u5951\u7ea6\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002</li> <li>Contracts 1.5.0\uff082026-08-16\uff09\uff1aFND-ADR-010/011 \u80fd\u529b\u7ebf\u589e\u91cf\uff0c\u4e0d\u662f\u63cf\u8ff0\u8865\u4e01\uff1a\u65b0\u589e <code>declared-read-surface-result</code>\u3001<code>structured-scan-policy</code> \u4e24\u4e2a\u9876\u5c42\u5951\u7ea6\uff08\u9876\u5c42\u5bf9\u8c61\u96c6\u5408 20 \u2192 22\uff09\uff0c\u6539\u53d8\u4e86\u516c\u5f00\u673a\u5668\u5408\u540c\u4e0e\u5ba1\u8ba1\u4e8b\u5b9e\u3002<code>contracts-1.5.0.pin.json</code> \u662f\u5f53\u524d\u73b0\u884c\u57fa\u7ebf\uff1b1.4.0 \u53ca\u66f4\u65e9 pin \u4fdd\u7559\u4e3a\u53ea\u8bfb\u517c\u5bb9\u5b58\u6863\u3002\u8be5 pin \u7684\u6458\u8981\u4e0e\u4e8b\u5b9e\u5747\u4ece\u5f53\u524d <code>describeAuditSurface()/digestAuditSurface()</code> \u673a\u68b0\u6295\u5f71\uff0cprovenance \u4ecd\u4e3a <code>product-compatibility-fixture</code>\u3002</li> <li>\u5ba1\u8ba1\u8fd0\u884c\u65f6\u5148\u505a\u5305\u9501\u9a8c\u8bc1\uff08\u89c1 isolation-and-lockfile.md\uff09\uff0c\u518d\u505a\u53d8\u5f02\u91cd\u653e\uff1bpin \u4e0d\u5339\u914d\u65f6\uff0c\u53d8\u5f02\u91cd\u653e\u7ed3\u679c\u4e0d\u5f97\u88ab\u91c7\u4fe1\u3002</li> </ul>"},{"location":"migration/","title":"\u4e2d\u6587 \u00b7 \u5b58\u91cf\u91c7\u7528\u4e0e\u8fc1\u79fb","text":"<p>English</p>"},{"location":"migration/#\u5b58\u91cf\u91c7\u7528\u4e0e\u8fc1\u79fbFND-070","title":"\u5b58\u91cf\u91c7\u7528\u4e0e\u8fc1\u79fb\uff08FND-070\uff09","text":"<p>\u672c\u9875\u63cf\u8ff0\u5b58\u91cf\u9879\u76ee\u5982\u4f55\u91c7\u7528 Skill Family \u57fa\u7840\u8bbe\u65bd\uff0c\u4ee5\u53ca\u8fc1\u79fb\u5b8c\u6210\u5224\u5b9a\u7684\u95e8\u7981\u3002\u5b83\u670d\u52a1\u4e8e\u4e24\u7c7b\u8bfb\u8005\uff1a\u4eba\u7c7b\u8d1f\u8d23\u4eba\u636e\u6b64\u5224\u65ad\u91c7\u7528\u8def\u5f84\u4e0e\u98ce\u9669\uff1b\u667a\u80fd\u4f53\u636e\u6b64\u7528 <code>adopt-plan</code> \u505a\u53ea\u8bfb\u76d8\u70b9\uff0c\u4e0d\u5728\u672c\u9875\u590d\u5236\u5199\u5165\u52a8\u4f5c\u3002</p>"},{"location":"migration/#\u5206\u7c7b\u65b9\u6cd5","title":"\u5206\u7c7b\u65b9\u6cd5","text":"<p>\u5b58\u91cf\u4ed3\u63a5\u5165 Foundation \u524d\uff0c\u5148\u6309\u4e0b\u9762\u56db\u7c7b\u5f52\u7c7b\u3002\u5206\u7c7b\u51b3\u5b9a\u8d70\u54ea\u6761\u8def\u5f84\u3001\u662f\u5426\u5199\u6587\u4ef6\u3001\u65e7\u5b9e\u73b0\u5982\u4f55\u5904\u7406\u3002</p> \u7c7b\u522b \u542b\u4e49 \u5904\u7406\u8def\u5f84 \u662f\u5426\u5199\u6587\u4ef6 <code>direct-adoption</code> \u4ed3\u5185\u5df2\u6709\u80fd\u529b\u53ef\u88ab Foundation \u539f\u6837\u66ff\u4ee3\uff0c\u65e0\u4e1a\u52a1\u8bed\u4e49\u8026\u5408 \u76f4\u63a5\u91c7\u7528\uff1a<code>adopt-plan</code> \u76d8\u70b9 \u2192 <code>scaffold</code>/<code>projection</code> \u843d\u76d8 \u662f\uff08\u53d7\u6536\u5bb9\uff09 <code>compatibility-layer</code> \u4ed3\u5185\u5df2\u6709\u5b9e\u73b0\u4e0e Foundation \u63a5\u53e3\u5b58\u5728\u5dee\u5f02\uff0c\u9700\u4e00\u5c42\u517c\u5bb9\u9002\u914d \u5199\u517c\u5bb9\u5c42\u540e\u91c7\u7528\uff0c\u65e7\u5b9e\u73b0\u7ecf\u517c\u5bb9\u5c42\u9000\u51fa \u662f\uff08\u517c\u5bb9\u5c42\u53d7\u6536\u5bb9\uff09 <code>keep-business</code> \u80fd\u529b\u542b\u9886\u57df\u8bed\u4e49\u6216\u4e1a\u52a1\u72b6\u6001\u673a\uff0c\u5c5e\u4e8e\u8c03\u7528\u65b9\u62e5\u6709\uff0cFoundation \u4e0d\u63a5 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u53ea\u63a5\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236 \u5426\uff08Foundation \u4fa7\uff09 <code>foundation-gap</code> \u9700\u8981\u7684\u80fd\u529b Foundation \u5c1a\u672a\u63d0\u4f9b\uff08\u5982 host apply\u3001Qoder driver\uff09 \u7559\u5728\u6d88\u8d39\u8005\u6216\u540e\u7eed\u7248\u672c\uff0c\u4e0d\u5f3a\u884c\u6269\u5f20 Foundation \u5426 <p>\u5206\u7c7b\u662f\u91c7\u7528\u51b3\u7b56\u7684\u524d\u63d0\u3002\u843d\u5165 <code>keep-business</code> \u6216 <code>foundation-gap</code> \u7684\u80fd\u529b\uff0c\u4e0d\u5e94\u4e3a\u4e86\u300c\u5b8c\u6210\u91c7\u7528\u300d\u800c\u585e\u8fdb Foundation\uff1b\u8fd9\u6b63\u597d\u662f\u67b6\u6784\u8def\u7531\u7b2c 1\u30018 \u6b65\u7684\u843d\u5730\u3002</p>"},{"location":"migration/#\u539f\u5219","title":"\u539f\u5219","text":"<ol> <li>\u8ba1\u5212\u5148\u884c\uff1a\u4efb\u4f55\u5b58\u91cf\u4ed3\u5148\u8fd0\u884c\u53ea\u8bfb <code>adopt-plan</code>\uff0c\u62ff\u5230\u73b0\u72b6\u3001\u76ee\u6807 Profile\u3001\u7cbe\u786e\u5199\u96c6\u3001\u51b2\u7a81\u3001\u65e7\u5b9e\u73b0\u9000\u51fa\u6e05\u5355\u4e0e\u9a8c\u6536\u547d\u4ee4\uff0c\u518d\u51b3\u5b9a\u662f\u5426\u6267\u884c\u5199\u5165\u3002</li> <li>\u53ea\u8bfb\u8ba1\u5212\u96f6\u53d8\u5316\uff1a<code>adopt-plan</code> \u4e0d\u5199\u4efb\u4f55\u6587\u4ef6\uff08\u542b\u4e34\u65f6\u6587\u4ef6\uff09\u3001\u4e0d\u8fd0\u884c git \u5199\u547d\u4ee4\u3001\u4e0d\u6539\u540d\u3001\u4e0d\u89e6\u78b0\u8fdc\u7aef\uff1b\u5bf9\u8f93\u5165\u4ed3\u5b57\u8282\u96f6\u53d8\u5316\uff08\u524d\u540e\u54c8\u5e0c\u8d70\u67e5\u53ef\u8bc1\uff09\u3002</li> <li>\u91c7\u7528\u4e0e\u6539\u540d\u5206\u79bb\uff1a\u57fa\u7840\u8bbe\u65bd\u91c7\u7528\u7edd\u4e0d\u8fde\u5e26\u4ed3\u5e93\u6539\u540d\u6216\u8fdc\u7aef\u5750\u6807\u53d8\u66f4\uff1b\u4e24\u8005\u662f\u72ec\u7acb\u51b3\u7b56\uff0c\u5de5\u5177\u4e0d\u63d0\u4f9b\u4efb\u4f55\u6539\u540d\u80fd\u529b\u3002</li> <li>\u53cc\u8f68\u4e0d\u7b97\u5b8c\u6210\uff1a\u8fc1\u79fb\u5b8c\u6210\u5224\u5b9a\u8981\u6c42\u65e7\u91cd\u590d\u5b9e\u73b0\u5df2\u5220\u9664\uff1b\u53ea\u63a5\u5165\u65b0\u57fa\u7840\u8bbe\u65bd\u800c\u65e7\u5b9e\u73b0\u4ecd\u5728\uff0c\u5224\u5b9a\u6052\u4e3a false\u3002</li> </ol>"},{"location":"migration/#adopt-plan-\u8f93\u51fa\u7ed3\u6784","title":"adopt-plan \u8f93\u51fa\u7ed3\u6784","text":"\u6bb5\u843d \u5185\u5bb9 <code>target</code> \u73b0\u72b6\uff1a\u5165\u53e3\u6570\u3001\u76ee\u6807\u81ea\u6709\u53d7\u7ba1\u58f0\u660e <code>project</code> / <code>traceability</code> \u76ee\u6807 Profile \u4e0e\u6bcf\u9879\u5199\u5165\u7684\u771f\u6e90\uff08Contracts \u7248\u672c\u3001skeleton \u751f\u6210\u51fd\u6570\u3001\u8bb8\u53ef\u8bc1 Profile \u4e0e\u53d8\u4f53\uff09 <code>git</code> \u53ea\u8bfb Git \u524d\u7f6e\u72b6\u6001\uff08\u4ed3\u5e93\u3001HEAD\u3001clean\uff09 <code>writeSet</code> \u7cbe\u786e\u5199\u96c6\uff1a\u6bcf\u8def\u5f84\u7684 action\uff08\u4ec5 <code>create</code>/<code>unchanged</code>\uff09\u3001fileClass\u3001sha256 <code>conflicts</code> \u624b\u5199\u51b2\u7a81\u3001\u53d7\u7ba1\u6f02\u79fb\u3001\u7b26\u53f7\u94fe\u63a5\u5360\u4f4d\u3001\u7f3a\u5b57\u6bb5\u4e34\u65f6\u4f8b\u5916 <code>risks</code> dirty\u3001\u5d4c\u5957\u4ed3\u3001tracked-but-ignored\u3001\u5230\u671f\u4f8b\u5916\u7b49 <code>migration</code> \u8fc1\u79fb\u72b6\u6001\u673a\uff1a\u7ed1\u5b9a\uff08binding\uff09\u3001\u5728\u76d8\u8bc1\u660e\uff08adoptionProof\uff09\u3001\u5f85\u5199\u5165\u6570\u3001check \u95e8\u7981\u3001\u56db\u7c7b\u9a8c\u8bc1\u8bc1\u636e\u3001\u72b6\u6001\u4e0e\u5b8c\u6210\u5224\u5b9a <code>verificationPlan</code> \u9a8c\u6536\u547d\u4ee4\u5e8f\u5217\uff08check \u2192 projection \u2192 \u590d\u67e5\uff09"},{"location":"migration/#\u8fc1\u79fb\u6e05\u5355skill-familymigrationjson","title":"\u8fc1\u79fb\u6e05\u5355\uff08skill-family.migration.json\uff09","text":"<p>\u76ee\u6807\u4ed3\u5728\u6839\u76ee\u5f55\u58f0\u660e\u81ea\u5df1\u7684\u8fc1\u79fb\u72b6\u6001\uff1a</p> <pre><code>{\n \"kind\": \"skill-family.migration-manifest\",\n \"legacyInfra\": [\n { \"path\": \"scripts/old-validator.mjs\", \"replacedBy\": \"sf-kit check\" }\n ],\n \"exceptions\": [\n {\n \"owner\": \"\u8d1f\u8d23\u4eba\",\n \"reason\": \"\u5177\u4f53\u539f\u56e0\",\n \"deadline\": \"2026-12-31\",\n \"migrationTarget\": \"wave-m1\"\n }\n ],\n \"targetProfile\": \"generic\",\n \"foundationPackages\": [\n { \"name\": \"skill-family-contracts\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 \u4f4d\u5341\u516d\u8fdb\u5236>\" },\n { \"name\": \"skill-family-harness-node\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 \u4f4d\u5341\u516d\u8fdb\u5236>\" },\n { \"name\": \"skill-family-engineering-kit\", \"version\": \"0.3.0\", \"digest\": \"sha256:<64 \u4f4d\u5341\u516d\u8fdb\u5236>\" }\n ],\n \"verification\": {\n \"unit\": \"docs/evidence/unit.json\",\n \"integration\": \"docs/evidence/integration.json\",\n \"consumer\": \"docs/evidence/consumer.json\",\n \"independentAudit\": \"docs/evidence/independent-audit.json\"\n }\n}\n</code></pre> <p>\u4ee5\u4e0a\u7ed3\u6784\u5c55\u793a\u4e86\u8fc1\u79fb\u6e05\u5355\u7684\u6838\u5fc3\u5b57\u6bb5\uff1b<code>legacyInfra</code> \u6bcf\u9879\u7ed9\u51fa\u65e7\u5b9e\u73b0\u8def\u5f84\u4e0e\u66ff\u4ee3\u7269\uff0c\u5de5\u5177\u53ea\u8bfb\u8bc4\u4f30\u5b58\u5728\u6027\uff0c\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\u3002</p> <p>0.3.0 \u4e2d\u7684 Quickstart Profile candidate \u5df2\u5347\u7ea7\u5230 v2\u3002\u8fc1\u79fb\u6e05\u5355\u82e5\u7ed1\u5b9a candidate \u80fd\u529b\uff0c\u4e09\u4e2a Foundation \u5305\u5fc5\u987b\u7edf\u4e00\u7cbe\u786e\u9501\u5b9a\u4e3a 0.3.0\uff1b\u4ecd\u9700 v1 \u7684\u5b58\u91cf\u63a5\u5165\u7ee7\u7eed\u7edf\u4e00\u9501\u5b9a 0.2.1\uff0c\u4e0d\u6df7\u88c5\u4e24\u7ec4\u7248\u672c\u3002</p> <ul> <li><code>legacyInfra</code> \u6bcf\u9879\u7ed9\u51fa\u65e7\u5b9e\u73b0\u8def\u5f84\u4e0e\u66ff\u4ee3\u7269\uff1b\u5de5\u5177\u53ea\u8bfb\u8bc4\u4f30\u5b58\u5728\u6027\uff0c\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\u3002</li> <li><code>exceptions</code> \u662f\u4e34\u65f6\u4f8b\u5916\uff1a\u5fc5\u987b\u540c\u65f6\u542b\u8d1f\u8d23\u4eba\uff08owner\uff09\u3001\u539f\u56e0\uff08reason\uff09\u3001\u622a\u6b62\u65f6\u95f4\uff08deadline\uff09\u3001\u8fc1\u79fb\u76ee\u6807\uff08migrationTarget\uff09\u56db\u9879\uff0c\u7f3a\u4efb\u4e00\u5b57\u6bb5\u5373\u8ba1\u4e3a\u51b2\u7a81\uff08\u8ba1\u5212\u5931\u8d25\uff09\uff1b\u5230\u671f\u4f8b\u5916\u4e0d\u81ea\u52a8\u7eed\u671f\uff0c\u6301\u7eed\u963b\u65ad\u5b8c\u6210\u5224\u5b9a\u3002</li> <li><code>targetProfile</code> / <code>foundationPackages</code>\uff1a\u91c7\u7528\u7ed1\u5b9a\u3002\u76ee\u6807 Profile \u5fc5\u987b\u4e0e\u8ba1\u5212 Profile \u4e00\u81f4\uff1b\u4e09\u4e2a Foundation \u5305\uff08contracts\u3001harness-node\u3001engineering-kit\uff09\u5fc5\u987b\u5404\u81ea\u7ed1\u5b9a\u7cbe\u786e\u7248\u672c\u53f7\uff08\u4e0d\u63a5\u53d7\u6d6e\u52a8\u8303\u56f4\uff09\u4e0e <code>sha256:</code> \u6458\u8981\u3002</li> <li><code>verification</code>\uff1a\u56db\u7c7b\u9a8c\u8bc1\u8bc1\u636e\u6587\u6863\u8def\u5f84\uff08unit\u3001integration\u3001consumer\u3001independentAudit\uff09\u3002\u6bcf\u4efd\u8bc1\u636e\u5fc5\u987b\u662f\u53ef\u89e3\u6790 JSON \u4e14\u5176 <code>projectId</code> \u4e0e\u76ee\u6807\u9879\u76ee\u8eab\u4efd\u4e00\u81f4\uff0c\u624d\u8ba1\u4e3a proven\uff1b\u8def\u5f84\u8d8a\u754c\u3001\u7f3a\u5931\u3001\u4e0d\u53ef\u89e3\u6790\u3001\u8eab\u4efd\u4e0d\u7b26\u5747\u4e3a\u672a\u8bc1\u660e\uff0cfail-closed\u3002</li> </ul>"},{"location":"migration/#\u8fc1\u79fb\u72b6\u6001\u673a","title":"\u8fc1\u79fb\u72b6\u6001\u673a","text":"<p>\u72b6\u6001\u5355\u8c03\u9012\u8fdb\uff0c\u53ea\u7531\u53ea\u8bfb\u8bc1\u636e\u63a8\u5bfc\uff0c\u4efb\u4f55\u5de5\u5177\u90fd\u4e0d\u901a\u8fc7\u5199\u5165\u63a8\u8fdb\u72b6\u6001\uff1a</p> <pre><code>not-declared \u2192 declared \u2192 adopted \u2192 verified \u2192 complete\n</code></pre> \u72b6\u6001 \u542b\u4e49 <code>not-declared</code> \u4e0d\u5b58\u5728\u5951\u7ea6\u6709\u6548\u7684\u8fc1\u79fb\u6e05\u5355 <code>declared</code> \u6e05\u5355\u5951\u7ea6\u6709\u6548\uff0c\u4f46\u91c7\u7528\u4e8b\u5b9e\u8bc1\u660e\u4e0d\u5168 <code>adopted</code> Foundation \u5b57\u8282\u5df2\u5728\u76d8\u4e14\u65e7\u5b9e\u73b0\u5df2\u9000\u51fa\uff0ccheck \u95e8\u7981\u672a\u7eff <code>verified</code> check \u95e8\u7981\u7eff\uff0c\u9a8c\u8bc1\u8bc1\u636e\u672a\u5168\u90e8 proven <code>complete</code> \u516b\u9879\u5b8c\u6210\u6761\u4ef6\u5168\u90e8\u6ee1\u8db3\uff1b<code>complete</code> \u4e3a\u771f\u5f53\u4e14\u4ec5\u5f53\u72b6\u6001\u4e3a <code>complete</code>"},{"location":"migration/#\u5b8c\u6210\u5224\u5b9a\u95e8\u7981","title":"\u5b8c\u6210\u5224\u5b9a\u95e8\u7981","text":"<p><code>migration.completion.complete</code> \u4e3a true \u5f53\u4e14\u4ec5\u5f53\u5168\u90e8\u516b\u9879\u6210\u7acb\uff1a</p> <ol> <li>\u5df2\u58f0\u660e\u5951\u7ea6\u6709\u6548\u7684\u8fc1\u79fb\u6e05\u5355\uff08kind/\u5b57\u6bb5\u7ecf Contracts schema \u6821\u9a8c\uff09\uff1b</li> <li>\u91c7\u7528\u7ed1\u5b9a\u5df2\u8bc1\u660e\uff1a\u76ee\u6807 Profile \u4e0e\u8ba1\u5212\u4e00\u81f4\uff0c\u4e09\u4e2a Foundation \u5305\u5747\u7ed1\u5b9a\u7cbe\u786e\u7248\u672c\u4e0e sha256 \u6458\u8981\uff1b</li> <li>Project Manifest\u3001managed lock\u3001identity \u4e0e\u5168\u90e8\u53d7\u7ba1\u9aa8\u67b6\u6587\u4ef6\u5728\u76d8\u4e14\u6458\u8981\u4e0e\u8ba1\u5212\u4e00\u81f4\uff08<code>adoptionProof.missing</code>/<code>mismatched</code> \u4e3a\u7a7a\uff09\uff1b</li> <li>\u5199\u96c6\u4e2d\u65e0\u5f85\u6267\u884c\u7684 create/replace/project \u52a8\u4f5c\uff08<code>pendingWrites</code> \u4e3a 0\uff09\uff1b</li> <li>Foundation check \u95e8\u7981\u7eff\uff1b</li> <li>\u6bcf\u9879\u65e7\u5b9e\u73b0\u5747\u5df2\u9000\u51fa\uff08absent\uff09\u2014\u2014containment \u62d2\u7edd\u6216\u7578\u5f62\u6761\u76ee\u4e0e present \u540c\u7b49 fail-closed\uff1b</li> <li>\u65e0\u7f3a\u5b57\u6bb5\u3001\u65e0\u4e0d\u53ef\u89e3\u6790\u622a\u6b62\u65f6\u95f4\u3001\u65e0\u5df2\u5230\u671f\u7684\u4e34\u65f6\u4f8b\u5916\uff1b\u65e0\u672a\u89e3\u51b3\u7684\u91c7\u7528\u51b2\u7a81\uff1b</li> <li>\u56db\u7c7b\u9a8c\u8bc1\u8bc1\u636e\uff08unit/integration/consumer/independentAudit\uff09\u5168\u90e8 proven \u4e14\u8eab\u4efd\uff08projectId\uff09\u5339\u914d\u3002</li> </ol> <p>\u672a\u8bc4\u4f30\u7684\u8f93\u5165\u4e0e\u672a\u8bc1\u660e\u7b49\u4ef7\uff1a\u95e8\u7981\u53ea\u4f9d\u636e\u51fa\u793a\u7684\u8bc1\u636e\u524d\u8fdb\u3002\u963b\u65ad\u7406\u7531\uff08<code>blockers</code>\uff09\u4e3a\u7a33\u5b9a\u53ef\u8bfb\u5b57\u7b26\u4e32\uff0c\u53ef\u76f4\u63a5\u8fdb\u5165\u8fc1\u79fb\u8bc4\u5ba1\u8bb0\u5f55\u3002</p>"},{"location":"migration/#\u5f3a\u5236\u8d1f\u4f8b\u4efb\u4e00\u573a\u666f-completion-\u5fc5\u987b\u4e3a-false","title":"\u5f3a\u5236\u8d1f\u4f8b\uff08\u4efb\u4e00\u573a\u666f completion \u5fc5\u987b\u4e3a false\uff09","text":"<ul> <li>\u7a7a\u4ed3 + \u7a7a\u6e05\u5355\uff08\u65e0\u5951\u7ea6\u6709\u6548\u6e05\u5355 \u2192 <code>not-declared</code>\uff09\uff1b</li> <li>\u6e05\u5355 kind \u9519\u8bef\uff08schema-invalid \u2192 \u89c6\u540c\u672a\u58f0\u660e\uff09\uff1b</li> <li>9 \u4e2a\u9aa8\u67b6\u6587\u4ef6\u4ecd\u5f85 create\uff08<code>declared</code>\uff0c\u5217\u51fa\u5168\u90e8\u7f3a\u5931\u8def\u5f84\uff09\uff1b</li> <li>managed lock \u6f02\u79fb\uff08<code>mismatched</code> \u975e\u7a7a\uff09\uff1b</li> <li>\u53ea\u63a5\u5165\u65b0\u5b9e\u73b0\u3001\u65e7\u5b9e\u73b0\u4ecd\u5728\uff08\u53cc\u8f68 \u2192 <code>declared</code>\uff09\uff1b</li> <li>\u6d88\u8d39\u8005\u9a8c\u8bc1\u8bc1\u636e\u7f3a\u5931\u6216\u8eab\u4efd\u4e0d\u7b26\uff08<code>verified</code>\uff0c\u4e0d\u5f97 complete\uff09\uff1b</li> <li>\u4e34\u65f6\u4f8b\u5916\u8fc7\u671f\uff08\u5de5\u5177\u7edd\u4e0d\u7eed\u671f\uff09\u3002</li> </ul>"},{"location":"migration/#\u65e7\u5b9e\u73b0\u5220\u9664\u4e0e\u56de\u6eda\u5408\u540c","title":"\u65e7\u5b9e\u73b0\u5220\u9664\u4e0e\u56de\u6eda\u5408\u540c","text":"<ul> <li>\u5220\u9664\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff1a<code>adopt-plan</code> \u53ea\u8bc4\u4f30\u65e7\u5b9e\u73b0\u5b58\u5728\u6027\u5e76\u5217\u51fa\u9000\u51fa\u6e05\u5355\uff0c\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\uff1b<code>foundation-gap</code> \u4e0e <code>keep-business</code> \u7c7b\u80fd\u529b\u4e0d\u8981\u6c42\u5220\u9664\u3002</li> <li>\u56de\u6eda\u4ee5\u8bc1\u636e\u4e3a\u51c6\uff1a\u91c7\u7528\u843d\u76d8\u524d\u5fc5\u987b\u5148\u6709 <code>adoptionProof</code> \u4e0e <code>foundationPlanDigest</code> \u53cc\u6458\u8981\u7ed1\u5b9a\uff1b\u56de\u6eda\u65f6\u4ee5\u8ba1\u5212\u5199\u96c6\u7684 <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u8fd8\u539f\uff0c\u672a\u58f0\u660e\u524d\u7f6e\u72b6\u6001\u7684\u8986\u76d6\u52a8\u4f5c\u5728 <code>projection</code> \u9636\u6bb5\u5373\u62d2\u7edd\u3002</li> <li>fail-closed \u9ed8\u8ba4\uff1a\u4efb\u4f55\u4e0d\u53ef\u89e3\u6790\u3001\u8d8a\u754c\u3001\u8eab\u4efd\u4e0d\u7b26\u6216\u8bc1\u636e\u7f3a\u5931\u7684\u8f93\u5165\uff0c\u90fd\u4f7f\u5bf9\u5e94\u5224\u5b9a\u4e3a\u672a\u8bc1\u660e\uff0c\u4e0d\u5047\u8bbe\u6210\u529f\u3002</li> </ul>"},{"location":"migration/#\u5341\u5b57\u6bb5-hand-off-\u8349\u6848","title":"\u5341\u5b57\u6bb5 hand-off \u8349\u6848","text":"<p><code>adopt-plan</code> \u8f93\u51fa\u643a\u5e26 <code>handoffDraft</code> \u5b50\u5757\uff08kind=<code>skill-family.handoff-draft</code>\uff0cschemaVersion=1\uff09\uff0c\u4e3a planner \u4fa7\u7684\u5341\u5b57\u6bb5 hand-off \u63d0\u4f9b\u7ed3\u6784\u5316\u6570\u636e\u8349\u6848\u3002\u5b57\u6bb5\u6765\u6e90\u53ea\u6709\u4e24\u79cd\uff1a<code>derived</code>\uff08\u53ef\u7531\u53ea\u8bfb\u8bc1\u636e\u673a\u68b0\u63a8\u5bfc\uff09\u4e0e <code>INCOMPLETE</code>\uff08\u4e0d\u53ef\u673a\u68b0\u63a8\u5bfc\uff0c\u7edd\u4e0d\u731c\u6d4b\uff09\u3002\u5341\u5b57\u6bb5\u4e0e\u6e90\u7801\u5e38\u91cf <code>HANDOFF_FIELDS</code> \u9010\u4e00\u5bf9\u5e94\uff1a</p> id \u5b57\u6bb5\u540d \u6765\u6e90 1 <code>project-identity</code> derived 2 <code>repository-state</code> derived 3 <code>foundation-binding</code> derived\uff08\u6e05\u5355\u5df2\u58f0\u660e\u7ed1\u5b9a\uff09\uff0fINCOMPLETE\uff08\u65e0\u6e05\u5355\u58f0\u660e\uff09 4 <code>write-set-policy</code> derived 5 <code>legacy-exits</code> derived 6 <code>business-logic-to-keep</code> \u6052 INCOMPLETE 7 <code>plan-summary</code> derived 8 <code>verification-entries</code> derived\uff08\u56db\u7c7b\u8bc1\u636e\u5168\u90e8 proven\uff09\uff0fINCOMPLETE\uff08\u4efb\u4e00\u672a\u8bc1\u660e\uff09 9 <code>legacy-removal-recovery</code> \u6052 INCOMPLETE 10 <code>authorization-status</code> derived\uff08commit/push/tag/publish \u6052\u4e3a false\uff09"},{"location":"migration/#INCOMPLETE-\u963b\u65ad\u89c4\u5219","title":"INCOMPLETE \u963b\u65ad\u89c4\u5219","text":"<ul> <li>\u4efb\u4f55 INCOMPLETE \u5b57\u6bb5\u90fd\u4f7f <code>ready=false</code>\uff1a\u8349\u6848\u5e26\u7f3a\u53e3\u5c31\u4e0d\u5f97\u8fdb\u5165 hand-off\u3002</li> <li>\u5de5\u5177\u7edd\u4e0d\u731c\u6d4b\u4e0d\u53ef\u673a\u68b0\u63a8\u5bfc\u7684\u5b57\u6bb5\uff1a</li> <li><code>business-logic-to-keep</code> \u4e0e <code>legacy-removal-recovery</code> \u6052 INCOMPLETE\uff0c\u5fc5\u987b\u7531\u4eba\u7c7b\u8d1f\u8d23\u4eba\u7ed9\u51fa\uff0c\u5de5\u5177\u65e0\u63a8\u5bfc\u4f9d\u636e\uff1b</li> <li><code>foundation-binding</code> \u5728\u65e0\u8fc1\u79fb\u6e05\u5355\u58f0\u660e\uff08<code>foundationPackages</code>\uff09\u65f6 INCOMPLETE\uff0c\u53ea\u8ba1\u6e05\u5355\u58f0\u660e\u7684\u7ed1\u5b9a\uff1b</li> <li><code>verification-entries</code> \u5728\u56db\u7c7b\u8bc1\u636e\uff08unit/integration/consumer/independentAudit\uff09\u4efb\u4e00\u672a\u8fbe proven \u65f6 INCOMPLETE\u3002</li> </ul>"},{"location":"migration/#\u7ed1\u5b9a","title":"\u7ed1\u5b9a","text":"<p>\u8349\u6848\u643a\u5e26\u53cc sha256 \u6458\u8981\uff08<code>binding</code> \u5757\uff09\uff1a<code>targetSetDigest</code> \u6c47\u603b\u76ee\u6807\u4ed3\u6587\u4ef6\u96c6\u5408\uff0c<code>foundationPlanDigest</code> \u6c47\u603b Foundation \u8ba1\u5212\u5199\u96c6\u3002\u540c\u4e00\u76ee\u6807\u4e24\u6b21\u8ba1\u5212\u5f97\u5230\u76f8\u540c\u6458\u8981\uff0c\u8349\u6848\u4e0e\u8ba1\u5212\u65f6\u523b\u7684\u76ee\u6807\u72b6\u6001\u7cbe\u786e\u7ed1\u5b9a\u3002</p>"},{"location":"migration/#\u6e32\u67d3\u8fb9\u754c","title":"\u6e32\u67d3\u8fb9\u754c","text":"<ul> <li>\u6e32\u67d3\u5668\u53ea\u5199 planner \u4fa7\u7684 hand-off \u8349\u6848\uff0c\u7edd\u4e0d\u5199\u6d88\u8d39\u8005\u4ed3\uff1b</li> <li>\u4e0d\u65b0\u589e\u7b2c\u4e94\u4e2a Kit \u9876\u5c42\u547d\u4ee4\uff1aKit \u9876\u5c42\u547d\u4ee4\u6052\u4e3a scaffold\u3001adopt-plan\u3001projection\u3001check \u56db\u4e2a\uff0c<code>handoffDraft</code> \u53ea\u662f <code>adopt-plan</code> \u8f93\u51fa\u7684\u5b50\u5757\u3002</li> </ul>"},{"location":"migration/#\u5371\u5bb3\u7c7b-fixture","title":"\u5371\u5bb3\u7c7b fixture","text":"<p><code>fixtures/adoption/cases/</code> \u8986\u76d6\u4e03\u4e2a\u5371\u5bb3\u7c7b\uff1adirty \u4ed3\u3001\u5d4c\u5957\u4ed3\u3001tracked-but-ignored\u3001\u7b26\u53f7\u94fe\u63a5\u5360\u4f4d\u3001\u751f\u6210\u7269\u6f02\u79fb\u3001\u65e7\u5b9e\u73b0\u9000\u51fa\u95e8\u7981\u3001\u4e34\u65f6\u4f8b\u5916\u5b57\u6bb5\u3002\u6bcf\u4e2a\u6848\u4f8b\u4ee5\u5b57\u8282\u7ea7\u524d\u540e\u5feb\u7167\u8bc1\u660e\u8ba1\u5212\u53ea\u8bfb\uff1b\u6848\u4f8b\u8bf4\u660e\u89c1\u4ed3\u5185 <code>fixtures/adoption/README.md</code>\u3002</p>"},{"location":"public/status/","title":"Skill Family Foundation \u2014 \u516c\u5f00\u72b6\u6001","text":"<p>\u672c\u9875\u662f\u672c\u9759\u6001\u53d1\u5e03\u5feb\u7167\u7684\u76ee\u6807\u5750\u6807\u548c\u9a8c\u8bc1\u5165\u53e3\u3002\u9875\u9762\u53ea\u4ece\u5404\u5305 package.json \u7684\u7248\u672c\u771f\u6e90\u673a\u68b0\u751f\u6210\uff0c\u7531 <code>node scripts/render-public-status.mjs --check</code> \u96f6\u5199\u5165\u91cd\u7b97\u5e76\u9010\u5b57\u8282\u6821\u9a8c\u3002</p>"},{"location":"public/status/#\u5305","title":"\u5305","text":"\u5305 \u7248\u672c \u516c\u5f00\u53d1\u5e03\u955c\u50cf <code>skill-family-contracts</code> 0.5.0 ifoohoo/skill-family-contracts <code>skill-family-harness-node</code> 0.5.0 ifoohoo/skill-family-harness-node <code>skill-family-engineering-kit</code> 0.5.0 ifoohoo/skill-family-engineering-kit"},{"location":"public/status/#\u6587\u6863","title":"\u6587\u6863","text":"<ul> <li>\u516c\u5f00\u6587\u6863\u7ad9</li> </ul>"},{"location":"public/status/#\u9a8c\u8bc1\u5165\u53e3","title":"\u9a8c\u8bc1\u5165\u53e3","text":"<ul> <li>\u672c\u9875\uff1a<code>node scripts/render-public-status.mjs --check</code>\uff08\u96f6\u5199\u5165\u91cd\u7b97\uff0c\u4e0e\u5df2\u63d0\u4ea4\u9875\u9762\u9010\u5b57\u8282\u4e00\u81f4\uff09</li> <li>\u9759\u6001\u7ad9\u4e0e\u57fa\u7ebf\uff1a<code>node scripts/render-public-site.mjs --check</code>\uff08\u51bb\u7ed3 MkDocs \u73af\u5883\u91cd\u7b97\uff0c\u4e0e\u5df2\u63d0\u4ea4\u57fa\u7ebf\u9010\u9879\u4e00\u81f4\uff09</li> <li>\u5de5\u4f5c\u533a\u6839\u95e8\u7981\uff1a<code>pnpm check</code>\uff0811 \u4e2a\u7a33\u5b9a\u4ea7\u54c1\u95e8\u7981\u6309\u56fa\u5b9a\u987a\u5e8f\u4e32\u8054\uff09</li> <li>registry\u3001Pages \u4e0e Release \u7684\u5b9e\u65f6\u8fdc\u7aef\u72b6\u6001\uff1a\u7531\u53d1\u5e03\u540e\u9a8c\u8bc1\u62a5\u544a\u8bc1\u660e\uff0c\u4e0d\u5728\u672c\u9875\u8bb0\u5f55</li> </ul>"},{"location":"public/status/#\u8bf4\u660e","title":"\u8bf4\u660e","text":"<ul> <li>\u672c\u9875\u4e0d\u5ba3\u79f0\u4efb\u4f55\u7248\u672c\u5df2\u5728\u8fdc\u7aef\u53d1\u5e03\uff1b\u53d1\u5e03\u52a8\u4f5c\u662f\u5426\u5df2\u6267\u884c\u7531\u53d1\u5e03\u540e\u7684\u8fdc\u7aef\u9a8c\u8bc1\u62a5\u544a\u8bc1\u660e\u3002</li> <li>\u4e09\u4e2a\u5305\u5747\u4e3a\u72ec\u7acb\u53d1\u5e03\u5230 npm \u7684\u516c\u5f00\u53d1\u5e03\u76ee\u6807\u3002</li> <li>\u8bb8\u53ef\u8bc1\uff1aApache-2.0</li> <li>\u79c1\u6709\u5de5\u4f5c\u533a\u4ed3\u4e0d\u5bf9\u5916\u53ef\u89c1\uff1b\u516c\u5f00\u53d1\u5e03\u7269\u53ea\u7ecf\u5404\u5305 public \u53d1\u5e03\u955c\u50cf\u4ed3\u4e0e npm tarball \u5206\u53d1\u3002</li> </ul>"},{"location":"recipes/","title":"\u4e2d\u6587 \u00b7 Recipes","text":"<p>English</p>"},{"location":"recipes/#Recipe-\u7d22\u5f15","title":"Recipe \u7d22\u5f15","text":"<p>\u672c\u76ee\u5f55\u7ed9\u5e38\u89c1\u67b6\u6784\u9700\u6c42\u63d0\u4f9b\u53ef\u76f4\u63a5\u590d\u5236\u6267\u884c\u7684\u6700\u5c0f\u505a\u6cd5\u3002\u6bcf\u4e2a recipe \u6309\u56fa\u5b9a\u4e5d\u6bb5\u7ec4\u7ec7\uff1a\u573a\u666f\u4e0e\u975e\u573a\u666f\u3001\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c\u3001\u6700\u5c0f\u4ee3\u7801\u6216\u547d\u4ee4\u3001\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e\u3001\u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b\u3001\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4\u3001\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91\u3001\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879\u3002</p>"},{"location":"recipes/#\u9009\u62e9\u89c4\u5219","title":"\u9009\u62e9\u89c4\u5219","text":"<ul> <li>\u9700\u6c42\u542b\u9886\u57df\u8bed\u4e49 / \u72b6\u6001\u673a / \u5ba1\u8ba1 oracle \u2192 \u7559\u5728\u6d88\u8d39\u8005\uff0c\u4e0d\u5728\u8fd9\u91cc\u627e Foundation \u80fd\u529b\u3002</li> <li>\u9700\u8981\u7ed3\u6784\u6216\u534f\u8bae\u6821\u9a8c \u2192 \u770b <code>domain-schema-validation</code>\u3002</li> <li>\u9700\u8981\u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u6216\u539f\u5b50\u5199 \u2192 \u770b <code>safe-filesystem-and-atomic-write</code>\u3002</li> <li>\u9700\u8981\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a \u2192 \u770b <code>deterministic-human-report</code>\u3002</li> <li>\u9700\u8981\u6301\u4e45\u4e8b\u4ef6\u4e0e\u6d3e\u751f\u5feb\u7167 \u2192 \u770b <code>durable-local-state</code>\u3002</li> <li>\u9700\u8981\u5b58\u91cf\u91c7\u7528\u76d8\u70b9 \u2192 \u770b <code>adopt-existing-repository</code>\u3002</li> <li>\u9700\u8981\u6587\u672c\u8d44\u6e90\u95ed\u5305\u6216\u5bbf\u4e3b\u63a5\u5165 \u2192 \u770b <code>adapter-text-closure</code> / <code>host-profile-integration</code>\u3002</li> <li>\u9700\u8981\u8bd5\u7528 Quickstart Profile v2 \u2192 \u7cbe\u786e\u9501\u5b9a\u4e09\u4e2a\u5305\u7684 0.3.0 candidate \u5b50\u8def\u5f84\uff1b\u9700\u8981 v1 \u65f6\u7ee7\u7eed\u9501\u5b9a 0.2.1\u3002</li> </ul>"},{"location":"recipes/#\u5171\u540c\u9a8c\u8bc1\u7ea6\u5b9a","title":"\u5171\u540c\u9a8c\u8bc1\u7ea6\u5b9a","text":"<ul> <li>\u6240\u6709\u793a\u4f8b\u5728\u65b0\u7684\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u6267\u884c\uff0c\u4e0d\u7559\u4e2a\u4eba\u8def\u5f84\u6216\u51ed\u636e\u3002</li> <li>\u793a\u4f8b\u4e0d\u542b\u4f01\u4e1a\u6807\u8bc6\u3001\u79c1\u6709 Profile\u3001\u771f\u5b9e\u4e1a\u52a1\u6570\u636e\u6216\u4e2a\u4eba\u8def\u5f84\u3002</li> <li>\u6bcf\u4e2a recipe \u81f3\u5c11\u7ed9\u51fa\u4e00\u4e2a\u6b63\u4f8b\u4e0e\u4e00\u4e2a\u8d1f\u4f8b\uff1b\u8d1f\u4f8b\u5fc5\u987b\u4ea7\u751f\u7a33\u5b9a\u5931\u8d25\u7801\u6216\u62d2\u7edd\u3002</li> <li>\u9a8c\u8bc1\u547d\u4ee4\u53ef\u76f4\u63a5\u590d\u5236\u8fd0\u884c\uff1b\u9700\u8981\u5305\u65f6\u5148 <code>npm install</code> \u5bf9\u5e94 <code>@0.3.0</code>\u3002</li> </ul>"},{"location":"recipes/#\u80fd\u529b-ID-\u603b\u89c8","title":"\u80fd\u529b ID \u603b\u89c8","text":"Recipe \u9996\u9009\u80fd\u529b ID adopt-existing-repository <code>foundation.kit.adopt-plan</code> safe-filesystem-and-atomic-write <code>foundation.harness.path-containment</code>\u3001<code>foundation.harness.atomic-write</code> domain-schema-validation <code>foundation.contracts.object-validation</code> adapter-text-closure <code>foundation.harness.resource-closure</code>\u3001<code>foundation.harness.host-adapter</code> deterministic-human-report <code>foundation.harness.report</code>\u3001<code>foundation.kit.report</code> durable-local-state <code>foundation.harness.state-store</code> host-profile-integration <code>foundation.kit.host</code>\u3001<code>foundation.profile.extension-spi</code>"},{"location":"recipes/adapter-text-closure/","title":"\u4e2d\u6587 \u00b7 Adapter \u6587\u672c\u95ed\u5305","text":"<p>English</p>"},{"location":"recipes/adapter-text-closure/#Recipe\u6587\u672c\u8d44\u6e90\u95ed\u5305\u4e0e\u5bbf\u4e3b\u6784\u5efa","title":"Recipe\uff1a\u6587\u672c\u8d44\u6e90\u95ed\u5305\u4e0e\u5bbf\u4e3b\u6784\u5efa","text":""},{"location":"recipes/adapter-text-closure/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u628a\u4e00\u7ec4\u6587\u672c\u8d44\u6e90\u5f52\u4e00\u6210\u53ef\u590d\u7b97\u7684\u95ed\u5305\uff0c\u5e76\u636e\u6b64\u5728\u53d7\u6536\u5bb9\u5904 materialize \u4e00\u4e2a\u5bbf\u4e3b\u9002\u914d\u6784\u5efa\uff0c\u4e14\u6784\u5efa\u6e05\u5355\u53ef\u5168\u6458\u8981\u590d\u9a8c\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u628a\u4e8c\u8fdb\u5236\u8d44\u6e90\u7eb3\u5165 adapter \u6295\u5f71\uff08\u4ec5\u652f\u6301\u6587\u672c\u95ed\u5305\uff09\uff1b\u9700\u8981 host apply/install/update/uninstall\uff08\u660e\u786e unsupported\uff09\u3002</p>"},{"location":"recipes/adapter-text-closure/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.resource-closure</code>\uff08\u786e\u5b9a\u6027\u95ed\u5305\u4e0e sha256 \u6458\u8981\uff09\u4e0e <code>foundation.harness.host-adapter</code>\uff08adapter source closure / build / manifest \u6821\u9a8c / materialize\uff09\u3002</p>"},{"location":"recipes/adapter-text-closure/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>adapter source \u4e3a\u5df2\u58f0\u660e\u7684\u6587\u672c\u95ed\u5305\uff08<code>content</code> \u53ea\u63a5\u53d7 string\uff0cutf8\uff09\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1amaterialize \u7528 sibling staging + \u5355\u6b21 rename\uff0c\u76ee\u6807\u5df2\u5b58\u5728\u5219\u62d2\u7edd\uff1bprobe \u9ed8\u8ba4\u4e0d spawn\u3001\u4e0d\u8d70 PATH\u3002</li> </ul>"},{"location":"recipes/adapter-text-closure/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import {\n computeResourceClosure,\n buildAdapterClosure,\n verifyAdapterBuildManifest,\n materializeAdapterBuild,\n} from \"skill-family-harness-node\";\n\nconst closure = computeResourceClosure([\n { path: \"skill.json\", content: \"{}\" },\n { path: \"readme.md\", content: \"# demo\" },\n]);\nconst built = buildAdapterClosure(closure);\nverifyAdapterBuildManifest(built.manifest); // \u5168\u6458\u8981\u590d\u9a8c\nawait materializeAdapterBuild(built, { outDir: \"./out\" }); // \u53d7\u6536\u5bb9\u843d\u76d8\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u5148\u7b97\u95ed\u5305\u3001\u518d\u6821\u9a8c\u6e05\u5355\u3001\u6700\u540e\u539f\u5b50 materialize \u7684\u987a\u5e8f\u3002</p>"},{"location":"recipes/adapter-text-closure/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>computeResourceClosure</code> \u8fd4\u56de\u786e\u5b9a\u6027\u95ed\u5305\u5bf9\u8c61\u4e0e sha256 \u6458\u8981\uff1b<code>materializeAdapterBuild</code> \u5728\u53d7\u6536\u5bb9\u76ee\u6807\u5199\u51fa\u4ea7\u7269\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/closure.test.mjs</code> \u4e0e <code>test/host.test.mjs</code>\u3002</p>"},{"location":"recipes/adapter-text-closure/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u4e8c\u8fdb\u5236 content \u4e0d\u652f\u6301 -> \u6821\u9a8c/\u6784\u5efa\u62d2\u7edd\nbuildAdapterClosure({ path: \"x.bin\", content: Buffer.from([0, 1, 2]) });\n// \u629b HarnessError\uff1aadapter source content \u4ec5\u652f\u6301 string (utf8)\n</code></pre> <p>\u6e05\u5355\u6458\u8981\u4e0d\u7b26\u3001\u76ee\u6807\u5df2\u5b58\u5728\u3001\u975e\u53d7\u4fe1\u53ef\u6267\u884c\u6587\u4ef6\u4e5f\u4f1a\u629b\u9519\u3002</p>"},{"location":"recipes/adapter-text-closure/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/closure.test.mjs \\\n packages/skill-family-harness-node/test/host.test.mjs\n</code></pre>"},{"location":"recipes/adapter-text-closure/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u5bbf\u4e3b\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\u3002</li> <li>\u5bbf\u4e3b\u5dee\u5f02\u58f0\u660e\u7531 Profile + Kit host \u5b50\u52a8\u4f5c\u6ce8\u5165\u3002</li> </ul>"},{"location":"recipes/adapter-text-closure/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>host apply \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u672a\u5b9e\u73b0\uff1bQoder \u5b8c\u6574 driver \u4e3a unsupported\u3002</li> <li>materialize \u4e3a\u539f\u5b50 sibling + rename\uff0c\u5931\u8d25\u65f6\u4e0d\u5f71\u54cd\u65e2\u6709\u76ee\u6807\uff1b\u5347\u7ea7\u8ddf\u968f <code>skill-family-harness-node</code> \u7248\u672c\u3002</li> </ul>"},{"location":"recipes/adopt-existing-repository/","title":"\u4e2d\u6587 \u00b7 \u91c7\u7528\u5b58\u91cf\u4ed3\u5e93","text":"<p>English</p>"},{"location":"recipes/adopt-existing-repository/#Recipe\u5b58\u91cf\u4ed3\u53ea\u8bfb\u91c7\u7528\u76d8\u70b9","title":"Recipe\uff1a\u5b58\u91cf\u4ed3\u53ea\u8bfb\u91c7\u7528\u76d8\u70b9","text":""},{"location":"recipes/adopt-existing-repository/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u5bf9\u4e00\u4e2a\u5df2\u5b58\u5728\u7684\u5b58\u91cf\u4ed3\u5224\u65ad\u662f\u5426\u53ef\u91c7\u7528 Foundation\uff0c\u5e76\u62ff\u5230\u7cbe\u786e\u5199\u96c6\u3001\u51b2\u7a81\u4e0e\u65e7\u5b9e\u73b0\u9000\u51fa\u6e05\u5355\uff0c\u4e14\u4e0d\u6539\u52a8\u4efb\u4f55\u5b57\u8282\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u81ea\u52a8\u6539\u5199\u5b58\u91cf\u4ed3\uff08\u7981\u6b62\u5199\u6587\u4ef6\u3001\u7981\u6b62\u81ea\u52a8\u8fc1\u79fb\uff09\uff1b\u9700\u8981\u53d1\u5e03\u5230\u8fdc\u7aef\uff08\u5f52 release-skill\uff09\u3002</p>"},{"location":"recipes/adopt-existing-repository/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.kit.adopt-plan</code>\uff08\u4e25\u683c\u53ea\u8bfb\u76d8\u70b9\u4e0e\u5b8c\u6210\u5224\u5b9a\uff09\u3002\u5b83\u53ea\u8f93\u51fa\uff0c\u4e0d\u5199\u6587\u4ef6\u3001\u4e0d\u8fd0\u884c git \u5199\u547d\u4ee4\u3002</p>"},{"location":"recipes/adopt-existing-repository/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u76ee\u6807\u4ed3\u5b58\u5728\u4e14\u53ef\u88ab\u53ea\u8bfb\u8bbf\u95ee\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a<code>adopt-plan</code> \u5bf9\u8f93\u5165\u4ed3\u5b57\u8282\u96f6\u53d8\u5316\uff1b\u65e7\u5b9e\u73b0\u5220\u9664\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff0c\u5de5\u5177\u7edd\u4e0d\u4ee3\u4e3a\u5220\u9664\u3002</li> </ul>"},{"location":"recipes/adopt-existing-repository/#4-\u6700\u5c0f\u547d\u4ee4","title":"4. \u6700\u5c0f\u547d\u4ee4","text":"<pre><code>npm install --save-dev skill-family-engineering-kit@0.3.0\nnpm exec -- skill-family-kit adopt-plan --root <repo>\n</code></pre>"},{"location":"recipes/adopt-existing-repository/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p>\u8f93\u51fa\u5305\u542b\u73b0\u72b6\uff08<code>target</code>\uff09\u3001\u76ee\u6807 Profile \u4e0e\u8ffd\u6eaf\uff08<code>project</code>/<code>traceability</code>\uff09\u3001\u53ea\u8bfb Git \u524d\u7f6e\u72b6\u6001\uff08<code>git</code>\uff09\u3001\u7cbe\u786e\u5199\u96c6\uff08<code>writeSet</code>\uff09\u3001\u51b2\u7a81\uff08<code>conflicts</code>\uff09\u3001\u98ce\u9669\uff08<code>risks</code>\uff09\u3001\u8fc1\u79fb\u72b6\u6001\u673a\uff08<code>migration</code>\uff09\u4e0e\u9a8c\u6536\u547d\u4ee4\u5e8f\u5217\uff08<code>verificationPlan</code>\uff09\u3002\u8bc1\u636e\u6765\u81ea <code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code> \u4e0e <code>test/migration.test.mjs</code>\u3002</p>"},{"location":"recipes/adopt-existing-repository/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<p>dirty \u4ed3\u8fd0\u884c <code>adopt-plan</code> \u524d\u540e\uff0c\u8f93\u5165\u4ed3\u5b57\u8282\u5fc5\u987b\u5b8c\u5168\u4e00\u81f4\uff08\u54c8\u5e0c\u8d70\u67e5\u53ef\u8bc1\uff09\uff1b\u5de5\u5177\u4e0d\u5199\u4e34\u65f6\u6587\u4ef6\u3001\u4e0d\u89e6\u78b0\u8fdc\u7aef\u3002\u82e5\u8fc1\u79fb\u6e05\u5355\u7f3a <code>exceptions</code> \u5fc5\u586b\u5b57\u6bb5\uff0c\u8ba1\u5212\u76f4\u63a5\u5931\u8d25\uff08\u5b8c\u6210\u5224\u5b9a false\uff09\uff0c\u5de5\u5177\u4e0d\u7eed\u671f\u3002</p>"},{"location":"recipes/adopt-existing-repository/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code># \u6b63\u4f8b\uff1a\u5bf9\u516c\u5f00 fixture \u5b58\u91cf\u4ed3\u505a\u53ea\u8bfb\u76d8\u70b9\nnpm exec -- skill-family-kit adopt-plan --root fixtures/m0-consumer\n\n# \u53ea\u8bfb\u8bca\u65ad\uff0c\u4e0d\u4fee\u590d\nnpm exec -- skill-family-kit check --root fixtures/m0-consumer\n</code></pre>"},{"location":"recipes/adopt-existing-repository/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u65e7\u5b9e\u73b0\u662f\u5426\u9000\u51fa\u3001\u4f55\u65f6\u5220\u9664\uff08\u5de5\u5177\u53ea\u8bc4\u4f30\u5b58\u5728\u6027\u5e76\u5217\u51fa\u9000\u51fa\u6e05\u5355\uff09\u3002</li> <li><code>business-logic-to-keep</code> \u4e0e <code>legacy-removal-recovery</code> \u6052\u4e3a INCOMPLETE\uff0c\u5fc5\u987b\u7531\u4eba\u7c7b\u8d1f\u8d23\u4eba\u7ed9\u51fa\u3002</li> </ul>"},{"location":"recipes/adopt-existing-repository/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li><code>adopt-plan</code> \u53ea\u8bfb\uff0c\u65e0\u5199\u98ce\u9669\uff0c\u65e0\u9700\u56de\u6eda\u3002</li> <li>\u771f\u6b63\u843d\u76d8\u7531 <code>scaffold</code>/<code>projection</code> \u6267\u884c\uff0c\u56de\u6eda\u4ee5 <code>adoptionProof</code> \u4e0e <code>foundationPlanDigest</code> \u53cc\u6458\u8981\u7ed1\u5b9a\u4e3a\u51c6\uff1b\u672a\u58f0\u660e <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u7684\u8986\u76d6\u52a8\u4f5c\u5728 <code>projection</code> \u9636\u6bb5\u5373\u62d2\u7edd\u3002</li> <li>\u82e5\u91c7\u7528 Quickstart Profile candidate\uff0c\u4e09\u4e2a\u5305\u6309\u540c\u4e00 profile \u7cbe\u786e\u9501\u5b9a\uff1av2 \u4f7f\u7528 0.3.0\uff0cv1 \u7ee7\u7eed\u4f7f\u7528 0.2.1\uff0c\u4e0d\u6df7\u88c5\u3002</li> </ul>"},{"location":"recipes/deterministic-human-report/","title":"\u4e2d\u6587 \u00b7 \u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a","text":"<p>English</p>"},{"location":"recipes/deterministic-human-report/#Recipe\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a","title":"Recipe\uff1a\u786e\u5b9a\u6027\u4eba\u7c7b\u62a5\u544a","text":""},{"location":"recipes/deterministic-human-report/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u4ece\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\u6210\u4eba\u7c7b\u53ef\u8bfb\u62a5\u544a\uff08Markdown + digest \u7ed1\u5b9a + \u5206\u7ea7\u68c0\u67e5\uff09\uff0c\u53cc\u8f93\u51fa\u6210\u7ec4\u5199\u5165\u5e76\u62d2\u7edd\u8def\u5f84\u522b\u540d\u4e0e\u8f93\u5165\u8986\u76d6\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u4ece\u5f00\u653e\u4e1a\u52a1 outputs \u81ea\u7531\u7f16\u62a5\u544a\uff08\u7981\u6b62\uff09\uff1b\u9700\u8981\u6a21\u578b\u8c03\u7528\u6216\u4e1a\u52a1\u7f16\u6392\u3002</p>"},{"location":"recipes/deterministic-human-report/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.report</code>\uff08validate \u2192 render \u2192 bind \u2192 check\uff0c\u7eaf\u51fd\u6570\uff09\u4e0e <code>foundation.kit.report</code>\uff08CLI \u5b50\u52a8\u4f5c\u7f16\u6392\u6e32\u67d3\u4e0e\u5206\u7ea7\uff09\u3002</p>"},{"location":"recipes/deterministic-human-report/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u5df2\u5b58\u5728\u7ecf Contracts \u6821\u9a8c\u7684 report-model \u4e0e operation-result\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1aMarkdown \u786e\u5b9a\u6027\u8f6c\u4e49\uff1bmodel/result/report \u4e09\u6458\u8981\u7ed1\u5b9a\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u5148\u6784\u9020\u5408\u6cd5 model\uff0cKit \u4e0d\u4ece\u4e1a\u52a1 outputs \u63a8\u5bfc\u4e8b\u5b9e\u3002</li> </ul>"},{"location":"recipes/deterministic-human-report/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import {\n validateReportModel,\n renderReportMarkdown,\n buildBinding,\n checkReport,\n} from \"skill-family-harness-node\";\n\nvalidateReportModel(model);\nconst markdown = renderReportMarkdown(model, { locale: \"zh-CN\" });\nconst binding = buildBinding(model, result, markdown);\nconst graded = checkReport(model, result, markdown, binding); // \u5206\u7ea7\u68c0\u67e5\u53d1\u73b0\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u6a21\u578b\u6821\u9a8c\u3001\u6e32\u67d3\u3001\u7ed1\u5b9a\u4e0e\u5206\u7ea7\u68c0\u67e5\u7684\u56db\u6b65\u987a\u5e8f\u3002</p>"},{"location":"recipes/deterministic-human-report/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>renderReportMarkdown</code> \u8fd4\u56de\u786e\u5b9a\u6027 Markdown\uff1b<code>buildBinding</code> \u4ea7\u51fa\u4e09\u6458\u8981\u7ed1\u5b9a\uff1b<code>checkReport</code> \u8fd4\u56de\u5206\u7ea7\u68c0\u67e5\u53d1\u73b0\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/report.test.mjs</code> \u4e0e <code>packages/skill-family-engineering-kit/test/report.test.mjs</code>\u3002</p>"},{"location":"recipes/deterministic-human-report/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u62a5\u544a\u5b57\u8282\u504f\u79bb\u786e\u5b9a\u6027\u91cd\u6e32\u67d3 -> SFC3003 (REPORT_FACT_DRIFT)\n// \u624b\u5de5\u6539\u4e86 markdown \u518d bind/check\uff0c\u6458\u8981\u5bf9\u4e0d\u4e0a\u5373\u5931\u8d25\ncheckReport(model, result, tamperedMarkdown, binding);\n// \u629b HarnessError\uff0cerrorCode = \"SFC3003\"\n</code></pre> <p><code>SFC3001</code>\uff08\u6458\u8981\u4e0d\u4e00\u81f4\uff09\u3001<code>SFC3002</code>\uff08\u7f3a\u5f3a\u5236\u5143\u7d20\uff09\u540c\u6837\u4e3a\u786c\u5931\u8d25\u3002</p>"},{"location":"recipes/deterministic-human-report/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/report.test.mjs \\\n packages/skill-family-engineering-kit/test/report.test.mjs\n</code></pre>"},{"location":"recipes/deterministic-human-report/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u62a5\u544a\u4e1a\u52a1\u7ed3\u8bba\u7684\u89e3\u8bfb\u3002</li> <li>\u8c03\u7528\u65b9\u5fc5\u987b\u5148\u6784\u9020\u5408\u6cd5 report-model\uff08Kit \u4e0d\u4ece\u4e1a\u52a1 outputs \u63a8\u5bfc\u4e8b\u5b9e\uff09\u3002</li> </ul>"},{"location":"recipes/deterministic-human-report/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\uff0c\u4e0d\u81ea\u7531\u64b0\u5199\uff1b\u5347\u7ea7\u8ddf\u968f <code>skill-family-harness-node</code> \u4e0e <code>skill-family-engineering-kit</code> \u7248\u672c\u3002</li> <li>\u53cc\u8f93\u51fa\u6210\u7ec4\u5199\u5165\uff0c\u62d2\u7edd\u8def\u5f84\u522b\u540d\u4e0e\u8f93\u5165\u8986\u76d6\uff0c\u56de\u6eda\u4ee5\u5199\u5165\u524d\u7684 <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u8fd8\u539f\u3002</li> </ul>"},{"location":"recipes/domain-schema-validation/","title":"\u4e2d\u6587 \u00b7 \u9886\u57df Schema \u6821\u9a8c","text":"<p>English</p>"},{"location":"recipes/domain-schema-validation/#Recipe\u9886\u57df\u65e0\u5173\u7684\u5951\u7ea6\u5bf9\u8c61\u6821\u9a8c","title":"Recipe\uff1a\u9886\u57df\u65e0\u5173\u7684\u5951\u7ea6\u5bf9\u8c61\u6821\u9a8c","text":""},{"location":"recipes/domain-schema-validation/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u6821\u9a8c\u4e00\u4efd\u6587\u6863\u662f\u5426\u7b26\u5408 Foundation \u5df2\u767b\u8bb0\u7684\u5951\u7ea6\u5bf9\u8c61\uff08\u5982 project-manifest\uff09\uff0c\u6309\u65b9\u8a00\u9009\u62e9\u6821\u9a8c\u7b56\u7565\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u6821\u9a8c\u6d88\u8d39\u8005\u81ea\u6709\u4e1a\u52a1 Schema\uff08\u6d88\u8d39\u8005\u5e94\u81ea\u884c\u6301\u6709\uff0cFoundation \u4e0d\u53d6\u4ee3\uff09\uff1b\u9700\u8981\u628a\u9886\u57df\u8bed\u4e49\u6821\u9a8c\u6df7\u5165\u901a\u7528\u5951\u7ea6\u3002</p> <p>Quickstart Profile v2 \u662f\u5355\u72ec\u7684 candidate \u8def\u5f84\u3002\u6d88\u8d39\u8005\u4ecd\u62e5\u6709\u4e1a\u52a1 Schema\uff1bEngineering Kit \u53ea\u5728\u6784\u5efa\u9636\u6bb5\u628a\u663e\u5f0f Schema \u96c6\u5408\u7f16\u8bd1\u6210\u6309 <code>$id</code> \u67e5\u8be2\u7684\u79bb\u7ebf validator\uff0c\u4e0d\u63a5\u7ba1 method \u5230 Schema \u7684\u9009\u62e9\u3002</p>"},{"location":"recipes/domain-schema-validation/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.contracts.object-validation</code>\uff08<code>validateDocument</code> / <code>compileSchema</code> / <code>detectDialect</code>\uff09\u3002\u7eaf Ajv \u5b9e\u73b0\uff0c\u652f\u6301 draft-07 \u4e0e 2020-12\u3002</p>"},{"location":"recipes/domain-schema-validation/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u5f85\u6821\u9a8c\u6587\u6863\u5e26\u6709\u5df2\u767b\u8bb0\u5951\u7ea6\u5bf9\u8c61\u7684 <code>$id</code>\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a<code>validateDocument</code> \u6c38\u4e0d\u4fee\u6539\u8c03\u7528\u8005\u8f93\u5165\uff1b\u89c4\u8303\u5316\u526f\u672c\u53ea\u5728\u7ed3\u679c <code>data</code> \u5b57\u6bb5\u8fd4\u56de\u3002</li> </ul>"},{"location":"recipes/domain-schema-validation/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import { validateDocument } from \"skill-family-contracts\";\n\nconst document = {\n schemaVersion: 1,\n kind: \"skill-family.project-manifest\",\n project: { id: \"my-project\", name: \"My Project\", description: \"Example\" },\n contracts: { version: \"1.0.0\", profile: \"generic\" },\n managedFiles: [\"package.json\"],\n updatedAt: \"2026-01-01T00:00:00Z\",\n};\n\nconst result = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/project-manifest.json\",\n dialect: \"2020-12\",\n});\nif (!result.valid) console.error(result.errorCode);\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u7528 <code>$id</code> \u6307\u5b9a\u76ee\u6807 Schema \u5e76\u53d6\u56de <code>{ valid, errorCode, errors, data }</code>\u3002</p>"},{"location":"recipes/domain-schema-validation/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p>\u6821\u9a8c\u901a\u8fc7\u65f6 <code>result.valid</code> \u4e3a true\uff1b\u5931\u8d25\u65f6 <code>errorCode</code> \u4e3a <code>SFC1001</code> \u7b49\u7a33\u5b9a\u7801\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-contracts/test/validator.test.mjs</code> \u4e0e <code>test/schemas.test.mjs</code>\u3002</p>"},{"location":"recipes/domain-schema-validation/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u672a\u77e5 $id -> \u8fd4\u56de valid:false\uff0cerrorCode = SFC1002 (UNKNOWN_SCHEMA_ID)\nconst bad = validateDocument(document, {\n schemaId: \"https://contracts.skill-family.example/v1/does-not-exist.json\",\n dialect: \"2020-12\",\n});\n// \u4e0d\u629b\u5f02\u5e38\uff0c\u8fd4\u56de\u7ed3\u6784\u5316\u7ed3\u679c\uff1a\n// { valid: false, errorCode: \"SFC1002\",\n// errors: [{ message: \"unknown schema $id: https://contracts.skill-family.example/v1/does-not-exist.json\" }] }\nif (!bad.valid) console.error(bad.errorCode); // SFC1002\n</code></pre>"},{"location":"recipes/domain-schema-validation/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-contracts/test/validator.test.mjs \\\n packages/skill-family-contracts/test/schemas.test.mjs\n</code></pre>"},{"location":"recipes/domain-schema-validation/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u5177\u4f53\u4e1a\u52a1\u5b57\u6bb5\u7684\u8bed\u4e49\u89e3\u91ca\u3002</li> <li>\u9886\u57df\u7ea7\u6821\u9a8c\u89c4\u5219\uff08\u4e0d\u5728 Foundation \u901a\u7528\u5951\u7ea6\u5185\uff09\u3002</li> </ul>"},{"location":"recipes/domain-schema-validation/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u5951\u7ea6\u6743\u5a01\u7248\u672c <code>CONTRACTS_VERSION = 1.4.0</code>\uff0cnpm \u5305\u7248\u672c <code>0.3.0</code> \u5e76\u884c\uff0c\u4e0d\u6df7\u7528\u3002</li> <li>\u9519\u8bef\u7801\u51bb\u7ed3\u4e0d\u6f02\u79fb\uff1bSchema \u53d8\u66f4\u4f5c\u4e3a\u65b0\u7684\u5408\u540c\u7248\u672c\u4efb\u52a1\u8fdb\u884c\uff0c\u4e0d\u5c31\u5730\u6539\u51bb\u7ed3\u5185\u5bb9\u3002</li> <li>candidate v2 \u5fc5\u987b\u7cbe\u786e\u9501\u5b9a 0.3.0\uff1b\u4ecd\u9700 v1 \u7684\u63a5\u5165\u7ee7\u7eed\u7cbe\u786e\u9501\u5b9a 0.2.1\u3002</li> </ul>"},{"location":"recipes/durable-local-state/","title":"\u4e2d\u6587 \u00b7 \u6301\u4e45\u672c\u5730\u72b6\u6001","text":"<p>English</p>"},{"location":"recipes/durable-local-state/#Recipe\u6301\u4e45\u672c\u5730\u72b6\u6001\u5e95\u5ea7","title":"Recipe\uff1a\u6301\u4e45\u672c\u5730\u72b6\u6001\u5e95\u5ea7","text":""},{"location":"recipes/durable-local-state/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u6301\u4e45\u5316\u4e8b\u4ef6\u65e5\u5fd7\u5e76\u4fdd\u8bc1\u987a\u5e8f\u4e0e\u5b8c\u6574\u6027\uff0c\u91cd\u5efa\u6216\u6821\u9a8c\u6d3e\u751f\u5feb\u7167\uff0c\u4ee5\u53ca\u68c0\u67e5\u6216\u6062\u590d\u534f\u4f5c\u5f0f\u5355\u5199\u8005\u9501\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u5728 Foundation \u5b9a\u4e49 workflow \u72b6\u6001\u673a\uff08\u7981\u6b62\uff09\uff1b\u9700\u8981\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\uff08fencing \u4e0d\u627f\u8bfa\u8be5\u573a\u666f\uff09\u3002</p>"},{"location":"recipes/durable-local-state/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.state-store</code>\uff08append-only \u4e8b\u4ef6\u3001hash chain\u3001\u5feb\u7167\u4e0e\u9501\u68c0\u67e5/\u6062\u590d\uff09\u3002\u4e8b\u4ef6\u542b\u4e49\u4e0e reducer \u8f6c\u79fb\u7531\u8c03\u7528\u65b9\u62e5\u6709\u3002</p>"},{"location":"recipes/durable-local-state/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li><code>STATE_GENESIS_DIGEST</code> \u4f5c\u4e3a\u94fe\u8d77\u70b9\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u662f\u552f\u4e00\u6743\u5a01\uff0csnapshot \u4e3a\u6d3e\u751f\u7f13\u5b58\uff1b<code>confirmOwnerTerminated</code> \u662f\u8c03\u7528\u65b9\u63d0\u4f9b\u7684\u5916\u90e8\u4fe1\u4efb\u951a\uff0c\u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\u3002</li> </ul>"},{"location":"recipes/durable-local-state/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n openStateStore,\n appendEvent,\n readEvents,\n writeSnapshot,\n readSnapshot,\n inspectStateStoreLock,\n recoverStateStoreLock,\n} from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-state-\"));\nconst store = openStateStore(root, { owner: \"writer-a\", expectedSchemas: [] });\nappendEvent(store, { eventType: \"demo\", payload: { n: 1 } });\nwriteSnapshot(store, readEvents(store));\nconst snap = readSnapshot(store);\nconst lock = inspectStateStoreLock(root); // { owner, fencing, ageMs, recovering }\nawait recoverStateStoreLock(root, {\n expectedOwner: lock.owner,\n expectedFencing: lock.fencing,\n confirmOwnerTerminated: true,\n});\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u5f00\u5e93\u3001\u8ffd\u52a0\u4e8b\u4ef6\u3001\u5199\u5feb\u7167\u3001\u67e5\u9501\u4e0e\u663e\u5f0f\u6062\u590d\u7684\u987a\u5e8f\u3002</p>"},{"location":"recipes/durable-local-state/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>readEvents</code> \u8fd4\u56de\u8ffd\u52a0\u7684\u4e8b\u4ef6\uff0c<code>readSnapshot</code> \u8fd4\u56de\u6d3e\u751f\u5feb\u7167\uff0c<code>inspectStateStoreLock</code> \u8fd4\u56de <code>owner</code>/<code>fencing</code>/<code>ageMs</code>/<code>recovering</code>\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/state-store.test.mjs</code>\uff08\u542b 34 \u5904\u65ad\u8a00\uff09\u3002</p>"},{"location":"recipes/durable-local-state/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u7b2c\u4e8c\u5199\u8005\u7acb\u5373\u6536\u5230 store-locked\nconst other = openStateStore(root, { owner: \"writer-b\", expectedSchemas: [] });\n// \u629b HarnessError\uff1adetails.kind = \"store-locked\"\n</code></pre> <p>hash chain \u65ad\u88c2\u3001\u9501 fencing \u4e0d\u5339\u914d\u3001\u6062\u590d\u7f3a\u5c11 <code>confirmOwnerTerminated</code> \u5747\u5931\u8d25\u5173\u95ed\u3002</p>"},{"location":"recipes/durable-local-state/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/state-store.test.mjs\n</code></pre>"},{"location":"recipes/durable-local-state/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u4e8b\u4ef6\u4e1a\u52a1\u542b\u4e49\u3001reducer \u8f6c\u79fb\u3002</li> <li><code>confirmOwnerTerminated</code> \u4fe1\u4efb\u951a\uff08Foundation \u4e4b\u5916\u786e\u8ba4\u65e7\u5199\u8005\u5df2\u7ec8\u6b62\uff09\u3002</li> </ul>"},{"location":"recipes/durable-local-state/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u72b6\u6001\u5e95\u5ea7\u53ea\u63d0\u4f9b\u673a\u5236\uff1b\u4e1a\u52a1\u72b6\u6001\u673a/\u7ec8\u6001\u5f52 loop-agent\u3002</li> <li>\u5d29\u6e83\u9057\u7559\u9501\u9700\u5916\u90e8\u53d6\u8bc1\u540e\u663e\u5f0f\u6062\u590d\uff0c\u4e0d\u81ea\u52a8\u5077\u9501\uff1b\u7cfb\u7edf\u4fdd\u6301\u53ef\u8bca\u65ad\u9501\u6b7b\u800c\u975e\u9759\u9ed8\u8986\u76d6\u3002</li> </ul>"},{"location":"recipes/host-profile-integration/","title":"\u4e2d\u6587 \u00b7 \u5bbf\u4e3b Profile \u96c6\u6210","text":"<p>English</p>"},{"location":"recipes/host-profile-integration/#Recipe\u5bbf\u4e3b\u63a5\u5165\u4e0e-Profile-\u6ce8\u5165","title":"Recipe\uff1a\u5bbf\u4e3b\u63a5\u5165\u4e0e Profile \u6ce8\u5165","text":""},{"location":"recipes/host-profile-integration/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u63cf\u8ff0\u5df2\u767b\u8bb0\u5bbf\u4e3b\uff08claude/codex\uff09\u3001\u63a2\u6d4b\u6216\u89c4\u5212\u5bbf\u4e3b\u63a5\u5165\uff0c\u5e76\u5411 Foundation \u6ce8\u5165\u5177\u4f53\u5bbf\u4e3b Profile \u4e0e\u53d7\u4fe1 driver\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981 host apply/install/update/uninstall\uff08\u660e\u786e unsupported\uff09\uff1b\u9700\u8981 Qoder \u5b8c\u6574 driver\uff08\u8be5\u5bbf\u4e3b unsupported\uff09\u3002</p>"},{"location":"recipes/host-profile-integration/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.kit.host</code>\uff08<code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code>\uff09\u4e0e <code>foundation.profile.extension-spi</code>\uff08<code>verifyProfile</code>\uff09\u3002\u5bbf\u4e3b\u5dee\u5f02\u58f0\u660e\u5728 <code>foundation.profile.hosts</code>\u3002</p>"},{"location":"recipes/host-profile-integration/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u5bbf\u4e3b Profile \u5df2\u5728 <code>profiles/hosts</code> \u767b\u8bb0\uff1b\u53d7\u4fe1 driver \u4ec5 <code>claude-version-v1</code> / <code>codex-version-v1</code>\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1aProfile \u5165\u53e3\u5fc5\u987b\u662f JSON \u6570\u636e\u8d44\u6e90\uff0c\u516c\u5171\u6838\u5fc3\u4e0d\u5bfc\u5165 <code>profiles/</code>\uff1b<code>coreOwned</code> \u4e3a\u7981\u5165\u76ee\u6807\u3002</li> </ul>"},{"location":"recipes/host-profile-integration/#4-\u6700\u5c0f\u547d\u4ee4\u4e0e\u4ee3\u7801","title":"4. \u6700\u5c0f\u547d\u4ee4\u4e0e\u4ee3\u7801","text":"<pre><code># \u63cf\u8ff0\u5df2\u767b\u8bb0\u5bbf\u4e3b\nnpm exec -- skill-family-kit adopt-plan host-describe --host claude --hosts-root profiles/hosts\n\n# \u53ea\u8bfb\u63a2\u6d4b\uff08\u9ed8\u8ba4\u4e0d spawn\uff09\nnpm exec -- skill-family-kit adopt-plan host-probe --host claude --hosts-root profiles/hosts\n</code></pre> <pre><code>import { describeHost, probeHost, planHost } from \"skill-family-engineering-kit\";\nimport { verifyProfile } from \"profiles/spi/index.mjs\";\n\nconst desc = describeHost(\"claude\"); // \u53d7\u652f\u6301\u5bbf\u4e3b\u63cf\u8ff0\nconst facts = probeHost(\"claude\", { allowSpawn: false });\nconst plan = planHost(desc, facts);\nconst spi = verifyProfile({ profileRoot: \"profiles/public-plugin\" }); // SPE0000\n</code></pre> <p>\u4ee5\u4e0a\u547d\u4ee4\u4e0e\u4ee3\u7801\u5c55\u793a\u4e86 describe/probe/plan \u7684\u53ea\u8bfb\u673a\u5236\uff0c\u4ee5\u53ca\u7528 <code>verifyProfile</code> \u6821\u9a8c Profile \u58f0\u660e\u3002</p>"},{"location":"recipes/host-profile-integration/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>describeHost</code> \u8fd4\u56de\u5bbf\u4e3b\u63cf\u8ff0\uff0c<code>probeHost</code> \u8fd4\u56de\u53ea\u8bfb\u63a2\u6d4b\u4e8b\u5b9e\uff0c<code>planHost</code> \u8fd4\u56de\u63a5\u5165\u8ba1\u5212\uff0c<code>verifyProfile</code> \u8fd4\u56de <code>SPE0000</code> \u7b49\u7ed3\u679c\u7801\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-engineering-kit/test/host.test.mjs</code> \u4e0e <code>fixtures/generic-profile-extension-conformance/verify.mjs</code>\u3002</p>"},{"location":"recipes/host-profile-integration/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code># \u8d1f\u4f8b\uff1aapply \u7a33\u5b9a\u62d2\u7edd\nnpm exec -- skill-family-kit adopt-plan host-apply --host claude --hosts-root profiles/hosts\n# \u9000\u51fa\u7801 2\uff1ahost apply is not implemented in the read-only Phase D slice\n</code></pre> <pre><code>// \u8d1f\u4f8b\uff1aqoder \u4e3a unsupported\ndescribeHost(\"qoder\"); // \u629b\u9519\uff1asupport = \"unsupported\"\n</code></pre>"},{"location":"recipes/host-profile-integration/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-engineering-kit/test/host.test.mjs \\\n fixtures/generic-profile-extension-conformance/verify.mjs\n</code></pre>"},{"location":"recipes/host-profile-integration/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u5bbf\u4e3b\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\u3002</li> <li>\u5bbf\u4e3b\u5e94\u7528\uff08apply\uff09\u7684\u6700\u7ec8\u843d\u5730\uff08\u5f53\u524d\u4e0d\u5728 Foundation \u8303\u56f4\uff09\u3002</li> </ul>"},{"location":"recipes/host-profile-integration/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u5bbf\u4e3b\u63a5\u5165\u7ebf\u53ea\u652f\u6301 describe/build/probe/plan\uff1bapply \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u672a\u5b9e\u73b0\u3002</li> <li>Qoder \u5b8c\u6574 driver \u4e3a unsupported\uff0c\u53ea\u53c2\u8003\u5176\u7ed3\u6784\uff0c\u4e0d\u58f0\u79f0\u5df2\u5728 Qoder \u8fd0\u884c\uff1b\u5347\u7ea7\u65b0\u589e\u53d7\u652f\u6301\u5bbf\u4e3b\u987b\u767b\u8bb0 descriptor \u5e76\u7ed1\u5b9a\u53d7\u4fe1 driver\u3002</li> </ul>"},{"location":"recipes/safe-filesystem-and-atomic-write/","title":"\u4e2d\u6587 \u00b7 \u5b89\u5168\u6587\u4ef6\u7cfb\u7edf\u4e0e\u539f\u5b50\u5199","text":"<p>English</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#Recipe\u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u4e0e\u539f\u5b50\u5199","title":"Recipe\uff1a\u5b89\u5168\u6587\u4ef6\u8bbf\u95ee\u4e0e\u539f\u5b50\u5199","text":""},{"location":"recipes/safe-filesystem-and-atomic-write/#1-\u573a\u666f\u4e0e\u975e\u573a\u666f","title":"1. \u573a\u666f\u4e0e\u975e\u573a\u666f","text":"<p>\u9002\u7528\uff1a\u9700\u8981\u5728 Node \u5185\u628a\u5916\u90e8\u63d0\u4f9b\u7684\u8def\u5f84\u9650\u5236\u5728\u67d0\u4e2a\u6839\u76ee\u5f55\u5185\uff0c\u5e76\u5411\u53d7\u6536\u5bb9\u8def\u5f84\u539f\u5b50\u5199\u5165\u666e\u901a\u6587\u4ef6\uff0c\u5931\u8d25\u65f6\u56de\u6eda\u4e0d\u7559\u6b8b\u5f71\u3002</p> <p>\u4e0d\u9002\u7528\uff1a\u9700\u8981\u628a\u6587\u4ef6\u9009\u62e9\u7684\u4e1a\u52a1\u89c4\u5219\u653e\u5165 Foundation\uff08\u4e1a\u52a1\u89c4\u5219\u7531\u8c03\u7528\u65b9\u62e5\u6709\uff09\uff1b\u9700\u8981\u5199\u5165\u672a\u53d7\u6536\u5bb9\u8def\u5f84\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#2-\u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b-ID","title":"2. \u67b6\u6784\u9009\u62e9\u53ca\u80fd\u529b ID","text":"<p>\u9996\u9009\u80fd\u529b\uff1a<code>foundation.harness.path-containment</code>\uff08\u8def\u5f84\u5206\u7c7b\u4e0e\u53d7\u6536\u5bb9\u89e3\u6790\uff09\u4e0e <code>foundation.harness.atomic-write</code>\uff08\u53d7\u6536\u5bb9\u8def\u5f84\u5185\u539f\u5b50\u5199\uff09\u3002\u4e24\u8005\u90fd\u53ea\u5b9e\u73b0\u673a\u5236\uff0c\u4e0d\u62e5\u6709\u8bed\u4e49\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#3-\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","title":"3. \u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u8fb9\u754c","text":"<ul> <li>\u8c03\u7528\u65b9\u63d0\u4f9b\u660e\u786e\u7684\u6839\u76ee\u5f55\uff08\u6536\u5bb9\u8fb9\u754c\uff09\u3002</li> <li>\u4fe1\u4efb\u8fb9\u754c\uff1a\u6240\u6709\u89e3\u6790\u7ed3\u679c\u5fc5\u987b\u843d\u5728\u6839\u76ee\u5f55\u5185\uff1b\u8d8a\u754c\u3001\u7b26\u53f7\u94fe\u63a5\u9003\u9038\u3001\u771f\u5b9e\u8def\u5f84\u9003\u9038\u5747\u88ab\u62d2\u7edd\u3002</li> </ul>"},{"location":"recipes/safe-filesystem-and-atomic-write/#4-\u6700\u5c0f\u4ee3\u7801","title":"4. \u6700\u5c0f\u4ee3\u7801","text":"<pre><code>import { mkdtempSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { resolveContained, writeFileAtomic } from \"skill-family-harness-node\";\n\nconst root = mkdtempSync(join(tmpdir(), \"sf-safe-\"));\nconst target = resolveContained(root, \"nested/config.json\"); // \u53d7\u6536\u5bb9\u7edd\u5bf9\u8def\u5f84\nawait writeFileAtomic(target, JSON.stringify({ ok: true }));\n</code></pre> <p>\u4ee5\u4e0a\u4ee3\u7801\u5c55\u793a\u4e86\u5148\u6536\u5bb9\u8def\u5f84\u3001\u518d\u539f\u5b50\u5199\u5165\u7684\u57fa\u672c\u987a\u5e8f\uff1b<code>writeFileAtomic</code> \u7528\u4e34\u65f6\u6587\u4ef6 + fsync + rename\uff0c\u5931\u8d25\u56de\u6eda\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#5-\u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","title":"5. \u9884\u671f\u8f93\u51fa\u4e0e\u8bc1\u636e","text":"<p><code>resolveContained</code> \u8fd4\u56de\u843d\u5728\u6839\u5185\u7684\u7edd\u5bf9\u8def\u5f84\uff1b<code>writeFileAtomic</code> \u5199\u5165\u5b8c\u6210\u7684\u6587\u4ef6\uff0c\u5b57\u8282\u4e0e\u8f93\u5165\u4e00\u81f4\u3002\u8bc1\u636e\uff1a<code>packages/skill-family-harness-node/test/containment.test.mjs</code> \u4e0e <code>test/atomic.test.mjs</code>\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#6-\u5b89\u5168\u5931\u8d25\u8d1f\u4f8b","title":"6. \u5b89\u5168/\u5931\u8d25\u8d1f\u4f8b","text":"<pre><code>// \u8d1f\u4f8b\uff1a\u8bd5\u56fe\u8d8a\u51fa\u6839\u76ee\u5f55 -> SFC2004 (path-traversal)\nimport { resolveContained } from \"skill-family-harness-node\";\nresolveContained(root, \"../escape.json\"); // \u629b HarnessError\uff0cdetails.kind = \"path-traversal\"\n</code></pre> <p>\u8d8a\u754c\u3001symlink-escape\u3001realpath-escape \u5747\u5f52 <code>SFC2004</code> \u52a0\u7a33\u5b9a <code>details.kind</code>\uff1b\u539f\u5b50\u5199\u5bf9\u8d8a\u754c\u8def\u5f84\u6216\u975e\u6cd5\u6570\u636e\u7c7b\u578b\u629b\u9519\u5e76\u56de\u6eda\u4e34\u65f6\u6587\u4ef6\u3002</p>"},{"location":"recipes/safe-filesystem-and-atomic-write/#7-\u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","title":"7. \u53ef\u590d\u5236\u9a8c\u8bc1\u547d\u4ee4","text":"<pre><code>node --test packages/skill-family-harness-node/test/containment.test.mjs \\\n packages/skill-family-harness-node/test/atomic.test.mjs\n</code></pre>"},{"location":"recipes/safe-filesystem-and-atomic-write/#8-\u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","title":"8. \u8c03\u7528\u65b9\u7ee7\u7eed\u62e5\u6709\u7684\u4e1a\u52a1\u903b\u8f91","text":"<ul> <li>\u54ea\u4e9b\u8def\u5f84\u662f\u4e1a\u52a1\u5141\u8bb8\u7684\u9009\u62e9\u89c4\u5219\uff08\u4e0d\u5728 Foundation \u5185\uff09\u3002</li> <li>\u5199\u5165\u5185\u5bb9\u7684\u4e1a\u52a1\u6b63\u786e\u6027\u3002</li> </ul>"},{"location":"recipes/safe-filesystem-and-atomic-write/#9-\u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","title":"9. \u5347\u7ea7\u4e0e\u56de\u6eda\u6ce8\u610f\u4e8b\u9879","text":"<ul> <li>\u8def\u5f84\u6536\u5bb9\u4e0e\u539f\u5b50\u5199\u5747\u4e3a\u53d7\u6536\u5bb9\u673a\u5236\uff0c\u5931\u8d25\u56de\u6eda\u4e0d\u7559\u534a\u6210\u54c1\uff0c\u65e0\u5916\u90e8\u56de\u6eda\u9700\u6c42\u3002</li> <li>\u5347\u7ea7\u8ddf\u968f <code>skill-family-harness-node</code> \u7248\u672c\uff1b<code>HARNESS_EXCLUSIONS</code> \u4e0d\u5f15\u5165\u8fdc\u7aef\u6216 git \u5199\u3002</li> </ul>"},{"location":"reference/compatibility/","title":"\u4e2d\u6587 \u00b7 \u517c\u5bb9\u6027","text":"<p>English</p>"},{"location":"reference/compatibility/#\u517c\u5bb9\u6027\u4e0e\u652f\u6301\u77e9\u9635","title":"\u517c\u5bb9\u6027\u4e0e\u652f\u6301\u77e9\u9635","text":"<p>\u672c\u9875\u7ed9\u51fa\u5305\u3001Contracts\u3001Node \u4e0e\u5bbf\u4e3b\u7684\u652f\u6301\u77e9\u9635\u548c\u5347\u7ea7\u89c4\u5219\u3002\u6240\u6709\u7248\u672c\u53f7\u4ece\u673a\u5668\u771f\u6e90\u590d\u7b97\uff0c\u4e0d\u51ed\u8bb0\u5fc6\u3002</p>"},{"location":"reference/compatibility/#\u5305\u7248\u672c\u77e9\u9635","title":"\u5305\u7248\u672c\u77e9\u9635","text":"\u5305 \u7248\u672c\uff08package.json\uff09 \u89d2\u8272 \u53d1\u5e03\u72b6\u6001 <code>skill-family-contracts</code> 0.3.0 Contracts 1.4.0 \u673a\u5668\u5951\u7ea6 \u516c\u5f00\u53d1\u5e03\u76ee\u6807\uff08private: false\uff09 <code>skill-family-harness-node</code> 0.3.0 Contracts \u7684 Node \u8584\u673a\u5236\u8fd0\u884c\u65f6 \u516c\u5f00\u53d1\u5e03\u76ee\u6807 <code>skill-family-engineering-kit</code> 0.3.0 \u56db\u4e2a\u5de5\u7a0b\u547d\u4ee4\uff08CLI <code>skill-family-kit</code>\uff09 \u516c\u5f00\u53d1\u5e03\u76ee\u6807 \u5de5\u4f5c\u533a\u4ed3 0.3.0 \u79c1\u6709\u7236\u5de5\u4f5c\u533a\uff08private: true\uff09 \u4ec5\u5f00\u53d1\u771f\u6e90 <p>\u5951\u7ea6\u6743\u5a01\u7248\u672c\uff08<code>CONTRACTS_VERSION</code>\uff09\u4e3a <code>1.4.0</code>\uff0cnpm \u5305\u7248\u672c\u4e3a <code>0.3.0</code>\uff0c\u4e24\u5957\u7248\u672c\u5e76\u884c\uff0c\u4e0d\u6df7\u7528\u3002</p>"},{"location":"reference/compatibility/#Quickstart-Profile-candidate-\u517c\u5bb9\u6027","title":"Quickstart Profile candidate \u517c\u5bb9\u6027","text":"\u5305\u7248\u672c candidate profile \u517c\u5bb9\u89c4\u5219 0.2.1 v1 \u5df2\u6709\u63a5\u5165\u53ef\u7ee7\u7eed\u7cbe\u786e\u9501\u5b9a 0.2.1 0.3.0 v2 \u4f7f\u7528 <code>execute-method</code>\u3001\u771f\u5b9e <code>$id</code> Schema \u96c6\u5408\u4e0e\u79bb\u7ebf Bundle\uff1b\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a 0.3.0 <p>v2 \u66ff\u6362 v1\uff0c\u4e0d\u63d0\u4f9b\u53cc\u8f68\u517c\u5bb9\u5c42\u3002\u7a33\u5b9a Contracts 1.4.0\u300118 \u7c7b\u5bf9\u8c61\u3001\u5185\u6838\u534f\u8bae\u4e0e\u9519\u8bef\u7801\u767b\u8bb0\u4e0d\u968f candidate \u5207\u6362\u800c\u53d8\u5316\u3002</p>"},{"location":"reference/compatibility/#Node-\u652f\u6301\u77e9\u9635","title":"Node \u652f\u6301\u77e9\u9635","text":"<ul> <li>\u5f15\u64ce\u8981\u6c42\uff1a<code>>=22.22.2 <23</code>\uff08\u9501\u5b9a major 22\uff09\u3002</li> <li>\u7cbe\u786e floor\uff1a<code>.node-version</code> \u53d6 <code>22.22.2</code>\uff0c\u4f5c\u4e3a\u8fd0\u884c\u65f6\u7248\u672c\u5224\u5b9a\u7684\u673a\u68b0\u771f\u6e90\u3002</li> <li>pnpm\uff1a<code>10.30.0</code>\uff08<code>package.json</code> \u7684 <code>packageManager</code>\uff09\u3002</li> <li>projen\uff1a<code>0.101.23</code>\uff08\u53d7\u7ba1\u5de5\u7a0b\u6587\u4ef6\u552f\u4e00\u751f\u6210\u5165\u53e3\uff09\u3002</li> </ul> <p>\u4f4e\u4e8e floor \u7684 Node \u7248\u672c\u4e0d\u80fd\u66ff\u4ee3\u6743\u5a01\u7ed3\u679c\uff1b\u7b2c\u4e8c\u8bed\u8a00\u5b9e\u73b0\u9996\u7248\u4e3a 0\u3002</p>"},{"location":"reference/compatibility/#Contracts-\u7248\u672c\u4e0e\u7a33\u5b9a\u6027","title":"Contracts \u7248\u672c\u4e0e\u7a33\u5b9a\u6027","text":"<ul> <li>\u9876\u5c42\u5bf9\u8c61\uff1a18 \u7c7b\uff08\u4ee5 <code>packages/skill-family-contracts/src/registry.json</code> \u4e3a\u552f\u4e00\u771f\u6e90\uff09\u3002</li> <li>\u5f3a\u5236\u673a\u68b0\u89c4\u5219\uff1a9 \u6761\uff0c\u9884\u7b97\u4e0a\u9650 20\u3001\u7edd\u5bf9\u4e0a\u9650 30\u3002</li> <li>kernel \u534f\u8bae\uff1a<code>skill-family.kernel.operation</code>\uff08stable\uff09\uff0cContracts 1.4.0\u3002</li> <li>Schema \u6821\u9a8c\u5668\uff1aAjv 8.20.0\uff08\u7cbe\u786e pin\uff09\uff0c\u652f\u6301 draft-07 \u4e0e 2020-12\u3002</li> <li>\u9519\u8bef\u7801\uff1a\u51bb\u7ed3\u767b\u8bb0\u8868\uff0c\u7801\u53ea\u589e\u4e0d\u6539\u3001\u4e0d\u590d\u7528\u3002</li> </ul>"},{"location":"reference/compatibility/#\u5bbf\u4e3b\u652f\u6301\u77e9\u9635","title":"\u5bbf\u4e3b\u652f\u6301\u77e9\u9635","text":"\u5bbf\u4e3b support driver \u5907\u6ce8 claude supported claude-version-v1 \u6280\u80fd\u8def\u5f84\u7531 Profile \u51b3\u5b9a codex supported codex-version-v1 \u6280\u80fd\u8def\u5f84\u56fa\u5b9a <code>.agents/skills</code> qoder unsupported \u65e0 No auditable non-interactive host driver is frozen <p>\u5bbf\u4e3b\u63a5\u5165\u7ebf\u5f53\u524d\u53ea\u652f\u6301 <code>describe</code>/<code>build</code>/<code>probe</code>/<code>plan</code>\uff1b<code>apply</code> \u7a33\u5b9a\u62d2\u7edd\uff0c\u5b89\u88c5/\u5378\u8f7d/\u66f4\u65b0\u5747\u672a\u5b9e\u73b0\u3002</p>"},{"location":"reference/compatibility/#\u5347\u7ea7\u89c4\u5219","title":"\u5347\u7ea7\u89c4\u5219","text":"<ul> <li>\u5305\u7248\u672c\uff1a\u4e09\u4e2a\u53f6\u5b50\u5305\u5fc5\u987b\u540c\u6b65\u7248\u672c\uff0c\u7981\u6b62\u5355\u5305\u6f02\u79fb\uff1b\u65b0\u589e\u7ec4\u4ef6\u987b\u8bf4\u660e\u5220\u9664\u5b83\u4f1a\u8ba9\u4e24\u4e2a\u4ee5\u4e0a\u771f\u5b9e\u6d88\u8d39\u8005\u91cd\u590d\u5b9e\u73b0\u3002</li> <li>Contracts\uff1a\u5bf9\u8c61\u96c6\u5408\u56fa\u5b9a 18 \u7c7b\uff0c\u65b0\u589e\u9700 ADR\uff1b\u9519\u8bef\u7801\u51bb\u7ed3\u4e0d\u6f02\u79fb\uff1bSchema \u53d8\u66f4\u4f5c\u4e3a\u65b0\u7684\u5408\u540c\u7248\u672c\u4efb\u52a1\u8fdb\u884c\u3002</li> <li>Kit \u547d\u4ee4\uff1a\u9876\u5c42\u547d\u4ee4\u56fa\u5b9a 4 \u4e2a\uff08scaffold/adopt-plan/projection/check\uff09\uff0c\u4e0d\u6269\u5f20\uff1b<code>REFUSED_MUTATION_FLAGS</code> \u5728 CLI \u5165\u53e3\u5373\u62d2\u3002</li> <li>Node/pnpm/projen\uff1a\u8ddf\u968f <code>.foundation/version-lock.json</code> \u4e0e <code>package.json</code> \u7684\u7cbe\u786e\u9501\u5b9a\uff0c\u5347\u7ea7\u987b\u7ecf <code>pnpm synth</code> \u91cd\u65b0\u751f\u6210\u53d7\u7ba1\u6295\u5f71\u3002</li> <li>\u5bbf\u4e3b\uff1a\u65b0\u589e\u53d7\u652f\u6301\u5bbf\u4e3b\u987b\u767b\u8bb0 descriptor \u5e76\u7ed1\u5b9a\u53d7\u4fe1 driver\uff1bunsupported \u5bbf\u4e3b\uff08\u5982 qoder\uff09\u53ea\u53c2\u8003\u7ed3\u6784\uff0c\u4e0d\u58f0\u79f0\u5df2\u5728\u5176\u4e0a\u8fd0\u884c\u3002</li> <li>Candidate\uff1acandidate \u5b50\u8def\u5f84\u5141\u8bb8\u5728\u540e\u7eed minor \u7248\u672c\u4fee\u6539\u6216\u79fb\u9664\uff1b0.2.1 v1 \u4e0e 0.3.0 v2 \u4e0d\u6df7\u88c5\uff0c\u6d88\u8d39\u8005\u6309\u6240\u9700 profile \u7cbe\u786e\u9501\u5b9a\u4e09\u4e2a\u5305\u7248\u672c\u3002</li> </ul>"},{"location":"reference/compatibility/#\u53cd\u517c\u5bb9\u8fb9\u754c\u660e\u786e\u4e0d\u652f\u6301","title":"\u53cd\u517c\u5bb9\u8fb9\u754c\uff08\u660e\u786e\u4e0d\u652f\u6301\uff09","text":"<ul> <li>host apply / install / update / uninstall\uff08unsupported\uff09\u3002</li> <li>Qoder \u5b8c\u6574 driver\uff08unsupported\uff09\u3002</li> <li>\u4e8c\u8fdb\u5236 adapter source\uff08\u4ec5\u6587\u672c\u95ed\u5305\uff09\u3002</li> <li>\u8fdc\u7aef\u53d1\u5e03\u4e0e\u5168\u90e8\u8fdc\u7aef\u5199\u5165\uff08\u5f52 release-skill\uff09\u3002</li> <li>\u4e1a\u52a1\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u3001\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\uff08\u5206\u522b\u7559\u6d88\u8d39\u8005 / loop-agent / \u72ec\u7acb\u5ba1\u8ba1\uff09\u3002</li> </ul>"},{"location":"reference/failure-and-side-effect-matrix/","title":"\u4e2d\u6587 \u00b7 \u5931\u8d25\u4e0e\u526f\u4f5c\u7528","text":"<p>English</p>"},{"location":"reference/failure-and-side-effect-matrix/#\u5931\u8d25\u4e0e\u526f\u4f5c\u7528\u77e9\u9635","title":"\u5931\u8d25\u4e0e\u526f\u4f5c\u7528\u77e9\u9635","text":"<p>\u672c\u9875\u9010\u516c\u5171\u5165\u53e3\u5217\u51fa\u8bfb\u5199\u3001spawn\u3001Git\u3001\u7f51\u7edc\u3001\u6b8b\u4f59\u72b6\u6001\u4e0e\u7a33\u5b9a\u9519\u8bef\u7801\u3002\u5b83\u670d\u52a1\u4e8e\u8c03\u7528\u65b9\u5728\u63a5\u5165\u524d\u5224\u65ad\u98ce\u9669\uff0c\u5e76\u4f5c\u4e3a <code>capability-catalog.json</code> \u4e2d <code>sideEffects</code> \u4e0e <code>failureSemantics</code> \u5b57\u6bb5\u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\u3002\u6240\u6709\u4e8b\u5b9e\u4ee5\u771f\u5b9e\u5b9e\u73b0\u4e0e\u8d1f\u4f8b\u6d4b\u8bd5\u4e3a\u51c6\u3002</p> <p>\u7b26\u53f7\u7ea6\u5b9a\uff1a\u8bfb=\u8bfb\u53d6\u6587\u4ef6\u7cfb\u7edf\uff1b\u5199=\u5199\u5165\u6587\u4ef6\u7cfb\u7edf\uff1bspawn=\u542f\u52a8\u5b50\u8fdb\u7a0b\uff1bGit=\u8bfb\u5199 Git\uff1b\u7f51\u7edc=\u8bbf\u95ee\u8fdc\u7aef\uff1b\u6b8b\u4f59=\u8c03\u7528\u7ed3\u675f\u540e\u4ecd\u7559\u5728\u78c1\u76d8/\u8fdb\u7a0b\u4e2d\u7684\u72b6\u6001\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#Contracts\u7eaf\u51fd\u6570\u5c42","title":"Contracts\uff08\u7eaf\u51fd\u6570\u5c42\uff09","text":"\u5165\u53e3 \u8bfb \u5199 spawn Git \u7f51\u7edc \u6b8b\u4f59\u72b6\u6001 \u7a33\u5b9a\u9519\u8bef\u7801 <code>validateDocument</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u7f16\u8bd1\u7f13\u5b58\u4ec5\u9a7b\u7559\u5185\u5b58\uff09 <code>SFC1001</code>/<code>SFC1002</code>/<code>SFC1006</code> <code>compileSchema</code> / <code>detectDialect</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC1006</code>/<code>SFC1012</code> <code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC1003</code>/<code>SFC1004</code> <code>runChecks</code> / <code>collectUnresolvedRefs</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC1002</code>\u2013<code>SFC1010</code> <code>verifyAllFixtures</code> / <code>verifyFixture</code> \u5426 \u5426 \u5426? \u5426 \u5426 \u5426 \u65e0 <code>SFC1010</code> <code>ERROR_CODES</code> / <code>stableError</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 \u51bb\u7ed3\u767b\u8bb0\u8868\uff0c\u4e0d\u65b0\u589e <p>Contracts \u5168\u90e8\u4e3a\u7eaf\u51fd\u6570\uff0c\u65e0\u6587\u4ef6/Git/\u7f51\u7edc/\u8fdb\u7a0b\u526f\u4f5c\u7528\uff1b\u9519\u8bef\u5bf9\u8c61\u542b <code>stableError</code> \u4e0e <code>details.kind</code>\uff0c\u4fbf\u4e8e\u8c03\u7528\u65b9\u5206\u7c7b\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#Harness\u673a\u5236\u5c42\u53d7\u6536\u5bb9","title":"Harness\uff08\u673a\u5236\u5c42\uff0c\u53d7\u6536\u5bb9\uff09","text":"\u5165\u53e3 \u8bfb \u5199 spawn Git \u7f51\u7edc \u6b8b\u4f59\u72b6\u6001 \u7a33\u5b9a\u9519\u8bef\u7801 <code>validateContractDocument</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u6821\u9a8c\u5668\u7f13\u5b58\u5185\u5b58\uff09 <code>SFC</code> \u6821\u9a8c\u5931\u8d25 <code>resolveContained</code> / <code>readFileContained</code> \u662f\uff08\u53ea\u8bfb\uff09 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC2004</code>\uff08<code>path-traversal</code>/<code>symlink-escape</code>/<code>realpath-escape</code>\uff09 <code>writeFileAtomic</code> \u5426 \u662f\uff08\u53d7\u6536\u5bb9\uff09 \u5426 \u5426 \u5426 \u5931\u8d25\u56de\u6eda\u4e34\u65f6\u6587\u4ef6 <code>SFC2004</code>\uff08<code>atomic-write-failed</code>\uff09 <code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code> \u5426 \u662f\uff08\u4e34\u65f6\u76ee\u5f55\uff09 \u5426 \u5426 \u5426 \u9000\u51fa\u65f6\u6e05\u7406\u4e34\u65f6\u76ee\u5f55 <code>SFC2004</code>\uff08<code>workspace-disposed</code>\uff09 <code>computeResourceClosure</code> / <code>digestBytes</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC</code>\uff08\u58f0\u660e/\u5185\u5bb9\u8fdd\u89c4\uff09 <code>parseRequest</code> / <code>processRequest</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u7eaf\u51fd\u6570\u7ba1\u7ebf\uff09 <code>SFC2004</code> <code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>checkReport</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0\uff08\u7eaf\u51fd\u6570\uff09 <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code> \u5426 \u5426 \u5426 \u5426 \u5426 \u65e0 <code>SFC2004</code>\uff08<code>missing-resource</code>\uff09 <code>materializeAdapterBuild</code> \u5426 \u662f\uff08\u53d7\u6536\u5bb9\uff0csibling + rename\uff09 \u5426 \u5426 \u5426 \u65e0\uff08\u539f\u5b50 rename\uff09 <code>SFC2004</code> <code>probeVersionVector</code> \u5426 \u5426 \u9ed8\u8ba4\u5426\uff08\u9700\u663e\u5f0f <code>--allow-host-spawn</code>\uff09 \u5426 \u5426 \u65e0 <code>SFC2004</code> <code>openStateStore</code> / <code>appendEvent</code> / <code>readEvents</code> / <code>writeSnapshot</code> \u662f \u662f\uff08\u4e8b\u4ef6/\u5feb\u7167/\u9501\u6587\u4ef6\uff09 \u5426 \u5426 \u5426 \u4e8b\u4ef6\u65e5\u5fd7 + \u9501\u6587\u4ef6 <code>SFC2004</code>\uff08<code>store-locked</code>/\u94fe\u65ad\u88c2\uff09 <code>inspectStateStoreLock</code> / <code>recoverStateStoreLock</code> \u662f \u662f\uff08\u4ec5\u6062\u590d\u5199\u9501\uff09 \u5426 \u5426 \u5426 \u9501\u6587\u4ef6\uff08\u5355\u8c03 fencing\uff09 <code>SFC2004</code> <p>Harness \u7684 <code>HARNESS_EXCLUSIONS</code> \u660e\u786e\u6392\u9664 release-state\u3001remote-network-access\u3001business-semantics\u3001workflow-orchestration\u3001model-calls\u3001git-writes\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#Engineering-Kit\u5de5\u7a0b\u547d\u4ee4\u5c42","title":"Engineering Kit\uff08\u5de5\u7a0b\u547d\u4ee4\u5c42\uff09","text":"\u5165\u53e3 \u8bfb \u5199 spawn Git \u7f51\u7edc \u6b8b\u4f59\u72b6\u6001 \u7a33\u5b9a\u9519\u8bef\u7801 / \u9000\u51fa\u7801 <code>scaffoldTarget</code> \u5426 \u662f\uff08\u53d7\u6536\u5bb9\u9aa8\u67b6\uff0c\u539f\u5b50 + \u6536\u5bb9\uff09 \u5426 \u5426 \u5426 \u65e0\uff08\u5931\u8d25\u4e0d\u7559\u534a\u6210\u54c1\uff09 <code>SFC2004</code>\uff08<code>target-not-empty</code>\uff09 <code>planAdoption</code> / <code>buildHandoffDraft</code> \u662f \u5426 \u5426 \u53ea\u8bfb\u63a2\u6d4b \u5426 \u65e0\uff08stdout \u8f93\u51fa\uff09 <code>SFC</code> \u5b8c\u6210\u5224\u5b9a false <code>runProjection</code> \u662f\uff08\u8bfb manifest\uff09 \u662f\uff08\u53d7\u7ba1\u8def\u5f84\uff0c\u4e24\u9636\u6bb5\uff09 \u5426 \u5426 \u5426 \u65e0\uff08\u5931\u8d25\u96f6\u5199/\u56de\u6eda\uff09 <code>SFC2004</code>\uff08<code>unauthorized-path</code>/<code>handwritten-overwrite</code>/<code>conflict-drift</code>\uff09 <code>runChecks</code>\uff08<code>check</code>\uff09 \u662f \u5426 \u5426 \u53ea\u8bfb\u767d\u540d\u5355 \u5426 \u65e0 \u9000\u51fa\u7801 1\uff08\u53d1\u73b0\uff09/ 2\uff08\u673a\u5236\uff09 <code>renderReportAction</code> / <code>checkReportAction</code> \u662f \u4ec5 <code>--out</code>/<code>--binding</code> \u5426 \u5426 \u5426 \u9ed8\u8ba4\u53ea\u5199 stdout <code>SFC3001</code>/<code>SFC3002</code>/<code>SFC3003</code> <code>probeGitState</code> / <code>probeGitFacts</code> \u662f \u5426 \u5426 \u53ea\u8bfb\u767d\u540d\u5355 \u5426 \u65e0 <code>SFC</code>\uff08\u8d8a\u6743\u53c2\u6570\u62d2\u7edd\uff09 <code>describeHost</code> / <code>probeHost</code> / <code>buildHostAdapter</code> / <code>planHost</code> \u662f build \u5199\uff08\u53d7\u6536\u5bb9\uff09 probe \u9ed8\u8ba4\u5426 \u5426 \u5426 \u65e0 <code>SFC2004</code>\uff1bapply \u7a33\u5b9a\u62d2\u7edd <code>loadLicensingProfile</code> / <code>generateLicenseContent</code> \u7b49 \u5426 \u5426\uff08\u7eaf\u51fd\u6570\u751f\u6210\uff09 \u5426 \u5426 \u5426 \u65e0 <code>SFC</code>\uff08\u975e\u6cd5 Profile\uff09 <code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code> \u662f \u5426 \u5426 \u5426 \u5426 \u65e0 findings <code>cliMain</code> / <code>runCommand</code> \u4f9d\u547d\u4ee4 \u4f9d\u547d\u4ee4 \u4f9d\u547d\u4ee4 \u4f9d\u547d\u4ee4 \u5426 \u4f9d\u547d\u4ee4 \u9000\u51fa\u7801 0/1/2 <p>Kit \u7684 <code>FORBIDDEN_SIDE_EFFECTS</code> \u542b git-init/commit/push/tag\u3001publish\u3001remote-write\uff1b<code>REFUSED_MUTATION_FLAGS</code>\uff08\u542b <code>--apply</code>\uff09\u5728 CLI \u5165\u53e3\u5373\u62d2\u3002</p>"},{"location":"reference/failure-and-side-effect-matrix/#\u6b8b\u4f59\u72b6\u6001\u5408\u96c6","title":"\u6b8b\u4f59\u72b6\u6001\u5408\u96c6","text":"<ul> <li>\u539f\u5b50\u5199\uff1a\u5931\u8d25\u65f6\u56de\u6eda\u4e34\u65f6\u6587\u4ef6\uff0c\u76ee\u6807\u76ee\u5f55\u4e0d\u7559\u534a\u6210\u54c1\u3002</li> <li>\u4e34\u65f6\u5de5\u4f5c\u533a\uff1a\u9000\u51fa\uff08\u542b\u5f02\u5e38\u8def\u5f84\uff09\u65f6\u6e05\u7406\u3002</li> <li>\u72b6\u6001\u5b58\u50a8\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u662f\u552f\u4e00\u6743\u5a01\uff0csnapshot \u4e3a\u6d3e\u751f\u7f13\u5b58\uff1b\u5d29\u6e83\u9057\u7559\u9501\u9700\u8c03\u7528\u65b9\u5728 Foundation \u5916\u786e\u8ba4\u65e7\u5199\u8005\u7ec8\u6b62\u540e\u663e\u5f0f\u6062\u590d\uff0c\u4e0d\u81ea\u52a8\u5077\u9501\u3002</li> <li>\u6295\u5f71\uff1a\u4efb\u4e00\u6821\u9a8c\u5931\u8d25\u6574\u4f53\u62d2\u7edd\u3001\u96f6\u5199\u5165\uff1b\u8986\u76d6\u65e2\u6709\u6587\u4ef6\u9700\u58f0\u660e <code>expect.sha256</code> \u524d\u7f6e\u72b6\u6001\u3002</li> <li>adopt-plan / check\uff1a\u7ed3\u6784\u6027\u53ea\u8bfb\uff0c\u8fd0\u884c\u524d\u540e\u5b57\u8282\u7ea7\u96f6\u53d8\u5316\u3002</li> </ul>"},{"location":"reference/failure-and-side-effect-matrix/#\u5931\u8d25\u540e\u8c03\u7528\u65b9\u8be5\u505a\u4ec0\u4e48","title":"\u5931\u8d25\u540e\u8c03\u7528\u65b9\u8be5\u505a\u4ec0\u4e48","text":"<ul> <li>\u6821\u9a8c\u5931\u8d25\uff08<code>SFC1001</code>/<code>SFC2002</code>/<code>SFC2003</code>\uff09\uff1a\u68c0\u67e5\u8f93\u5165\u662f\u5426\u6ee1\u8db3\u76ee\u6807 Schema \u6216\u53c2\u6570\u5408\u540c\uff0c\u4e0d\u91cd\u8bd5\u5df2\u88ab\u51bb\u7ed3\u62d2\u7edd\u7684\u767b\u8bb0\u3002</li> <li>\u6536\u5bb9\u5931\u8d25\uff08<code>SFC2004</code> + <code>path-traversal</code> \u7b49\uff09\uff1a\u786e\u8ba4\u6839\u76ee\u5f55\u4e0e\u8def\u5f84\u662f\u5426\u8d8a\u754c\uff0c\u4e0d\u8981\u628a\u4e1a\u52a1\u9009\u62e9\u89c4\u5219\u585e\u8fdb Foundation\u3002</li> <li>\u72b6\u6001\u9501\u51b2\u7a81\uff08<code>store-locked</code>\uff09\uff1a\u5728 Foundation \u4e4b\u5916\u786e\u8ba4\u65e7\u5199\u8005\u5df2\u7ec8\u6b62\uff0c\u518d\u7528\u7cbe\u786e\u5339\u914d\u7684 owner/fencing \u8c03\u7528\u6062\u590d\u3002</li> <li>check \u53d1\u73b0\uff08\u9000\u51fa\u7801 1\uff09\uff1a\u5904\u7f6e\u53d1\u73b0\u9879\uff0cKit \u4e0d\u81ea\u52a8\u4fee\u590d\u3002</li> </ul>"},{"location":"reference/api/","title":"\u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u76ee\u5f55\u4e3a Skill Family Foundation \u4e09\u5305\u5efa\u7acb\u673a\u5668\u53ef\u8bfb\u80fd\u529b\u76ee\u5f55\uff08<code>docs/agents/capability-catalog.json</code>\uff09\u7684\u4eba\u7c7b\u53ef\u8bfb\u6295\u5f71\u3002\u8303\u56f4\u6309 hand-off \u00a74.3\uff1a\u4f18\u5148\u4ece\u771f\u5b9e\u5bfc\u51fa\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684 API \u5168\u96c6\u3002</p>"},{"location":"reference/api/#\u8986\u76d6\u8303\u56f4","title":"\u8986\u76d6\u8303\u56f4","text":"\u5305 \u9875\u9762 \u516c\u5171\u5165\u53e3\u6027\u8d28 <code>skill-family-contracts</code> contracts.md \u673a\u5668\u5951\u7ea6\u3001\u534f\u8bae\u3001\u9519\u8bef\u7801\u3001fixture\u3001\u5ba1\u8ba1\u8868\u9762\uff08\u7eaf\u51fd\u6570\u4e3a\u4e3b\uff09 <code>skill-family-harness-node</code> harness.md \u4e1a\u52a1\u4e2d\u7acb Node \u673a\u5236\uff08\u6536\u5bb9\u3001\u539f\u5b50\u5199\u3001\u95ed\u5305\u3001\u8bf7\u6c42\u3001\u62a5\u544a\u3001\u72b6\u6001\u5e95\u5ea7\uff09 <code>skill-family-engineering-kit</code> engineering-kit.md \u56db\u4e2a\u9876\u5c42\u547d\u4ee4\u4e0e\u53ea\u8bfb/\u53d7\u63a7\u5199\u5b50\u52a8\u4f5c <p>\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 \u00a74.3 \u81f3\u5c11\u8bf4\u660e\uff1a\u7b7e\u540d\u4e0e\u8f93\u5165\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p>"},{"location":"reference/api/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u5173\u7cfb","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u5173\u7cfb","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID\uff08\u5982 <code>foundation.contracts.object-validation</code>\u3001<code>foundation.harness.state-store</code>\uff09\u5b9a\u4e49\u5728 <code>docs/agents/capability-catalog.json</code>\uff0c\u672c\u9875\u4ece\u4e2d\u6295\u5f71\u5e76\u94fe\u63a5\u56de <code>sourceRefs</code> \u4e0e\u6d4b\u8bd5\u5f15\u7528\u3002</li> <li>\u672c\u9875\u7b7e\u540d\u53d6\u81ea\u5404\u5305 <code>src/index.mjs</code> \u4e0e\u6e90\u6a21\u5757\u771f\u5b9e\u5bfc\u51fa\uff1b\u95e8\u7981 <code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code>\uff0c\u62d2\u7edd catalog \u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\u3002</li> <li>catalog \u662f\u6587\u6863\u5c42\u673a\u5668\u4e8b\u5b9e\uff0c\u4e0d\u662f\u65b0\u7684 Contracts \u516c\u5171\u5bf9\u8c61\u6216\u534f\u8bae\uff1b\u672a\u7ecf ADR \u4e0d\u5f97\u4e3a\u5199\u6587\u6863\u65b0\u589e\u7b2c\u56db\u5305\u6216 Contracts \u5bf9\u8c61\u3002</li> </ul>"},{"location":"reference/api/#\u5173\u952e\u7eaa\u5f8b","title":"\u5173\u952e\u7eaa\u5f8b","text":"<ul> <li>\u673a\u5236\u5931\u8d25\u7edf\u4e00 <code>SFC2004</code>\uff08<code>EXECUTION_FAILED</code>\uff09\uff0c\u7531 <code>details.kind</code> \u533a\u5206\uff08<code>HARNESS_ERROR_KINDS</code> \u51bb\u7ed3\u679a\u4e3e\uff09\uff1bContracts \u6821\u9a8c\u5931\u8d25\uff08<code>SFC1001</code> / <code>SFC1002</code>\uff09\u7ecf <code>validateDocument</code> \u8fd4\u56de\u503c\u8868\u8fbe\u3001\u4e0d\u629b\u5f02\u5e38\u3002</li> <li>Kit \u9876\u5c42\u547d\u4ee4\u96c6\u5408\u56fa\u5b9a\u4e3a 4 \u4e2a\uff08<code>scaffold</code> / <code>adopt-plan</code> / <code>projection</code> / <code>check</code>\uff09\uff0c\u4e0d\u6269\u5f20\uff1b<code>host apply</code> / <code>install</code> / <code>update</code> / <code>uninstall</code>\u3001Qoder \u5b8c\u6574 driver\u3001\u4e8c\u8fdb\u5236 adapter source\u3001\u8fdc\u7aef\u53d1\u5e03\u3001\u4e1a\u52a1\u72b6\u6001\u673a\u3001\u6a21\u578b\u7f16\u6392\u3001\u9886\u57df\u5ba1\u8ba1\u8bed\u4e49\u5747\u660e\u786e unsupported\u3002</li> <li>\u6240\u6709\u7248\u672c\u5b57\u6bb5\u4ece <code>package.json</code> \u4e0e Contracts \u771f\u6e90\u751f\u6210\u6216\u7531 fact-check \u6821\u9a8c\uff1b<code>CONTRACTS_VERSION=1.4.0</code> \u4e0e npm \u5305\u7248\u672c <code>0.3.0</code> \u5e76\u884c\u3002</li> </ul>"},{"location":"reference/api/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p>\u4e09\u4e2a\u5305\u90fd\u901a\u8fc7\u65e2\u6709 candidate \u5b50\u8def\u5f84\u516c\u5f00 Quickstart Profile v2\u3002Contracts \u5b9a\u4e49 <code>execute-method</code> \u4ea4\u6362\u7ed3\u6784\uff0cHarness \u590d\u9a8c\u5b57\u8282\u548c\u7ed1\u5b9a\uff0cKit \u4ece\u663e\u5f0f\u6d88\u8d39\u8005 Schema \u751f\u6210\u79bb\u7ebf Bundle\u3002\u8be5\u80fd\u529b\u4ecd\u6807\u8bb0\u4e3a <code>candidate</code>\uff0c0.3.0 \u7684 v2 \u4e0e 0.2.1 \u7684 v1 \u4e0d\u517c\u5bb9\uff1b\u6d88\u8d39\u8005\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a\u6240\u9009\u5305\u7248\u672c\u3002</p>"},{"location":"reference/api/contracts/","title":"skill-family-contracts \u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u9875\u4ece\u771f\u5b9e\u5bfc\u51fa\uff08<code>src/index.mjs</code> \u4e0e\u5404\u6e90\u6a21\u5757\uff09\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684\u5168\u96c6\u3002\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 hand-off \u00a74.3 \u8bf4\u660e\uff1a\u7b7e\u540d\u3001\u8f93\u5165\u4e0e\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p> <p>\u80fd\u529b\u5206\u7ec4\uff08\u4e0e <code>docs/agents/capability-catalog.json</code> \u5bf9\u5e94\uff09\uff1a</p> <ul> <li>\u5bf9\u8c61\u6821\u9a8c \u2192 <code>validateDocument</code> / <code>compileSchema</code> / <code>detectDialect</code></li> <li>\u767b\u8bb0\u4e0e\u534f\u8bae \u2192 <code>loadRegistry</code> / <code>findSchemaByObject</code> / <code>findProtocol</code> / <code>registerSchema</code> / <code>registerProtocol</code></li> <li>\u5185\u6838\u534f\u8bae \u2192 <code>loadKernelProtocol</code> / <code>findOperation</code> / <code>checkOperation</code></li> <li>\u5f3a\u5236\u68c0\u67e5 \u2192 <code>runChecks</code> / <code>collectUnresolvedRefs</code></li> <li>fixture \u6821\u9a8c \u2192 <code>listFixtures</code> / <code>verifyFixture</code> / <code>verifyAllFixtures</code></li> <li>\u9519\u8bef\u7801 \u2192 <code>ContractsError</code> / <code>isRegisteredErrorCode</code> / <code>stableError</code></li> <li>\u5ba1\u8ba1\u8868\u9762 \u2192 <code>canonicalJson</code> / <code>digestDocument</code> / <code>digestAuditSurface</code></li> </ul> <p>\u5305\u7ea7\u5e38\u91cf\uff08\u51bb\u7ed3\uff0c\u4ec5\u4f5c\u4e8b\u5b9e\u6295\u5f71\uff0c\u4e0d\u53e6\u7acb\u6743\u5a01\uff09\uff1a<code>CONTRACT_OBJECTS</code>\uff0818 \u7c7b\u9876\u5c42\u5bf9\u8c61\uff0c\u95ed\u96c6\uff09\u3001<code>CONTRACT_BOUNDARY</code>\u3001<code>CONTRACTS_VERSION = \"1.4.0\"</code>\u3001<code>SUPPORTED_DIALECTS</code>\u3001<code>VALIDATION_POLICIES</code>\u3001<code>CHECK_TYPES</code>\uff089 \u7c7b\u673a\u68b0\u68c0\u67e5\uff09\u3001<code>MANDATORY_RULES</code>\u3001<code>RULE_BUDGET</code>\u3001<code>ERROR_CODES</code>\u3002</p>"},{"location":"reference/api/contracts/#\u5bf9\u8c61\u6821\u9a8c-foundationcontractsobject-validation","title":"\u5bf9\u8c61\u6821\u9a8c (foundation.contracts.object-validation)","text":""},{"location":"reference/api/contracts/#validateDocument","title":"validateDocument","text":"<ul> <li>\u7b7e\u540d\uff1a<code>validateDocument(document, { schemaId, schema, dialect, policy = \"strict\" } = {})</code></li> <li>\u8f93\u5165\uff1a\u4efb\u610f JSON \u6587\u6863\uff1b\u76ee\u6807\u5951\u7ea6\u5bf9\u8c61 <code>$id</code> \u6216 schema \u5bf9\u8c61\uff1b\u65b9\u8a00\uff08<code>draft-07</code> / <code>2020-12</code>\uff09\uff1b\u7b56\u7565\uff08<code>strict</code> \| <code>tolerant</code>\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u6821\u9a8c\u901a\u8fc7\u8fd4\u56de <code>{valid:true}</code>\uff08\u4e0d\u542b <code>errorCode</code>\uff09\uff1b\u5931\u8d25\u8fd4\u56de <code>{valid:false, errorCode, errors}</code>\uff0c\u4e0d\u629b\u51fa\uff08\u5df2\u5b9e\u6d4b\uff1a\u672a\u77e5 <code>$id</code> \u8fd4\u56de <code>SFC1002</code>\uff0c\u6587\u6863\u4e0d\u7b26\u8fd4\u56de <code>SFC1001</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002\u4ec5\u8bfb\u53d6\u8fdb\u7a0b\u5185 Ajv \u7f16\u8bd1\u7f13\u5b58\uff0c\u4e0d\u89e6\u5916\u90e8\u8d44\u6e90\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6/Git/\u7f51\u7edc/\u8fdb\u7a0b\u526f\u4f5c\u7528\uff1b\u9996\u6b21\u7f16\u8bd1\u5199\u5165\u5185\u5b58\u7f16\u8bd1\u7f13\u5b58\uff0c\u540e\u7eed\u540c <code>(schemaId,dialect,policy)</code> \u590d\u7528\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1002</code>\uff08\u672a\u77e5 <code>$id</code>\uff09\u3001<code>SFC1001</code>\uff08\u6587\u6863\u4e0d\u7b26 Schema\uff09\u3002\u4e24\u8005\u5747\u7ecf\u8fd4\u56de\u503c <code>errorCode</code> \u8868\u8fbe\uff0c\u8c03\u7528\u65b9\u4ee5 <code>valid</code> \u5b57\u6bb5\u5224\u65ad\u6210\u8d25\uff0c\u4e0d\u4ee5 <code>try/catch</code> \u6355\u83b7\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5f85\u6821\u9a8c\u6587\u6863\u5e26\u5df2\u767b\u8bb0\u5951\u7ea6\u5bf9\u8c61 <code>$id</code>\uff1bNode >= 22.22.2\uff1b\u6821\u9a8c\u5668\u56fa\u5b9a\u4e3a Ajv 8.20.0\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/validator.mjs</code>\u3002</li> <li>\u6b63\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/validator.test.mjs</code>\u3001<code>schemas.test.mjs</code>\u3001<code>host-contracts.test.mjs</code>\u3001<code>report-contracts.test.mjs</code>\u3002</li> <li>\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c\u4e0a\uff08\u672a\u77e5 <code>$id</code> \u4e0e\u4e0d\u7b26 Schema \u5747\u8fd4\u56de <code>valid:false</code>\uff09\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5177\u4f53\u4e1a\u52a1\u5b57\u6bb5\u7684\u8bed\u4e49\u89e3\u91ca\u3001\u9886\u57df\u7ea7\u6821\u9a8c\u89c4\u5219\u3002</li> </ul>"},{"location":"reference/api/contracts/#compileSchema","title":"compileSchema","text":"<ul> <li>\u7b7e\u540d\uff1a<code>compileSchema(target, { dialect, policy = \"strict\" } = {})</code></li> <li>\u8f93\u5165\uff1aschema \u5bf9\u8c61\u6216 <code>$id</code>\uff1b\u65b9\u8a00\uff1b\u7b56\u7565\u3002</li> <li>\u8f93\u51fa\uff1a\u7f16\u8bd1\u540e\u7684 Ajv <code>validate</code> \u51fd\u6570\uff1b\u6216\u629b <code>ContractsError</code>\uff08<code>SFC1012</code> <code>SCHEMA_COMPILE_FAILED</code>\uff0c\u5f53 schema \u81ea\u8eab\u65e0\u6cd5\u5728\u58f0\u660e\u65b9\u8a00\u4e0b\u7f16\u8bd1\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff0c\u4ec5\u5199\u5165\u7f16\u8bd1\u7f13\u5b58\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1012</code>\uff08\u7f16\u8bd1\u5931\u8d25\uff0c\u629b\u5f02\u5e38\u2014\u2014\u4e0e <code>validateDocument</code> \u7684\u8fd4\u56de\u5f0f\u5931\u8d25\u4e0d\u540c\uff09\u3001<code>SFC1006</code>\uff08\u672a\u77e5\u65b9\u8a00\uff0c\u7531 <code>detectDialect</code> \u629b\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aAjv 8.20.0 \u56fa\u5b9a\uff1b<code>dialect</code> \u5c5e\u51bb\u7ed3\u652f\u6301\u96c6\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/validator.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c <code>validateDocument</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1aschema \u7684\u4e1a\u52a1\u542b\u4e49\u3002</li> </ul>"},{"location":"reference/api/contracts/#detectDialect","title":"detectDialect","text":"<ul> <li>\u7b7e\u540d\uff1a<code>detectDialect(schema)</code></li> <li>\u8f93\u5165\uff1a\u5e26 <code>$schema</code> \u5b57\u6bb5\u7684 schema \u5bf9\u8c61\u3002</li> <li>\u8f93\u51fa\uff1a\u65b9\u8a00\u5b57\u7b26\u4e32\uff08<code>draft-07</code> / <code>2020-12</code>\uff09\uff1b\u672a\u77e5\u65b9\u8a00\u629b <code>ContractsError</code>\uff08<code>SFC1006</code> <code>UNSUPPORTED_DIALECT</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1006</code>\uff08\u58f0\u660e\u65b9\u8a00\u4e0d\u5728\u51bb\u7ed3\u652f\u6301\u96c6\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u65b9\u8a00\u96c6\u51bb\u7ed3\uff08<code>SUPPORTED_DIALECTS</code>\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/validator.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c\u4e0a\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u65b9\u8a00\u9009\u62e9\u7b56\u7565\uff08\u4f55\u65f6\u7528 tolerant\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u767b\u8bb0\u4e0e\u534f\u8bae-foundationcontractsregistry-protocol","title":"\u767b\u8bb0\u4e0e\u534f\u8bae (foundation.contracts.registry-protocol)","text":""},{"location":"reference/api/contracts/#loadRegistry--listSchemas--listProtocols--findSchemaRegistration--findSchemaByObject--findProtocol","title":"loadRegistry / listSchemas / listProtocols / findSchemaRegistration / findSchemaByObject / findProtocol","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>loadRegistry()</code></li> <li><code>listSchemas(registry = REGISTRY)</code></li> <li><code>listProtocols(registry = REGISTRY)</code></li> <li><code>findSchemaRegistration(schemaId, registry = REGISTRY)</code></li> <li><code>findSchemaByObject(object, registry = REGISTRY)</code></li> <li><code>findProtocol(name, version, registry = REGISTRY)</code></li> <li>\u8f93\u5165\uff1a\u5bf9\u8c61\u540d\u3001<code>$id</code>\u3001\u534f\u8bae\u540d/\u7248\u672c\uff08\u5176\u4f59\u9ed8\u8ba4\u8bfb\u51bb\u7ed3 <code>REGISTRY</code>\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u5df2\u767b\u8bb0 schema \u5143\u4fe1\u606f\u6216\u534f\u8bae\u5b9a\u4e49\uff1b\u672a\u547d\u4e2d\u8fd4\u56de <code>undefined</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u767b\u8bb0\u7c7b\u51b2\u7a81\u7ecf <code>registerSchema</code> / <code>registerProtocol</code> \u629b <code>SFC1003</code>\uff08<code>DUPLICATE_SCHEMA_ID</code>\uff09/ <code>SFC1004</code>\uff08<code>DUPLICATE_PROTOCOL_NAME</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>registry.json</code> \u968f\u5305\u53d1\u5e03\uff1b<code>schemaVersion=1</code>\u3001<code>contractsVersion=1.4.0</code> \u4e3a\u552f\u4e00\u6743\u5a01\uff1b18 \u7c7b\u9876\u5c42\u5bf9\u8c61\u96c6\u5408\u56fa\u5b9a\uff0c\u65b0\u589e\u9700 ADR\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/registry.mjs</code>\u3001<code>registry.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/registry.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5bf9\u8c61\u4e1a\u52a1\u542b\u4e49\u7684\u89e3\u91ca\u3002</li> </ul>"},{"location":"reference/api/contracts/#registerSchema--registerProtocol","title":"registerSchema / registerProtocol","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>registerSchema(entry, registry = REGISTRY)</code></li> <li><code>registerProtocol(entry, registry = REGISTRY)</code></li> <li>\u8f93\u5165\uff1aschema/protocol \u767b\u8bb0\u9879\u3002</li> <li>\u8f93\u51fa\uff1a\u5199\u5165\u540e\u7684 registry\uff08\u9ed8\u8ba4\u51bb\u7ed3 <code>REGISTRY</code> \u4e0a\u7684\u526f\u4f5c\u7528\uff09\uff1b\u91cd\u590d <code>$id</code>/\u534f\u8bae\u540d\u629b <code>ContractsError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u9ed8\u8ba4\u5411\u8fdb\u7a0b\u5185\u51bb\u7ed3 registry \u767b\u8bb0\uff0c\u5c5e\u53d7\u63a7\u5185\u5b58\u526f\u4f5c\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u8fdb\u7a0b\u5185 registry \u53d8\u66f4\uff1b\u4e0d\u843d\u76d8\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1003</code>\uff08\u91cd\u590d <code>$id</code>\uff09\u3001<code>SFC1004</code>\uff08\u91cd\u590d\u534f\u8bae\u540d\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a18 \u7c7b\u5bf9\u8c61\u96c6\u4e0e\u534f\u8bae\u540d\u96c6\u51bb\u7ed3\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a\u540c\u4e0a\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a\u540c\u4e0a\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u767b\u8bb0\u9879\u7684\u4e1a\u52a1\u7406\u7531\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u5185\u6838\u534f\u8bae-foundationcontractskernel-protocol","title":"\u5185\u6838\u534f\u8bae (foundation.contracts.kernel-protocol)","text":""},{"location":"reference/api/contracts/#loadKernelProtocol--findOperation--checkOperation","title":"loadKernelProtocol / findOperation / checkOperation","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>loadKernelProtocol()</code></li> <li><code>findOperation(name, kernel = KERNEL)</code></li> <li><code>checkOperation(operation, params)</code></li> <li>\u8f93\u5165\uff1a\u534f\u8bae\u540d\u3001\u64cd\u4f5c\u540d\u3001\u64cd\u4f5c\u53c2\u6570\u3002</li> <li>\u8f93\u51fa\uff1a\u534f\u8bae\u5b9a\u4e49\u6216\u64cd\u4f5c\u53c2\u6570\u6821\u9a8c\u7ed3\u679c\uff1b\u5931\u8d25\u65f6\u629b <code>ContractsError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08\u52a0\u8f7d\u4e3a\u53ea\u8bfb\u89e3\u6790\uff0c\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC2002</code>\uff08<code>UNKNOWN_OPERATION</code>\uff0c\u64cd\u4f5c\u540d\u4e0d\u5728\u51bb\u7ed3\u8bcd\u6c47\uff09\u3001<code>SFC2003</code>\uff08<code>INVALID_PARAMS</code>\uff0c\u53c2\u6570\u8fdd\u53cd\u64cd\u4f5c\u53c2\u6570\u5951\u7ea6\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>kernel-protocol.json</code> \u968f\u5305\u53d1\u5e03\uff1b\u5185\u6838\u534f\u8bae\u7248\u672c\u4e0e Contracts \u7248\u672c\u7ed1\u5b9a\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/kernel.mjs</code>\u3001<code>kernel-protocol.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/kernel.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u64cd\u4f5c\u7684\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\uff08\u72b6\u6001\u673a/\u91cd\u8bd5/\u7ec8\u6001\u8f6c <code>loop-agent</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u5f3a\u5236\u68c0\u67e5-foundationcontractsmandatory-checks","title":"\u5f3a\u5236\u68c0\u67e5 (foundation.contracts.mandatory-checks)","text":""},{"location":"reference/api/contracts/#runChecks--collectUnresolvedRefs","title":"runChecks / collectUnresolvedRefs","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runChecks({ schemaEntries, ... } = {})</code></li> <li><code>collectUnresolvedRefs(schemaEntries)</code></li> <li>\u8f93\u5165\uff1a\u5f85\u68c0\u67e5\u5951\u7ea6\u96c6\u6216\u5408\u6210 registry/fixtures\u3002</li> <li>\u8f93\u51fa\uff1a\u68c0\u67e5\u7ed3\u8bba\u4e0e\u672a\u89e3\u6790\u5f15\u7528\u6e05\u5355\uff1b\u8fdd\u53cd\u89c4\u5219\u629b <code>ContractsError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1002</code>/<code>1003</code>/<code>1004</code>/<code>1005</code>/<code>1006</code>/<code>1008</code>/<code>1009</code>/<code>1010</code> \u5bf9\u5e94\u5404\u89c4\u5219 violated\uff1b<code>SFC1005</code>\uff08<code>UNRESOLVED_REF</code>\uff09\u3001<code>SFC1008</code>\uff08<code>RULE_BUDGET_EXCEEDED</code>\uff09\u3001<code>SFC1010</code>\uff08<code>FIXTURE_EXPECTATION_MISMATCH</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aregistry \u4e0e rules \u5df2\u52a0\u8f7d\uff1b<code>CHECK_TYPES</code> \u4e3a 9 \u7c7b\u95ed\u96c6\uff1b<code>RULE_BUDGET</code> \u9650\u5236 <code>firstVersionMax</code> \u4e0e <code>absoluteMax</code>\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/checker.mjs</code>\u3001<code>rules.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/checker.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u89c4\u5219\u4e1a\u52a1\u7406\u7531\u7684\u89e3\u91ca\uff08\u8bed\u4e49\u63a5\u53d7/\u62d2\u7edd\u5c5e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#fixture-\u6821\u9a8c-foundationcontractsfixture-verification","title":"fixture \u6821\u9a8c (foundation.contracts.fixture-verification)","text":""},{"location":"reference/api/contracts/#listFixtures--fixtureClasses--verifyFixture--verifyAllFixtures","title":"listFixtures / fixtureClasses / verifyFixture / verifyAllFixtures","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>listFixtures()</code></li> <li><code>fixtureClasses()</code></li> <li><code>verifyFixture(fixture)</code></li> <li><code>verifyAllFixtures()</code></li> <li>\u8f93\u5165\uff1afixture \u7c7b\u6216\u5355\u4e2a fixture \u6807\u8bc6\u3002</li> <li>\u8f93\u51fa\uff1a\u9010 fixture \u7684\u6821\u9a8c\u7ed3\u679c\uff08\u6b63\u4f8b\u987b\u901a\u8fc7\u3001\u8d1f\u4f8b\u987b\u4ee5\u58f0\u660e\u7a33\u5b9a\u7801\u5931\u8d25\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08\u53ea\u8bfb fixture \u76ee\u5f55\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u8bbf\u95ee fixture\uff0c\u65e0\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC1010</code>\uff08<code>FIXTURE_EXPECTATION_MISMATCH</code>\uff0c\u8d1f\u4f8b\u672a\u4ea7\u751f\u9884\u671f\u5931\u8d25\uff09\uff1b<code>SFC1009</code>\uff08<code>UNKNOWN_ERROR_CODE</code>\uff0cfixture \u5f15\u7528\u672a\u767b\u8bb0\u7801\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1afixtures \u76ee\u5f55\u4e3a\u516c\u5f00\u6216\u5b8c\u5168\u865a\u6784\u6570\u636e\uff1bfixture \u4e0e\u5ba1\u8ba1\u5668\u9884\u671f\u7ed3\u679c\u4e0d\u5171\u4eab\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/fixtures.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/fixtures.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1afixture \u80cc\u540e\u7684\u4e1a\u52a1\u610f\u56fe\uff08fixture \u53ea\u8bc1\u7ed3\u6784\u3001\u4e0d\u8bc1\u8bed\u4e49\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#\u9519\u8bef\u7801-foundationcontractserror-codes","title":"\u9519\u8bef\u7801 (foundation.contracts.error-codes)","text":""},{"location":"reference/api/contracts/#ContractsError--errorCodeRegistry--errorCodeInfo--isRegisteredErrorCode--assertRegisteredErrorCode--stableError","title":"ContractsError / errorCodeRegistry / errorCodeInfo / isRegisteredErrorCode / assertRegisteredErrorCode / stableError","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>class ContractsError extends Error</code>\uff08\u6784\u9020 <code>(code, message, details)</code>\uff09</li> <li><code>errorCodeRegistry()</code></li> <li><code>errorCodeInfo(code)</code></li> <li><code>isRegisteredErrorCode(code)</code></li> <li><code>assertRegisteredErrorCode(code)</code></li> <li><code>stableError(code, message, details)</code></li> <li>\u8f93\u5165\uff1a\u9519\u8bef\u7801\u5b57\u7b26\u4e32\u3001\u9519\u8bef\u4e0a\u4e0b\u6587\u3002</li> <li>\u8f93\u51fa\uff1a\u5e26\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details</code> \u7684\u9519\u8bef\u5bf9\u8c61\uff1b<code>assertRegisteredErrorCode</code> \u5bf9\u672a\u767b\u8bb0\u7801\u629b <code>TypeError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08<code>ContractsError</code> \u6784\u9020\u4e3a\u7eaf\u5bf9\u8c61\uff0c\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u9519\u8bef\u7801\u4f53\u7cfb\u672c\u8eab\u51bb\u7ed3\uff08<code>error-codes.json</code>\uff09\uff0c\u65b0\u589e\u7801\u5c5e Contracts \u53d8\u66f4\uff1b<code>SFC1009</code> \u7528\u4e8e\u672a\u767b\u8bb0\u7801\u65ad\u8a00\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>error-codes.json</code> \u968f\u5305\u53d1\u5e03\uff1b\u51bb\u7ed3\u5bf9\u8c61\u4e0d\u53ef\u53d8\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/errors.mjs</code>\u3001<code>error-codes.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/boundary.test.mjs</code>\u3001<code>immutability.test.mjs</code>\u3001<code>audit-surface.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u9519\u8bef\u7801\u7684\u4e1a\u52a1\u5f52\u56e0\u3002</li> </ul> <p>Contracts \u9519\u8bef\u7801\u4e00\u89c8\uff08\u7a33\u5b9a\u3001append-only\uff09\uff1a</p> \u7801 \u540d\u79f0 \u7c7b\u522b SFC1001 SCHEMA_VALIDATION_FAILED contract SFC1002 UNKNOWN_SCHEMA_ID contract SFC1003 DUPLICATE_SCHEMA_ID contract SFC1004 DUPLICATE_PROTOCOL_NAME contract SFC1005 UNRESOLVED_REF contract SFC1006 UNSUPPORTED_DIALECT contract SFC1007 UNKNOWN_CHECK_TYPE contract SFC1008 RULE_BUDGET_EXCEEDED contract SFC1009 UNKNOWN_ERROR_CODE contract SFC1010 FIXTURE_EXPECTATION_MISMATCH contract SFC1011 UNKNOWN_PROTOCOL contract SFC1012 SCHEMA_COMPILE_FAILED contract SFC2002 UNKNOWN_OPERATION kernel SFC2003 INVALID_PARAMS kernel SFC2004 EXECUTION_FAILED kernel\uff08\u673a\u5236\u5931\u8d25\u7edf\u4e00\u7801\uff0c\u627f\u8f7d <code>details.kind</code>\uff09 SFC3001 REPORT_DIGEST_MISMATCH report SFC3002 REPORT_ELEMENT_MISSING report SFC3003 REPORT_FACT_DRIFT report"},{"location":"reference/api/contracts/#\u5ba1\u8ba1\u8868\u9762-foundationcontractsaudit-surface","title":"\u5ba1\u8ba1\u8868\u9762 (foundation.contracts.audit-surface)","text":""},{"location":"reference/api/contracts/#canonicalJson--digestDocument--describeAuditSurface--digestAuditSurface","title":"canonicalJson / digestDocument / describeAuditSurface / digestAuditSurface","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>canonicalJson(value)</code></li> <li><code>digestDocument(value, { algorithm = \"sha256\" } = {})</code></li> <li><code>describeAuditSurface()</code></li> <li><code>digestAuditSurface(surface = describeAuditSurface())</code></li> <li>\u8f93\u5165\uff1a\u4efb\u610f JSON \u6587\u6863\u3002</li> <li>\u8f93\u51fa\uff1acanonical \u5b57\u7b26\u4e32\u4e0e sha256 \u6458\u8981\uff1b\u5ba1\u8ba1\u8868\u9762\u7ed3\u6784\u63cf\u8ff0\u4e0e\u5176\u6458\u8981\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e JSON \u503c\u3001\u672a\u77e5\u7b97\u6cd5\uff08<code>AUDIT_DIGEST_ALGORITHMS</code> \u4ec5 <code>sha256</code>\uff09\u3001\u51bb\u7ed3\u8fdd\u89c4\u629b <code>ContractsError</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>AUDIT_SURFACE_VERSION=1</code>\uff1b\u6458\u8981\u7b97\u6cd5\u4ec5 <code>sha256</code>\uff1b\u4f9d\u8d56\u65b9\u5411 Audit \u2192 Contracts\uff0c\u672c\u6a21\u5757\u4e0d\u53cd\u5411\u5bfc\u5165\u5ba1\u8ba1\u4ea7\u7269\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-contracts/src/audit-surface.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-contracts/test/audit-surface.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5ba1\u8ba1\u8bed\u4e49\u7ed3\u8bba\uff08\u63a5\u53d7/\u62d2\u7edd\u5c5e\u5916\u90e8\u72ec\u7acb\u5ba1\u9605\uff09\u3002</li> </ul>"},{"location":"reference/api/contracts/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p><code>skill-family-contracts/candidate/quickstart-profile</code> \u5bfc\u51fa v2 \u534f\u8bae\u3001\u6309\u771f\u5b9e <code>$id</code> \u7d22\u5f15\u7684 Resource/Task/Result Schema \u96c6\u5408\uff0c\u4ee5\u53ca <code>validateQuickstartProfileDocument</code>\u3002\u552f\u4e00\u64cd\u4f5c\u540d\u662f\u4e1a\u52a1\u4e2d\u7acb\u7684 <code>execute-method</code>\uff1bFoundation \u4e0d\u767b\u8bb0 method \u8bcd\u8868\uff0c\u4e5f\u4e0d\u89e3\u91ca parameters\u3001evidence \u6216 domainResult \u7684\u9886\u57df\u542b\u4e49\u3002</p> <p>\u8be5\u5165\u53e3\u4ece <code>0.2.1</code> \u8d77\u516c\u5f00\uff0c\u4f46\u7a33\u5b9a\u6027\u4ecd\u4e3a <code>candidate</code>\u30020.3.0 \u5df2\u7528 v2 \u66ff\u6362 v1\uff0c\u4e24\u8005\u4e0d\u517c\u5bb9\uff1a\u65b0\u63a5\u5165\u9700\u7cbe\u786e\u9501\u5b9a <code>0.3.0</code>\uff0c\u4ecd\u9700 v1 \u7684\u63a5\u5165\u7ee7\u7eed\u7cbe\u786e\u9501\u5b9a <code>0.2.1</code>\u3002candidate Schema \u4e0d\u8fdb\u5165\u7a33\u5b9a <code>src/registry.json</code>\u3002</p>"},{"location":"reference/api/contracts/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID \u89c1 <code>docs/agents/capability-catalog.json</code>\uff08<code>foundation.contracts.</code>\uff09\u3002</li> <li>\u673a\u68b0\u6821\u9a8c\uff1a<code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code>\uff0c\u62d2\u7edd\u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\uff1b<code>sourceRefs</code> \u4e0e\u6d4b\u8bd5\u5f15\u7528\u5747\u6307\u5411\u672c\u9875\u6240\u5217\u771f\u5b9e\u6587\u4ef6\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/","title":"skill-family-engineering-kit \u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u9875\u4ece\u771f\u5b9e\u5bfc\u51fa\uff08<code>src/index.mjs</code> \u4e0e\u5404\u6e90\u6a21\u5757\u3001CLI \u5165\u53e3\uff09\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684\u5168\u96c6\u3002\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 hand-off \u00a74.3 \u8bf4\u660e\uff1a\u7b7e\u540d\u3001\u8f93\u5165\u4e0e\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p> <p>Kit \u6d88\u8d39 Contracts \u4e0e Harness\uff0c\u53ea\u62e5\u6709\u56db\u4e2a\u9876\u5c42\u547d\u4ee4\u4e0e\u5b83\u4eec\u7684\u53ea\u8bfb/\u53d7\u63a7\u5199\u8fb9\u754c\u3002\u5305\u7ea7\u5e38\u91cf\uff1a<code>TOP_LEVEL_COMMANDS</code>\uff08\u51bb\u7ed3 4 \u4e2a\uff1a<code>scaffold</code> / <code>adopt-plan</code> / <code>projection</code> / <code>check</code>\uff09\u3001<code>FORBIDDEN_SIDE_EFFECTS</code>\u3001<code>COMMAND_SIDE_EFFECTS</code>\u3001<code>KIT_EXIT_CODES</code>\uff08<code>ok=0</code> / <code>findings=1</code> / <code>rejected=2</code>\uff09\u3002Kit \u6c38\u4e0d\u6267\u884c Git \u5199\u3001\u53d1\u5e03\u3001\u5220\u9664\u7528\u6237\u5185\u5bb9\u6216\u89e6\u7f51\u3002</p> <p>\u80fd\u529b\u5206\u7ec4\uff08\u4e0e <code>docs/agents/capability-catalog.json</code> \u5bf9\u5e94\uff09\uff1a</p> <ul> <li>scaffold \u2192 <code>scaffoldTarget</code></li> <li>adopt-plan \u2192 <code>planAdoption</code> / <code>evaluateMigrationCompletion</code></li> <li>projection \u2192 <code>runProjection</code> / <code>loadProjectionManifest</code></li> <li>check \u2192 <code>runChecks</code> / <code>runCoreCheck</code></li> <li>report \u2192 <code>renderReportAction</code> / <code>checkReportAction</code></li> <li>git-probe \u2192 <code>probeGitState</code> / <code>probeGitFacts</code></li> <li>host \u2192 <code>describeHost</code> / <code>probeHost</code> / <code>refuseHostApply</code> \u2026</li> <li>licensing \u2192 <code>loadLicensingProfile</code> / <code>generateLicenseContent</code> \u2026</li> <li>identity-check \u2192 <code>checkIdentityDrift</code> / <code>validateIdentityAgainstProfile</code></li> <li>CLI \u2192 <code>runCommand</code> / <code>cliMain</code></li> </ul>"},{"location":"reference/api/engineering-kit/#scaffold-foundationkitscaffold","title":"scaffold (foundation.kit.scaffold)","text":""},{"location":"reference/api/engineering-kit/#scaffoldTarget--describeSkeletonFiles--normalizeSkeletonInputs","title":"scaffoldTarget / describeSkeletonFiles / normalizeSkeletonInputs","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>scaffoldTarget({ root, projectId, projectName, profileId, licensingProfile, licensingVariant, licensingProfileData, profilesRoot, identityProjections } = {})</code>\uff08async\uff09</li> <li><code>describeSkeletonFiles(inputs)</code>\uff08async\uff09</li> <li><code>normalizeSkeletonInputs({ projectId, projectName, profileId, licensingProfile, licensingVariant, rootBasename })</code></li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3001\u9aa8\u67b6\u9009\u9879\uff08<code>projectId</code> \u7b49\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u7cbe\u786e\u96c6\u5408\u7684\u6258\u7ba1\u9aa8\u67b6\u6587\u4ef6\uff08\u539f\u5b50 + \u8def\u5f84\u6536\u5bb9\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>normalizeSkeletonInputs</code> \u662f\uff1b<code>scaffoldTarget</code> \u843d\u76d8\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u76ee\u6807\u521b\u5efa\u6587\u4ef6\uff08\u539f\u5b50 + \u6536\u5bb9\uff09\uff1b\u76ee\u6807\u975e\u7a7a\u5219\u62d2\u7edd\u3001\u4e0d\u8986\u76d6\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u6cd5 kebab <code>projectId</code> / \u975e\u7a7a\u76ee\u6807\u629b <code>KitError</code>\uff08<code>KIT_ERROR_KINDS</code> \u7684 <code>invalid-params</code> / <code>rejected</code>\uff09\uff1b\u975e\u6cd5\u53c2\u6570 <code>+ INVALID_PARAMS</code>\uff08<code>SFC2003</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u76ee\u6807\u4e3a\u53ef\u5199\u7a7a\u76ee\u5f55\uff1bNode >= 22.22.2\uff1b\u9aa8\u67b6\u96c6\u5408\u4e0e <code>scaffold-conformance</code> fixture \u4e00\u81f4\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/scaffold.mjs</code>\u3001<code>skeleton.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/scaffold.test.mjs</code>\u3001<code>skeleton-contract.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e1a\u52a1\u9879\u76ee\u5185\u5bb9\uff08\u5b58\u91cf\u4ed3\u6539\u7528 <code>adopt-plan</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#adopt-plan-foundationkitadopt-plan","title":"adopt-plan (foundation.kit.adopt-plan)","text":""},{"location":"reference/api/engineering-kit/#planAdoption--buildHandoffDraft--evaluateMigrationCompletion--validateException--assessLegacyExitList--findNestedRepositories","title":"planAdoption / buildHandoffDraft / evaluateMigrationCompletion / validateException / assessLegacyExitList / findNestedRepositories","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>planAdoption({ root, manifest, ... } = {})</code>\uff08async\uff09</li> <li><code>buildHandoffDraft({ ... })</code></li> <li><code>evaluateMigrationCompletion({ ... })</code></li> <li><code>validateException(exception, index, nowMs)</code></li> <li><code>assessLegacyExitList(root, legacyItems)</code>\uff08async\uff09</li> <li><code>findNestedRepositories(entries)</code></li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3001\u8fc1\u79fb\u6e05\u5355\u8def\u5f84\u3002</li> <li>\u8f93\u51fa\uff1a\u91c7\u7528\u5206\u7c7b\uff08<code>direct-adoption</code> / <code>compatibility-layer</code> / <code>keep-business</code> / <code>foundation-gap</code>\uff09\u3001\u5b8c\u6210\u5224\u5b9a\u3001handoff \u8349\u7a3f\uff08\u4ec5\u8f93\u51fa\uff0c\u4e0d\u843d\u76d8\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5206\u7c7b\u4e0e\u8bc4\u4f30\u51fd\u6570\u4e3a\u7eaf\u51fd\u6570\uff1b<code>planAdoption</code> \u542b\u53ea\u8bfb\u63a2\u6d4b\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u4e25\u683c\u53ea\u8bfb\u2014\u2014\u4e0d\u5199\u6587\u4ef6\uff08\u4e34\u65f6\u6587\u4ef6\u4e5f\u4e0d\u5199\uff09\u3001\u4e0d Git \u5199\u3001\u4e0d rename\u3001\u4e0d\u89e6\u7f51\uff1b\u53ef\u80fd\u89e6\u53d1\u53ea\u8bfb Git \u63a2\u6d4b\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u4f8b\u5916\u7f3a\u5b57\u6bb5 / \u672a\u9000\u51fa\u65e7\u5b9e\u73b0\u5219\u5b8c\u6210\u5224\u5b9a <code>false</code>\uff1b\u786c\u5931\u8d25\u629b <code>KitError</code>\uff08<code>CONTRACTS_VERSION</code> \u4e0d\u4e00\u81f4\u7b49\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u76ee\u6807\u4ed3\u5b58\u5728\u4e14\u53ef\u53ea\u8bfb\u8bbf\u95ee\uff1b<code>MIGRATION_MANIFEST_PATH</code> / <code>MIGRATION_MANIFEST_SCHEMA_ID</code> \u6307\u5411\u5951\u7ea6\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/adopt-plan.mjs</code>\u3001<code>migration.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/adopt-plan.test.mjs</code>\u3001<code>migration.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5b58\u91cf\u4e1a\u52a1\u4ee3\u7801\u7684\u8fc1\u79fb\u51b3\u7b56\uff08\u771f\u6b63\u8fc1\u79fb\u6267\u884c\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#projection-foundationkitprojection","title":"projection (foundation.kit.projection)","text":""},{"location":"reference/api/engineering-kit/#runProjection--loadProjectionManifest","title":"runProjection / loadProjectionManifest","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runProjection({ root, manifest: manifestRelPath } = {})</code>\uff08async\uff09</li> <li><code>loadProjectionManifest(rootAbs, manifestRelPath)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u6295\u5f71\u6e05\u5355\u3001\u76ee\u6807\u6839\u3002</li> <li>\u8f93\u51fa\uff1a\u6295\u5f71\u6587\u4ef6\uff08\u4ec5\u5728\u6821\u9a8c\u5168\u90e8\u901a\u8fc7\u65f6\u5199\u5165\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>loadProjectionManifest</code> \u662f\uff1b<code>runProjection</code> \u4e24\u9636\u6bb5\uff08\u5168\u6821\u9a8c\u540e\u624d\u5199\uff0c\u5931\u8d25\u56de\u6eda\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u76ee\u6807\u5199\u6295\u5f71\u6587\u4ef6\uff1b\u4e0d\u8986\u76d6 handwritten \u6587\u4ef6\uff1b\u4efb\u4e00\u6821\u9a8c\u5931\u8d25\u96f6\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u672a\u6388\u6743 / \u624b\u5199\u51b2\u7a81 / \u8d8a\u754c / \u5185\u5bb9\u51b2\u7a81\u629b <code>KitError</code>\uff08<code>rejected</code> / <code>unauthorized</code> \u7c7b <code>kind</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u6295\u5f71\u6e05\u5355\u5df2\u767b\u8bb0\uff08<code>PROJECTION_MANIFEST_PATH</code>\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/projection.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/projection.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6295\u5f71\u5185\u5bb9\u7684\u4e1a\u52a1\u542b\u4e49\uff08\u8fdc\u7aef\u53d1\u5e03\u8f6c <code>release-skill</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#check-foundationkitcheck","title":"check (foundation.kit.check)","text":""},{"location":"reference/api/engineering-kit/#runChecks--runCoreCheck--isContainedDeclaration","title":"runChecks / runCoreCheck / isContainedDeclaration","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runChecks({ root, allowGitSpawn = true, only, profilesRoot } = {})</code>\uff08async\uff09</li> <li><code>runCoreCheck({ root, allowGitSpawn = true, profilesRoot } = {})</code>\uff08async\uff09</li> <li><code>isContainedDeclaration(rel)</code></li> <li>\u8f93\u5165\uff1a<code>--only</code> \u53d6\u503c <code>contracts\|drift\|closure\|version\|docs\|git\|identity</code>\u3002</li> <li>\u8f93\u51fa\uff1a\u53d1\u73b0\u6e05\u5355\uff1b\u9000\u51fa\u7801 <code>findings=1</code>\uff08\u6709\u53d1\u73b0\uff09\u3001<code>mechanism=2</code>\uff08\u67d0\u7c7b\u68c0\u67e5\u65e0\u6cd5\u5b8c\u6210\uff09\u3001<code>ok=0</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8bfb\u53d6\u76ee\u6807\u6587\u4ef6\u4e0e\u53ea\u8bfb Git \u72b6\u6001\uff09\uff1b\u4f46\u53ea\u8bca\u65ad\u3001\u4e0d\u4fee\u590d\u3001\u4e0d\u5199\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6\u5199\u5165\uff1b\u53ea\u8bfb Git \u63a2\u6d4b\uff08\u81f3\u591a\u4e00\u6b21\u51bb\u7ed3 <code>status</code> \u67e5\u8be2\uff09\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>CHECK_CLASSES</code> \u4e3a\u4e03\u7c7b\u95ed\u96c6\uff0c\u4e0d\u6269\u5f20\uff1b\u673a\u5236\u5931\u8d25\u629b <code>KitError</code>\uff08<code>mechanism</code> \u7c7b\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>GIT_READ_ONLY_ALLOWLIST</code> \u9650\u5b9a\u53ef\u8c03\u7528\u5b50\u547d\u4ee4\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/check.mjs</code>\u3001<code>core-check.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/check.test.mjs</code>\u3001<code>core-check.test.mjs</code>\u3001<code>check-equivalence.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u53d1\u73b0\u9879\u7684\u4e1a\u52a1\u5904\u7f6e\uff08\u81ea\u52a8\u4fee\u590d\u6267\u884c\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#report-foundationkitreport","title":"report (foundation.kit.report)","text":""},{"location":"reference/api/engineering-kit/#renderReportAction--checkReportAction","title":"renderReportAction / checkReportAction","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>renderReportAction(options = {})</code>\uff08async\uff09</li> <li><code>checkReportAction(options = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a<code>report-model</code>\u3001<code>--out</code> / <code>--binding</code> \u9009\u9879\u3002</li> <li>\u8f93\u51fa\uff1aMarkdown \u6587\u672c\uff1b\u663e\u5f0f <code>--out</code> / <code>--binding</code> \u624d\u843d\u76d8\uff0c\u5426\u5219\u53ea\u5199 stdout\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u9ed8\u8ba4\u53ea\u5199 stdout\uff1b\u663e\u5f0f\u9009\u9879\u624d\u5199\u53d7\u6536\u5bb9\u6587\u4ef6\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u9ed8\u8ba4\u65e0\u6587\u4ef6\u5199\u5165\uff1b\u663e\u5f0f <code>--out</code> / <code>--binding</code> \u624d\u5199\u53d7\u6536\u5bb9\u6587\u4ef6\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u786c\u5931\u8d25\u8ba1\u4e3a\u53d1\u73b0\uff1b\u975e\u6cd5\u53c2\u6570 <code>reject</code>\uff08<code>invalid-params</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5df2\u5b58\u5728 Harness <code>report-model</code>\uff1b\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u786e\u5b9a\u6027\u6e32\u67d3\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/report.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/report.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u62a5\u544a\u7ed3\u8bba\u89e3\u8bfb\uff08\u673a\u5236\u5728 Harness <code>report</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#git-probe-foundationkitgit-probe","title":"git-probe (foundation.kit.git-probe)","text":""},{"location":"reference/api/engineering-kit/#probeGitState--probeGitFacts","title":"probeGitState / probeGitFacts","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>probeGitState(root, { allowSpawn = true } = {})</code>\uff08async\uff09</li> <li><code>probeGitFacts(root, candidatePaths, { allowSpawn = true } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3002</li> <li>\u8f93\u51fa\uff1aGit \u72b6\u6001\u4e0e\u4e8b\u5b9e\uff08\u53ea\u8bfb\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8c03\u7528 <code>git</code> \u53ea\u8bfb\u5b50\u547d\u4ee4\uff09\uff1b\u4e0d\u542b\u4efb\u4f55\u5199\u64cd\u4f5c\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u8c03\u7528 <code>git status</code> / <code>ls-files</code> / <code>check-ignore</code>\uff1b\u53c2\u6570\u5411\u91cf\u51bb\u7ed3\u4e8e <code>GIT_STATUS_ARGS</code> / <code>GIT_LS_FILES_ARGS</code> / <code>GIT_CHECK_IGNORE_ARGS</code>\uff0c\u4e0d\u5728\u767d\u540d\u5355\u5373\u62d2\u7edd\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u767d\u540d\u5355\u53c2\u6570\u5411\u91cf\u629b <code>KitError</code>\uff08<code>unauthorized-git</code> \u7c7b\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>GIT_READ_ONLY_ALLOWLIST</code> \u9650\u5b9a\u53ef\u8c03\u7528\u5b50\u547d\u4ee4\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/gitprobe.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/git-probe.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1aGit \u5199\u64cd\u4f5c\u6388\u6743\uff08Git \u5199\u5f52 Git \u751f\u547d\u5468\u671f\u6307\u5357\uff0cFoundation \u4e0d\u62e5\u6709\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#host-foundationkithost","title":"host (foundation.kit.host)","text":""},{"location":"reference/api/engineering-kit/#describeHost--loadHostRegistry--probeHost--buildHostAdapter--materializeHostBuild--planHost--assertPlanConsistency--refuseHostApply--probeTrustedVersionDriver","title":"describeHost / loadHostRegistry / probeHost / buildHostAdapter / materializeHostBuild / planHost / assertPlanConsistency / refuseHostApply / probeTrustedVersionDriver","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff0c\u9664 <code>refuseHostApply</code> \u5916\u5747\u4e3a async\uff09\uff1a</li> <li><code>describeHost({ hostId, hostsRoot, registry } = {})</code></li> <li><code>loadHostRegistry({ hostsRoot, registry } = {})</code></li> <li><code>probeHost({ hostId, hostsRoot, registry, executable, allowSpawn = false, timeoutMs = 5000, runner } = {})</code></li> <li><code>buildHostAdapter({ hostId, pathCategoryId, input, hostsRoot, registry } = {})</code></li> <li><code>materializeHostBuild(options)</code></li> <li><code>planHost({ hostId, pathCategoryId, buildManifest, probeFacts, hostsRoot, registry } = {})</code></li> <li><code>assertPlanConsistency(planInput)</code></li> <li><code>refuseHostApply()</code>\uff08\u76f4\u63a5\u629b\u9519\uff09</li> <li><code>probeTrustedVersionDriver({ hostId, driverId, capabilities = CAPABILITIES, executable, allowSpawn = false, timeoutMs = 5000, runner } = {})</code></li> <li>\u8f93\u5165\uff1a\u5bbf\u4e3b\u6807\u8bc6\u3001probe/plan \u9009\u9879\u3002</li> <li>\u8f93\u51fa\uff1a\u5bbf\u4e3b\u63cf\u8ff0\u3001probe \u7ed3\u679c\u3001\u6784\u5efa\u4ea7\u7269\u3001plan\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>assertPlanConsistency</code> / <code>refuseHostApply</code> \u662f\uff1b\u5176\u4f59\u542b\u843d\u76d8\u6216\u8fdb\u7a0b\u8c03\u7528\u3002</li> <li>\u526f\u4f5c\u7528\uff1a<code>build</code> / <code>materialize</code> \u5728\u53d7\u6536\u5bb9\u76ee\u6807\u5199\u4ea7\u7269\uff1b<code>probe</code> \u9ed8\u8ba4 <code>allowSpawn=false</code>\uff0c\u4e0d\u53d6 PATH\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1aunsupported host\uff08\u5982 <code>qoder</code>\uff09\u629b <code>KitError</code>\uff08<code>unsupported-host</code>\uff09\uff1b<code>apply</code> \u7531 <code>refuseHostApply</code> \u7a33\u5b9a\u62d2\u7edd\uff1b\u7f3a probe facts \u629b <code>KitError</code>\uff08<code>missing-probe-facts</code>\uff09\u3002<code>HOST_DRIVER_IDS</code> \u4ec5\u4e24\u4e2a\u53d7\u4fe1 driver\uff08<code>claude-version-v1</code> / <code>codex-version-v1</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5bbf\u4e3b Profile \u5df2\u5728 <code>profiles/hosts</code> \u767b\u8bb0\uff1b\u53d7\u4fe1 driver \u9650\u5b9a\uff1b<code>apply</code> / <code>install</code> / <code>update</code> / <code>uninstall</code> \u660e\u786e unsupported\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>unstable</code>\uff08host \u80fd\u529b\u6574\u4f53 unstable\uff09\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/host.mjs</code>\u3001<code>host-profiles.mjs</code>\u3001<code>host-drivers.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/host.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5bbf\u4e3b\u4e1a\u52a1\u8bed\u4e49\uff08<code>host apply</code> \u660e\u786e unsupported\uff1bQoder \u5b8c\u6574 driver unsupported\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#licensing-foundationkitlicensing","title":"licensing (foundation.kit.licensing)","text":""},{"location":"reference/api/engineering-kit/#loadLicensingProfile--listLicensingProfiles--validateLicensingProfile--generateLicenseContent--generateNoticeContent--generateIdentityRecord--bundledProfilesRoot","title":"loadLicensingProfile / listLicensingProfiles / validateLicensingProfile / generateLicenseContent / generateNoticeContent / generateIdentityRecord / bundledProfilesRoot","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>loadLicensingProfile({ profilesRoot, profileId, variant } = {})</code>\uff08async\uff09</li> <li><code>listLicensingProfiles(profilesRoot)</code></li> <li><code>validateLicensingProfile(profile)</code></li> <li><code>generateLicenseContent(profile)</code> / <code>generateNoticeContent(profile, { projectName })</code> / <code>generateIdentityRecord(profile, { projectId, projectName, projections } = {})</code></li> <li><code>bundledProfilesRoot()</code></li> <li>\u8f93\u5165\uff1aProfile \u6807\u8bc6\u3001\u53d8\u4f53\u9009\u62e9\u3002</li> <li>\u8f93\u51fa\uff1a\u8bb8\u53ef\u8bc1 / \u58f0\u660e / \u8eab\u4efd\u8bb0\u5f55\u6587\u672c\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>validateLicensingProfile</code> \u4e0e\u5404 <code>generate</code> \u662f\uff1b<code>load</code> \u542b\u53ea\u8bfb\u8bfb\u53d6 Profile \u6570\u636e\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\uff08\u7eaf\u51fd\u6570\u751f\u6210 + \u53ea\u8bfb\u8bfb\u53d6\uff09\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u591a\u53d8\u4f53\u672a\u6307\u5b9a / \u975e\u6cd5 Profile \u629b <code>KitError</code>\uff08<code>invalid-licensing-profile</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>profiles/licensing/registry.json</code> + <code>schema.json</code> \u5b58\u5728\uff1b\u9ed8\u8ba4\u53d6 registry \u7b2c\u4e00\u53d8\u4f53\uff0c\u591a\u53d8\u4f53\u987b\u663e\u5f0f\u9009\u62e9\uff1b\u6240\u6709\u5546\u4e1a\u8f7d\u8377\u5f53\u524d\u5173\u95ed\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/licensing.mjs</code>\u3001<code>profiles/licensing/registry.json</code>\u3001<code>profiles/licensing/schema.json</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/licensing.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6388\u6743\u4e1a\u52a1\u8bed\u4e49\uff08\u6388\u6743\u6267\u884c\u51b3\u7b56\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#identity-check-foundationkitidentity-check","title":"identity-check (foundation.kit.identity-check)","text":""},{"location":"reference/api/engineering-kit/#loadIdentityRecord--checkIdentityDrift--validateIdentityAgainstProfile","title":"loadIdentityRecord / checkIdentityDrift / validateIdentityAgainstProfile","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>loadIdentityRecord(rootAbs)</code>\uff08async\uff09</li> <li><code>checkIdentityDrift({ rootAbs, identityRecord } = {})</code>\uff08async\uff09</li> <li><code>validateIdentityAgainstProfile(record, profilesRoot)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u76ee\u6807\u6839\u3001Profile \u6807\u8bc6\u3002</li> <li>\u8f93\u51fa\uff1a\u6f02\u79fb\u53d1\u73b0\u3001\u6821\u9a8c\u7ed3\u8bba\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>validateIdentityAgainstProfile</code> \u662f\uff1b<code>load</code> / <code>check</code> \u542b\u53ea\u8bfb\u8bfb\u53d6\u76ee\u6807\u6587\u4ef6\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u8bfb\u53d6\u76ee\u6807\u6587\u4ef6\uff1b\u4e0d\u4fee\u6539\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6f02\u79fb\u6216\u6821\u9a8c\u5931\u8d25\u4ea7\u51fa findings\uff08\u4e0d\u629b\u9519\uff0c\u7531 <code>check</code> \u9000\u51fa\u7801 <code>1</code> \u8868\u8fbe\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>IDENTITY_RECORD_PATH</code> \u6307\u5411\u8eab\u4efd\u8bb0\u5f55\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/identity-check.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/identity-check.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6f02\u79fb\u4e1a\u52a1\u5904\u7f6e\uff08\u81ea\u52a8\u4fee\u590d\u7531\u8c03\u7528\u65b9\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/engineering-kit/#CLI-foundationkitcli","title":"CLI (foundation.kit.cli)","text":""},{"location":"reference/api/engineering-kit/#runCommand--cliMain--\u62d2\u7edd\u53d8\u66f4\u65d7\u6807","title":"runCommand / cliMain / \u62d2\u7edd\u53d8\u66f4\u65d7\u6807","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>runCommand(command, options = {})</code>\uff08async\uff09\u2014\u2014 \u6309 <code>TOP_LEVEL_COMMANDS</code> \u5206\u6d3e\uff0c\u8fd4\u56de <code>{ exitCode, output }</code></li> <li><code>cliMain(argv)</code>\uff08async\uff09\u2014\u2014 CLI \u5165\u53e3</li> <li>\u8f93\u5165\uff1a<code>argv</code>\u3002</li> <li>\u8f93\u51fa\uff1a\u547d\u4ee4\u7ed3\u679c\uff1b\u9000\u51fa\u7801 <code>ok=0</code> / <code>findings=1</code> / <code>rejected=2</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u4f9d\u547d\u4ee4\u4ea7\u751f\u53d7\u6536\u5bb9\u6587\u4ef6\u5199\u5165\u6216\u53ea\u8bfb\u63a2\u6d4b\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u4f9d\u547d\u4ee4\u800c\u5b9a\uff08scaffold/projection \u53d7\u6536\u5bb9\u5199\uff1badopt-plan/check \u53ea\u8bfb\uff09\uff1b<code>REFUSED_MUTATION_FLAGS</code>\uff08\u5982 <code>--apply</code>\uff09\u5728 <code>parseOptions</code> \u5165\u53e3\u5373\u62d2\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u672a\u77e5\u547d\u4ee4 / \u62d2\u7edd\u65d7\u6807\u9000\u51fa\u7801 <code>2</code>\uff08<code>unknown-command</code> / <code>refused-mutation</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aNode >= 22.22.2\uff1b<code>TOP_LEVEL_COMMANDS</code> \u56fa\u5b9a 4 \u4e2a\uff0c\u7b2c 5 \u4e2a\u547d\u4ee4\u7981\u6b62\u65b0\u589e\uff1b<code>REFUSED_MUTATION_FLAGS</code> \u5728\u89e3\u6790\u5165\u53e3\u5373\u62d2\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-engineering-kit/src/index.mjs</code>\u3001<code>cli.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-engineering-kit/test/cli.test.mjs</code>\u3001<code>boundary.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u547d\u4ee4\u7684\u4e1a\u52a1\u76ee\u6807\uff08\u547d\u4ee4\u96c6\u5408\u4e0d\u6269\u5f20\uff09\u3002</li> </ul> <p>Kit \u9519\u8bef\u7c7b\u578b\uff1a<code>KitError extends ContractsError</code>\uff08\u6784\u9020\u672a\u767b\u8bb0\u7801\u7acb\u5373\u629b <code>TypeError</code>\uff09\uff1b<code>KIT_ERROR_KINDS</code> \u4e3a\u7a33\u5b9a kind \u679a\u4e3e\uff1b<code>kitError</code> / <code>invalidParamsError</code> / <code>unknownCommandError</code> / <code>mutationModeError</code> / <code>refusalError</code> \u4e3a\u6784\u9020\u8f85\u52a9\u3002<code>REFUSED_MUTATION_FLAGS</code> \u5217\u51fa\u5165\u53e3\u5373\u62d2\u7684\u53d8\u66f4\u65d7\u6807\uff08\u5982 <code>--apply</code>\uff09\u3002</p>"},{"location":"reference/api/engineering-kit/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p><code>skill-family-engineering-kit/candidate/quickstart-profile</code> \u5bfc\u51fa <code>buildQuickstartProfileProjection</code> \u4e0e <code>QUICKSTART_PROFILE_TARGET_PREFIX</code>\u3002builder \u63a5\u6536\u663e\u5f0f\u6d88\u8d39\u8005 Schema \u8def\u5f84\u4e0e\u51bb\u7ed3\u6765\u6e90\u8eab\u4efd\uff0c\u751f\u6210\u6309 Schema <code>$id</code> \u67e5\u8be2\u7684 standalone validator\u3001\u673a\u68b0\u6295\u5f71\u7684 Contracts/Harness runtime\u3001\u8bb8\u53ef\u8bc1\u548c\u5b8c\u6574 provenance\u3002</p> <p>Bundle \u79bb\u7ebf\u8fd0\u884c\u65f6\u4e0d\u9700\u8981 Foundation \u5305\u3001<code>node_modules</code> \u6216 Ajv\u3002builder \u53ea\u8fd4\u56de\u7a33\u5b9a projection manifest\uff0c\u4e0d\u5199\u76ee\u6807\u6587\u4ef6\uff0c\u4e5f\u4e0d\u589e\u52a0\u7b2c\u4e94\u4e2a Kit \u9876\u5c42\u547d\u4ee4\uff1b\u8c03\u7528\u65b9\u4ecd\u9700\u628a manifest \u4ea4\u7ed9 <code>runProjection</code> \u5b8c\u6210\u6388\u6743\u5199\u5165\u30020.3.0 \u7684 v2 \u4e0e 0.2.1 \u7684\u4f9d\u8d56\u95ed\u5305 Bundle \u4e0d\u517c\u5bb9\uff0c\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a\u7248\u672c\u3002</p>"},{"location":"reference/api/engineering-kit/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID \u89c1 <code>docs/agents/capability-catalog.json</code>\uff08<code>foundation.kit.</code>\u3001<code>foundation.unsupported.</code>\uff09\u3002</li> <li>\u673a\u68b0\u6821\u9a8c\uff1a<code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code> \u4e0e <code>cli.mjs</code>\uff0c\u62d2\u7edd\u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\uff0c\u5e76\u6821\u9a8c <code>TOP_LEVEL_COMMANDS</code> \u672a\u6269\u5f20\u4e3a\u8d85 4 \u4e2a\u3002</li> </ul>"},{"location":"reference/api/harness/","title":"skill-family-harness-node \u516c\u5171 API \u53c2\u8003","text":"<p>\u672c\u9875\u4ece\u771f\u5b9e\u5bfc\u51fa\uff08<code>src/index.mjs</code> \u4e0e\u5404\u6e90\u6a21\u5757\uff09\u6838\u5bf9\uff0c\u4e0d\u624b\u5199\u65e0\u6cd5\u8bc1\u660e\u65b0\u9c9c\u5ea6\u7684\u5168\u96c6\u3002\u6bcf\u4e2a\u516c\u5171\u5165\u53e3\u6309 hand-off \u00a74.3 \u8bf4\u660e\uff1a\u7b7e\u540d\u3001\u8f93\u5165\u4e0e\u8f93\u51fa\u3001\u662f\u5426\u7eaf\u51fd\u6570\u3001\u6587\u4ef6/\u8fdb\u7a0b/Git/\u7f51\u7edc\u526f\u4f5c\u7528\u3001\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\u3001\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\u3001<code>since</code> \u4e0e <code>stability</code>\u3001\u6e90\u6587\u4ef6\u4e0e\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\u3001\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\u3002</p> <p>Harness \u662f\u8584\u8fd0\u884c\u65f6\uff1a\u6d88\u8d39 Contracts\uff0c\u53ea\u5b9e\u73b0\u4e1a\u52a1\u4e2d\u7acb\u673a\u5236\uff1b\u4e0d\u62e5\u6709\u4e1a\u52a1\u8bed\u4e49\u3001\u7f16\u6392\u3001Git\u3001\u7f51\u7edc\u4e0e\u7b2c\u4e8c\u8bed\u8a00\u3002\u5305\u7ea7\u5e38\u91cf\uff1a<code>HARNESS_CAPABILITIES</code>\uff0816 \u9879\u80fd\u529b\uff0c\u95ed\u96c6\uff09\u3001<code>HARNESS_EXCLUSIONS</code>\uff08\u660e\u786e\u6392\u9664 <code>business-semantics</code> / <code>workflow-orchestration</code> / <code>git-writes</code> / <code>model-calls</code> / <code>release-state</code> / <code>remote-network-access</code>\uff09\u3002</p> <p>\u80fd\u529b\u5206\u7ec4\uff08\u4e0e <code>docs/agents/capability-catalog.json</code> \u5bf9\u5e94\uff09\uff1a</p> <ul> <li>\u5951\u7ea6\u6821\u9a8c \u2192 <code>validateContractDocument</code> / <code>getValidator</code></li> <li>\u8def\u5f84\u6536\u5bb9 \u2192 <code>classifyPathInput</code> / <code>resolveContained</code> / <code>readFileContained</code></li> <li>\u539f\u5b50\u5199 \u2192 <code>writeFileAtomic</code></li> <li>\u4e34\u65f6\u5de5\u4f5c\u533a \u2192 <code>TemporaryWorkspace</code> / <code>withTemporaryWorkspace</code></li> <li>\u8d44\u6e90\u95ed\u5305 \u2192 <code>computeResourceClosure</code> / <code>digestBytes</code> / <code>closureContains</code></li> <li>\u8bf7\u6c42\u7ba1\u7ebf \u2192 <code>parseRequest</code> / <code>processRequest</code></li> <li>\u62a5\u544a \u2192 <code>validateReportModel</code> / <code>renderReportMarkdown</code> / <code>buildBinding</code> / <code>verifyBinding</code> / <code>checkReport</code></li> <li>\u5bbf\u4e3b\u9002\u914d\u673a\u5236 \u2192 <code>normalizeAdapterSource</code> / <code>buildAdapterClosure</code> / <code>materializeAdapterBuild</code> / <code>probeVersionVector</code></li> <li>\u6301\u4e45\u72b6\u6001\u5e95\u5ea7 \u2192 <code>openStateStore</code> / <code>appendEvent</code> / <code>readSnapshot</code> / <code>verifyStateStore</code> \u2026</li> <li>\u57fa\u7ebf\u7269\u5316 \u2192 <code>computeDirectoryDigest</code> / <code>materializeBaseline</code>\uff08FND-ADR-009\uff09</li> <li>\u53ea\u8bfb chokepoint \u2192 <code>createReadChokepoint</code>\uff08FND-ADR-009\uff09</li> <li>\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf \u2192 <code>scanSurface</code>\uff08FND-ADR-009\uff09</li> <li>token \u4e0a\u754c\u4f30\u7b97 \u2192 <code>estimateTokenUpperBound</code>\uff08FND-ADR-009\uff09</li> <li>\u901a\u7528\u4e0a\u9650\u5b88\u536b \u2192 <code>openUsageGuard</code> / <code>appendUsageEvent</code> / <code>readUsage</code> / <code>closeUsageGuard</code>\uff08FND-ADR-009\uff09</li> <li>\u673a\u5236\u9519\u8bef \u2192 <code>HarnessError</code> / <code>mechanismError</code> / <code>HARNESS_ERROR_KINDS</code></li> </ul>"},{"location":"reference/api/harness/#\u5951\u7ea6\u6821\u9a8c-foundationharnesscontract-validation","title":"\u5951\u7ea6\u6821\u9a8c (foundation.harness.contract-validation)","text":""},{"location":"reference/api/harness/#validateContractDocument--getValidator--resolveSchemaContext--validatorCacheSize","title":"validateContractDocument / getValidator / resolveSchemaContext / validatorCacheSize","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>validateContractDocument(document, { schemaId, dialect, policy = \"strict\" } = {})</code></li> <li><code>getValidator({ schemaId, dialect, policy = \"strict\" } = {})</code></li> <li><code>resolveSchemaContext({ schemaId, dialect, policy = \"strict\" } = {})</code></li> <li><code>validatorCacheSize()</code></li> <li>\u8f93\u5165\uff1aschema \u4e0a\u4e0b\u6587\u6216\u5951\u7ea6\u6587\u6863\u3002</li> <li>\u8f93\u51fa\uff1a\u6821\u9a8c\u7ed3\u679c\uff08\u8bed\u4e49\u540c Contracts <code>validateDocument</code>\uff0c\u4f46\u7ecf Node \u8fd0\u884c\u65f6\u590d\u7528\u7f13\u5b58\uff09\uff1b\u7f13\u5b58\u5927\u5c0f\u67e5\u8be2\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08<code>getValidator</code> / <code>validateContractDocument</code> \u5199\u5165\u8fdb\u7a0b\u5185\u4ee5 schema \u4e3a\u952e\u7684\u6821\u9a8c\u5668\u7f13\u5b58\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u8fdb\u7a0b\u5185\u5185\u5b58\u7f13\u5b58\u6821\u9a8c\u5668\u5b9e\u4f8b\uff1b\u65e0\u6587\u4ef6/Git/\u7f51\u7edc\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6cbf\u7528 Contracts <code>SFC1001</code> / <code>SFC1002</code> / <code>SFC1006</code>\uff1b\u5e95\u5c42\u673a\u5236\u5931\u8d25\u7edf\u4e00 <code>SFC2004</code> + <code>HARNESS_ERROR_KINDS</code> \u7684 <code>kind</code>\uff08\u5982 <code>INVALID_PATH</code>\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5df2\u5b89\u88c5 <code>skill-family-contracts</code>\uff1bAjv 8.20.0\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/validation.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/validation.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5951\u7ea6\u4e1a\u52a1\u5b57\u6bb5\u8bed\u4e49\uff08\u8bed\u4e49\u5b9a\u4e49\u4ecd\u5728 Contracts\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u8def\u5f84\u6536\u5bb9-foundationharnesspath-containment","title":"\u8def\u5f84\u6536\u5bb9 (foundation.harness.path-containment)","text":""},{"location":"reference/api/harness/#classifyPathInput--resolveContained--readFileContained","title":"classifyPathInput / resolveContained / readFileContained","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>classifyPathInput(input, platform = process.platform)</code></li> <li><code>resolveContained(root, relPath)</code></li> <li><code>readFileContained(root, relPath, { encoding } = {})</code></li> <li>\u8f93\u5165\uff1a\u6839\u76ee\u5f55\uff08\u6536\u5bb9\u8fb9\u754c\uff09\u4e0e\u5f85\u89e3\u6790\u7684\u76f8\u5bf9/\u7edd\u5bf9\u8def\u5f84\u3002</li> <li>\u8f93\u51fa\uff1a\u53d7\u6536\u5bb9\u7edd\u5bf9\u8def\u5f84\u6216\u8bfb\u5230\u7684\u6587\u4ef6\u5185\u5bb9\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>classifyPathInput</code> \u662f\uff1b<code>resolveContained</code> / <code>readFileContained</code> \u4e3a <code>async</code>\uff0c\u542b\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\uff08\u8bfb\u53d6/\u89e3\u6790\uff09\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u673a\u5236\u5931\u8d25\u629b <code>HarnessError</code>\uff08<code>SFC2004</code>\uff09+ <code>details.kind</code> \u2208 <code>{PATH_TRAVERSAL, SYMLINK_ESCAPE, REALPATH_ESCAPE, INVALID_ROOT, ABSOLUTE_PATH, WINDOWS_DRIVE_PATH, WINDOWS_PATH, UNC_PATH, INVALID_PATH, READ_FAILED}</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8c03\u7528\u65b9\u63d0\u4f9b\u660e\u786e\u6839\u76ee\u5f55\uff1b\u6240\u6709\u89e3\u6790\u7ed3\u679c\u5fc5\u987b\u843d\u5728\u6839\u76ee\u5f55\u5185\uff1bWindows \u76d8\u7b26/UNC \u9003\u9038\u540c\u6837\u62d2\u7edd\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/paths.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/containment.test.mjs</code>\u3001<code>boundaries.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u54ea\u4e9b\u8def\u5f84\u662f\u4e1a\u52a1\u5141\u8bb8\u7684\u9009\u62e9\u89c4\u5219\uff08\u4e1a\u52a1\u9009\u62e9\u8bed\u4e49\u7559\u5728\u8c03\u7528\u65b9\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u539f\u5b50\u5199-foundationharnessatomic-write","title":"\u539f\u5b50\u5199 (foundation.harness.atomic-write)","text":""},{"location":"reference/api/harness/#writeFileAtomic","title":"writeFileAtomic","text":"<ul> <li>\u7b7e\u540d\uff1a<code>writeFileAtomic(root, relPath, data, { mode = 0o644 } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u5df2\u6536\u5bb9\u76ee\u6807\u8def\u5f84\u3001\u6587\u4ef6\u5185\u5bb9\uff08<code>string</code> \u6216 <code>Buffer</code>\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u5199\u5165\u5b8c\u6210\u7684\u6587\u4ef6\uff0c\u5b57\u8282\u4e0e\u8f93\u5165\u4e00\u81f4\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u843d\u76d8\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u6839\u76ee\u5f55\u5185\u521b\u5efa\u4e34\u65f6\u6587\u4ef6\uff0c\u5148 <code>fsync</code> \u518d <code>rename</code> \u8986\u76d6\u76ee\u6807\uff1b\u5931\u8d25\u65f6\u56de\u6eda\u4e34\u65f6\u6587\u4ef6\u3001\u4e0d\u7559\u6b8b\u5f71\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u8d8a\u754c\u8def\u5f84\u629b <code>SFC2004</code> + <code>PATH_TRAVERSAL</code>/\u8d8a\u754c\u7c7b <code>kind</code>\uff1b\u975e\u6cd5\u6570\u636e\u7c7b\u578b / \u5199\u5931\u8d25 <code>+ ATOMIC_WRITE_FAILED</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u76ee\u6807\u8def\u5f84\u7ecf <code>path-containment</code> \u9a8c\u8bc1\u5728\u6839\u76ee\u5f55\u5185\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/atomic.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/atomic.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5199\u5165\u5185\u5bb9\u7684\u4e1a\u52a1\u6b63\u786e\u6027\u3002</li> </ul>"},{"location":"reference/api/harness/#\u4e34\u65f6\u5de5\u4f5c\u533a-foundationharnesstemporary-workspace","title":"\u4e34\u65f6\u5de5\u4f5c\u533a (foundation.harness.temporary-workspace)","text":""},{"location":"reference/api/harness/#TemporaryWorkspace--createTemporaryWorkspace--withTemporaryWorkspace","title":"TemporaryWorkspace / createTemporaryWorkspace / withTemporaryWorkspace","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>class TemporaryWorkspace</code>\uff08\u6784\u9020 <code>(options)</code>\uff09</li> <li><code>createTemporaryWorkspace(options)</code>\uff08async\uff09</li> <li><code>withTemporaryWorkspace(fn, options)</code>\uff08async\uff0c\u56de\u8c03\u5f0f\u751f\u547d\u5468\u671f\uff09</li> <li>\u8f93\u5165\uff1a\u53ef\u9009\u524d\u7f00/\u6807\u7b7e\u3002</li> <li>\u8f93\u51fa\uff1a\u4e34\u65f6\u5de5\u4f5c\u76ee\u5f55\u53e5\u67c4\uff1b<code>with</code> \u5728\u56de\u8c03\u7ed3\u675f\u540e\u6e05\u7406\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u521b\u5efa\u5e76\u5220\u9664\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u5b50\u76ee\u5f55\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u5bbf\u4e3b\u4e34\u65f6\u76ee\u5f55\u521b\u5efa\u5b50\u76ee\u5f55\uff0c\u9000\u51fa/\u5f02\u5e38\u65f6\u5220\u9664\uff1b\u4e0d\u6301\u4e45\u5316\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u521b\u5efa\u5931\u8d25 <code>+ WORKSPACE_CREATE_FAILED</code>\uff1b\u6e05\u7406\u5931\u8d25 <code>+ WORKSPACE_DISPOSE_FAILED</code>\uff1b\u5df2\u91ca\u653e\u540e\u4f7f\u7528 <code>+ WORKSPACE_DISPOSED</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u5bbf\u4e3b\u63d0\u4f9b\u53ef\u5199\u4e34\u65f6\u76ee\u5f55\uff08\u5982 <code>os.tmpdir</code>\uff09\uff1b\u8def\u5f84\u4e0d\u9003\u9038\u51fa\u5bbf\u4e3b\u4e34\u65f6\u6839\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/workspace.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/workspace.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e34\u65f6\u4ea7\u7269\u7684\u6700\u7ec8\u53bb\u5904\uff08\u6301\u4e45\u6001\u8f6c <code>state-store</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u8d44\u6e90\u95ed\u5305-foundationharnessresource-closure","title":"\u8d44\u6e90\u95ed\u5305 (foundation.harness.resource-closure)","text":""},{"location":"reference/api/harness/#computeResourceClosure--digestBytes--closureContains","title":"computeResourceClosure / digestBytes / closureContains","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>computeResourceClosure({ root, resources } = {})</code>\uff08async\uff09</li> <li><code>digestBytes(bytes)</code></li> <li><code>closureContains(closure, relPath)</code></li> <li>\u8f93\u5165\uff1a\u8d44\u6e90\u5217\u8868\uff08\u8def\u5f84 + \u5185\u5bb9\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u786e\u5b9a\u6027\u95ed\u5305\u5bf9\u8c61\u4e0e sha256 \u6458\u8981\uff1b<code>closureContains</code> \u5224\u5b9a\u67d0\u76f8\u5bf9\u8def\u5f84\u662f\u5426\u5728\u95ed\u5305\u5185\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>digestBytes</code> / <code>closureContains</code> \u662f\uff1b<code>computeResourceClosure</code> \u542b\u6309 <code>root</code> \u8bfb\u53d6\u8d44\u6e90\uff0c\u5c5e\u53d7\u63a7\u53ea\u8bfb\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u6309 <code>root</code> \u53ea\u8bfb\u8bfb\u53d6\u8d44\u6e90\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u6cd5/\u91cd\u590d\u8d44\u6e90\u58f0\u660e\u629b <code>SFC2004</code> + <code>CLOSURE_CONFLICT</code> / <code>MISSING_RESOURCE</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8d44\u6e90\u4e3a\u53ef\u5e8f\u5217\u5316\u6587\u672c\u6761\u76ee\uff08\u4e8c\u8fdb\u5236\u6295\u5f71\u660e\u786e unsupported\uff09\uff1b\u53bb\u91cd\u4e0e\u6392\u5e8f\u56fa\u5b9a\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/closure.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/closure.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u8d44\u6e90\u4e1a\u52a1\u542b\u4e49\u3002</li> </ul>"},{"location":"reference/api/harness/#\u8bf7\u6c42\u7ba1\u7ebf-foundationharnessrequest-processing","title":"\u8bf7\u6c42\u7ba1\u7ebf (foundation.harness.request-processing)","text":""},{"location":"reference/api/harness/#parseRequest--processRequest","title":"parseRequest / processRequest","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>parseRequest(raw)</code></li> <li><code>processRequest(raw, { now = () => new Date() } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u539f\u59cb\u8bf7\u6c42\u8d1f\u8f7d\uff08\u5e94\u7b26\u5408 kernel \u534f\u8bae\u7ed3\u6784\uff09\u3002</li> <li>\u8f93\u51fa\uff1a\u89c4\u8303\u5316 <code>operation-request</code> \u4e0e\u7ec8\u6001 <code>operation-result</code>\uff08\u7ec8\u6001\u96c6\u5408\u56fa\u5b9a\u4e3a <code>REJECTED</code> / <code>FAILED</code> / <code>SUCCESS</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>parseRequest</code> \u662f\uff1b<code>processRequest</code> \u4e3a\u7eaf\u51fd\u6570\u7ba1\u7ebf\uff08\u65e0\u5916\u90e8\u526f\u4f5c\u7528\uff0c\u9ed8\u8ba4 <code>now</code> \u53ef\u6ce8\u5165\u4ee5\u4fdd\u8bc1\u786e\u5b9a\u6027\u6d4b\u8bd5\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6/Git/\u7f51\u7edc\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u89e3\u6790\u5931\u8d25\u8fdb\u5165 <code>REJECTED</code>/<code>FAILED</code> \u7ec8\u6001\u5e76\u5e26 <code>SFC2002</code> / <code>SFC2003</code> / <code>SFC2004</code>\uff1b\u673a\u5236\u5931\u8d25 <code>+ EXECUTION_FAILED</code> <code>kind</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8bf7\u6c42\u7b26\u5408 kernel \u534f\u8bae\u7ed3\u6784\uff1b\u4e1a\u52a1\u8bed\u4e49\u7531\u6d88\u8d39\u8005\u62e5\u6709\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/request.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/request.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u64cd\u4f5c\u7684\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\uff08\u72b6\u6001\u673a/\u91cd\u8bd5\u8f6c <code>loop-agent</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u62a5\u544a-foundationharnessreport","title":"\u62a5\u544a (foundation.harness.report)","text":""},{"location":"reference/api/harness/#validateReportModel--renderReportMarkdown--computeResultDigest--computeModelDigest--digestReport--buildBinding--verifyBinding--checkReport--collectStyleWarnings","title":"validateReportModel / renderReportMarkdown / computeResultDigest / computeModelDigest / digestReport / buildBinding / verifyBinding / checkReport / collectStyleWarnings","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>validateReportModel(reportModel, { resultDocument } = {})</code></li> <li><code>renderReportMarkdown(model)</code></li> <li><code>computeResultDigest(resultDocument)</code> / <code>computeModelDigest(reportModel)</code> / <code>digestReport(reportMarkdown)</code></li> <li><code>buildBinding(reportModel, resultDocument, reportMarkdown)</code></li> <li><code>verifyBinding(binding, { reportModel, resultDocument, reportMarkdown } = {})</code></li> <li><code>checkReport({ reportMarkdown, reportModel, resultDocument, binding } = {})</code></li> <li><code>collectStyleWarnings(reportMarkdown)</code></li> <li>\u8f93\u5165\uff1a<code>report-model</code>\u3001\u6e32\u67d3\u9009\u9879\uff08<code>locale</code> / <code>audience</code> / <code>style</code>\uff09\uff1b<code>SUPPORTED_REPORT_LOCALES = [zh-CN, en-US]</code>\u3002</li> <li>\u8f93\u51fa\uff1aMarkdown \u6587\u672c\u3001\u7ed1\u5b9a\u5bf9\u8c61\u3001\u5206\u7ea7\u68c0\u67e5\u53d1\u73b0\uff1b\u4eba\u7c7b\u62a5\u544a\u7531\u673a\u5668\u7ed3\u679c\u6d3e\u751f\uff0c\u7981\u6b62\u81ea\u7531\u64b0\u5199\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff08\u65e0\u65f6\u949f\u3001\u65e0\u73af\u5883\u3001\u65e0\u7f51\u7edc\u3001\u65e0\u6a21\u578b\u8c03\u7528\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u6587\u4ef6/Git/\u7f51\u7edc\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a<code>SFC3001</code>\uff08<code>REPORT_DIGEST_MISMATCH</code>\uff0c\u7ed1\u5b9a\u6458\u8981\u4e0d\u7b26\u6216\u62a5\u544a\u975e\u6a21\u578b\u89c4\u8303\u6e32\u67d3\uff09\u3001<code>SFC3002</code>\uff08<code>REPORT_ELEMENT_MISSING</code>\uff0c\u5f3a\u5236\u5143\u7d20\u7f3a\u5931\uff09\u3001<code>SFC3003</code>\uff08<code>REPORT_FACT_DRIFT</code>\uff0c\u62a5\u544a\u6539\u5199\u7ed1\u5b9a\u7ed3\u679c\u4e8b\u5b9e\u6216\u5b57\u8282\u4e0e\u786e\u5b9a\u6027\u518d\u6e32\u67d3\u4e0d\u4e00\u81f4\uff09\u3002\u98ce\u683c\u544a\u8b66\u7531 <code>collectStyleWarnings</code> \u4ea7\u51fa\uff0c\u4ec5\u5efa\u8bae\u3001\u4e0d\u7f16\u7801\u3001\u4e0d\u963b\u65ad\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>REPORT_RENDERER_NAME</code> / <code>VERSION</code> \u53d6\u81ea\u5404\u81ea package\uff08\u5f53\u524d <code>0.3.0</code>\uff09\uff1b\u53cc\u8f93\u51fa\u6210\u7ec4\u5199\u5165\u5e76\u62d2\u7edd\u8def\u5f84\u522b\u540d\u4e0e\u8f93\u5165\u8986\u76d6\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/report.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/report.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u62a5\u544a\u4e1a\u52a1\u7ed3\u8bba\u7684\u89e3\u8bfb\uff08\u7f16\u6392\u7531 Kit <code>report</code> \u5b50\u52a8\u4f5c\u8d1f\u8d23\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u5bbf\u4e3b\u9002\u914d\u673a\u5236-foundationharnesshost-adapter","title":"\u5bbf\u4e3b\u9002\u914d\u673a\u5236 (foundation.harness.host-adapter)","text":""},{"location":"reference/api/harness/#normalizeAdapterSource--buildAdapterClosure--verifyAdapterBuildManifest--materializeAdapterBuild--probeVersionVector","title":"normalizeAdapterSource / buildAdapterClosure / verifyAdapterBuildManifest / materializeAdapterBuild / probeVersionVector","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>normalizeAdapterSource(input)</code></li> <li><code>buildAdapterClosure({ hostId, pathCategory, input } = {})</code></li> <li><code>verifyAdapterBuildManifest(manifestInput, { hostId, pathCategory } = {})</code></li> <li><code>materializeAdapterBuild({ targetRoot, build, writer = writeFileAtomic } = {})</code>\uff08async\uff09</li> <li><code>probeVersionVector({ hostId, capabilities, executable, argv, allowSpawn = false, timeoutMs = 5000, runner = spawnSync } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1aadapter source\u3001\u76ee\u6807\u8def\u5f84\u3001probe \u9009\u9879\u3002</li> <li>\u8f93\u51fa\uff1a\u6784\u5efa\u95ed\u5305\u3001\u6821\u9a8c\u540e\u7684\u6e05\u5355\u3001materialize \u4ea7\u7269\u3001\u7248\u672c\u5411\u91cf\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a<code>normalizeAdapterSource</code> / <code>buildAdapterClosure</code> / <code>verifyAdapterBuildManifest</code> \u662f\uff1b<code>materializeAdapterBuild</code> / <code>probeVersionVector</code> \u542b\u843d\u76d8\u6216\u8fdb\u7a0b\u8c03\u7528\u3002</li> <li>\u526f\u4f5c\u7528\uff1a<code>materializeAdapterBuild</code> \u5728\u53d7\u6536\u5bb9\u76ee\u6807\u521b\u5efa sibling staging \u5e76\u5355\u6b21 rename\uff1b<code>probeVersionVector</code> \u9ed8\u8ba4 <code>allowSpawn=false</code>\uff0c\u4e0d\u53d6 PATH\u3001\u4e0d\u81ea\u52a8\u6267\u884c\u5bbf\u4e3b\u4e8c\u8fdb\u5236\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6e05\u5355\u6458\u8981\u4e0d\u7b26 <code>+ MANIFEST_MISMATCH</code>\uff1b\u76ee\u6807\u5df2\u5b58\u5728 <code>+ PORTABLE_PATH_COLLISION</code>\uff1b\u975e\u53d7\u4fe1\u53ef\u6267\u884c\u6587\u4ef6 <code>+ UNTRUSTED_EXECUTABLE</code>\uff1b\u6784\u5efa/\u63a2\u6d4b\u5931\u8d25 <code>+ HOST_BUILD_FAILED</code> / <code>HOST_PROBE_FAILED</code>\uff1b\u5951\u7ea6\u4e0d\u7b26 <code>+ HOST_CONTRACT_INVALID</code>\uff1b\u4ee5\u4e0a\u5747\u5305\u4e8e <code>SFC2004</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1aadapter source \u4e3a\u5df2\u58f0\u660e\u6587\u672c\u95ed\u5305\uff08<code>content</code> \u7c7b\u578b\u56fa\u5b9a <code>string</code>\uff0c\u4ec5 utf8\uff1b\u4e8c\u8fdb\u5236\u6295\u5f71 unsupported\uff09\uff1b\u53d7\u4fe1\u53ef\u6267\u884c\u6587\u4ef6\u65b9\u53ef materialize\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/host.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/host.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5bbf\u4e3b\u5177\u4f53\u4e1a\u52a1\u8bed\u4e49\uff08<code>host apply</code> \u660e\u786e unsupported\uff0c\u8f6c Profile + Kit <code>host</code> \u5b50\u52a8\u4f5c\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u6301\u4e45\u72b6\u6001\u5e95\u5ea7-foundationharnessstate-store","title":"\u6301\u4e45\u72b6\u6001\u5e95\u5ea7 (foundation.harness.state-store)","text":""},{"location":"reference/api/harness/#openStateStore--appendEvent--readEvents--readSnapshot--writeSnapshot--verifyStateStore--rebuildSnapshot--inspectStateStoreLock--recoverStateStoreLock--closeStateStore--close","title":"openStateStore / appendEvent / readEvents / readSnapshot / writeSnapshot / verifyStateStore / rebuildSnapshot / inspectStateStoreLock / recoverStateStoreLock / closeStateStore / close","text":"<ul> <li>\u7b7e\u540d\uff08\u8282\u9009\uff09\uff1a</li> <li><code>openStateStore(root, { owner, payloadSchemas, clock } = {})</code>\uff08async\uff09</li> <li><code>appendEvent(store, event)</code>\uff08async\uff09</li> <li><code>readEvents(store, { afterSequence = 0 } = {})</code>\uff08async\uff09</li> <li><code>readSnapshot(store, { reducer, initial = null } = {})</code>\uff08async\uff09</li> <li><code>writeSnapshot(store, state, { hostSessionRef, reducer, initial = null } = {})</code>\uff08async\uff09</li> <li><code>verifyStateStore(store, { reducer, initial = null } = {})</code>\uff08async\uff09</li> <li><code>rebuildSnapshot(store, reducer, { initial = null } = {})</code>\uff08async\uff09</li> <li><code>inspectStateStoreLock(root, { clock } = {})</code>\uff08async\uff09</li> <li><code>recoverStateStoreLock(root, { ... } = {})</code>\uff08async\uff09</li> <li><code>closeStateStore(store)</code> / <code>close(store)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u4e8b\u4ef6\u8d1f\u8f7d\u3001\u5feb\u7167\u3001\u9501\u4ee4\u724c\u3002</li> <li>\u8f93\u51fa\uff1a\u4e8b\u4ef6\u3001hash chain \u6821\u9a8c\u7ed3\u679c\u3001\u5feb\u7167\uff1b<code>STATE_GENESIS_DIGEST</code> \u4f5c\u4e3a\u94fe\u8d77\u70b9\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8bfb\u5199\u4e8b\u4ef6\u65e5\u5fd7\u4e0e\u5feb\u7167\u6587\u4ef6\uff0c\u5199\u534f\u4f5c\u5f0f\u5355\u5199\u8005\u9501\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u8def\u5f84\u8bfb\u5199\u4e8b\u4ef6\u65e5\u5fd7\u4e0e\u5feb\u7167\uff1b\u5199\u9501\u6587\u4ef6\u7528\u4e8e\u672c\u5730\u534f\u4f5c\u5f0f\u5355\u5199\u8005\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1ahash chain \u65ad\u88c2 <code>+ CHAIN_BROKEN</code>\uff1b\u9501 fencing \u51b2\u7a81 <code>+ STORE_LOCKED</code>\uff1b\u9501\u635f\u574f <code>+ LOCK_CORRUPT</code>\uff1b\u6062\u590d\u62d2\u7edd <code>+ LOCK_RECOVERY_REFUSED</code>\uff1b\u975e\u6cd5\u4e8b\u4ef6 <code>+ UNSAFE_STATE_ENTRY</code> / <code>EVENT_SCHEMA_INVALID</code>\uff1b\u91cd\u590d\u5e8f\u53f7 <code>+ DUPLICATE_SEQUENCE</code>\uff1b\u5e42\u7b49\u51b2\u7a81 <code>+ IDEMPOTENCY_CONFLICT</code>\uff1b\u5feb\u7167\u4e0d\u4e00\u81f4 <code>+ SNAPSHOT_MISMATCH</code>\uff1b\u5df2\u5173\u95ed <code>+ STORE_CLOSED</code>\uff1b\u4ee5\u4e0a\u5747\u5305\u4e8e <code>SFC2004</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u4e8b\u4ef6\u65e5\u5fd7\u4e3a\u552f\u4e00\u6743\u5a01\uff0csnapshot \u4e3a\u6d3e\u751f\u7f13\u5b58\uff1bfencing \u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\uff1b<code>confirmOwnerTerminated</code> \u4fe1\u4efb\u951a\u7531\u8c03\u7528\u65b9\u63d0\u4f9b\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/state-store.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/state-store.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e8b\u4ef6\u4e1a\u52a1\u542b\u4e49\u3001reducer \u8f6c\u79fb\u3001owner-terminated \u4fe1\u4efb\u951a\uff08\u4e1a\u52a1\u72b6\u6001\u673a/\u7ec8\u6001\u8f6c <code>loop-agent</code>\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u673a\u5236\u9519\u8bef-foundationharnesserrors","title":"\u673a\u5236\u9519\u8bef (foundation.harness.errors)","text":""},{"location":"reference/api/harness/#HarnessError--mechanismError--HARNESS_ERROR_KINDS","title":"HarnessError / mechanismError / HARNESS_ERROR_KINDS","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>class HarnessError extends ContractsError</code>\uff08\u6784\u9020 <code>(code, message, details)</code>\uff0c\u672a\u767b\u8bb0\u7801\u7acb\u5373\u629b <code>TypeError</code>\uff09</li> <li><code>mechanismError(kind, message, extraDetails)</code>\uff08\u8fd4\u56de <code>SFC2004</code> + \u7a33\u5b9a <code>details.kind</code>\uff09</li> <li><code>HARNESS_ERROR_KINDS</code>\uff08\u51bb\u7ed3\u5bf9\u8c61\uff09</li> <li>\u8f93\u5165\uff1a\u9519\u8bef <code>kind</code>\u3001\u4e0a\u4e0b\u6587\u3002</li> <li>\u8f93\u51fa\uff1a\u5e26\u7a33\u5b9a <code>kind</code> \u7684\u9519\u8bef\u5bf9\u8c61\uff1b\u975e\u6cd5 <code>kind</code> \u629b <code>TypeError</code>\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u672c\u6a21\u5757\u4e0d\u53d1\u660e\u65b0\u7801\u2014\u2014\u673a\u5236\u5931\u8d25\u7edf\u4e00 <code>SFC2004</code>\uff08<code>EXECUTION_FAILED</code>\uff09\uff0c\u5176\u6ce8\u518c\u542b\u4e49\u4e3a\u300c\u673a\u5236\u8fd0\u884c\u65f6\u6267\u884c\u5408\u89c4\u64cd\u4f5c\u65f6\u5931\u8d25\uff1bdetails \u643a\u5e26\u673a\u5236\u8bc1\u636e\u300d\uff1b<code>details.kind</code> \u53d6\u4e0b\u5217\u51bb\u7ed3\u679a\u4e3e\u4e4b\u4e00\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>HARNESS_ERROR_KINDS</code> \u51bb\u7ed3\uff0c\u65b0\u589e SFC \u7801\u5c5e Contracts \u53d8\u66f4\uff08\u4e0d\u5728\u672c\u5305\u5199\u96c6\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.2.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/errors.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/boundary.test.mjs</code>\u3001<code>boundaries.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u9519\u8bef\u4e1a\u52a1\u5f52\u56e0\u3002</li> </ul> <p><code>HARNESS_ERROR_KINDS</code> \u51bb\u7ed3\u679a\u4e3e\uff08v1\uff09\uff1a</p> kind \u542b\u4e49 <code>invalid-path</code> / <code>absolute-path</code> / <code>windows-drive-path</code> / <code>windows-path</code> / <code>unc-path</code> \u8def\u5f84\u5f62\u6001\u975e\u6cd5 <code>path-traversal</code> / <code>symlink-escape</code> / <code>realpath-escape</code> \u6536\u5bb9\u9003\u9038 <code>invalid-root</code> \u6839\u76ee\u5f55\u975e\u6cd5 <code>atomic-write-failed</code> / <code>read-failed</code> \u6587\u4ef6\u8bfb\u5199\u5931\u8d25 <code>missing-resource</code> \u8d44\u6e90\u7f3a\u5931 <code>workspace-create-failed</code> / <code>workspace-dispose-failed</code> / <code>workspace-disposed</code> \u4e34\u65f6\u5de5\u4f5c\u533a\u5f02\u5e38 <code>closure-conflict</code> / <code>unsupported-policy</code> \u95ed\u5305/\u7b56\u7565\u51b2\u7a81 <code>execution-failed</code> / <code>invalid-result</code> \u6267\u884c/\u7ed3\u679c\u5f02\u5e38 <code>store-closed</code> / <code>store-locked</code> / <code>lock-corrupt</code> / <code>lock-recovery-refused</code> \u72b6\u6001\u9501\u5f02\u5e38 <code>unsafe-state-entry</code> / <code>event-schema-invalid</code> / <code>duplicate-sequence</code> / <code>idempotency-conflict</code> / <code>chain-broken</code> / <code>snapshot-mismatch</code> \u72b6\u6001\u4e8b\u4ef6\u5f02\u5e38 <code>host-contract-invalid</code> / <code>host-build-failed</code> / <code>host-probe-failed</code> / <code>untrusted-executable</code> / <code>portable-path-collision</code> / <code>manifest-mismatch</code> \u5bbf\u4e3b\u9002\u914d\u5f02\u5e38 <code>baseline-mismatch</code> / <code>content-guard-rejected</code> \u57fa\u7ebf\u7269\u5316\u5931\u8d25\u5173\u95ed <code>read-chokepoint-rejected</code> \u53ea\u8bfb\u51c6\u5165\u62d2\u7edd <code>surface-scan-violation</code> / <code>scan-policy-invalid</code> \u8868\u9762\u626b\u63cf\u5931\u8d25\u5173\u95ed <code>upper-bound-exceeded</code> \u4e0a\u9650\u5b88\u536b\u8d8a\u9650"},{"location":"reference/api/harness/#\u57fa\u7ebf\u7269\u5316-foundationharnessbaseline-materialization","title":"\u57fa\u7ebf\u7269\u5316 (foundation.harness.baseline-materialization)","text":"<p>FND-ADR-009\u3002\u628a\u51bb\u7ed3\u57fa\u7ebf\u7269\u5316\u4e3a\u5b57\u8282\u4fdd\u771f\u7684\u4e34\u65f6\u526f\u672c\uff1a\u7269\u5316\u524d\u6821\u9a8c\u6e90\u6458\u8981\u3001\u7269\u5316\u540e\u540c\u65f6\u6821\u9a8c\u526f\u672c\u6458\u8981\u4e0e\u6e90\u6458\u8981\uff08\u6355\u83b7\u7269\u5316\u4e2d\u9014\u7684\u4efb\u4e00\u4fa7\u53d8\u5316\uff09\uff1b\u526f\u672c\u5185\u7b26\u53f7\u94fe\u63a5\u4e00\u5f8b\u62d2\u7edd\u3002</p>"},{"location":"reference/api/harness/#computeDirectoryDigest--materializeBaseline","title":"computeDirectoryDigest / materializeBaseline","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>computeDirectoryDigest(rootDir)</code>\uff08async\uff0c\u8fd4\u56de 64 \u4f4d\u5c0f\u5199 sha256 \u5341\u516d\u8fdb\u5236\u6458\u8981\uff09</li> <li><code>materializeBaseline({ baselineDir, baselineDigest, prefix = \"sf-baseline-\" } = {})</code>\uff08async\uff0c\u8fd4\u56de\u7269\u5316\u6839\u8def\u5f84\uff09</li> <li>\u8f93\u5165\uff1a\u57fa\u7ebf\u76ee\u5f55\u4e0e\u51bb\u7ed3\u6458\u8981\u3002</li> <li>\u8f93\u51fa\uff1a\u786e\u5b9a\u6027\u76ee\u5f55\u6458\u8981\uff1b\u7269\u5316\u540e\u7684\u4e34\u65f6\u76ee\u5f55\u6839\u8def\u5f84\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u8bfb\u6e90\u6811\u3001\u5728\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u521b\u5efa\u526f\u672c\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\u6e90\u57fa\u7ebf\uff1b\u5199\u7cfb\u7edf\u4e34\u65f6\u76ee\u5f55\u5e76\u5728\u5931\u8d25\u65f6\u6e05\u7406\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u6458\u8981\u4e0d\u7b26\uff08\u7269\u5316\u524d\u6216\u7269\u5316\u540e\uff09\u629b <code>SFC2004</code> + <code>baseline-mismatch</code>\uff08details \u542b <code>phase</code>\uff1a<code>pre-materialization</code> / <code>post-materialization</code>\uff09\uff1b\u76ee\u5f55\u4e0d\u53ef\u7528\u629b <code>invalid-root</code>\uff1b\u5efa\u76ee\u5f55\u5931\u8d25\u629b <code>workspace-create-failed</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8c03\u7528\u65b9\u6301\u6709\u51bb\u7ed3\u6458\u8981\uff1b\u540c\u4e00\u6743\u9650\u7ea7\u8fdb\u7a0b\u53ef\u5728\u7269\u5316\u7a97\u53e3\u5185\u6539\u52a8\u6e90\uff0c\u673a\u5236\u4ee5\u53cc\u7aef\u6458\u8981\u6355\u83b7\u5e76\u5931\u8d25\u5173\u95ed\uff0c\u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/baseline.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/baseline.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u6b8b\u7559\u5185\u5bb9\u5224\u5b9a\uff08<code>contentGuard</code> \u8c13\u8bcd\uff09\u4e0e\u526f\u672c\u6700\u7ec8\u53bb\u5904\u3002</li> </ul> <p><code>TemporaryWorkspace.fromBaseline({ baselineDir, baselineDigest, prefix, contentGuard })</code> \u4e0e <code>createTemporaryWorkspace({ baseline: { ... } })</code> \u628a\u7269\u5316\u63a5\u5165\u5de5\u4f5c\u533a\u751f\u547d\u5468\u671f\uff1a<code>contentGuard</code> \u7f3a\u7701\u4e3a\u5141\u8bb8\uff08\u5b57\u8282\u4fdd\u771f\u662f\u673a\u5236\u5951\u7ea6\uff0c\u6b8b\u7559\u5224\u5b9a\u5f52\u6d88\u8d39\u8005\uff09\uff1b\u5b88\u536b\u629b\u9519\u5305\u88c5\u4e3a <code>content-guard-rejected</code> \u5e76 dispose \u526f\u672c\u3002</p>"},{"location":"reference/api/harness/#\u53ea\u8bfb-chokepoint-foundationharnessread-chokepoint","title":"\u53ea\u8bfb chokepoint (foundation.harness.read-chokepoint)","text":"<p>FND-ADR-009\u3002\u628a\u53d7\u4fdd\u62a4\u533a\u57df\u7684\u8bfb\u53d6\u96c6\u4e2d\u5230\u4e00\u4e2a\u51c6\u5165\u5165\u53e3\uff1a\u5141\u8bb8\u6839\u96c6\u5408 + \u53ef\u9009\u8eab\u4efd\u8c13\u8bcd\uff1b\u8d8a\u754c\u3001\u94fe\u63a5\u9003\u9038\u4e0e\u975e\u6388\u6743\u8eab\u4efd\u4e00\u5f8b <code>read-chokepoint-rejected</code>\u3002</p>"},{"location":"reference/api/harness/#createReadChokepoint","title":"createReadChokepoint","text":"<ul> <li>\u7b7e\u540d\uff1a<code>createReadChokepoint({ allowRoots, allowIdentity } = {})</code> \u2192 <code>{ assertReadAllowed, read }</code></li> <li>\u8f93\u5165\uff1a\u975e\u7a7a\u5141\u8bb8\u6839\u96c6\u5408\uff1b\u53ef\u9009\u8eab\u4efd\u8c13\u8bcd <code>(identity) => boolean</code>\u3002</li> <li>\u8f93\u51fa\uff1a\u51c6\u5165\u540e\u7684 <code>{ root, relPath, absolute }</code> \u6216\u53d7\u6536\u5bb9\u8bfb\u53d6\u7ed3\u679c\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08<code>async</code>\uff0c\u542b\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb realpath / \u6536\u5bb9\u8bfb\u53d6\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u8d8a\u754c/\u9003\u9038/\u975e\u6388\u6743\u629b <code>SFC2004</code> + <code>read-chokepoint-rejected</code>\uff1b\u8d44\u6e90\u7f3a\u5931\u629b <code>missing-resource</code>\uff1b\u53c2\u6570\u975e\u6cd5\u629b <code>TypeError</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8c03\u7528\u65b9\u58f0\u660e\u5141\u8bb8\u6839\u96c6\u5408\u4e0e\u8eab\u4efd\u89c4\u5219\uff1b\u673a\u5236\u4e0d\u89e3\u91ca\u4efb\u4f55\u79c1\u6709\u8eab\u4efd\u6216\u8def\u5f84\u8bed\u4e49\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/chokepoint.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/chokepoint.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u5141\u8bb8\u6839\u96c6\u5408\u3001\u8eab\u4efd\u8c13\u8bcd\u3001\u51c6\u5165\u540e\u8bfb\u53d6\u8bed\u4e49\u3002</li> </ul> <p>\u5b57\u7b26\u4e32\u8f93\u5165\u4e0e <code>{ root, relPath }</code> \u8f93\u5165\u8d70\u540c\u4e00 <code>resolveContained</code> \u6536\u5bb9\u5206\u7c7b\uff08\u542b macOS <code>/var \u2192 /private/var</code> \u7b49\u7b26\u53f7\u94fe\u63a5\u524d\u7f00\u6839\u7684\u7edf\u4e00\u89c4\u8303\u5316\uff09\u3002</p>"},{"location":"reference/api/harness/#\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf-foundationharnesssurface-scan","title":"\u7b56\u7565\u5316\u8868\u9762\u626b\u63cf (foundation.harness.surface-scan)","text":"<p>FND-ADR-009\u3002\u6309 <code>surface-scan-policy</code> \u5951\u7ea6\u6587\u6863\u5bf9\u58f0\u660e\u8868\u9762\u505a\u8def\u5f84\u4e0e\u5185\u5bb9\u6a21\u5f0f\u626b\u63cf\uff1a\u9996\u4e2a\u547d\u4e2d\u5373\u5931\u8d25\u5173\u95ed\uff1b\u7b56\u7565\u975e\u6cd5\u6216\u6a21\u5f0f\u4e0d\u53ef\u7f16\u8bd1\u540c\u6837\u5931\u8d25\u5173\u95ed\uff1b\u7f3a\u5931\u626b\u63cf\u6587\u4ef6\u4e0d\u9759\u9ed8\u8df3\u8fc7\u3002</p>"},{"location":"reference/api/harness/#scanSurface","title":"scanSurface","text":"<ul> <li>\u7b7e\u540d\uff1a<code>scanSurface({ root, relPaths, policy, encoding = \"utf8\" } = {})</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u626b\u63cf\u6839\u3001\u76f8\u5bf9\u8def\u5f84\u6e05\u5355\u3001\u7b56\u7565\u5951\u7ea6\u6587\u6863\u3002</li> <li>\u8f93\u51fa\uff1a<code>{ scanned, bytes, policy }</code>\uff08\u51bb\u7ed3\u5bf9\u8c61\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u53ea\u8bfb\u6587\u4ef6\u7cfb\u7edf\u8bbf\u95ee\uff1b\u8fdb\u7a0b\u5185\u6b63\u5219\u7f16\u8bd1\uff0c\u65e0\u6301\u4e45\u72b6\u6001\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u53ea\u8bfb\uff1b\u4e0d\u5199\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u547d\u4e2d\u629b <code>SFC2004</code> + <code>surface-scan-violation</code>\uff08details \u542b <code>kindOfHit</code>\uff1a<code>path</code> / <code>content</code>\uff09\uff1b\u7b56\u7565\u975e\u6cd5\u6216\u6a21\u5f0f\u4e0d\u53ef\u7f16\u8bd1\u629b <code>scan-policy-invalid</code>\uff1b\u7f3a\u5931\u6587\u4ef6\u629b <code>missing-resource</code>\uff1b\u53c2\u6570\u975e\u6cd5\u629b <code>TypeError</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u7b56\u7565\u6587\u6863\u901a\u8fc7\u5951\u7ea6\u6821\u9a8c\uff1b<code>allowedUses</code> \u53ea\u643a\u5e26\u4e0d\u89e3\u91ca\uff0c\u547d\u4e2d\u4e0d\u88ab\u8c41\u514d\uff08\u8c41\u514d\u7531\u6d88\u8d39\u8005\u5c42\u5b9e\u73b0\uff09\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/surface-scan.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/surface-scan.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u7b56\u7565\u5185\u5bb9\u3001\u5141\u8bb8\u7528\u9014\u8bed\u4e49\u4e0e\u547d\u4e2d\u540e\u7684\u5904\u7f6e\u3002</li> </ul> <p>\u6ce8\u5165\u5f0f\u81ea\u6d4b\u7ea6\u5b9a\uff1a\u626b\u63cf\u5668\u65e0\u72b6\u6001\u2014\u2014\u6ce8\u5165\u6a21\u5f0f\u5e76\u626b\u63cf\u540e\u79fb\u9664\u6ce8\u5165\uff0c\u518d\u6b21\u626b\u63cf\u7ed3\u679c\u5b57\u8282\u4e00\u81f4\uff08\u81ea\u6d4b\u89c1\u6d4b\u8bd5\u6587\u4ef6\uff0c\u4e0d\u5192\u5145\u72ec\u7acb\u590d\u6838\uff09\u3002</p>"},{"location":"reference/api/harness/#token-\u4e0a\u754c\u4f30\u7b97-foundationharnesstoken-estimation","title":"token \u4e0a\u754c\u4f30\u7b97 (foundation.harness.token-estimation)","text":"<p>FND-ADR-009\u3002\u786e\u5b9a\u6027\u9886\u57df\u4f30\u7b97\u539f\u8bed\uff1aUTF-8 \u5b57\u8282\u6570\u7eaf\u51fd\u6570\uff0c\u65e0\u6a21\u578b\u3001\u65e0\u7f51\u7edc\u3001\u65e0 tokenizer \u4f9d\u8d56\u3001\u65e0\u6301\u4e45\u72b6\u6001\u5bfc\u5165\uff1b\u7ed3\u679c\u7b26\u5408 <code>token-estimate-result</code> \u5951\u7ea6\uff08\u65e0\u65f6\u95f4\u6233\uff0c<code>guarantees</code> \u4e3a\u5c01\u95ed\u679a\u4e3e\uff09\u3002</p>"},{"location":"reference/api/harness/#estimateTokenUpperBound","title":"estimateTokenUpperBound","text":"<ul> <li>\u7b7e\u540d\uff1a<code>estimateTokenUpperBound(text)</code>\uff08\u7eaf\u51fd\u6570\uff09</li> <li>\u8f93\u5165\uff1a\u6587\u672c\u5b57\u7b26\u4e32\u3002</li> <li>\u8f93\u51fa\uff1a<code>token-estimate-result</code> \u5bf9\u8c61\uff08<code>upperBound === inputBytes</code>\uff09\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u662f\uff1b\u96f6\u4f9d\u8d56\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u65e0\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u975e\u5b57\u7b26\u4e32\u8f93\u5165\u629b <code>TypeError</code>\uff08\u65e0 SFC \u7801\uff09\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a\u8f93\u5165\u4e3a JavaScript \u5b57\u7b26\u4e32\uff1b\u4f30\u7b97\u53ea\u627f\u8bfa\u4e0a\u754c\uff08\u5b57\u8282\u6570\u5373\u4e0a\u754c\uff09\uff0c\u4e0d\u627f\u8bfa\u771f\u5b9e token \u8ba1\u6570\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/token-estimate.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/token-estimate.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4f30\u7b97\u7ed3\u679c\u7684\u89e3\u91ca\u4e0e\u6d88\u8d39\u4fa7\u6362\u7b97\uff08\u6a21\u578b\u8c03\u7528\u4e0e\u771f\u5b9e token \u8ba1\u6570\u4e0d\u5728 Foundation\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#\u901a\u7528\u4e0a\u9650\u5b88\u536b-foundationharnessupper-bound-guard","title":"\u901a\u7528\u4e0a\u9650\u5b88\u536b (foundation.harness.upper-bound-guard)","text":"<p>FND-ADR-009\u3002\u590d\u7528 state-store \u4e8b\u4ef6\u8d26\u4e0e token-lock \u663e\u5f0f\u5360\u7528\u5b9e\u73b0\u901a\u7528\u4e0a\u9650\u5b88\u536b\uff1a\u8d8a\u9650\u4e8b\u4ef6\u5931\u8d25\u5173\u95ed\u4e14\u4e0d\u5199\u5165\uff1b\u4e0a\u9650\u503c\u3001\u5355\u4f4d\u7c7b\u522b\u4e0e\u8d85\u9650\u7b56\u7565\u5168\u90e8\u7531\u6d88\u8d39\u8005\u914d\u7f6e\uff0c\u6a21\u5757\u4e0d\u643a\u5e26\u4efb\u4f55\u56fa\u5b9a\u6570\u989d\u6216\u5b9a\u4ef7\u8bcd\u6c47\u3002</p>"},{"location":"reference/api/harness/#openUsageGuard--appendUsageEvent--readUsage--closeUsageGuard","title":"openUsageGuard / appendUsageEvent / readUsage / closeUsageGuard","text":"<ul> <li>\u7b7e\u540d\uff1a</li> <li><code>openUsageGuard({ stateRoot, owner, payloadSchemas, reducer, initial = 0, upperBound, lockRoot, lockPath, clock } = {})</code>\uff08async\uff09</li> <li><code>appendUsageEvent(guard, event, { beforeCommit } = {})</code>\uff08async\uff09</li> <li><code>readUsage(guard)</code>\uff08async\uff09</li> <li><code>closeUsageGuard(guard)</code>\uff08async\uff09</li> <li>\u8f93\u5165\uff1a\u4e8b\u4ef6\u8d1f\u8f7d\u3001\u7eaf\u5f52\u7ea6\u51fd\u6570\u3001\u975e\u8d1f\u4e0a\u9650\u3001\u72b6\u6001\u6839\u4e0e\u9501\u6839/\u9501\u8def\u5f84\u3002</li> <li>\u8f93\u51fa\uff1a\u8ffd\u52a0\u7ed3\u679c\u3001\u5f53\u524d\u7528\u91cf\u8bfb\u6570\u3001\u5b88\u536b\u53e5\u67c4\u3002</li> <li>\u7eaf\u51fd\u6570\uff1a\u5426\uff08\u5199\u4e8b\u4ef6\u8d26\u4e0e\u9501\u6587\u4ef6\uff09\u3002</li> <li>\u526f\u4f5c\u7528\uff1a\u5728\u53d7\u6536\u5bb9\u8def\u5f84\u5199\u4e8b\u4ef6\u8d26\u4e0e\u9501\u6587\u4ef6\uff1b\u6253\u5f00\u65f6\u663e\u5f0f\u5360\u7528\u9501\u3001\u5173\u95ed\u65f6\u91ca\u653e\u3002</li> <li>\u7a33\u5b9a\u9519\u8bef\u7801\u4e0e <code>details.kind</code>\uff1a\u8d8a\u9650\u629b <code>SFC2004</code> + <code>upper-bound-exceeded</code>\uff08details \u542b <code>upperBound</code> / <code>projected</code>\uff0c\u4e8b\u4ef6\u4e0d\u5199\u5165\uff09\uff1b\u9501\u88ab\u5360\u7528\u629b <code>store-locked</code>\uff1b\u4e8b\u4ef6\u8d26\u65ad\u94fe\u629b <code>chain-broken</code>\uff1b\u4e8b\u4ef6 schema \u8fdd\u89c4\u629b <code>event-schema-invalid</code>\u3002</li> <li>\u524d\u7f6e\u6761\u4ef6\u4e0e\u4fe1\u4efb\u951a\uff1a<code>lockRoot</code>/<code>lockPath</code> \u7531\u6d88\u8d39\u8005\u6307\u5b9a\u5728 state store \u6839\u4e4b\u5916\uff1b\u4e8b\u4ef6\u8d26\u662f\u552f\u4e00\u6743\u5a01\uff1bfencing \u4e0d\u627f\u8bfa\u62b5\u5fa1\u540c\u6743\u9650\u6076\u610f\u8fdb\u7a0b\u3002</li> <li><code>since</code> / <code>stability</code>\uff1a<code>0.3.0</code> / <code>stable</code>\u3002</li> <li>\u6e90\u6587\u4ef6\uff1a<code>packages/skill-family-harness-node/src/budget-guard.mjs</code>\u3002</li> <li>\u6b63\u4f8b/\u8d1f\u4f8b\u6d4b\u8bd5\uff1a<code>packages/skill-family-harness-node/test/budget-guard.test.mjs</code>\u3002</li> <li>\u8c03\u7528\u65b9\u4ecd\u62e5\u6709\u7684\u4e1a\u52a1\u8bed\u4e49\uff1a\u4e8b\u4ef6\u542b\u4e49\u3001\u5f52\u7ea6\u51fd\u6570\u3001\u4e0a\u9650\u6570\u503c\u4e0e\u8d85\u9650\u540e\u7684\u4e1a\u52a1\u5904\u7f6e\uff08\u5b9a\u4ef7\u4e0e\u8ba1\u8d39\u8bed\u4e49\u7559\u5728\u6d88\u8d39\u8005\uff09\u3002</li> </ul>"},{"location":"reference/api/harness/#Quickstart-Profile-v2-candidate","title":"Quickstart Profile v2 candidate","text":"<p><code>skill-family-harness-node/candidate/quickstart-profile</code> \u8d1f\u8d23\u521b\u5efa observation Resource\u3001Task \u4e0e\u7ec8\u6001 Result\uff0c\u5e76\u590d\u9a8c\u771f\u5b9e\u6587\u4ef6\u5b57\u8282\u3001Resource id \u5168\u5c40\u552f\u4e00\u6027\u3001Task digest\u3001operation \u8eab\u4efd\u3001\u9010\u5b57\u6bb5 <code>run/stage/attempt</code> \u4ee5\u53ca evidence \u7cbe\u786e\u56de\u6307\u3002<code>verifyQuickstartExchange</code> \u628a\u673a\u5236\u62d2\u7edd\u8f6c\u6362\u6210\u7ed3\u6784\u5316\u7ed3\u679c\uff0c\u629b\u51fa\u5f0f\u5165\u53e3\u7ee7\u7eed\u4f7f\u7528\u5df2\u767b\u8bb0\u7684 <code>SFC2004</code> \u4e0e\u7a33\u5b9a <code>details.kind</code>\u3002</p> <p>\u8be5\u5165\u53e3\u4e0d\u9009\u62e9 method\uff0c\u4e0d\u89e3\u91ca domainResult\uff0c\u4e5f\u4e0d\u62e5\u6709\u91cd\u8bd5\u3001\u8c03\u5ea6\u6216\u751f\u547d\u5468\u671f\u30020.3.0 \u7684 v2 \u4e0e 0.2.1 \u7684 v1 \u4e0d\u517c\u5bb9\uff1b\u63a5\u5165\u5fc5\u987b\u7cbe\u786e\u9501\u5b9a\u6240\u9009\u7248\u672c\u3002</p>"},{"location":"reference/api/harness/#\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","title":"\u4e0e\u673a\u5668\u4e8b\u5b9e\u5c42\u7684\u4e92\u94fe","text":"<ul> <li>\u80fd\u529b\u7a33\u5b9a ID \u89c1 <code>docs/agents/capability-catalog.json</code>\uff08<code>foundation.harness.*</code>\uff09\u3002</li> <li>\u673a\u68b0\u6821\u9a8c\uff1a<code>scripts/docs/capability-catalog-check.mjs</code> \u89e3\u6790 <code>src/index.mjs</code>\uff0c\u62d2\u7edd\u5f15\u7528\u4e0d\u5b58\u5728\u7684\u5165\u53e3\u3002</li> </ul>"}]}