mcp-probe-kit 3.6.5 → 3.6.8

package/build/lib/harness-skill-targets.d.ts

@@ -0,0 +1,38 @@
+/** Canonical Skill path — never changes per harness */
+export declare const CANONICAL_SKILL_REL_PATH = ".agents/skills/mcp-probe-kit/SKILL.md";
+export type HarnessId = "agents" | "cursor" | "claude" | "codex" | "opencode" | "trae" | "traecli" | "codebuddy" | "lingma" | "comate";
+export type HarnessAdapterKind = "skill-mirror" | "rules-pointer" | "claude-pointer";
+export interface HarnessAdapterTarget {
+    id: string;
+    harnessId: HarnessId;
+    relPath: string;
+    kind: HarnessAdapterKind;
+    /** 项目内已有该目录时才写适配层（零配置） */
+    markerDir: string;
+}
+export interface HarnessDetectionResult {
+    markerHarnesses: HarnessId[];
+    detected: HarnessId[];
+    skillCanonical: string;
+    adaptersToWrite: HarnessAdapterTarget[];
+}
+export declare const HARNESS_ADAPTER_TARGETS: HarnessAdapterTarget[];
+/**
+ * 零配置 harness 检测：项目里已有工具目录（如 `.trae/`）则写对应薄适配。
+ * AGENTS.md 与 canonical Skill 路径始终不变。
+ */
+export declare function detectHarnessContext(projectRoot: string): HarnessDetectionResult;
+export interface LayoutHarnessManifest {
+    detected: HarnessId[];
+    skillCanonical: string;
+    adapters: Array<{
+        id: string;
+        kind: HarnessAdapterKind;
+        path: string;
+    }>;
+}
+export declare function toLayoutHarnessManifest(detection: HarnessDetectionResult, writtenAdapters: Array<{
+    id: string;
+    kind: HarnessAdapterKind;
+    path: string;
+}>): LayoutHarnessManifest;

package/build/lib/harness-skill-targets.js

@@ -0,0 +1,95 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { MCP_PROBE_SKILL_REL_PATH } from "./workflow-skill-template.js";
+/** Canonical Skill path — never changes per harness */
+export const CANONICAL_SKILL_REL_PATH = MCP_PROBE_SKILL_REL_PATH;
+export const HARNESS_ADAPTER_TARGETS = [
+    {
+        id: "trae-skill",
+        harnessId: "trae",
+        relPath: ".trae/skills/mcp-probe-kit/SKILL.md",
+        kind: "skill-mirror",
+        markerDir: ".trae",
+    },
+    {
+        id: "traecli-skill",
+        harnessId: "traecli",
+        relPath: ".traecli/skills/mcp-probe-kit/SKILL.md",
+        kind: "skill-mirror",
+        markerDir: ".traecli",
+    },
+    {
+        id: "codebuddy-skill",
+        harnessId: "codebuddy",
+        relPath: ".codebuddy/skills/mcp-probe-kit/SKILL.md",
+        kind: "skill-mirror",
+        markerDir: ".codebuddy",
+    },
+    {
+        id: "lingma-rules",
+        harnessId: "lingma",
+        relPath: ".lingma/rules/mcp-probe-kit-mcp.md",
+        kind: "rules-pointer",
+        markerDir: ".lingma",
+    },
+    {
+        id: "comate-rules",
+        harnessId: "comate",
+        relPath: ".comate/rules/mcp-probe-kit-mcp.mdr",
+        kind: "rules-pointer",
+        markerDir: ".comate",
+    },
+    {
+        id: "claude-pointer",
+        harnessId: "claude",
+        relPath: "CLAUDE.md",
+        kind: "claude-pointer",
+        markerDir: ".claude",
+    },
+];
+const MARKER_DIR_TO_HARNESS = {
+    ".trae": "trae",
+    ".traecli": "traecli",
+    ".codebuddy": "codebuddy",
+    ".lingma": "lingma",
+    ".comate": "comate",
+    ".cursor": "cursor",
+    ".claude": "claude",
+    ".codex": "codex",
+    ".opencode": "opencode",
+};
+function detectMarkerHarnesses(projectRoot) {
+    const found = [];
+    for (const [markerDir, harnessId] of Object.entries(MARKER_DIR_TO_HARNESS)) {
+        if (fs.existsSync(path.join(projectRoot, markerDir))) {
+            found.push(harnessId);
+        }
+    }
+    return found;
+}
+function shouldWriteAdapter(projectRoot, adapter) {
+    return fs.existsSync(path.join(projectRoot, adapter.markerDir));
+}
+/**
+ * 零配置 harness 检测：项目里已有工具目录（如 `.trae/`）则写对应薄适配。
+ * AGENTS.md 与 canonical Skill 路径始终不变。
+ */
+export function detectHarnessContext(projectRoot) {
+    const root = path.resolve(projectRoot);
+    const markerHarnesses = detectMarkerHarnesses(root);
+    const detected = markerHarnesses.length > 0 ? markerHarnesses : ["agents"];
+    const adaptersToWrite = HARNESS_ADAPTER_TARGETS.filter((adapter) => shouldWriteAdapter(root, adapter));
+    return {
+        markerHarnesses,
+        detected,
+        skillCanonical: CANONICAL_SKILL_REL_PATH,
+        adaptersToWrite,
+    };
+}
+export function toLayoutHarnessManifest(detection, writtenAdapters) {
+    return {
+        detected: detection.detected,
+        skillCanonical: detection.skillCanonical,
+        adapters: writtenAdapters,
+    };
+}

package/build/lib/project-context-layout.d.ts

@@ -32,6 +32,15 @@ export interface ProjectContextLayoutArgs {
 }
 /** Primary env key recorded in layout.json (optional local override via projectRoot) */
 export declare const LAYOUT_PROJECT_ROOT_ENV = "MCP_PROJECT_ROOT";
+export interface LayoutManifestHarnessV1 {
+    detected: string[];
+    skillCanonical: string;
+    adapters: Array<{
+        id: string;
+        kind: string;
+        path: string;
+    }>;
+}
 export interface LayoutManifestV1 {
     version: 1;
     /** Ignored if present in old files — project root is always inferred from manifest path */
@@ -45,6 +54,8 @@ export interface LayoutManifestV1 {
     indexStyle: "agents" | "legacy";
     generatedBy: string;
     generatedAt: string;
+    /** Harness detection snapshot (AGENTS.md + canonical Skill stay harness-agnostic) */
+    harness?: LayoutManifestHarnessV1;
 }
 export declare function toPosixPath(value: string): string;
 export declare function relativeLink(fromRel: string, toRel: string): string;
@@ -66,8 +77,10 @@ export declare function manifestPathRelativeToProject(projectRoot: string, absol
 export declare function layoutAbsPath(layout: ProjectContextLayout, relativePath: string): string;
 type ProjectContextLayoutCore = Omit<ProjectContextLayout, "projectRoot" | "projectRootPosix">;
 export declare function attachProjectRoot(layout: ProjectContextLayoutCore, projectRoot: string): ProjectContextLayout;
-export declare function buildLayoutManifest(layout: ProjectContextLayout): LayoutManifestV1;
-export declare function writeLayoutManifest(projectRoot: string, layout: ProjectContextLayout): string;
+export declare function buildLayoutManifest(layout: ProjectContextLayout, harness?: LayoutManifestHarnessV1): LayoutManifestV1;
+export declare function writeLayoutManifest(projectRoot: string, layout: ProjectContextLayout, harness?: LayoutManifestHarnessV1): string;
+/** Patch harness section on an existing layout.json (e.g. after bootstrap adapters). */
+export declare function patchLayoutManifestHarness(projectRoot: string, harness: LayoutManifestHarnessV1): string | null;
 export declare function layoutFromManifest(manifest: LayoutManifestV1, fallbackProjectRoot: string, manifestFilePath?: string): ProjectContextLayout;
 export declare function resolveProjectContextLayout(projectRoot: string, args?: ProjectContextLayoutArgs): ProjectContextLayout;
 export declare function countCjkChars(text: string): number;

package/build/lib/project-context-layout.js

@@ -196,7 +196,7 @@ export function attachProjectRoot(layout, projectRoot) {
         projectRootPosix: projectRootToManifestValue(resolved),
     };
 }
-export function buildLayoutManifest(layout) {
+export function buildLayoutManifest(layout, harness) {
     return {
         version: 1,
         projectRootEnv: LAYOUT_PROJECT_ROOT_ENV,
@@ -207,17 +207,41 @@ export function buildLayoutManifest(layout) {
         indexStyle: layout.indexStyle,
         generatedBy: "init_project_context",
         generatedAt: new Date().toISOString(),
+        ...(harness ? { harness } : {}),
     };
 }
-export function writeLayoutManifest(projectRoot, layout) {
+export function writeLayoutManifest(projectRoot, layout, harness) {
     const resolvedRoot = path.resolve(projectRoot);
     const manifestRel = layoutManifestRel(layout.contextRoot);
-    const manifest = buildLayoutManifest(attachProjectRoot(layout, resolvedRoot));
+    const manifest = buildLayoutManifest(attachProjectRoot(layout, resolvedRoot), harness);
     const absoluteManifest = path.join(resolvedRoot, ...manifestRel.split("/"));
     fs.mkdirSync(path.dirname(absoluteManifest), { recursive: true });
     fs.writeFileSync(absoluteManifest, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
     return manifestRel;
 }
+function layoutHarnessEquals(left, right) {
+    return JSON.stringify(left ?? null) === JSON.stringify(right);
+}
+/** Patch harness section on an existing layout.json (e.g. after bootstrap adapters). */
+export function patchLayoutManifestHarness(projectRoot, harness) {
+    const resolvedRoot = path.resolve(projectRoot);
+    const existing = readLayoutManifest(resolvedRoot);
+    if (!existing) {
+        return null;
+    }
+    if (layoutHarnessEquals(existing.harness, harness)) {
+        return null;
+    }
+    const layout = layoutFromManifest(existing, resolvedRoot);
+    const manifestRel = layout.manifestPath;
+    const absoluteManifest = path.join(resolvedRoot, ...manifestRel.split("/"));
+    const updated = {
+        ...existing,
+        harness,
+    };
+    fs.writeFileSync(absoluteManifest, `${JSON.stringify(updated, null, 2)}\n`, "utf8");
+    return manifestRel;
+}
 export function layoutFromManifest(manifest, fallbackProjectRoot, manifestFilePath) {
     const contextRoot = normalizeRelativePath(manifest.contextRoot);
     const projectRoot = resolveManifestProjectRoot(manifest, fallbackProjectRoot, manifestFilePath);

package/build/lib/workflow-skill-installer.d.ts

@@ -1,3 +1,4 @@
+import { type HarnessAdapterEnsureResult } from "./harness-adapters.js";
 export interface SkillEnsureResult {
     skillPath: string;
     skillRelPath: string;
@@ -17,6 +18,7 @@ export interface McpProbeKitBootstrapResult {
     projectRoot: string;
     skill: SkillEnsureResult;
     agentsMd: AgentsMdEnsureResult;
+    harness?: HarnessAdapterEnsureResult;
     /** 工作区可能解析失败（写到了 mcp-probe-kit 安装目录） */
     workspaceWarning?: string;
 }

package/build/lib/workflow-skill-installer.js

@@ -1,10 +1,12 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { agentsSkillReferenceSatisfied, resolveAgentsSkillRefMode, } from "./agents-skill-ref.js";
 import { generateAgentsMdInner } from "./agents-md-template.js";
 import { mergeAgentsMdBlock } from "./merge-agents-md.js";
-import { detectDocumentLocale, resolveProjectContextLayout, toPosixPath, } from "./project-context-layout.js";
 import { generateWorkflowSkillContent, LEGACY_WORKFLOW_SKILL_REL_PATH, MCP_PROBE_SKILL_REL_PATH, } from "./workflow-skill-template.js";
-import { agentsContextNeedsUpgrade, getMcpProbeSkillVersion, parseSkillVersionMarker, skillContentNeedsUpgrade, } from "./workflow-skill-version.js";
+import { agentsContextNeedsUpgrade, getMcpProbeSkillVersion, parseSkillInstalledVersion, skillContentNeedsUpgrade, } from "./workflow-skill-version.js";
+import { ensureHarnessAdapters } from "./harness-adapters.js";
+import { detectDocumentLocale, patchLayoutManifestHarness, resolveProjectContextLayout, toPosixPath, } from "./project-context-layout.js";
 import { isLikelyProjectNamedRelativePath, getMcpPackageInstallRoot, resolveWorkspaceRoot, } from "./workspace-root.js";
 function buildWorkspaceWarning(projectRoot) {
     const normalizedRoot = path.resolve(projectRoot);
@@ -42,6 +44,7 @@ function buildAgentsMdInner(projectRoot, existingAgentsContent) {
     const layout = resolveProjectContextLayout(projectRoot);
     const locale = detectDocumentLocale(projectRoot, existingAgentsContent);
     const graphReady = fs.existsSync(path.join(projectRoot, layout.latestMarkdownPath));
+    const contextReady = fs.existsSync(path.join(projectRoot, layout.legacyIndexPath));
     return generateAgentsMdInner({
         layout,
         locale,
@@ -53,6 +56,7 @@ function buildAgentsMdInner(projectRoot, existingAgentsContent) {
         docs: [],
         projectRootPosix: toPosixPath(projectRoot),
         graphReady,
+        contextReady,
     });
 }
 function agentsMdNeedsUpdate(content, skillRelPath, targetVersion) {
@@ -68,6 +72,9 @@ function agentsMdNeedsUpdate(content, skillRelPath, targetVersion) {
     if (!content.includes(skillRelPath)) {
         return true;
     }
+    if (!agentsSkillReferenceSatisfied(content, resolveAgentsSkillRefMode())) {
+        return true;
+    }
     if (agentsContextNeedsUpgrade(content, targetVersion)) {
         return true;
     }
@@ -85,7 +92,7 @@ export function ensureMcpProbeSkill(projectRoot) {
     const skillPath = path.join(root, MCP_PROBE_SKILL_REL_PATH);
     const targetVersion = getMcpProbeSkillVersion();
     const existing = fs.existsSync(skillPath) ? fs.readFileSync(skillPath, "utf8") : null;
-    const previousVersion = existing ? parseSkillVersionMarker(existing) : null;
+    const previousVersion = existing ? parseSkillInstalledVersion(existing) : null;
     if (!skillContentNeedsUpgrade(existing, targetVersion)) {
         return {
             skillPath,
@@ -144,10 +151,17 @@ export function ensureAgentsMdSkillReference(projectRoot) {
 export function ensureMcpProbeKitBootstrap(projectRoot) {
     const root = path.resolve(projectRoot);
     const workspaceWarning = buildWorkspaceWarning(root);
+    const skill = ensureMcpProbeSkill(root);
+    const agentsMd = ensureAgentsMdSkillReference(root);
+    const skillContent = fs.readFileSync(skill.skillPath, "utf8");
+    const layout = resolveProjectContextLayout(root);
+    const harness = ensureHarnessAdapters(root, skillContent, layout.indexPath);
+    patchLayoutManifestHarness(root, harness.layoutHarness);
     return {
         projectRoot: root,
-        skill: ensureMcpProbeSkill(root),
-        agentsMd: ensureAgentsMdSkillReference(root),
+        skill,
+        agentsMd,
+        harness,
         workspaceWarning,
     };
 }

package/build/lib/workflow-skill-template.d.ts

@@ -6,4 +6,7 @@ export declare const MCP_PROBE_SKILL_REL_PATH = ".agents/skills/mcp-probe-kit/SK
 /** @deprecated 旧路径，仅用于检测并升级 AGENTS.md 引用 */
 export declare const LEGACY_WORKFLOW_SKILL_REL_PATH = ".agents/skills/workflow/SKILL.md";
 export declare function generateWorkflowSkillBody(skillVersion?: string): string;
+export declare const MCP_PROBE_SKILL_NAME = "mcp-probe-kit";
+export declare const MCP_PROBE_SKILL_DESCRIPTION = "\u5C06\u7528\u6237\u610F\u56FE\u8DEF\u7531\u5230 mcp-probe-kit MCP \u5DE5\u5177\uFF08start_feature\u3001start_bugfix\u3001code_insight\u3001workflow\u3001gencommit \u7B49\uFF09\u3002\u5728\u5DF2\u914D\u7F6E MCP \u4E14\u51C6\u5907\u5199\u4EE3\u7801\u524D\u8BFB\u53D6\uFF1B\u4EC5\u8BF4\u660E\u8C03\u54EA\u4E2A MCP\uFF0C\u4E0D\u662F\u9879\u76EE\u7814\u53D1\u6D41\u7A0B\u672C\u8EAB\u3002Routes intent to mcp-probe-kit MCP tools; read before coding when MCP is configured.";
+export declare function formatSkillFrontmatter(skillVersion?: string): string;
 export declare function generateWorkflowSkillContent(skillVersion?: string): string;

package/build/lib/workflow-skill-template.js

@@ -4,7 +4,7 @@
  */
 import { VERSION } from "../version.js";
 import { MCP_INTENT_QUICK_LOOKUP, MCP_SKILL_AVOID_RULES, MCP_SKILL_COMMON_FLOWS, MCP_TOOL_SKILL_GROUPS, } from "./mcp-tool-skill-registry.js";
-import { formatSkillVersionMarker } from "./workflow-skill-version.js";
+import { SKILL_VERSION_FRONTMATTER_KEY } from "./workflow-skill-version.js";
 export const MCP_PROBE_SKILL_REL_PATH = ".agents/skills/mcp-probe-kit/SKILL.md";
 /** @deprecated 旧路径，仅用于检测并升级 AGENTS.md 引用 */
 export const LEGACY_WORKFLOW_SKILL_REL_PATH = ".agents/skills/workflow/SKILL.md";
@@ -74,12 +74,19 @@ ${renderAvoidRules()}
 *mcp-probe-kit 按版本自动同步（当前 \`${skillVersion}\`）。路径：\`${MCP_PROBE_SKILL_REL_PATH}\`*
 `;
 }
+export const MCP_PROBE_SKILL_NAME = "mcp-probe-kit";
+export const MCP_PROBE_SKILL_DESCRIPTION = `将用户意图路由到 mcp-probe-kit MCP 工具（start_feature、start_bugfix、code_insight、workflow、gencommit 等）。在已配置 MCP 且准备写代码前读取；仅说明调哪个 MCP，不是项目研发流程本身。Routes intent to mcp-probe-kit MCP tools; read before coding when MCP is configured.`;
+export function formatSkillFrontmatter(skillVersion = VERSION) {
+    return `---
+name: ${MCP_PROBE_SKILL_NAME}
+description: >-
+  ${MCP_PROBE_SKILL_DESCRIPTION}
+${SKILL_VERSION_FRONTMATTER_KEY}: "${skillVersion}"
+---`;
+}
 export function generateWorkflowSkillContent(skillVersion = VERSION) {
-    const versionMarker = formatSkillVersionMarker(skillVersion);
-    return `${versionMarker}
+    return `${formatSkillFrontmatter(skillVersion)}
 
 ${generateWorkflowSkillBody(skillVersion)}
-
-${versionMarker}
 `;
 }

package/build/lib/workflow-skill-version.d.ts

@@ -1,4 +1,6 @@
-/** Skill 文件首行版本标记：`<!-- mcp-probe-kit-skill-version: 3.5.0 -->` */
+/** Skill frontmatter 版本字段 */
+export declare const SKILL_VERSION_FRONTMATTER_KEY = "mcp-probe-kit-version";
+/** @deprecated 旧版 HTML 版本标记，仍用于解析历史文件 */
 export declare const SKILL_VERSION_MARKER = "mcp-probe-kit-skill-version";
 /** AGENTS.md mcp-probe 块内版本标记 */
 export declare const AGENTS_CONTEXT_VERSION_MARKER = "mcp-probe:context-version";
@@ -6,6 +8,10 @@ export declare function getMcpProbeSkillVersion(): string;
 export declare function formatSkillVersionMarker(version?: string): string;
 export declare function formatAgentsContextVersionMarker(version?: string): string;
 export declare function parseSkillVersionMarker(content: string): string | null;
+/** 从 Skill 正文解析已安装版本（frontmatter 优先，HTML 注释兜底） */
+export declare function parseSkillInstalledVersion(content: string): string | null;
+/** 是否缺少 Agent Skill 发现所需的 YAML frontmatter */
+export declare function skillFrontmatterNeedsUpgrade(content: string): boolean;
 export declare function parseAgentsContextVersion(content: string): string | null;
 /** 比较 semver（仅主版本号段，忽略 prerelease 后缀） */
 export declare function compareSemver(a: string, b: string): number;

package/build/lib/workflow-skill-version.js

@@ -1,5 +1,7 @@
 import { VERSION } from "../version.js";
-/** Skill 文件首行版本标记：`<!-- mcp-probe-kit-skill-version: 3.5.0 -->` */
+/** Skill frontmatter 版本字段 */
+export const SKILL_VERSION_FRONTMATTER_KEY = "mcp-probe-kit-version";
+/** @deprecated 旧版 HTML 版本标记，仍用于解析历史文件 */
 export const SKILL_VERSION_MARKER = "mcp-probe-kit-skill-version";
 /** AGENTS.md mcp-probe 块内版本标记 */
 export const AGENTS_CONTEXT_VERSION_MARKER = "mcp-probe:context-version";
@@ -17,6 +19,44 @@ export function parseSkillVersionMarker(content) {
     const match = content.match(pattern);
     return match?.[1]?.trim() ?? null;
 }
+function parseSkillVersionFromFrontmatter(content) {
+    if (!content.trimStart().startsWith("---")) {
+        return null;
+    }
+    const end = content.indexOf("\n---", 3);
+    if (end === -1) {
+        return null;
+    }
+    const header = content.slice(0, end + 4);
+    const pattern = new RegExp(`^${SKILL_VERSION_FRONTMATTER_KEY}:\\s*["']?([^"'\\n]+)["']?\\s*$`, "m");
+    const match = header.match(pattern);
+    return match?.[1]?.trim().replace(/^["']|["']$/g, "") ?? null;
+}
+/** 从 Skill 正文解析已安装版本（frontmatter 优先，HTML 注释兜底） */
+export function parseSkillInstalledVersion(content) {
+    return parseSkillVersionFromFrontmatter(content) ?? parseSkillVersionMarker(content);
+}
+/** 是否缺少 Agent Skill 发现所需的 YAML frontmatter */
+export function skillFrontmatterNeedsUpgrade(content) {
+    if (!content.trimStart().startsWith("---")) {
+        return true;
+    }
+    const end = content.indexOf("\n---", 3);
+    if (end === -1) {
+        return true;
+    }
+    const header = content.slice(0, end + 4);
+    if (!/^name:\s*mcp-probe-kit\s*$/m.test(header)) {
+        return true;
+    }
+    if (!/^description:\s*>?-?\s*\S/m.test(header)) {
+        return true;
+    }
+    if (!new RegExp(`^${SKILL_VERSION_FRONTMATTER_KEY}:\\s*`, "m").test(header)) {
+        return true;
+    }
+    return false;
+}
 export function parseAgentsContextVersion(content) {
     const pattern = new RegExp(`<!--\\s*${AGENTS_CONTEXT_VERSION_MARKER}:\\s*([^\\s>]+)\\s*-->`, "i");
     const match = content.match(pattern);
@@ -49,7 +89,10 @@ export function skillContentNeedsUpgrade(existing, targetVersion = VERSION) {
     if (!existing?.trim()) {
         return true;
     }
-    const installed = parseSkillVersionMarker(existing);
+    if (skillFrontmatterNeedsUpgrade(existing)) {
+        return true;
+    }
+    const installed = parseSkillInstalledVersion(existing);
     if (!installed) {
         return true;
     }

package/build/tools/init_project_context.js

@@ -6,6 +6,9 @@ import { resolveWorkspaceRoot, isLikelyProjectNamedRelativePath, buildProjectRoo
 import { detectDocumentLocale, layoutAbsPath, legacyProjectContextExists, parseLayoutArgsFromRecord, resolveProjectContextLayout, toPosixPath, writeLayoutManifest, } from "../lib/project-context-layout.js";
 import { mergeAgentsMdBlock } from "../lib/merge-agents-md.js";
 import { generateAgentsMdInner } from "../lib/agents-md-template.js";
+import { ensureHarnessAdapters } from "../lib/harness-adapters.js";
+import { generateWorkflowSkillContent, MCP_PROBE_SKILL_REL_PATH } from "../lib/workflow-skill-template.js";
+import { getMcpProbeSkillVersion } from "../lib/workflow-skill-version.js";
 import { formatFileDeliverySection, writeProjectFile, } from "../lib/file-delivery.js";
 import * as fs from "fs";
 import * as path from "path";
@@ -177,14 +180,26 @@ async function generateProjectContext(layout, projectRoot) {
             category: detection.category,
             docs,
             projectRootPosix: layout.projectRootPosix,
-            graphReady: false,
+            graphReady: fs.existsSync(layoutAbsPath(layout, layout.latestMarkdownPath)),
+            contextReady: modularExists,
         });
         const mergedAgents = mergeAgentsMdBlock(existingAgentsRaw, agentsInner);
-        const manifestWritten = writeLayoutManifest(projectRootAbs, layout);
+        const skillPath = layoutAbsPath(layout, MCP_PROBE_SKILL_REL_PATH);
+        const skillContent = fs.existsSync(skillPath)
+            ? fs.readFileSync(skillPath, "utf8")
+            : generateWorkflowSkillContent(getMcpProbeSkillVersion());
+        const harnessResult = ensureHarnessAdapters(projectRootAbs, skillContent, layout.indexPath);
+        const manifestWritten = writeLayoutManifest(projectRootAbs, layout, harnessResult.layoutHarness);
         const agentsMdWritten = writeProjectFile(projectRootAbs, layout.indexPath, mergedAgents.content, "always");
         const writtenFiles = [
             agentsMdWritten,
             { path: manifestWritten, action: "updated" },
+            ...harnessResult.adapters
+                .filter((a) => a.created || a.updated)
+                .map((a) => ({
+                path: a.path,
+                action: (a.created ? "created" : "updated"),
+            })),
         ];
         const pendingFiles = [
             ...(modularExists

package/package.json

@@ -1,84 +1,84 @@
-{
-  "name": "mcp-probe-kit",
-  "version": "3.6.5",
-  "description": "AI-Powered Development Toolkit - MCP Server with 30 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, MCP Skill auto-sync, UI/UX Pro Max, and Requirements Interview.",
-  "mcpName": "io.github.mybolide/mcp-probe-kit",
-  "type": "module",
-  "main": "build/index.js",
-  "bin": {
-    "mcp-probe-kit": "build/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
-    "watch": "tsc --watch",
-    "dev": "tsc && node build/index.js",
-    "test": "vitest --run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "sync-ui-data": "tsx scripts/sync-ui-data.ts",
-    "sync-version": "node scripts/sync-version.mjs",
-    "verify-workflow-skill": "tsx scripts/verify-workflow-skill.ts",
-    "sync-workflow-skill": "tsx scripts/sync-workflow-skill.ts",
-    "prebuild": "npm run sync-version && npm run sync-ui-data && npm run verify-workflow-skill && npm run sync-workflow-skill",
-    "docs:serve": "npx http-server docs -p 8080 -o"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "cursor",
-    "ai-tools",
-    "development-tools",
-    "code-quality",
-    "code-review",
-    "refactor",
-    "debugging",
-    "sql-generator",
-    "ui-generator",
-    "react",
-    "vue",
-    "typescript",
-    "git-tools",
-    "ai-assistant"
-  ],
-  "author": {
-    "name": "小墨 (Kyle)",
-    "url": "https://www.bytezonex.com/"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mybolide/mcp-probe-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
-  },
-  "homepage": "https://mcp-probe-kit.bytezonex.com",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "build",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "cross-spawn": "^7.0.6",
-    "csv-parse": "^6.1.0",
-    "tar": "^7.5.6"
-  },
-  "devDependencies": {
-    "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^20.0.0",
-    "@types/tar": "^6.1.13",
-    "@vitest/ui": "^4.0.18",
-    "fast-check": "^4.5.3",
-    "tsx": "^4.21.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "mcp-probe-kit",
+  "version": "3.6.8",
+  "description": "AI-Powered Development Toolkit - MCP Server with 30 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, MCP Skill auto-sync, UI/UX Pro Max, and Requirements Interview.",
+  "mcpName": "io.github.mybolide/mcp-probe-kit",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "mcp-probe-kit": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
+    "watch": "tsc --watch",
+    "dev": "tsc && node build/index.js",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "sync-ui-data": "tsx scripts/sync-ui-data.ts",
+    "sync-version": "node scripts/sync-version.mjs",
+    "verify-workflow-skill": "tsx scripts/verify-workflow-skill.ts",
+    "sync-workflow-skill": "tsx scripts/sync-workflow-skill.ts",
+    "prebuild": "npm run sync-version && npm run sync-ui-data && npm run verify-workflow-skill && npm run sync-workflow-skill",
+    "docs:serve": "npx http-server docs -p 8080 -o"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "ai-tools",
+    "development-tools",
+    "code-quality",
+    "code-review",
+    "refactor",
+    "debugging",
+    "sql-generator",
+    "ui-generator",
+    "react",
+    "vue",
+    "typescript",
+    "git-tools",
+    "ai-assistant"
+  ],
+  "author": {
+    "name": "小墨 (Kyle)",
+    "url": "https://www.bytezonex.com/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mybolide/mcp-probe-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
+  },
+  "homepage": "https://mcp-probe-kit.bytezonex.com",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cross-spawn": "^7.0.6",
+    "csv-parse": "^6.1.0",
+    "tar": "^7.5.6"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^20.0.0",
+    "@types/tar": "^6.1.13",
+    "@vitest/ui": "^4.0.18",
+    "fast-check": "^4.5.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  }
+}