关于 site-diagnosis
面向顾问的结构化访谈技能,用于准备为 AI 编码工具制作的网站提供咨询。它收集项目背景、问题、技术细节和目标,并在 Obsidian 知识库中生成咨询简报。
主要功能
- 01五轮诊断访谈
- 02支持俄语或英语选择
- 03询问项目、设计与技术情况
- 04记录客户自由文本补充
- 05生成 Markdown 咨询简报
- 06将简报保存到 Obsidian 知识库
适用场景
- 01准备网站咨询
- 02识别设计或性能问题
- 03了解客户的技术背景
- 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]
保存后,告知用户文件所在位置,并简要概述你注意到的内容——答案中显现出的模式、不一致之处或主要风险。