svharness 0.13.5 → 0.14.1

package/README.md

@@ -150,7 +150,7 @@ S40/S50                 -> harness-build-skill-spec-builder
 S60                     -> harness-build-skill-references-intake
 S61/S65                 -> harness-build-skill-agent-env-merge
 S70                     -> harness-build-skill-knowledge-builder
-S80/S90                 -> harness-build-skill-orchestrator
+S80/S85/S90             -> harness-build-skill-orchestrator (+ S85 委派 pre-seal-review)
 ```
 
 `.harness-build-state.yaml` 跟踪进度，任何阶段可中断再续。
@@ -192,7 +192,8 @@ harness-build-{skill|rule}-<semantic-name>
 | **S65_customize_agent_env** | agent-env 定制（extra-skills/extra-rules 冲突建议与重命名建议 → 用户确认 → 写入） | `agent-env/rules/` + `agent-env/skills/` |
 | **S70_runtime_assets** | 运行期 Skills & tasks 索引（skill 执行 task） | `agent-env/skills/` + `tasks/templates/` |
 | **S80_seed_memory** | Memory 初始化 | `agent-env/memory/categories/` |
-| **S90_finalize** | 封板 | 版本 bump + CHANGELOG + 终审 |
+| **S85_pre_seal_validation** | 封存前校验 | `svharness doctor` + 全面审查报告 |
+| **S90_finalize** | 封板 | 版本 bump + CHANGELOG + `bootstrap_mode: false` |
 
 > 反复调用 orchestrator 总是从"第一个非 DONE 的阶段"继续。
 > **S10_wiki 仅在有 baseline 时出现；无 baseline 则不构建 wiki，流程从 S20_collect_inputs 开始。**
@@ -222,6 +223,7 @@ svharness wizard
 | `build` | 对应 `svharness build` |
 | `apply` | 对应 `svharness apply` |
 | `convert` | 对应 `svharness convert` |
+| `doctor` | 对应 `svharness doctor` |
 
 `build` 节除路径外，可写人类可读说明（仅写入配置文件，供团队阅读）：
 
@@ -391,6 +393,31 @@ S60（`harness-build-skill-references-intake`）属于 **build 阶段**。若某
 - 软回滚：后续 `apply` 不再传 `--inject-build-main-bridge`。
 - 硬回滚：删除 `<adapter.skillsDir>/harness-build-skills-bridge/` 即可；`build-agent-env/` 可保留用于后续构建流改造。
 
+### `doctor` —— harness 健康度与封存前硬检查（S85）
+
+在 Agent 进入 **S85_pre_seal_validation** / 封板前，对 harness 目录执行可重复的硬检查：
+
+```bash
+# 封存前全量（要求 S00–S80 均为 DONE）
+svharness doctor --harness ./my-app-harness --mode pre-seal
+
+# 日常巡检（不强制所有阶段 DONE）
+svharness doctor --harness ./my-app-harness --mode health
+
+# Agent 友好：JSON 报告
+svharness doctor --harness ./my-app-harness --mode pre-seal --format json --report ./my-app-harness/doctor-report.json
+```
+
+| 选项 | 说明 |
+|------|------|
+| `--harness` | harness 根目录（必填；可写在 `svharness.config.yaml` 的 `doctor.harness`） |
+| `--mode` | `pre-seal`（默认）或 `health` |
+| `--format` | `text`（默认）或 `json` |
+| `--report` | JSON 报告路径（默认 `<harness>/doctor-report.json`） |
+| `--strict` | 将 warning 视为 error |
+
+退出码：`0` 通过，`1` 存在 error。通过 doctor 后，由 `harness-build-skill-pre-seal-review` 完成语义层全面审查并经用户确认，方可将 S85 标为 DONE 并进入 S90。
+
 ### `convert` —— 文档 → Markdown 预处理（对接 S20_collect_inputs）
 
 把本地原始需求文档（`.pdf / .docx / .pptx / .xlsx / .html / .epub / .txt / .csv / .json / ...`）通过**云端部署**的 `markitdown_serve`（FastAPI + Microsoft MarkItDown）批量转为 Markdown，产物统一落到 `<harness>/<type>/md/`（`type` 为 `requirements` 或 `references`），直接喂给下游 `S40_extract_requirements` 条目化流程，显著提升 specs 生成质量的稳定性。
@@ -761,7 +788,7 @@ svharness build --harness-name demo-unknown --arch python --agent codechat `
 - [x] `apply` —— 把已构建好的 harness 绑定到目标项目（默认复制模式，`--clone` 兼容保留）
 - [x] 构建辅助资源统一命名（`build-skills/harness-build-skill-*`、`build-rules/harness-build-rule-*`）
 - [ ] `detach` —— 从目标项目解绑并清理 dispatcher skill
-- [ ] `doctor` —— 检查既有 harness 的健康度
+- [x] `doctor` —— 检查既有 harness 的健康度（`svharness doctor`）
 - [ ] `phase` —— 从 CLI 直接运行某个构建阶段
 - [ ] `--arch auto` —— 根据 `--baseline` 自动推断架构
 - [ ] 更多架构模板（`ios-swiftui` / `service-kotlin` / `python-fastapi` 等）

package/dist/commands/apply.js

@@ -13,6 +13,7 @@ const apply_project_entry_1 = require("../core/apply-project-entry");
 const validate_args_1 = require("../utils/validate-args");
 const logger_1 = require("../utils/logger");
 const version_1 = require("../utils/version");
+const skill_md_validate_1 = require("../utils/skill-md-validate");
 const DISPATCHER_SKILL_NAME = 'harness-apply-skills-main';
 const BUILD_MAIN_BRIDGE_SKILL_NAME = 'harness-build-skills-bridge';
 const BUILD_SKILL_TEMPLATE_FILES = [
@@ -23,6 +24,7 @@ const BUILD_SKILL_TEMPLATE_FILES = [
     'harness-build-skill-agent-env-merge.md',
     'harness-build-skill-knowledge-builder.md',
     'harness-build-skill-wiki-writer.md',
+    'harness-build-skill-pre-seal-review.md',
 ];
 const BUILD_RULE_TEMPLATE_FILES = [
     'harness-build-rule-agent-agnostic.md',
@@ -30,6 +32,7 @@ const BUILD_RULE_TEMPLATE_FILES = [
     'harness-build-rule-convert-check.md',
     'harness-build-rule-memory-write.md',
     'harness-build-rule-orchestrator-flow.md',
+    'harness-build-rule-pre-seal-review.md',
     'harness-build-rule-skills-tasks-output.md',
     'harness-build-rule-specs-schema.md',
     'harness-build-rule-user-interaction.md',
@@ -407,24 +410,8 @@ async function validateInjectedReferences(input) {
     }
     return failures;
 }
-function extractFrontmatter(content) {
-    const normalized = content.replace(/\r\n/g, '\n');
-    if (!normalized.startsWith('---\n'))
-        return undefined;
-    const endIdx = normalized.indexOf('\n---\n', 4);
-    if (endIdx < 0)
-        return undefined;
-    return {
-        block: normalized.slice(4, endIdx),
-        normalized,
-        endIdx,
-    };
-}
-function extractFrontmatterBlock(content) {
-    return extractFrontmatter(content)?.block;
-}
 function syncSkillFrontmatterName(content, expectedName) {
-    const frontmatter = extractFrontmatter(content);
+    const frontmatter = (0, skill_md_validate_1.extractFrontmatter)(content);
     if (!frontmatter) {
         return { content, changed: false, warning: '缺少 frontmatter' };
     }
@@ -451,63 +438,6 @@ function syncSkillFrontmatterName(content, expectedName) {
         changed: true,
     };
 }
-async function validateFrontmatterFields(input) {
-    const warnings = [];
-    if (!(await fs_extra_1.default.pathExists(input.file))) {
-        warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} 缺失，无法校验 frontmatter`);
-        return warnings;
-    }
-    const content = await fs_extra_1.default.readFile(input.file, 'utf8');
-    const block = extractFrontmatterBlock(content);
-    if (!block) {
-        warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} 缺少 frontmatter`);
-        return warnings;
-    }
-    try {
-        const parsed = js_yaml_1.default.load(block);
-        if (!parsed || typeof parsed !== 'object') {
-            warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} frontmatter 解析为空`);
-            return warnings;
-        }
-        for (const key of input.requiredKeys) {
-            if (!(key in parsed)) {
-                warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} frontmatter 缺少字段：${key}`);
-            }
-        }
-        if ('alwaysApply' in parsed && typeof parsed.alwaysApply !== 'boolean') {
-            warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} frontmatter alwaysApply 应为 boolean`);
-        }
-    }
-    catch (err) {
-        warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} frontmatter 解析失败：${err.message}`);
-    }
-    return warnings;
-}
-async function validateSkillNameMatchesDir(input) {
-    const warnings = [];
-    if (!(await fs_extra_1.default.pathExists(input.file)))
-        return warnings;
-    const content = await fs_extra_1.default.readFile(input.file, 'utf8');
-    const block = extractFrontmatterBlock(content);
-    if (!block)
-        return warnings;
-    try {
-        const parsed = js_yaml_1.default.load(block);
-        if (!parsed || typeof parsed !== 'object')
-            return warnings;
-        if (typeof parsed.name !== 'string')
-            return warnings;
-        const expected = node_path_1.default.basename(node_path_1.default.dirname(input.file));
-        const actual = parsed.name.trim();
-        if (actual && actual !== expected) {
-            warnings.push(`${node_path_1.default.relative(input.targetRoot, input.file)} frontmatter.name(${actual}) 与目录名(${expected}) 不一致`);
-        }
-    }
-    catch {
-        // parse failures are already reported by validateFrontmatterFields
-    }
-    return warnings;
-}
 async function saveBuildSkillsToBuildAgentEnv(input) {
     const destRoot = node_path_1.default.join(input.targetRoot, 'build-agent-env', 'skills');
     await fs_extra_1.default.ensureDir(destRoot);
@@ -901,19 +831,19 @@ async function runApply(opts) {
     if (bridgeSkillPath)
         skillFrontmatterChecks.push(bridgeSkillPath);
     for (const file of skillFrontmatterChecks) {
-        consistencyWarnings.push(...(await validateFrontmatterFields({
+        consistencyWarnings.push(...(await (0, skill_md_validate_1.validateFrontmatterFields)({
             targetRoot,
             file,
             requiredKeys: ['name', 'description'],
         })));
-        consistencyWarnings.push(...(await validateSkillNameMatchesDir({
+        consistencyWarnings.push(...(await (0, skill_md_validate_1.validateSkillNameMatchesDir)({
             targetRoot,
             file,
         })));
     }
     const ruleFrontmatterChecks = [...runtimeRuleFiles, ...buildRuleFiles];
     for (const file of ruleFrontmatterChecks) {
-        consistencyWarnings.push(...(await validateFrontmatterFields({
+        consistencyWarnings.push(...(await (0, skill_md_validate_1.validateFrontmatterFields)({
             targetRoot,
             file,
             requiredKeys: ['description'],

package/dist/commands/doctor/check-bootstrap.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkBootstrap = checkBootstrap;
+const utils_1 = require("./utils");
+async function checkBootstrap(ctx) {
+    const id = 'bootstrap';
+    const findings = [];
+    if (ctx.mode !== 'pre-seal') {
+        return { id, title: 'Bootstrap 模式', findings };
+    }
+    const harness = await (0, utils_1.readHarnessYaml)(ctx.harnessRoot);
+    if (!harness) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: '缺少或无法解析 harness.yaml',
+            path: 'harness.yaml',
+        });
+        return { id, title: 'Bootstrap 模式', findings };
+    }
+    const specs = harness.specs;
+    const bootstrapMode = specs?.bootstrap_mode;
+    if (bootstrapMode !== true) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: `封存前 specs.bootstrap_mode 应为 true（当前：${String(bootstrapMode)}）`,
+            path: 'harness.yaml',
+        });
+    }
+    return { id, title: 'Bootstrap 模式', findings };
+}

package/dist/commands/doctor/check-chinese-heuristic.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkChineseHeuristic = checkChineseHeuristic;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+const SCAN_PATHS = [
+    'requirements/yaml',
+    'specs',
+    'agent-env/rules',
+    'agent-env/skills',
+    'tasks/templates',
+    'baseline/wiki',
+    'agent-env/memory',
+];
+const LATIN_RUN_MIN = 24;
+const LATIN_RUN = /[A-Za-z][A-Za-z0-9_\-./]{23,}/g;
+const ALLOWED_IN_LINE = [
+    /^CMDID_/,
+    /^https?:\/\//,
+    /schema\.json/,
+    /\.yaml$/,
+    /\.md$/,
+    /frontmatter/,
+];
+function lineLooksAllowed(line) {
+    const t = line.trim();
+    if (!t)
+        return true;
+    return ALLOWED_IN_LINE.some((re) => re.test(t));
+}
+async function checkChineseHeuristic(ctx) {
+    const id = 'chinese-heuristic';
+    const findings = [];
+    for (const sub of SCAN_PATHS) {
+        const root = node_path_1.default.join(ctx.harnessRoot, sub);
+        const files = await (0, utils_1.listRealFilesRecursive)(root, { extensions: ['.yaml', '.yml', '.md', '.mdc'] });
+        for (const file of files) {
+            if (file.endsWith('schema.json'))
+                continue;
+            const content = await fs_extra_1.default.readFile(file, 'utf8');
+            const lines = content.split(/\r?\n/);
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (lineLooksAllowed(line))
+                    continue;
+                const matches = line.match(LATIN_RUN);
+                if (matches && matches.some((m) => m.length >= LATIN_RUN_MIN)) {
+                    findings.push({
+                        checkId: id,
+                        severity: 'warning',
+                        message: `第 ${i + 1} 行疑似过长英文描述，请确认已中文化：${matches[0].slice(0, 40)}…`,
+                        path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    return { id, title: '中文产出启发式', findings };
+}

package/dist/commands/doctor/check-convert-pairing.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkConvertPairing = checkConvertPairing;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+async function checkPairingForSide(ctx, side, findings, checkId) {
+    const rawDir = node_path_1.default.join(ctx.harnessRoot, side, 'raw');
+    const mdDir = node_path_1.default.join(ctx.harnessRoot, side, 'md');
+    if (!(await fs_extra_1.default.pathExists(rawDir)))
+        return;
+    const rawNames = await (0, utils_1.listDirEntries)(rawDir);
+    const mdNames = new Set((await (0, utils_1.listDirEntries)(mdDir)).map((n) => (0, utils_1.basenameWithoutExt)(n)));
+    for (const name of rawNames) {
+        const rawPath = node_path_1.default.join(rawDir, name);
+        const stat = await fs_extra_1.default.stat(rawPath);
+        if (!stat.isFile())
+            continue;
+        const ext = node_path_1.default.extname(name).toLowerCase();
+        if (ext === '.md') {
+            const base = (0, utils_1.basenameWithoutExt)(name);
+            if (!mdNames.has(base)) {
+                findings.push({
+                    checkId,
+                    severity: 'warning',
+                    message: `${side}/raw 中 ${name} 为 .md，建议在 ${side}/md/ 保留同基名副本或确认已条目化`,
+                    path: (0, utils_1.rel)(ctx.harnessRoot, rawPath),
+                });
+            }
+            continue;
+        }
+        if (!(0, utils_1.isRealFileName)(name))
+            continue;
+        const base = (0, utils_1.basenameWithoutExt)(name);
+        if (!mdNames.has(base)) {
+            findings.push({
+                checkId,
+                severity: 'error',
+                message: `${side}/raw/${name} 在 ${side}/md/ 缺少同基名 .md（${base}.md）`,
+                path: (0, utils_1.rel)(ctx.harnessRoot, rawPath),
+            });
+        }
+    }
+}
+async function checkConvertPairing(ctx) {
+    const id = 'convert-pairing';
+    const findings = [];
+    await checkPairingForSide(ctx, 'requirements', findings, id);
+    await checkPairingForSide(ctx, 'references', findings, id);
+    return { id, title: 'raw/md 转换配对', findings };
+}

package/dist/commands/doctor/check-empty-dirs.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkEmptyDirs = checkEmptyDirs;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+async function collectEmptyDirs(harnessRoot, dir, findings, checkId) {
+    if (!(await fs_extra_1.default.pathExists(dir)))
+        return;
+    const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
+    for (const ent of entries) {
+        if (ent.name.startsWith('.') && ent.name !== '.gitkeep')
+            continue;
+        const full = node_path_1.default.join(dir, ent.name);
+        if (ent.isDirectory()) {
+            const relPath = (0, utils_1.rel)(harnessRoot, full);
+            if (utils_1.EMPTY_DIR_WHITELIST.has(relPath)) {
+                await collectEmptyDirs(harnessRoot, full, findings, checkId);
+                continue;
+            }
+            if (relPath === 'agent-env/_incoming/skills') {
+                const state = await (0, utils_1.readBuildState)(harnessRoot);
+                const s65 = state?.phases.S65_customize_agent_env;
+                if (s65?.status === 'DONE') {
+                    await collectEmptyDirs(harnessRoot, full, findings, checkId);
+                    continue;
+                }
+            }
+            if (await (0, utils_1.isEmptyOrGitkeepOnly)(full)) {
+                findings.push({
+                    checkId,
+                    severity: 'error',
+                    message: `目录为空或仅含 .gitkeep：${relPath}`,
+                    path: relPath,
+                });
+            }
+            else {
+                await collectEmptyDirs(harnessRoot, full, findings, checkId);
+            }
+        }
+    }
+}
+async function checkEmptyDirs(ctx) {
+    const id = 'empty-dirs';
+    const findings = [];
+    await collectEmptyDirs(ctx.harnessRoot, ctx.harnessRoot, findings, id);
+    return { id, title: '空目录检查', findings };
+}

package/dist/commands/doctor/check-incoming.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkIncoming = checkIncoming;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+async function checkIncoming(ctx) {
+    const id = 'incoming';
+    const findings = [];
+    const incomingDir = node_path_1.default.join(ctx.harnessRoot, 'agent-env', '_incoming', 'skills');
+    const manifestPath = node_path_1.default.join(ctx.harnessRoot, 'agent-env', '_incoming', 'manifest.yaml');
+    if (!(await fs_extra_1.default.pathExists(incomingDir))) {
+        return { id, title: 'Incoming 资产', findings };
+    }
+    const entries = await (0, utils_1.listDirEntries)(incomingDir);
+    const fileNames = await Promise.all(entries.map(async (n) => {
+        const full = node_path_1.default.join(incomingDir, n);
+        const s = await fs_extra_1.default.stat(full);
+        return s.isFile() ? n : null;
+    }));
+    const realFiles = fileNames.filter((n) => !!n && (0, utils_1.isRealFileName)(n));
+    if (realFiles.length === 0) {
+        return { id, title: 'Incoming 资产', findings };
+    }
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    const s65 = state?.phases.S65_customize_agent_env;
+    if (s65?.status === 'DONE') {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: `S65 已 DONE 但 _incoming/skills/ 仍有未处理文件：${realFiles.join(', ')}`,
+            path: (0, utils_1.rel)(ctx.harnessRoot, incomingDir),
+        });
+    }
+    else if (!(await fs_extra_1.default.pathExists(manifestPath))) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: '_incoming/skills/ 有文件但缺少 manifest.yaml',
+            path: (0, utils_1.rel)(ctx.harnessRoot, manifestPath),
+        });
+    }
+    return { id, title: 'Incoming 资产', findings };
+}

package/dist/commands/doctor/check-memory.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkMemory = checkMemory;
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+async function checkMemory(ctx) {
+    const id = 'memory';
+    const findings = [];
+    const categoriesDir = node_path_1.default.join(ctx.harnessRoot, 'agent-env', 'memory', 'categories');
+    const mdFiles = await (0, utils_1.listRealFilesRecursive)(categoriesDir, { extensions: ['.md'] });
+    if (mdFiles.length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: 'agent-env/memory/categories/ 无分类 .md（S80 须播种）',
+            path: 'agent-env/memory/categories',
+        });
+    }
+    return { id, title: 'Memory 分类', findings };
+}

package/dist/commands/doctor/check-policy-grep.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkPolicyGrep = checkPolicyGrep;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+const SCAN_ROOTS = [
+    'specs',
+    'tasks',
+    'agent-env/rules',
+    'agent-env/skills',
+    'agent-env/memory',
+];
+const SCAN_EXTENSIONS = new Set(['.yaml', '.yml', '.md', '.mdc']);
+async function checkPolicyGrep(ctx) {
+    const id = 'policy-grep';
+    const findings = [];
+    for (const root of SCAN_ROOTS) {
+        const absRoot = node_path_1.default.join(ctx.harnessRoot, root);
+        const files = await (0, utils_1.listRealFilesRecursive)(absRoot);
+        for (const file of files) {
+            const ext = node_path_1.default.extname(file).toLowerCase();
+            if (!SCAN_EXTENSIONS.has(ext))
+                continue;
+            const content = (await fs_extra_1.default.readFile(file, 'utf8')).toLowerCase();
+            for (const term of utils_1.AGENT_BLACKLIST) {
+                const needle = term.toLowerCase();
+                if (content.includes(needle)) {
+                    findings.push({
+                        checkId: id,
+                        severity: 'error',
+                        message: `含 agent 绑定关键词 "${term}"`,
+                        path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    return { id, title: 'Agent-agnostic 策略', findings };
+}

package/dist/commands/doctor/check-references.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkReferences = checkReferences;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const utils_1 = require("./utils");
+async function checkReferences(ctx) {
+    const id = 'references';
+    const findings = [];
+    const rawDir = node_path_1.default.join(ctx.harnessRoot, 'references', 'raw');
+    const mdDir = node_path_1.default.join(ctx.harnessRoot, 'references', 'md');
+    const indexPath = node_path_1.default.join(ctx.harnessRoot, 'references', 'yaml', 'index.yaml');
+    const rawFiles = await (0, utils_1.listRealFilesRecursive)(rawDir);
+    const mdFiles = await (0, utils_1.listRealFilesRecursive)(mdDir, { extensions: ['.md'] });
+    if (rawFiles.length === 0 && mdFiles.length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'info',
+            message: 'references 无输入，若 S20 已确认「无新增」可忽略',
+        });
+        return { id, title: '参考资料', findings };
+    }
+    if (rawFiles.length > 0 && mdFiles.length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: 'references/raw 有文件但 references/md/ 无 Markdown 产物',
+            path: 'references/md',
+        });
+    }
+    if (rawFiles.length > 0 || mdFiles.length > 0) {
+        if (!(await fs_extra_1.default.pathExists(indexPath))) {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: '缺少 references/yaml/index.yaml 结构化索引（S60 产出）',
+                path: 'references/yaml/index.yaml',
+            });
+        }
+        else {
+            try {
+                const raw = await fs_extra_1.default.readFile(indexPath, 'utf8');
+                if (!raw.trim()) {
+                    findings.push({
+                        checkId: id,
+                        severity: 'error',
+                        message: 'references/yaml/index.yaml 为空',
+                        path: 'references/yaml/index.yaml',
+                    });
+                }
+                else {
+                    const doc = js_yaml_1.default.load(raw);
+                    if (!doc || typeof doc !== 'object') {
+                        findings.push({
+                            checkId: id,
+                            severity: 'error',
+                            message: 'references/yaml/index.yaml 解析为空',
+                            path: 'references/yaml/index.yaml',
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `index.yaml 解析失败：${err.message}`,
+                    path: 'references/yaml/index.yaml',
+                });
+            }
+        }
+    }
+    return { id, title: '参考资料', findings };
+}

package/dist/commands/doctor/check-requirements.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRequirements = checkRequirements;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const utils_1 = require("./utils");
+async function checkRequirements(ctx) {
+    const id = 'requirements';
+    const findings = [];
+    const rawDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'raw');
+    const yamlDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'yaml');
+    const rawFiles = await (0, utils_1.listRealFilesRecursive)(rawDir);
+    if (rawFiles.length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: 'requirements/raw/ 无真实文档（不得仅含 .gitkeep）',
+            path: 'requirements/raw',
+        });
+    }
+    const yamlFiles = (await (0, utils_1.listRealFilesRecursive)(yamlDir, { extensions: ['.yaml', '.yml'] })).filter((f) => !f.endsWith('schema.json'));
+    if (yamlFiles.length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: 'requirements/yaml/ 无条目化 YAML 产出',
+            path: 'requirements/yaml',
+        });
+    }
+    else {
+        for (const file of yamlFiles) {
+            try {
+                const raw = await fs_extra_1.default.readFile(file, 'utf8');
+                if (!raw.trim()) {
+                    findings.push({
+                        checkId: id,
+                        severity: 'error',
+                        message: 'requirements YAML 文件为空',
+                        path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                    });
+                    continue;
+                }
+                js_yaml_1.default.load(raw);
+            }
+            catch (err) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `requirements YAML 解析失败：${err.message}`,
+                    path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                });
+            }
+        }
+    }
+    const mdDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'md');
+    if (rawFiles.length > 0 && (await (0, utils_1.listDirEntries)(mdDir)).length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: 'requirements/raw 有文件但 requirements/md/ 为空，请确认 S30 已完成',
+            path: 'requirements/md',
+        });
+    }
+    return { id, title: '需求文档', findings };
+}