mcp-probe-kit 3.6.2 → 3.6.5

package/build/schemas/output/project-tools.d.ts

@@ -70,6 +70,50 @@ export declare const ProjectInitSchema: {
                     readonly items: {
                         readonly type: "string";
                     };
+                    readonly description: "已废弃，请用 writtenFiles / plannedFiles";
+                };
+                readonly writtenFiles: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "已写入磁盘的路径";
+                };
+                readonly plannedFiles: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "规划中尚未创建的路径";
+                };
+            };
+        };
+        readonly writtenFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly action: {
+                        readonly type: "string";
+                        readonly enum: readonly ["created", "updated", "skipped"];
+                    };
+                };
+            };
+        };
+        readonly pendingFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly reason: {
+                        readonly type: "string";
+                    };
                 };
             };
         };
@@ -174,6 +218,36 @@ export declare const ProjectContextSchema: {
                     };
                 };
             };
+            readonly description: "文档索引（含已写入与待生成）";
+        };
+        readonly writtenFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly action: {
+                        readonly type: "string";
+                        readonly enum: readonly ["created", "updated", "skipped"];
+                    };
+                };
+            };
+        };
+        readonly pendingFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly reason: {
+                        readonly type: "string";
+                    };
+                };
+            };
         };
         readonly nextSteps: {
             readonly type: "array";
@@ -268,6 +342,41 @@ export declare const FeatureSpecSchema: {
                 };
             };
         };
+        readonly writtenFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly action: {
+                        readonly type: "string";
+                        readonly enum: readonly ["created", "updated", "skipped"];
+                    };
+                };
+            };
+        };
+        readonly pendingFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly reason: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly specPaths: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
     };
     readonly required: readonly ["summary", "featureName", "requirements", "tasks"];
 };
@@ -459,7 +568,17 @@ export interface ProjectInit {
     structure: {
         directories?: string[];
         files?: string[];
+        writtenFiles?: string[];
+        plannedFiles?: string[];
     };
+    writtenFiles?: Array<{
+        path: string;
+        action: 'created' | 'updated' | 'skipped';
+    }>;
+    pendingFiles?: Array<{
+        path: string;
+        reason: string;
+    }>;
     techStack?: string[];
     dependencies?: Record<string, string>;
     scripts?: Record<string, string>;
@@ -486,6 +605,14 @@ export interface ProjectContext {
     }>;
     nextSteps?: string[];
     metadata?: Record<string, any>;
+    writtenFiles?: Array<{
+        path: string;
+        action: 'created' | 'updated' | 'skipped';
+    }>;
+    pendingFiles?: Array<{
+        path: string;
+        reason: string;
+    }>;
 }
 export interface FeatureSpec {
     summary: string;
@@ -509,6 +636,15 @@ export interface FeatureSpec {
         normal?: string;
         pessimistic?: string;
     };
+    writtenFiles?: Array<{
+        path: string;
+        action: 'created' | 'updated' | 'skipped';
+    }>;
+    pendingFiles?: Array<{
+        path: string;
+        reason: string;
+    }>;
+    specPaths?: string[];
 }
 export interface Estimate {
     summary: string;

package/build/schemas/output/project-tools.js

@@ -32,7 +32,29 @@ export const ProjectInitSchema = {
             description: '项目结构',
             properties: {
                 directories: { type: 'array', items: { type: 'string' } },
-                files: { type: 'array', items: { type: 'string' } },
+                files: { type: 'array', items: { type: 'string' }, description: '已废弃，请用 writtenFiles / plannedFiles' },
+                writtenFiles: { type: 'array', items: { type: 'string' }, description: '已写入磁盘的路径' },
+                plannedFiles: { type: 'array', items: { type: 'string' }, description: '规划中尚未创建的路径' },
+            },
+        },
+        writtenFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    action: { type: 'string', enum: ['created', 'updated', 'skipped'] },
+                },
+            },
+        },
+        pendingFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    reason: { type: 'string' },
+                },
             },
         },
         techStack: {
@@ -100,6 +122,27 @@ export const ProjectContextSchema = {
                     purpose: { type: 'string' },
                 },
             },
+            description: '文档索引（含已写入与待生成）',
+        },
+        writtenFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    action: { type: 'string', enum: ['created', 'updated', 'skipped'] },
+                },
+            },
+        },
+        pendingFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    reason: { type: 'string' },
+                },
+            },
         },
         nextSteps: {
             type: 'array',
@@ -156,6 +199,27 @@ export const FeatureSpecSchema = {
                 pessimistic: { type: 'string' },
             },
         },
+        writtenFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    action: { type: 'string', enum: ['created', 'updated', 'skipped'] },
+                },
+            },
+        },
+        pendingFiles: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string' },
+                    reason: { type: 'string' },
+                },
+            },
+        },
+        specPaths: { type: 'array', items: { type: 'string' } },
     },
     required: ['summary', 'featureName', 'requirements', 'tasks'],
 };

package/build/tools/__tests__/add_feature.write.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/__tests__/add_feature.write.unit.test.js

@@ -0,0 +1,30 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, test } from "vitest";
+import { addFeature } from "../add_feature.js";
+describe("add_feature 不落盘", () => {
+    test("仅返回模板与 pendingFiles，不写 specs 文件", async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-add-feature-"));
+        const cwd = process.cwd();
+        process.chdir(projectRoot);
+        try {
+            const result = await addFeature({
+                feature_name: "user-auth",
+                description: "用户登录与注册",
+            });
+            expect(result.isError).toBeFalsy();
+            const structured = result.structuredContent;
+            expect(structured.pendingFiles).toHaveLength(3);
+            expect(structured.writtenFiles).toBeUndefined();
+            expect(fs.existsSync(path.join(projectRoot, "docs", "specs", "user-auth", "requirements.md"))).toBe(false);
+            const text = String(result.content[0].text);
+            expect(text).toMatch(/由 Agent 落盘/);
+            expect(text).toMatch(/MCP \*\*不会\*\*写入磁盘/);
+        }
+        finally {
+            process.chdir(cwd);
+            fs.rmSync(projectRoot, { recursive: true, force: true });
+        }
+    });
+});

package/build/tools/__tests__/code_insight.unit.test.js

@@ -128,7 +128,7 @@ describe("code_insight 单元测试", () => {
             }
         }
     });
-    test("返回 docs 保存指引而不直接代写文件", async () => {
+    test("save_to_docs 时返回 delegated plan，由 Agent 落盘图谱文件", async () => {
         const prev = process.env.MCP_ENABLE_GITNEXUS_BRIDGE;
         process.env.MCP_ENABLE_GITNEXUS_BRIDGE = "0";
         const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "code-insight-docs-"));
@@ -146,13 +146,11 @@ describe("code_insight 单元测试", () => {
             expect(text).toMatch(/使用场景指南/);
             expect(structured.projectDocs.latestMarkdownFilePath).toMatch(/docs\/graph-insights\/latest\.md$/);
             expect(structured.projectDocs.archiveMarkdownFilePath).toContain("/docs/graph-insights/");
-            expect(structured.projectDocs.projectContextFilePath).toMatch(/\/(AGENTS\.md|docs\/project-context\.md)$/);
-            expect(structured.projectDocs.navigationSnippet).toMatch(/代码图谱洞察/);
             expect(structured.plan.mode).toBe("delegated");
             expect(structured.plan.steps).toHaveLength(2);
             expect(structured.plan.steps[0].id).toBe("consume-result");
             expect(structured.plan.steps[1].id).toBe("optional-save");
-            expect(structured.plan.steps[1].outputs[0]).toMatch(/docs\/graph-insights\/latest\.md$/);
+            expect(structured.writtenFiles).toBeUndefined();
             expect(fs.existsSync(path.join(projectRoot, "docs", "graph-insights", "latest.md"))).toBe(false);
         }
         finally {

package/build/tools/__tests__/init_project.write.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/__tests__/init_project.write.unit.test.js

@@ -0,0 +1,22 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, test } from "vitest";
+import { initProject } from "../init_project.js";
+describe("init_project 落盘边界", () => {
+    test("仅写入 Skill 与 AGENTS.md，docs 由 Agent 创建", async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-init-project-"));
+        const result = await initProject({
+            project_name: "Demo App",
+            project_root: projectRoot,
+            input: "一个简单的演示应用",
+        });
+        expect(result.isError).toBeFalsy();
+        const structured = result.structuredContent;
+        expect(structured.writtenFiles.length).toBe(2);
+        expect(structured.pendingFiles.length).toBeGreaterThan(0);
+        expect(fs.existsSync(path.join(projectRoot, "AGENTS.md"))).toBe(true);
+        expect(fs.existsSync(path.join(projectRoot, "docs", "project-context.md"))).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, "docs", "specs", "demo-app", "requirements.md"))).toBe(false);
+    });
+});

package/build/tools/__tests__/init_project_context.unit.test.js

@@ -1,74 +1,78 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { describe, expect, test } from 'vitest';
-import { initProjectContext } from '../init_project_context.js';
-describe('init_project_context 单元测试', () => {
-    test('返回 delegated plan，含 finalize-agents-md 与 AGENTS.md 模板', async () => {
-        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-init-'));
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, test } from "vitest";
+import { initProjectContext } from "../init_project_context.js";
+describe("init_project_context 单元测试", () => {
+    test("MCP 仅写入 AGENTS.md 与 layout.json", async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-kit-init-"));
         const result = await initProjectContext({
-            docs_dir: 'docs',
+            docs_dir: "docs",
             project_root: projectRoot,
         });
         expect(result.isError).toBeFalsy();
-        expect('structuredContent' in result).toBe(true);
-        if (!('structuredContent' in result)) {
-            throw new Error('structuredContent 缺失');
+        expect("structuredContent" in result).toBe(true);
+        if (!("structuredContent" in result)) {
+            throw new Error("structuredContent 缺失");
         }
         const structured = result.structuredContent;
-        expect(structured.documentation.some((item) => item.path === 'AGENTS.md')).toBe(true);
-        expect(structured.documentation.some((item) => item.path === 'docs/graph-insights/latest.md')).toBe(true);
-        expect(structured.metadata?.layout?.indexPath).toBe('AGENTS.md');
-        expect(structured.metadata?.agentsMdTemplate).toMatch(/mcp-probe:context begin/);
-        expect(structured.metadata?.manifestWritten).toBe('docs/.mcp-probe/layout.json');
-        expect(fs.existsSync(path.join(projectRoot, 'docs', '.mcp-probe', 'layout.json'))).toBe(true);
+        expect(structured.writtenFiles.some((f) => f.path === "AGENTS.md")).toBe(true);
+        expect(structured.writtenFiles.some((f) => f.path === "docs/.mcp-probe/layout.json")).toBe(true);
+        expect(structured.pendingFiles.some((f) => f.path === "docs/project-context.md")).toBe(true);
+        expect(fs.existsSync(path.join(projectRoot, "docs", ".mcp-probe", "layout.json"))).toBe(true);
+        expect(fs.existsSync(path.join(projectRoot, "AGENTS.md"))).toBe(true);
+        expect(fs.existsSync(path.join(projectRoot, "docs", "project-context.md"))).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, "docs", "project-context", "tech-stack.md"))).toBe(false);
         const plan = structured.metadata?.plan;
-        expect(plan?.mode).toBe('delegated');
+        expect(plan?.mode).toBe("delegated");
         expect(plan.steps.map((step) => step.id)).toEqual([
-            'write-modular-docs',
-            'bootstrap-code-insight',
-            'persist-graph-docs',
-            'finalize-agents-md',
+            "write-modular-docs",
+            "bootstrap-code-insight",
+            "persist-graph-docs",
         ]);
-        expect(plan.steps[0].outputs).toContain('docs/project-context.md');
-        expect(plan.steps[3].id).toBe('finalize-agents-md');
+        const text = result.content[0].text;
+        expect(text).toMatch(/文件落盘状态/);
+        expect(text).toMatch(/尚未创建/);
     });
-    test('输出文本包含 AGENTS.md 与 MCP 触发规则', async () => {
-        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-init-'));
+    test("输出文本包含 AGENTS.md 与 MCP 触发规则", async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-kit-init-"));
         const result = await initProjectContext({
             project_root: projectRoot,
         });
         const text = result.content[0].text;
         expect(text).toMatch(/AGENTS\.md/);
-        expect(text).toMatch(/start_feature/);
-        expect(text).toMatch(/finalize-agents-md/);
+        expect(text).toMatch(/文件落盘状态/);
     });
-    test('已存在 project-context 分类文档时跳过重写 modular', async () => {
-        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-context-'));
-        fs.mkdirSync(path.join(projectRoot, 'docs', 'project-context'), { recursive: true });
-        fs.writeFileSync(path.join(projectRoot, 'docs', 'project-context.md'), '# existing context\n', 'utf8');
+    test("已存在 project-context 分类文档时跳过重写 modular", async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-kit-context-"));
+        fs.mkdirSync(path.join(projectRoot, "docs", "project-context"), { recursive: true });
+        fs.writeFileSync(path.join(projectRoot, "docs", "project-context.md"), "# existing context\n", "utf8");
         const result = await initProjectContext({
-            docs_dir: 'docs',
+            docs_dir: "docs",
             project_root: projectRoot,
         });
         expect(result.isError).toBeFalsy();
         const structured = result.structuredContent;
         expect(structured.metadata?.legacyProjectContextExists).toBe(true);
         expect(structured.metadata?.plan?.steps.map((step) => step.id)).toEqual([
-            'bootstrap-code-insight',
-            'persist-graph-docs',
-            'finalize-agents-md',
+            "bootstrap-code-insight",
+            "persist-graph-docs",
         ]);
+        expect(structured.pendingFiles.every((f) => !f.path.startsWith("docs/project-context"))).toBe(true);
+        expect(fs.readFileSync(path.join(projectRoot, "docs", "project-context.md"), "utf8")).toBe("# existing context\n");
+        expect(fs.existsSync(path.join(projectRoot, "AGENTS.md"))).toBe(true);
         const text = result.content[0].text;
         expect(text).toMatch(/保留/);
     });
-    test('已有 AGENTS.md 用户内容时 prepend merge', async () => {
-        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mcp-probe-kit-agents-'));
-        fs.writeFileSync(path.join(projectRoot, 'AGENTS.md'), '# Custom rules\n', 'utf8');
-        const result = await initProjectContext({ project_root: projectRoot });
-        const structured = result.structuredContent;
-        expect(structured.metadata?.agentsMdMergeMode).toBe('prepended');
-        expect(structured.metadata?.agentsMdTemplate).toMatch(/<!-- mcp-probe:context begin/);
-        expect(structured.metadata?.agentsMdTemplate).toContain('# Custom rules');
+    test("已有 AGENTS.md 时 merge 而非覆盖", async () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-kit-agents-"));
+        fs.writeFileSync(path.join(projectRoot, "AGENTS.md"), "# Custom rules\n", "utf8");
+        const result = await initProjectContext({
+            project_root: projectRoot,
+        });
+        const agents = fs.readFileSync(path.join(projectRoot, "AGENTS.md"), "utf8");
+        expect(agents).toContain("# Custom rules");
+        expect(agents).toMatch(/mcp-probe:context/);
+        expect(result.structuredContent.metadata?.agentsMdMergeMode).not.toBe("replaced");
     });
 });

package/build/tools/add_feature.js

@@ -1,12 +1,12 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
-import { okText } from "../lib/response.js";
+import { okStructured } from "../lib/response.js";
 import { loadTemplate, normalizeTemplateProfile } from "../lib/template-loader.js";
 import { handleToolError } from "../utils/error-handler.js";
 /**
  * add_feature 工具
  *
  * 功能：为已有项目添加新功能的规格文档
- * 模式：指令生成器模式 - 返回详细的生成指南，由 AI 执行实际操作
+ * 模式：指令生成器 — MCP 返回模板与要求，由调用方 Agent 按模板落盘
  *
  * 输出文件：
  * - docs/specs/{feature_name}/requirements.md - 需求文档
@@ -236,9 +236,9 @@ ${combinedValidation.warnings.length > 0 ? `- 其他警告: ${combinedValidation
 
 ---
 
-## 📝 创建文档
+## 📝 创建文档（由 Agent 落盘）
 
-请在 \`${docsDir}/specs/${featureName}/\` 目录下创建以下三个文件：
+MCP **不会**写入磁盘。请根据下方模板，在 \`${docsDir}/specs/${featureName}/\` 创建三个文件并替换占位符。
 
 ### 文件 1: requirements.md
 
@@ -286,9 +286,26 @@ ${fenceClose}
 *指南版本: 1.1.0*
 *工具: MCP Probe Kit - add_feature*
 `;
-        return okText(guide, {
+        const specPaths = [
+            `${docsDir}/specs/${featureName}/requirements.md`,
+            `${docsDir}/specs/${featureName}/design.md`,
+            `${docsDir}/specs/${featureName}/tasks.md`,
+        ];
+        const pendingFiles = specPaths.map((specPath) => ({
+            path: specPath,
+            reason: "由 Agent 根据本工具返回的模板写入",
+        }));
+        const structuredData = {
+            summary: `功能规格：${featureName}`,
+            featureName,
+            requirements: ["见 requirements.md 模板"],
+            tasks: [{ id: "1", title: "按模板创建 specs 文档", description: "将下方模板落盘并补充真实内容" }],
+            pendingFiles,
+            specPaths,
+        };
+        return okStructured(guide, structuredData, {
             schema: (await import("../schemas/output/project-tools.js")).FeatureSpecSchema,
-            note: "本工具返回功能规格生成指南，AI 应根据指南创建需求、设计和任务文档",
+            note: "本工具返回模板与要求，不代写文件；Agent 须按指南创建 specs",
             template: {
                 profile: templateProfile,
                 requested: profileDecision.requested,

package/build/tools/code_insight.js

@@ -197,7 +197,7 @@ function renderUsageGuide() {
 ## 下一步建议
 - 查询不精确: 增加 \`goal\`（例如“理解登录认证流程”）
 - 出现歧义: 传入 \`uid\` 或 \`file_path\` 重新执行
-- 需要落盘: 传 \`save_to_docs: true\`，再按 delegated plan 写入 docs/graph-insights`;
+- 需要落盘: 传 \`save_to_docs: true\`，再按 delegated plan 由 Agent 写入 docs/graph-insights`;
 }
 export function resolveCodeInsightQuery(input) {
     const finalTarget = input.target || ((input.mode === "context" || input.mode === "impact") ? input.input : "");
@@ -369,7 +369,7 @@ ${result.warnings.length > 0 ? `警告: ${result.warnings.join(", ")}` : ""}`.tr
         structured.nextAction = delegatedPlan?.kind === "ambiguity"
             ? "请先选择 uid 或 file_path 重新调用 code_insight 完成消歧"
             : projectDocs
-                ? `请按 delegated plan 落盘图谱文档，并更新 ${projectDocs.projectContextFilePath} 的索引入口`
+                ? `请按 delegated plan 由 Agent 落盘图谱文档，并更新 ${projectDocs.projectContextFilePath} 的索引入口`
                 : null;
         const structuredWithHandles = attachHandles(structured, {
             graph_resource: DEFAULT_GRAPH_RESOURCE_URI,
@@ -379,7 +379,7 @@ ${result.warnings.length > 0 ? `警告: ${result.warnings.join(", ")}` : ""}`.tr
                 tool: "code_insight",
                 goal: delegatedPlan.kind === "ambiguity"
                     ? "先完成符号消歧，再继续图谱分析"
-                    : "完成图谱分析后，将结果按 delegated plan 落盘到 docs/graph-insights",
+                    : "完成图谱分析后，由 Agent 按 delegated plan 落盘到 docs/graph-insights",
                 tasks: delegatedPlan.kind === "ambiguity"
                     ? [
                         "先阅读本次 code_insight 返回的 candidates",

package/build/tools/init_project.js

@@ -37,6 +37,21 @@ export async function initProject(args) {
             : "";
         const featureSlug = projectName.toLowerCase().replace(/\s+/g, '-');
         const agentsRel = toPosixPath(bootstrap.agentsMd.path);
+        const bootstrapWritten = [
+            { path: MCP_PROBE_SKILL_REL_PATH, action: bootstrap.skill.created ? "created" : bootstrap.skill.updated ? "updated" : "skipped" },
+            { path: agentsRel, action: bootstrap.agentsMd.created ? "created" : bootstrap.agentsMd.updated ? "updated" : "skipped" },
+        ];
+        const pendingFiles = [
+            { path: "docs/project-context.md", reason: "由 Agent 按指南创建" },
+            { path: "docs/constitution.md", reason: "由 Agent 按指南创建" },
+            { path: `docs/specs/${featureSlug}/requirements.md`, reason: "由 Agent 按指南创建" },
+            { path: `docs/specs/${featureSlug}/design.md`, reason: "由 Agent 按指南创建" },
+            { path: `docs/specs/${featureSlug}/tasks.md`, reason: "由 Agent 按指南创建" },
+            { path: `docs/specs/${featureSlug}/research.md`, reason: "由 Agent 按指南创建" },
+            { path: "scripts/check-prerequisites.sh", reason: "由 Agent 按指南创建" },
+            { path: "scripts/setup.sh", reason: "由 Agent 按指南创建" },
+            { path: "src/", reason: "由 Agent 按项目类型创建源代码目录" },
+        ];
         const message = `你需要按照 Spec-Driven Development（规范驱动开发）的方式初始化项目，参考 https://github.com/github/spec-kit 的工作流程。
 
 📋 **项目需求**：
@@ -208,7 +223,7 @@ ${warningBlock}
 7. 识别可以并行执行的任务以优化开发效率
 
 🚀 **开始执行**：
-现在请按照上述步骤创建项目结构和所有必需的文档。`;
+MCP 已写入 Skill 与 AGENTS.md。请按上述步骤由 Agent 创建 docs、scripts、src 及 specs 文档。`;
         // 创建结构化数据对象
         const structuredData = {
             summary: `初始化项目：${projectName}`,
@@ -234,29 +249,17 @@ ${warningBlock}
                     'scripts/',
                     'src/'
                 ],
-                files: [
-                    MCP_PROBE_SKILL_REL_PATH,
-                    agentsRel,
-                    'docs/project-context.md',
-                    'docs/constitution.md',
-                    `docs/specs/${featureSlug}/requirements.md`,
-                    `docs/specs/${featureSlug}/design.md`,
-                    `docs/specs/${featureSlug}/tasks.md`,
-                    `docs/specs/${featureSlug}/research.md`,
-                    'scripts/check-prerequisites.sh',
-                    'scripts/setup.sh'
-                ]
+                writtenFiles: bootstrapWritten.map((file) => file.path),
+                plannedFiles: pendingFiles.map((file) => file.path),
             },
+            writtenFiles: bootstrapWritten,
+            pendingFiles,
             nextSteps: [
-                '确认 .agents/skills/mcp-probe-kit/SKILL.md 与 AGENTS.md 已落盘',
-                '创建项目目录结构',
-                '生成 project-context.md',
-                '生成 constitution.md',
-                '生成需求文档 requirements.md',
-                '生成设计文档 design.md',
-                '生成任务清单 tasks.md',
-                '生成技术调研 research.md',
-                '创建辅助脚本'
+                '确认 Skill 与 AGENTS.md 已落盘',
+                '按指南创建 docs/ 文档与 specs',
+                '创建 scripts/ 辅助脚本',
+                '创建 src/ 源代码目录',
+                '运行 init_project_context 生成完整上下文与图谱',
             ]
         };
         return okStructured(message, structuredData, {