@chantezy/mcp-jingwei 1.0.0

package/README.md

@@ -0,0 +1,69 @@
+# @chantezy/mcp-jingwei
+
+> 精卫平台（4399 内部工具）产品工作流技能集合，以 MCP Server 形式分发。
+> 覆盖需求方案讨论、版本更新文案、竞品/平台拆解分析、需求文档转帮助中心四大场景。
+
+## 这是什么
+
+一个 MCP Server，把精卫平台相关的产品工作流技能打包发布到 npm。各 IDE / AI 客户端通过 `npx` 拉取最新版，调用三个工具即可按需加载技能内容：
+
+| 工具 | 作用 |
+|------|------|
+| `list_skills` | 列出所有可用技能（名称 + 描述） |
+| `get_skill` | 获取指定技能的完整内容（剥离 frontmatter 的正文） |
+| `get_reference` | 获取指定技能的参考文档（仅部分技能有 `references/` 目录） |
+
+## 包含技能
+
+| 技能 | 方向 | 说明 |
+|------|------|------|
+| `jingwei-product-discussion` | 需求方案讨论 | 文档系统 + 项目管理系统的需求分析、方案发散、竞品参考 |
+| `jingwei-version-update-description` | 版本更新文案 | 按飞书风格生成两句话功能更新介绍 |
+| `product-platform-analysis` | 平台/竞品分析 | 基于链接做产品结构拆解与竞品对标，输出 MD 报告 |
+| `doc-to-help-center` | 文档转帮助中心 | 把 PRD 改写为面向普通用户的帮助中心教程 |
+
+## 在 IDE 中接入
+
+任何支持 MCP 的客户端，配置如下：
+
+```json
+{
+  "mcpServers": {
+    "jingwei": {
+      "command": "npx",
+      "args": ["--yes", "@chantezy/mcp-jingwei@latest"]
+    }
+  }
+}
+```
+
+- `--yes`：跳过 npx 首次安装确认
+- `@latest`：强制拉最新版，避免本地缓存旧版本
+
+接入后重启客户端，在对话中输入「列出所有可用的精卫平台技能」即可验证。
+
+## 本地调试
+
+开发时直接调用本地构建产物，无需走 npm：
+
+```json
+{
+  "mcpServers": {
+    "jingwei": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
+      "env": { "DEBUG": "1" }
+    }
+  }
+}
+```
+
+启动后 stderr 会输出已加载技能数量，便于排查同步问题。
+
+## 更新流程
+
+技能内容随 `git push` 触发 GitHub Actions 自动同步、编译、发布到 npm（通过 Trusted Publisher / OIDC 无 token 发布）。各客户端下次启动时拉 `@latest` 即获取最新版。
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { listSkills, getSkill, getReference } from "./skill-loader.js";
+const server = new McpServer({
+    name: "mcp-jingwei",
+    version: "1.0.0",
+});
+if (process.env.DEBUG) {
+    process.stderr.write(`[mcp-jingwei] 已加载 ${listSkills().length} 个技能\n`);
+}
+server.tool("list_skills", "列出所有可用的精卫平台技能（名称 + 描述），用于了解可加载哪些技能", {}, async () => {
+    const skills = listSkills();
+    const text = skills.length > 0
+        ? skills.map((s) => `- ${s.name}: ${s.description}`).join("\n")
+        : "暂无技能";
+    return { content: [{ type: "text", text }] };
+});
+server.tool("get_skill", "获取指定技能的完整内容（已剥离 frontmatter 的正文）。技能名称通过 list_skills 查询", { name: z.string().describe("技能名称，如 jingwei-product-discussion") }, async ({ name }) => {
+    const skill = getSkill(name);
+    return {
+        content: [{ type: "text", text: skill?.content || `未找到技能：${name}` }],
+    };
+});
+server.tool("get_reference", "获取指定技能的参考文档内容。仅部分技能有 references 目录（如 jingwei-product-discussion）", {
+    name: z.string().describe("技能名称"),
+    ref: z.string().describe("参考文档文件名（不带 .md 也可），如 platform-spec"),
+}, async ({ name, ref }) => {
+    return { content: [{ type: "text", text: getReference(name, ref) }] };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,MAAM,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,IAAI,CACT,aAAa,EACb,oCAAoC,EACpC,EAAE,EACF,KAAK,IAAI,EAAE;IACT,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GACR,MAAM,CAAC,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/D,CAAC,CAAC,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,wDAAwD,EACxD,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC,EAAE,EAClE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;KAC9E,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,kEAAkE,EAClE;IACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC/D,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE;IACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC,CACF,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/skill-loader.d.ts

@@ -0,0 +1,12 @@
+export interface SkillMeta {
+    name: string;
+    description: string;
+    dir: string;
+}
+interface Skill extends SkillMeta {
+    content: string;
+}
+export declare function listSkills(): SkillMeta[];
+export declare function getSkill(name: string): Skill | undefined;
+export declare function getReference(name: string, ref: string): string;
+export {};

package/dist/skill-loader.js

@@ -0,0 +1,95 @@
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// dist/ 上一级即包根，skills/ 是包根下的同级目录
+const SKILLS_DIR = join(__dirname, "..", "skills");
+/**
+ * 行级解析 YAML frontmatter，只取 name / description 两个字段。
+ * 不引入 yaml 依赖；description 取第一个冒号之后的整段值并去引号。
+ */
+function parseFrontmatter(md) {
+    const lines = md.split(/\r?\n/);
+    let name = "";
+    let description = "";
+    let bodyStart = 0;
+    if (lines[0]?.trim() === "---") {
+        let i = 1;
+        while (i < lines.length && lines[i].trim() !== "---") {
+            const line = lines[i];
+            const idx = line.indexOf(":");
+            if (idx > -1) {
+                const key = line.slice(0, idx).trim();
+                let value = line.slice(idx + 1).trim();
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                if (key === "name")
+                    name = value;
+                else if (key === "description")
+                    description = value;
+            }
+            i++;
+        }
+        bodyStart = i + 1; // 跳过收尾的 ---
+    }
+    const body = lines.slice(bodyStart).join("\n").replace(/^\n+/, "");
+    return { name, description, body };
+}
+let cache = null;
+function loadSkills() {
+    if (cache)
+        return cache;
+    if (!existsSync(SKILLS_DIR)) {
+        cache = [];
+        return cache;
+    }
+    const skills = [];
+    for (const entry of readdirSync(SKILLS_DIR, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const skillMdPath = join(SKILLS_DIR, entry.name, "SKILL.md");
+        if (!existsSync(skillMdPath))
+            continue;
+        const md = readFileSync(skillMdPath, "utf-8");
+        const { name, description, body } = parseFrontmatter(md);
+        skills.push({
+            name: name || entry.name,
+            description: description || "",
+            dir: entry.name,
+            content: body,
+        });
+    }
+    cache = skills;
+    return skills;
+}
+export function listSkills() {
+    return loadSkills().map(({ name, description, dir }) => ({ name, description, dir }));
+}
+export function getSkill(name) {
+    const skills = loadSkills();
+    return skills.find((s) => s.name === name || s.dir === name);
+}
+export function getReference(name, ref) {
+    const skill = getSkill(name);
+    if (!skill)
+        return `未找到技能：${name}`;
+    const refName = ref.endsWith(".md") ? ref : `${ref}.md`;
+    const refPath = join(SKILLS_DIR, skill.dir, "references", refName);
+    if (existsSync(refPath)) {
+        return readFileSync(refPath, "utf-8");
+    }
+    // 未命中时列出该技能可用的参考文档，便于调用方自纠
+    const refsDir = join(SKILLS_DIR, skill.dir, "references");
+    if (existsSync(refsDir)) {
+        const files = readdirSync(refsDir, { withFileTypes: true })
+            .filter((f) => f.isFile() && f.name.endsWith(".md"))
+            .map((f) => f.name);
+        if (files.length > 0) {
+            return `未找到参考文档：${ref}\n该技能可用参考文档：\n${files.map((f) => `- ${f}`).join("\n")}`;
+        }
+    }
+    return `技能 ${name} 没有参考文档目录`;
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skill-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@chantezy/mcp-jingwei",
+  "version": "1.0.0",
+  "description": "精卫平台产品工作流技能集合 MCP Server（需求讨论 / 版本文案 / 竞品分析 / 文档转帮助中心）",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "mcp-jingwei": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "sync": "bash scripts/sync-skills.sh",
+    "prepublishOnly": "npm run sync && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "skills",
+    "jingwei",
+    "product-design",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chantezy/project-skills.git",
+    "directory": "jingwei/mcp-server"
+  },
+  "homepage": "https://github.com/chantezy/project-skills/tree/main/jingwei",
+  "bugs": {
+    "url": "https://github.com/chantezy/project-skills/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  }
+}

package/skills/doc-to-help-center/README.md

@@ -0,0 +1,65 @@
+# doc-to-help-center
+
+> 需求文档转帮助中心教程 Skill
+> 把开发者视角的需求文档（PRD）改写为普通用户一看就懂的功能教程，输出 Markdown 文件。
+
+---
+
+## 这是什么
+
+一个部署在 Claude 上的 Skill：给它一份需求文档链接，它会剔除产品逻辑、研发实现、原型说明、评审备注等内部内容，只保留用户能用的功能说明、操作步骤、注意事项，输出一篇可直接放进帮助中心的 Markdown 教程。
+
+**使用前提**：必须提供需求文档链接——没给链接时，Skill 会先向你索取，不会凭空撰写。
+
+---
+
+## 文件结构
+
+```
+doc-to-help-center/
+├── README.md      # 本文件
+└── SKILL.md       # Skill 主文件（硬性约束、执行流程、文档结构、语言规则、配图规则、自检清单）
+```
+
+---
+
+## 快速开始
+
+```
+把这个需求文档整理成帮助中心教程：<文档链接>
+帮我将这份 PRD 转成面向用户的功能说明：<文档链接>
+```
+
+---
+
+## 转换规则速览
+
+| 规则 | 说明 |
+|------|------|
+| 必须输入 | 需求文档链接，缺失时先索取 |
+| 剔除内容 | 产品逻辑、研发实现、原型说明、评审备注、排期/负责人/版本记录 |
+| 保留内容 | 功能说明、操作步骤、限制条件、注意事项 |
+| 默认结构 | 功能简介 / 功能详情 / 操作流程 / 其他（可按内容自定义） |
+| 语言风格 | 通俗简洁、零术语、以"你"称呼、正式友好中立 |
+| 界面元素 | 按钮/菜单名用「」标注，与原文档命名一致 |
+| 配图标记 | 需要截图处标记 `[图片]`，由你自行补充 |
+
+---
+
+## 输出效果示例
+
+**输入**：一份关于"文档评论支持图片框选"的 PRD（含需求背景、技术方案、Figma 链接、二期规划）
+
+**输出**：
+```markdown
+# 评论图片框选
+
+## 功能简介
+在文档评论中插入图片时，你可以在图片上框选特定区域，让讨论精准定位到图片的具体位置。
+
+## 操作流程
+第一步：在文档评论框中点击「插入图片」，上传需要讨论的图片 [图片]
+第二步：在图片上拖动鼠标框选需要讨论的区域，添加评论内容后发送 [图片]
+```
+
+——原文中的需求背景、技术方案、评审痕迹全部剔除，只保留用户视角的操作指引。

package/skills/doc-to-help-center/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: doc-to-help-center
+description: 需求文档转帮助中心教程 Skill，将开发者视角的需求文档（PRD）改写为面向普通用户的功能教程文档，输出 Markdown 文件。当用户提供需求文档/PRD 链接并说"转成帮助文档""写个用户教程""整理成帮助中心内容""把这个需求文档转成用户手册"时，必须触发本 Skill。即使用户只丢了一个文档链接并提到"帮助中心"，也应立即按本 Skill 流程执行；用户未提供链接时，必须先向用户索取文档链接，不得凭空撰写。
+---
+
+# 需求文档转帮助中心教程
+
+将研发/产品视角的需求文档（PRD），改写为**普通用户一看就懂**的帮助中心教程，输出 Markdown 文件。
+
+---
+
+## 硬性约束（不可违反）
+
+1. **文档链接是必须输入项**：用户未提供链接时，先向用户索取需求文档链接，不开始撰写；严禁凭空编造功能内容
+2. **只写文档里有的功能**：不补充文档中不存在的功能点；文档未覆盖但用户必然关心的信息（如入口位置），用合理推断写出并避免与原文冲突，不确定则不写
+3. **输出为 Markdown 格式**：分模块、分步骤、使用小标题
+
+---
+
+## 执行流程
+
+1. **确认链接** → 用户未提供则索取；提供后读取文档全文
+2. **识别功能范围** → 从 PRD 中提取"用户能做什么"：功能点、操作入口、操作路径、限制条件
+3. **剔除内部内容** → 删除以下类型内容，一个字都不带入正文：
+   - 产品逻辑与设计动机（"为什么做这个"）
+   - 研发实现细节（技术方案、字段定义、接口、数据库）
+   - 原型说明（"点击左上角第三个按钮的交互稿见第 X 页"）
+   - 评审备注、排期、负责人、版本记录
+   - 内部术语、代号、黑话
+4. **重写为用户语言** → 按下方结构与风格撰写
+5. **输出 Markdown 文件** → 直接输出完整文档内容
+
+---
+
+## 文档结构
+
+默认按以下四个模块组织，模块下用小标题拆分；**可根据实际内容自定义模块**（如功能单一可合并，功能复杂可拆分）：
+
+```markdown
+# 功能名称
+
+## 功能简介
+一段话说明：这个功能是什么、能帮你做什么、适合什么场景使用。
+
+## 功能详情
+分点介绍功能的各项能力和规则（限制条件、可见范围、生效时机等）。
+
+## 操作流程
+### 第一步：……
+具体操作描述 [图片]
+
+### 第二步：……
+具体操作描述 [图片]
+
+## 其他
+注意事项、常见问题、相关功能链接等。
+```
+
+**结构规则**：
+- 「功能简介」只写一段，不超过三句话，先说"是什么"再说"能做什么"
+- 「操作流程」每一步一个小标题，步骤内只写用户要做的动作，不混入功能介绍
+- 步骤数量超过 5 步时，按操作阶段拆成多个小节（如"创建 XX""管理 XX"）
+- 「其他」无内容可写时整节省略，不留空标题
+
+---
+
+## 语言与风格规则
+
+1. **零专业术语**：不出现接口、字段、配置项、状态机等词汇；必须提及时换成用户语言（"状态"→"当前进度"）
+2. **以"你"称呼用户**，站在使用者立场描述操作："你可以……""点击……后，即可……"
+3. **语气正式、友好、中立**：不使用感叹号、营销词（强大/便捷/智能）、口语化表达（"搞定""超方便"）
+4. **步骤描述标准化**：动作 + 位置 + 结果，例如"点击页面右上角的「新建文档」，在弹窗中输入标题后即可创建"
+5. **界面元素加引号**：按钮、菜单、入口名称用「」标注，与原文档中的实际命名保持一致
+6. **限制条件要明确**：权限要求、数量上限、生效范围等，必须写清楚，不能省略
+
+---
+
+## 配图标记规则
+
+- 凡是**文字说不清的空间位置或多步界面操作**，在对应步骤末尾标记 `[图片]`
+- 标记独占一行或紧跟步骤描述末尾，格式固定为 `[图片]`，由用户自行补充截图
+- 纯概念说明（功能简介等）不标记配图
+- 不描述图片内容（不写"[图片：新建按钮位置示意图]"），保持标记简洁统一
+
+---
+
+## 转换对照示例
+
+**PRD 原文**：
+> 需求背景：目前文档评论不支持图片，用户在评审设计稿时无法 pinpoint 问题区域，导致沟通效率低。技术方案：复用现有附件上传组件，新增 annotation 字段存储框选坐标。交互稿见 Figma 第 3 页。评审备注：二期考虑支持视频标注。
+
+**转换后**：
+> ## 评论图片框选
+>
+> ### 功能简介
+> 在文档评论中插入图片时，你可以在图片上框选特定区域，让讨论精准定位到图片的具体位置。
+>
+> ### 操作流程
+> 第一步：在文档评论框中点击「插入图片」，上传需要讨论的图片 [图片]
+>
+> 第二步：在图片上拖动鼠标框选需要讨论的区域，添加你的评论内容后发送 [图片]
+
+（原文中的需求背景、技术方案、Figma 引用、二期规划全部剔除。）
+
+---
+
+## 输出前自检清单
+
+- [ ] 是否已拿到用户提供的文档链接？（没有则先索取，未开始撰写）
+- [ ] 正文是否零研发术语、零产品逻辑、零评审痕迹？
+- [ ] 每个功能点是否都能在原文档中找到出处？
+- [ ] 操作步骤是否都是"动作 + 位置 + 结果"？
+- [ ] 界面元素名称是否用「」标注且与原文一致？
+- [ ] 需要配图的步骤是否标记了 `[图片]`？
+- [ ] 语气是否正式友好、无感叹号和营销词？

package/skills/platform-analysis/README.md

@@ -0,0 +1,70 @@
+# product-platform-analysis
+
+> 产品平台深度拆解与竞品分析 Skill
+> 基于用户提供的链接与资料，对内容/工具平台做系统化产品结构拆解，或对竞品做对标分析，输出 Markdown 分析报告。
+
+---
+
+## 这是什么
+
+一个部署在 Claude 上的 Skill：给它一个平台官网链接（可选附帮助中心、文档、截图等资料），它会用浏览器工具实际探索站点结构，然后输出一份完整的产品分析报告。
+
+**两种分析模式**，Skill 会自动判定：
+
+| 模式 | 触发方式 | 输出章节 |
+|------|---------|---------|
+| **A. 平台拆解** | "分析一下这个平台""拆解产品结构" | 第一至六章 |
+| **B. 竞品对标** | "做个竞品分析""对比我们和 XX""调研竞品功能" | 第一至七章（追加对标分析） |
+
+**报告章节**：
+1. **产品概述**（定位 / 用户 / 价值 / 差异化，表格）
+2. **功能架构拆解**（一级功能 → 二级功能 → 功能树）
+3. **核心业务流程**（用户旅程表格 + 核心任务步骤）
+4. **信息架构分析**（IA 树 + 三条定性评价）
+5. **用户角色分析**（角色 × 目标 × 操作 × 权限）
+6. **总结：亮点与可借鉴点**（含信息来源与局限说明）
+7. **对标分析**（仅竞品模式：商业模式与定价 / 竞争力评估 / 机会与威胁 / 行动建议）
+
+**核心原则**：只基于你提供的链接分析，不编造未观察到的功能；未验证的内容明确标注「未观察到」。
+
+---
+
+## 文件结构
+
+```
+platform-analysis/
+├── README.md      # 本文件
+└── SKILL.md       # Skill 主文件（分析模式、硬性约束、输入要求、执行流程、报告框架、风格规则）
+```
+
+---
+
+## 快速开始
+
+**平台拆解**：
+```
+帮我拆解一下 https://www.notion.so 的产品结构
+分析一下这个平台：https://xxx.com
+```
+
+**竞品对标**：
+```
+做个 PingCode 的竞品分析，对标我们的项目管理方向：https://xxx.com
+这是我们竞品的官网链接，出一份竞品分析报告
+对比一下 https://xxx.com 和我们的文档系统
+```
+
+**输入说明**：
+- 官网地址为**必须项**，缺失会先向你索取
+- 竞品模式下会追问**对比基准**（对标我们哪个产品方向），避免分析写成空泛的通用建议
+- 参考资料（帮助中心/产品文档/截图）可选，提供越多分析越深入
+- 部分功能需登录可见时，报告中会标注「未观察到」并列入信息来源与局限说明
+
+---
+
+## 适用场景
+
+- **竞品结构调研**：快速摸清竞品功能版图、IA 设计、商业模式
+- **竞品对标评估**：功能覆盖/易用性/协作/定价四维对比，输出机会与威胁
+- **新平台选型评估**：系统化了解一个 SaaS 产品的能力边界
+- **产品学习参考**：提取成熟平台的功能架构与流程设计作为借鉴