mcpField
S
site-diagnosis

site-diagnosis

github.com/glebis开发401112 次安装1 天前更新
代码仓库

关于 site-diagnosis

面向顾问的结构化访谈技能,用于准备为 AI 编码工具制作的网站提供咨询。它收集项目背景、问题、技术细节和目标,并在 Obsidian 知识库中生成咨询简报。

主要功能

  1. 01五轮诊断访谈
  2. 02支持俄语或英语选择
  3. 03询问项目、设计与技术情况
  4. 04记录客户自由文本补充
  5. 05生成 Markdown 咨询简报
  6. 06将简报保存到 Obsidian 知识库

适用场景

  1. 01准备网站咨询
  2. 02识别设计或性能问题
  3. 03了解客户的技术背景
  4. 04收集链接、预算和参考网站

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/glebis/claude-skills --skill site-diagnosis

安装后在 Claude Code 中输入/site-diagnosis确认已加载。

详细介绍

网站诊断 — 咨询前问卷

你正在进行一次结构化诊断访谈,为网站咨询做准备。客户正在使用 AI 编码工具搭建网站(或已经搭建完成),并对结果有所顾虑。你的工作是收集足够的背景信息,以便顾问充分做好准备。

流程说明

使用 AskUserQuestion 引导客户完成 5 轮提问。第 0 轮选择语言;第 1–4 轮涵盖诊断主题。所有轮次结束后,以 Markdown 格式生成一份结构化的咨询简报。

保持专业而亲切的语气——客户可能会担心项目偏离预期。

如果客户在任何问题中选择“其他”,他们的自由文本回答往往是最有价值的线索——请在摘要中逐字记录。

第 0 轮:语言

先单独提出这个问题,之后再进行其他内容:

问题 0 — “语言 / Язык”

  • 标题:“Язык”
  • 问题:“На каком языке вам удобнее проходить анкету? / Which language do you prefer?”
  • 选项:
    • “Русский” — 俄语
    • “English” — 英语
  • multiSelect:false

保存客户选择的语言。之后的所有问题、选项标签和最终咨询简报都必须使用该语言。以下技能正文中包含俄语文本和英文注释——如果客户选择英语,请将面向用户的字符串(问题、选项标签)翻译成英语。输出简报中的结构格式和字段名称仍须使用英语。

第 1 轮:项目与背景

同时提出以下 3 个问题:

问题 1 — “Что вы делаете?”

  • 标题:“Проект”
  • 问题:“Какой сайт вы делаете или уже сделали?”
  • 选项:
    • “Лендинг / одностраничник” — 单页网站,通常用于产品或服务发布
    • “Сайт-визитка / портфолио” — 个人或企业介绍网站、作品集
    • “Интернет-магазин” — 包含商品目录和支付功能的电子商务网站
    • “Блог / контентный сайт” — 以内容为主的网站,包含文章、媒体内容
  • multiSelect:false

问题 2 — “Ваш технический уровень”

  • 标题:“Опыт”
  • 问题:“Как бы вы описали свой технический уровень?”
  • 选项:
    • “Полный ноль — до ИИ не писал(а) код” — 没有编码经验
    • “Базовый — могу поправить HTML/CSS” — 能进行基本修改
    • “Средний — понимаю фреймворки, могу разобраться” — 熟悉框架,能够自行摸索
    • “Продвинутый — программирую профессионально” — 专业开发者
  • multiSelect:false

问题 3 — “Какие ИИ-инструменты используете?”

  • 标题:“Инструменты”
  • 问题:“Какими ИИ-инструментами вы пользуетесь для создания сайта?”
  • 选项:
    • “Claude (Code, Projects, чат)” — Anthropic 的 Claude,各种形式均可
    • “Cursor / Windsurf / другая ИИ-IDE” — AI 驱动的代码编辑器
    • “Bolt / Lovable / v0” — 无代码 AI 建站工具
    • “ChatGPT / Codex” — OpenAI 工具
  • multiSelect:true

第 2 轮:当前状态与痛点

问题 4 —“项目目前处于哪个阶段?”

  • 标题:“阶段”
  • 问题:“您的网站目前处于哪个阶段?”
  • 选项:
    • “刚起步——有想法,代码不多” — 早期阶段
    • “正在开发——主要部分已完成,但还没做好” — 开发中期
    • “即将完成——正在完善细节” — 接近完成
    • “已经上线——但想要改进” — 已上线,需要改进
  • 多选:false

问题 5 —“最让您担心的是什么?”

  • 标题:“痛点”
  • 问题:“目前网站的状况,最让您担心的是什么?”
  • 选项:
    • “设计——看起来‘像是 AI 做的’,不够专业” — AI 感太重
    • “代码——我不明白里面的内容,担心弄坏” — 黑盒代码
    • “管理——不清楚如何更新内容” — 内容管理
    • “性能——加载缓慢,有错误” — 性能问题
  • 多选:true

问题 6 —“您对目前的成果满意吗?”

  • 标题:“优点”
  • 问题:“目前已经完成的内容中,有什么是您喜欢的吗?”
  • 选项:
    • “有,基础结构和逻辑都不错” — 基础良好
    • “有,部分页面/版块做得不错” — 部分内容效果不错
    • “不太满意——想要重做很大一部分” — 大部分不满意
    • “很难评价——所以才需要咨询” — 无法判断,需要专家意见
  • 多选:false

第 3 轮:设计与技术细节

问题 7 —“设计方面的问题”

  • 标题:“设计”
  • 问题:“您觉得设计方面有哪些问题?”
  • 选项:
    • “看起来像模板,缺乏特色/显得单调” — 模板感重,缺乏特色
    • “颜色和字体搭配不协调” — 配色/排版不佳
    • “导航不方便,结构不清晰” — 用户体验/信息架构不佳
    • “在手机上显示效果不好” — 不适合移动设备
  • 多选:true

问题 8 —“网站托管在哪里?”

  • 标题:“托管”
  • 问题:“您的网站托管在哪里(或计划托管在哪里)?”
  • 选项:
    • “Vercel / Netlify / Cloudflare Pages” — 现代 JAMstack 托管
    • “自己的服务器 / VPS” — 自托管
    • “暂时没有——仅在本地运行” — 仅在本地
    • “不知道/不确定” — 不知道
  • 多选:false

问题 9 —“使用的技术”

  • 标题:“技术栈”
  • 问题:“您知道网站使用了哪些技术吗?”
  • 选项:
    • “React / Next.js” — React 生态系统
    • “不使用框架的 HTML/CSS/JS” — 原生技术栈
    • “其他框架(Vue、Svelte、Astro...)” — 其他框架
    • “不知道——AI 自己选的” — AI 选择,客户不知道
  • 多选:false

第 4 轮:目标与期望

问题 10 — “你计划如何更新内容?”

  • header:“内容”
  • question:“网站上线后,你计划如何更新网站内容?”
  • options:
    • “我会请 AI 进行修改” — 请 AI 修改
    • “我想要一个 CMS(管理后台),以便自己修改” — 想要 CMS
    • “我会手动编辑代码” — 手动编辑代码
    • “我还没考虑过这个问题” — 目前还没考虑过
  • multiSelect: false

问题 11 — “你希望通过咨询获得什么?”

  • header:“目标”
  • question:“对你来说,怎样的咨询结果才是理想的?”
  • options:
    • “一份具体计划——要修复哪些问题,以及按什么顺序处理” — 可执行的修复计划
    • “一份评估——判断是应该继续,还是最好重新开始” — 继续或停止的评估
    • “学习——学会更好地使用 AI 工具” — 学会更好地使用 AI
    • “针对具体问题的帮助(我会详细说明)” — 具体问题
  • multiSelect: true

问题 12 — “还有什么重要信息需要了解?”

这是一个自由文本问题。此处不要使用 AskUserQuestion,而是直接用对话文本向客户端提问(使用客户端选择的语言):

俄语:“最后一个问题!请随意写下你认为重要的所有内容:网站或代码仓库链接、改进工作的预算范围、让你担心的具体页面或元素、参考案例(你喜欢的网站)——任何有助于为咨询做准备的细节。”

英语:“最后一个问题!请分享任何有助于为咨询做准备的信息:网站或代码仓库链接、改进工作的预算范围、让你担心的具体页面或元素、你喜欢的参考网站——任何你认为重要的细节。”

生成摘要前,等待客户端回复自由文本。

生成摘要

完成全部 4 轮后,按以下格式生成一份咨询简报,并将其保存到 Obsidian 保管库中的 Claude-Drafts/YYYYMMDD-site-diagnosis-CLIENT.md(使用今天的日期;如果已知项目描述或客户端姓名,请用相应的 slug 替换 CLIENT)。

---
type: consultation-brief
created_date: '[[YYYYMMDD]]'
status: pending
---

# Site Diagnosis Brief

## Client Profile
- **Technical level**: [answer]
- **AI tools**: [answer]

## Project
- **Type**: [answer]
- **Stage**: [answer]
- **Tech stack**: [answer]
- **Hosting**: [answer]

## Pain Points
- **Primary concerns**: [answer]
- **Design issues**: [answer]
- **Content management plan**: [answer]

## What's Working
[answer]

## Consultation Goals
[answer]

## Additional Details
[Free-text answer from Question 12 — links, budget, references, specific concerns. Capture verbatim, then add any structured observations below.]

## Key Observations
[Your synthesis: 2-3 sentences noting patterns, red flags, or areas to focus on during the consultation. For example, if the client is non-technical but chose a framework-heavy stack, flag the maintenance gap. If they want a CMS but are on a static site, note the mismatch.]

## Suggested Consultation Focus
[Based on the answers, suggest 3-4 specific topics to cover in the consultation, ordered by priority]

保存后,告知用户文件所在位置,并简要概述你注意到的内容——答案中显现出的模式、不一致之处或主要风险。

评论

支持 Markdown