@namewta/speculo 0.8.11 → 0.8.13

package/template/skills/engineering-standards-builder/references/rules/03-interview-and-decisions.md

@@ -66,10 +66,11 @@ Verification:
 
 用户已经明确授权实施时：
 
-- 使用仓库主导实践；
-- 对新项目采用官方适用默认；
+- 使用治理合同中优先级最高且已复核的项目证据；
+- 用户指定模板、当前门禁与成熟受测实现发生冲突时，记录 current/target/migration，不按数量选择；
 - 对存量项目采用 Ratchet；
-- 不确定且高风险的事项标记为 `pending-decision`，不伪造用户选择；
+- 缺少项目证据的细节省略或标记为 `pending-decision`，只有安全与正确性底线可采用 Builder baseline；
+- 不伪造用户选择或把通用默认写成项目既有规范；
 - 继续生成可用规范，不用形式化问答阻塞。
 
 ## 完成条件

package/template/skills/engineering-standards-builder/references/rules/14-generation-contract.md

@@ -1,105 +1,89 @@
-# 项目规范生成合同
+# 项目 Skill Set 生成合同
 
-## Canonical 路径
+## 最小结构
 
-唯一正式规范：
+必须生成 `.agents/skills/engineering-standards/`，它是项目工程规范的权威入口和路由器。只有存在独立触发价值时才生成同级领域 Skill。
 
 ```text
-.agents/skills/engineering-standards/
+.agents/skills/
+  engineering-standards/
+    SKILL.md
+    generated-skill-set.json
+    references/project/
+      00-project-profile.md
+      01-module-map.md
+      02-decisions-and-exceptions.md
+      03-skill-map.md
+      04-source-and-template-map.md
+      review-checklist.md
+  <optional-domain-skill>/
+    SKILL.md
+    references/...
 ```
 
-推荐树：
+根入口使用 `templates/project-skill/SKILL.md.template`；领域入口使用 `templates/domain-skill/SKILL.md.template`。详细内容只创建有证据且被入口路由的文件。
 
-```text
-SKILL.md
-references/
-  project/
-    00-project-profile.md
-    01-module-map.md
-    02-decisions-and-exceptions.md
-  rules/
-    architecture-and-boundaries.md
-    files-and-naming.md
-    api-errors-resources.md
-    testing.md
-    security-and-data.md
-    quality-gates.md
-    review-and-delivery.md
-  typescript/...
-  java/...
-  go/...
-  rust/...
-```
+## Skill 拆分门
 
-只创建有内容并被入口路由的目录。未使用语言目录不得存在。
+领域 Skill 必须同时具备：独立触发场景、重复使用价值、项目证据、清晰责任边界和上下文缩减收益。语言、目录、Agent 数量或“看起来完整”都不是拆分理由。
 
-## 主入口
+根 Skill 维护跨域规范、项目画像、模块地图、决策/例外、Skill Map 和来源地图。领域 Skill 维护特定开发工作流、关键源码/模板导航、集成点和验证方式；不得重新定义根 Skill 的冲突规则。
 
-使用 `templates/project-skill/SKILL.md.template`。主入口必须：
+## 项目源码与模板引用
 
-- frontmatter `name: engineering-standards`；
-- 描述适用项目与触发分支；
-- 先读取 project profile 和 module map；
-- 根据当前变更 scope 路由到最小 references；
-- 要求实现前检查边界、实现后运行真实门禁；
-- 不复制详细语言规范。
+每个重要来源使用项目根相对路径，并说明：
 
-## 项目 References
+- 何时读取；
+- 它负责的能力或生成范围；
+- 输出目标；
+- 生成后需要的注册、import、配置或补充实现；
+- 对应消费者、测试或 validator；
+- 发现 legacy 或不适用场景时如何处理。
 
-使用模板：
+项目 FM、scaffold 和源码保持唯一事实源。Skill 不复制 `.ftl`、源码文件或大段代码；只做精准导航和行为约束。
 
-- `00-project-profile.md.template`
-- `01-module-map.md.template`
-- `02-decisions-and-exceptions.md.template`
-- `review-checklist.md.template`
+## 所有权清单
 
-生成规则统一格式：
+根目录中的 `generated-skill-set.json` 使用 `templates/project-skill/generated-skill-set.json.template`，最小 schema：
 
-```text
-### <Rule ID> <Title>
-Scope:
-Level: MUST | SHOULD | MAY
-Source:
-Applies when:
-Rule:
-Rationale:
-Verification:
-Exception:
+```json
+{
+  "schema_version": 1,
+  "generator": "engineering-standards-builder",
+  "skills": [
+    {
+      "name": "engineering-standards",
+      "path": ".agents/skills/engineering-standards",
+      "role": "router"
+    }
+  ]
+}
 ```
 
-不是每个轻量建议都要展开九个字段，但所有 MUST/SHOULD 必须至少有 Scope、Level、Source、Rule、Verification。
-
-## 选择性生成
-
-- 通用规则按项目风险裁剪，但安全、错误、资源、测试和门禁不能被无理由删除；
-- TypeScript 项目才生成 `typescript/`；
-- React/Vue 分别按模块生成，混合仓库分别限定 scope；
-- Java/Spring Boot、Go、Rust 同理；
-- 未支持语言生成通用规则与明确 fallback，不伪造专属语法规范。
+允许的 role 只有 `router` 和 `domain`。必须恰有一个 router；path 必须等于 `.agents/skills/<name>`。不要加入时间戳、hash、模型、扫描计数或可从文件树重新推导的字段。
 
-## 命令
+## 安全刷新
 
-生成规范只记录：
+- create：目标名称与已有未登记 Skill 冲突时不得覆盖；
+- refresh：只管理旧清单列出的 Skill，保留其他 `.agents/skills/*`；
+- legacy 根 Skill 无清单时，只可在计划中声明接管 `engineering-standards` 本身，不能顺带接管同级 Skills；
+- 删除和重命名必须在计划中列出；
+- 先形成完整候选并验证，再替换已登记内容；失败时保持或恢复旧 Skill Set；
+- 保留仍有效的用户决策、例外、公共 API 和项目特有知识；
+- 相同输入重复刷新不得产生无意义 diff。
 
-- manifest/build/CI 中已存在的命令；
-- 用户明确确认要新增的命令；
-- 对尚未实现的目标命令标记 `planned`，不能当作当前可执行门禁。
+兼容入口只在用户要求或旧路径已存在时使用 `templates/compatibility/`，并保持一句单向路由；它们不进入项目规范正文。
 
-## 兼容入口
+## 规则格式
 
-兼容文件只有一句单向路由，使用 `templates/compatibility/`。创建条件：
+所有 MUST/SHOULD 至少包含：
 
-- 仓库已有旧路径；
-- 用户要求；
-- `.claude` 或其他 Agent 目录实际存在并需要入口。
-
-不得让 `.agents/skills/engineering-standards` 指回兼容路径。
-
-## 写入安全
+```text
+Scope:
+Level: MUST | SHOULD
+Source:
+Rule:
+Verification:
+```
 
-- create：目标已存在时停止或转 merge；
-- merge/refresh：先读取、备份或通过版本控制保护，再原子替换；
-- dry-run：只输出计划和内容摘要，不写文件；
-- 不覆盖目标根外路径；
-- 不修改生成代码或 Vendor；
-- 不删除未在计划中声明的用户文件。
+项目命令只能来自现有配置/CI 或用户明确决定。尚未实现的命令标记 `planned`，不能报告为当前门禁。

package/template/skills/engineering-standards-builder/references/rules/15-validation-contract.md

@@ -1,65 +1,42 @@
-# 验证合同
+# Skill Set 验证合同
 
 ## 静态验证
 
 运行：
 
 ```bash
-node <skill-root>/scripts/validate-generated-skill.mjs \
-  --root <project-root> \
-  --strict
+node <skill-root>/scripts/validate-generated-skill.mjs --root <project-root> --strict
 ```
 
-必须确认：
+验证器必须确认：
 
-- canonical 路径和 `SKILL.md` 存在；
-- frontmatter 合法且 `name: engineering-standards`；
-- 所有相对 Markdown 引用可解析；
+- `engineering-standards` 根路由和六个项目 references 存在；
+- `generated-skill-set.json` schema、唯一 router、name/path/role 与实际目录一致；
+- 清单中每个 Skill 的 frontmatter 合法，根入口能路由到所有领域 Skill；
+- Markdown 链接只能落在项目根内，目标存在且不经 symlink 越界；
+- 来源地图至少引用一个 Skill 外的真实项目文件；
 - 没有未替换模板变量；
-- project profile、module map、decisions/exceptions 存在；
-- 每条 MUST/SHOULD 规则有 scope、source 和 verification；
-- 未使用语言/框架目录没有生成；
-- compatibility wrapper 仅一句且单向；
-- 没有 wrapper 循环；
-- canonical 内容只有一份。
+- MUST/SHOULD 规则包含 scope、source、rule 和 verification；
+- 生成的语言/框架规则有 Project Inventory 信号；
+- compatibility wrapper 只有一句且不形成循环；
+- 同名 canonical 正文没有重复副本。
 
-## 语义验证
-
-人工检查：
-
-- 模块地图与仓库事实一致；
-- 每个命令来自 manifest/CI/用户决策；
-- React/Vue、Java/Spring、Go、Rust 规则只应用于正确 scope；
-- current/target/migration 没有混写；
-- 用户决定和仍有效例外被保留；
-- 没有将 Builder 默认伪装为仓库事实；
-- 不存在通用规则中的语言专属目录硬编码。
-
-## 项目门禁
+验证器只检查清单声明的 Builder 产物，不把清单外 Skill 当作待删除对象。
 
-只运行已授权且项目真实存在的命令。记录：
-
-```text
-command
-working directory
-exit code
-result
-unverified impact
-```
-
-失败时保留原始失败，不通过改配置、删测试或扩大排除获取通过。
+## 语义验证
 
-## 幂等性
+人工复核模块地图、Skill 拆分、命令来源、模板责任范围、消费者/测试、current/target/migration、用户决策和例外。尤其确认：
 
-对 generated Skill 重新执行同一输入时应产生零无意义 diff。若时间戳会变化，应从生成内容中删除时间戳或使用稳定的源版本字段。
+- 没有把 Builder 默认写成项目事实；
+- 没有用 legacy 多数模式覆盖用户指定模板或成熟实现；
+- 没有复制项目模板/源码造成第二事实源；
+- 每个领域 Skill 都能独立触发并减少上下文；
+- 未覆盖范围被明确省略或标为待确认，而非伪造规则。
 
-## 报告
+## 项目门禁与幂等性
 
-结果分为：
+只运行项目真实存在且已授权的命令，记录 working directory、退出码、结果和未验证影响。失败时保留原始失败，不改配置或删测试掩盖问题。
 
-- passed；
-- failed；
-- not-run；
-- not-applicable。
+使用相同项目事实与决策再次生成，应无无意义 diff。时间戳和扫描计数不得进入生成内容。
 
-“未运行”不能报告为通过。
+结果使用 `passed`、`failed`、`not-run`、`not-applicable`；未运行不能报告为通过。

package/template/skills/engineering-standards-builder/references/rules/16-language-adapter-contract.md

@@ -1,55 +1,18 @@
-# 语言适配器与未内置语言 Fallback
+# 语言适配器与 Fallback
 
-## 适配器组成
+Builder 内置语言/框架 references 是发现和审计检查清单。它们帮助识别公共 API、类型/错误/资源、并发、测试、工具链和版本风险，但不能覆盖项目代码、模板、配置与用户决定。
 
-新增语言或框架支持必须同时提供：
-
-```text
-references/<language>/00-detection-and-scope.md
-references/<language>/... language rules
-examples/<language>/<fixture>/
-discover-project.mjs detection signals
-self-test.mjs assertions
-SKILL.md routing pointer
-manifest entry
-```
-
-框架、运行时和应用类型放在语言目录下的 `frameworks/`、`runtimes/`、`app-types/`，不要污染通用规则。
-
-## Detection
-
-检测至少交叉使用两类信号：
-
-- manifest/build/toolchain；
-- 源文件与入口；
-- CI/build 命令；
-- 框架依赖或注解；
-- 官方目录/模块配置。
-
-仅文件扩展名通常为 medium confidence；manifest + 源码入口可为 high confidence。
-
-## 语言规则最小覆盖
-
-- 模块/package/crate 与 public API；
-- 命名和目录；
-- 类型/错误/资源/并发；
-- 测试布局和工具；
-- formatter、lint/static analysis、build；
-- 版本与兼容策略；
-- 官方依据；
-- 语言专属访谈触发条件。
+只读取 Project Inventory 和源码证据命中的适配器。一个依赖、一种扩展名或根目录 manifest 不能让规则扩散到所有模块。
 
 ## 未内置语言
 
-发现 Python、Kotlin、C#、C/C++ 或其他语言而没有内置适配器时：
-
-1. 仍生成通用规则；
-2. 从仓库事实提取真实 formatter/linter/test/build 命令；
-3. 保留现有目录和语言惯例；
-4. 将语言专属规则标记为 `pending-adapter`；
-5. 不把 TypeScript、Java、Go 或 Rust 模式套用；
-6. 必要时按本合同构建新适配器。
+遇到 Python、Kotlin、C#、C/C++ 或其他未内置语言时：
 
-## 完成条件
+1. 从项目代码、配置、测试和 CI 提取真实规范；
+2. 保留现有目录、公开边界和成熟惯例；
+3. 引用真实 formatter、lint、test 和 build 命令；
+4. 对缺乏证据的语言细节省略或标记 `pending-decision`；
+5. 不套用 TypeScript、Java、Go 或 Rust 模式；
+6. 只有需要让 Builder 本身长期识别该生态时，才扩展语言适配器与 fixture。
 
-适配器能被发现、选择、生成和测试；无触发项目不会加载它；其 examples 被 self-test 实际使用。
+无内置适配器不阻止生成项目专属 Skill。项目证据优先于 Builder 覆盖范围。

package/template/skills/engineering-standards-builder/references/rules/README.md

@@ -1,6 +1,6 @@
 # 通用规则索引
 
-`references/rules/` 只描述跨语言成立的目标、证据和治理合同。语言、框架、运行时的具体实现必须进入对应适配器。
+`references/rules/` 描述跨语言的审计维度、证据和治理合同。它们是 Builder 的工作方法，不是可直接复制到项目的规范正文；语言、框架、运行时的具体结论必须由项目证据支持。
 
 按运行阶段读取：
 
@@ -18,6 +18,6 @@
 - [工具链、质量门禁与 CI](11-tooling-quality-gates-and-ci.md)
 - [Git、评审与交付](12-git-review-and-delivery.md)
 - [采用、例外与 Ratchet](13-adoption-exceptions-and-ratchets.md)
-- [项目规范生成合同](14-generation-contract.md)
-- [验证合同](15-validation-contract.md)
+- [项目 Skill Set 生成合同](14-generation-contract.md)
+- [Skill Set 验证合同](15-validation-contract.md)
 - [语言适配器与 Fallback](16-language-adapter-contract.md)

package/template/skills/engineering-standards-builder/scripts/self-test.mjs

@@ -83,27 +83,43 @@ function assertFixture(inventory, expected, fixtureName) {
 
 async function writeGeneratedFixture(projectRoot) {
   await mkdir(path.join(projectRoot, 'src'), { recursive: true });
+  await mkdir(path.join(projectRoot, 'docs', 'fm'), { recursive: true });
   await writeFile(path.join(projectRoot, 'package.json'), `${JSON.stringify({
     name: 'generated-validation-fixture', private: true,
     dependencies: { vue: '^3.5.0' }, devDependencies: { typescript: '^5.9.0', vite: '^7.0.0' },
   }, null, 2)}\n`);
   await writeFile(path.join(projectRoot, 'tsconfig.json'), '{"compilerOptions":{"strict":true},"include":["src"]}\n');
   await writeFile(path.join(projectRoot, 'src', 'App.vue'), '<script setup lang="ts">const value = 1</script>\n<template><main>{{ value }}</main></template>\n');
+  await writeFile(path.join(projectRoot, 'docs', 'fm', 'component.vue.ftl'), '<template><main>${title}</main></template>\n');
 
   const canonical = path.join(projectRoot, '.agents', 'skills', 'engineering-standards');
+  const domain = path.join(projectRoot, '.agents', 'skills', 'generated-vue-development');
   await mkdir(path.join(canonical, 'references', 'project'), { recursive: true });
   await mkdir(path.join(canonical, 'references', 'rules'), { recursive: true });
   await mkdir(path.join(canonical, 'references', 'typescript', 'frameworks'), { recursive: true });
-  await writeFile(path.join(canonical, 'SKILL.md'), `---\nname: engineering-standards\ndescription: Generated fixture standards.\n---\n\n# Engineering Standards\n\nRead [profile](references/project/00-project-profile.md), [modules](references/project/01-module-map.md), [decisions](references/project/02-decisions-and-exceptions.md), [review](references/project/review-checklist.md), [rules](references/rules/core.md), [TypeScript](references/typescript/language.md), and [Vue](references/typescript/frameworks/vue.md).\n`);
+  await mkdir(path.join(domain, 'references'), { recursive: true });
+  await writeFile(path.join(canonical, 'generated-skill-set.json'), `${JSON.stringify({
+    schema_version: 1,
+    generator: 'engineering-standards-builder',
+    skills: [
+      { name: 'engineering-standards', path: '.agents/skills/engineering-standards', role: 'router' },
+      { name: 'generated-vue-development', path: '.agents/skills/generated-vue-development', role: 'domain' },
+    ],
+  }, null, 2)}\n`);
+  await writeFile(path.join(canonical, 'SKILL.md'), `---\nname: engineering-standards\ndescription: Generated fixture standards.\n---\n\n# Engineering Standards\n\nRead [profile](references/project/00-project-profile.md), [modules](references/project/01-module-map.md), [decisions](references/project/02-decisions-and-exceptions.md), [skills](references/project/03-skill-map.md), [sources](references/project/04-source-and-template-map.md), [review](references/project/review-checklist.md), [rules](references/rules/core.md), [TypeScript](references/typescript/language.md), and [Vue](references/typescript/frameworks/vue.md). Route Vue work to [generated-vue-development](../generated-vue-development/SKILL.md).\n`);
   await writeFile(path.join(canonical, 'references', 'project', '00-project-profile.md'), '# Project Profile\n\nVue fixture.\n');
   await writeFile(path.join(canonical, 'references', 'project', '01-module-map.md'), '# Module Map\n\n- module:. uses TypeScript and Vue.\n');
   await writeFile(path.join(canonical, 'references', 'project', '02-decisions-and-exceptions.md'), '# Decisions and Exceptions\n\nNo exceptions.\n');
+  await writeFile(path.join(canonical, 'references', 'project', '03-skill-map.md'), '# Skill Map\n\n- generated-vue-development: Vue implementation.\n');
+  await writeFile(path.join(canonical, 'references', 'project', '04-source-and-template-map.md'), '# Source and Template Map\n\n- [Vue implementation](../../../../../src/App.vue)\n- [Component template](../../../../../docs/fm/component.vue.ftl)\n');
   await writeFile(path.join(canonical, 'references', 'project', 'review-checklist.md'), '# Review Checklist\n\n- Verify scope.\n');
   const rule = `# Core Rules\n\n### CORE-001 Validated boundary\nScope: repository\nLevel: MUST\nSource: repository-fact\nApplies when: external input enters the application.\nRule: Validate external input before domain use.\nRationale: Preserve trusted internal models.\nVerification: Review boundary tests.\nException: Recorded project exception only.\n`;
   await writeFile(path.join(canonical, 'references', 'rules', 'core.md'), rule);
   await writeFile(path.join(canonical, 'references', 'typescript', 'language.md'), rule.replace('CORE-001', 'TS-001'));
   await writeFile(path.join(canonical, 'references', 'typescript', 'frameworks', 'vue.md'), rule.replace('CORE-001', 'VUE-001'));
-  return canonical;
+  await writeFile(path.join(domain, 'SKILL.md'), '---\nname: generated-vue-development\ndescription: Implement Vue features in the generated fixture.\n---\n\n# Vue Development\n\nRead `../engineering-standards/SKILL.md`, then inspect [the mature component](../../../src/App.vue) and [the project template](../../../docs/fm/component.vue.ftl).\n');
+  await writeFile(path.join(domain, 'references', 'workflow.md'), '# Workflow\n\nUse the project template and verify the component.\n');
+  return { canonical, domain };
 }
 
 async function main() {
@@ -174,9 +190,39 @@ async function main() {
 
     const generatedTemp = await mkdtemp(path.join(os.tmpdir(), 'standards-builder-generated-'));
     tempRoots.push(generatedTemp);
-    const canonical = await writeGeneratedFixture(generatedTemp);
+    const { canonical } = await writeGeneratedFixture(generatedTemp);
     const valid = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
-    assert(valid.status === 0, `valid generated Skill was rejected: ${(valid.stderr || valid.stdout).trim()}`);
+    assert(valid.status === 0, `valid generated Skill Set was rejected: ${(valid.stderr || valid.stdout).trim()}`);
+
+    const unowned = path.join(generatedTemp, '.agents', 'skills', 'user-maintained-skill');
+    await mkdir(unowned, { recursive: true });
+    await writeFile(path.join(unowned, 'SKILL.md'), '---\nname: user-maintained-skill\ndescription: User-owned fixture skill.\n---\n\n# User Skill\n');
+    const withUnowned = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
+    assert(withUnowned.status === 0, 'validator must ignore a Skill outside the Builder ownership manifest');
+
+    const sourceMap = path.join(canonical, 'references', 'project', '04-source-and-template-map.md');
+    const sourceMapText = await readFile(sourceMap, 'utf8');
+    await writeFile(sourceMap, `${sourceMapText}\n- [Missing project source](../../../../../src/missing.ts)\n`);
+    const brokenSource = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
+    assert(brokenSource.status !== 0, 'validator must reject a missing project source link');
+    await writeFile(sourceMap, sourceMapText);
+
+    const ownershipPath = path.join(canonical, 'generated-skill-set.json');
+    const ownershipText = await readFile(ownershipPath, 'utf8');
+    const badOwnership = JSON.parse(ownershipText);
+    badOwnership.skills[1].path = '.agents/skills/../outside';
+    await writeFile(ownershipPath, `${JSON.stringify(badOwnership, null, 2)}\n`);
+    const escapingOwnership = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
+    assert(escapingOwnership.status !== 0, 'validator must reject an invalid owned Skill path');
+    await writeFile(ownershipPath, ownershipText);
+
+    const routerPath = path.join(canonical, 'SKILL.md');
+    const routerText = await readFile(routerPath, 'utf8');
+    await writeFile(routerPath, routerText.replace('[generated-vue-development](../generated-vue-development/SKILL.md)', '`generated-vue-development`'));
+    const missingRoute = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
+    assert(missingRoute.status !== 0, 'validator must reject a domain Skill that is not linked by the router');
+    await writeFile(routerPath, routerText);
+
     await writeFile(path.join(canonical, 'references', 'typescript', 'frameworks', 'react.md'), '# React\n');
     const wrongFramework = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
     assert(wrongFramework.status !== 0, 'strict validator must reject an unselected React rule in a Vue-only project');
@@ -186,7 +232,7 @@ async function main() {
     await writeFile(path.join(wrapper, 'SKILL.md'), '---\nname: typescript-standards\ndescription: alias\n---\n\nRoute to engineering-standards.\nSecond body line.\n');
     const badWrapper = runNode(generatedValidator, ['--root', generatedTemp, '--strict']);
     assert(badWrapper.status !== 0, 'validator must reject a multi-line compatibility wrapper');
-    process.stdout.write('self-test: generated Skill validator OK\n');
+    process.stdout.write('self-test: generated Skill Set validator OK\n');
 
     const manifest = runNode(manifestScript, ['--root', args.root, '--check']);
     assert(manifest.status === 0, `manifest check failed: ${(manifest.stderr || manifest.stdout).trim()}`);

package/template/skills/engineering-standards-builder/scripts/validate-builder.mjs

@@ -35,7 +35,8 @@ async function collect(rootReal) {
   const directories = [];
   async function visit(directory) {
     const relDir = toPosix(path.relative(rootReal, directory)) || '.';
-    const entries = await readdir(directory, { withFileTypes: true });
+    const entries = (await readdir(directory, { withFileTypes: true }))
+      .filter((entry) => entry.name !== '.DS_Store');
     entries.sort((a, b) => a.name.localeCompare(b.name, 'en'));
     directories.push({ abs: directory, rel: relDir, entries });
     for (const entry of entries) {
@@ -89,7 +90,7 @@ function normalizeLinkTarget(sourceAbs, link) {
 }
 
 async function computeManifest(rootReal, files) {
-  return `${files.map((file) => file.rel).filter((rel) => rel !== 'manifest.txt' && !rel.endsWith('/.DS_Store')).sort((a, b) => a.localeCompare(b, 'en')).join('\n')}\n`;
+  return `${files.map((file) => file.rel).filter((rel) => rel !== 'manifest.txt' && path.posix.basename(rel) !== '.DS_Store').sort((a, b) => a.localeCompare(b, 'en')).join('\n')}\n`;
 }
 
 function failLines(errors, warnings) {
@@ -138,9 +139,11 @@ async function main() {
         if (frontmatter.values.name !== 'engineering-standards-builder') errors.push('stable Skill ID must remain engineering-standards-builder for drop-in replacement');
         if (!frontmatter.values.description) errors.push('frontmatter description is missing');
         if (/[<>]/.test(frontmatter.values.description ?? '')) errors.push('frontmatter description must not contain angle brackets');
+        if (frontmatter.values['disable-model-invocation'] !== 'true') errors.push('Builder must remain explicitly user-invoked with disable-model-invocation: true');
+      }
+      for (const requiredConcept of ['Agent Team', 'generated-skill-set.json', '最小原则', 'Skill 边界']) {
+        if (!skillText.includes(requiredConcept)) errors.push(`SKILL.md is missing core contract: ${requiredConcept}`);
       }
-      const completionCount = (skillText.match(/\*\*完成标准\*\*/g) ?? []).length;
-      if (completionCount < 7) errors.push(`SKILL.md must define completion criteria for all seven stages; found ${completionCount}`);
     }
 
     const localMarkdownFiles = files.filter((file) => /\.md(?:\.template)?$/.test(file.name) || file.name === 'SKILL.md.template');
@@ -218,6 +221,15 @@ async function main() {
         if (!indexText.includes(file.name)) errors.push(`template is not indexed in templates/README.md: ${file.rel}`);
       }
     }
+    for (const requiredTemplate of [
+      'templates/project-skill/SKILL.md.template',
+      'templates/project-skill/generated-skill-set.json.template',
+      'templates/project-skill/references/project/03-skill-map.md.template',
+      'templates/project-skill/references/project/04-source-and-template-map.md.template',
+      'templates/domain-skill/SKILL.md.template',
+    ]) {
+      if (!fileByRel.has(requiredTemplate)) errors.push(`required Skill Set template missing: ${requiredTemplate}`);
+    }
 
     const fixtureExpectations = files.filter((file) => file.name === 'expected.json' && file.rel.startsWith('examples/'));
     if (fixtureExpectations.length < 6) errors.push(`at least six fixture contracts are required; found ${fixtureExpectations.length}`);