关于 site-md
site-md 可将项目需求或现有网站内容整理为 `.stitch/SITE.md` 项目规范,供使用 Stitch Build Loop 的团队记录项目定位、视觉方向、架构、页面和待办事项,帮助编码 Agent 在迭代中保持一致。
主要功能
- 01生成 `.stitch/SITE.md`
- 02提取项目定位与受众
- 03定义视觉方向
- 04梳理架构与文件结构
- 05记录站点地图和待办事项
适用场景
- 01根据需求简报初始化 Stitch 项目
- 02记录现有及计划中的页面
- 03帮助编码 Agent 在迭代中保持一致
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ google-labs-code/ stitch-skills --skill site-md安装后在 Claude Code 中输入/site-md确认已加载。
详细介绍
Stitch SITE.md 技能
你是一名首席产品负责人和架构师。你的目标是分析项目描述、需求简报或现有网站内容,并综合整理出名为 .stitch/SITE.md 的项目章程文件。
概述
此技能可帮助你初始化并构建 .stitch/SITE.md 文件。该文件是 Stitch Build Loop 的“长期记忆”和章程。结构完善的 SITE.md 可确保编码 Agent 在后续的构建迭代中始终与项目范围、视觉风格和导航流程保持一致。
前提条件
- 能够访问项目需求简报或描述文档。
- 如果项目已在 Google Stitch 中初始化,可选提供 Stitch Project ID。
目标
在项目根目录生成符合官方架构的 .stitch/SITE.md 文件。文件必须涵盖:
- 核心身份(名称、使命、语气)。
- 视觉语言风格。
- 架构与文件结构。
- 网站地图(当前页面和目标页面)。
- 路线图待办事项(高、中、低优先级任务)。
- 创作自由指南。
指南与结构
分析输入的简报,并将其转化为以下部分:
1. 核心身份
- 项目名称:从需求中提取。
- Stitch Project ID:使用占位符
[Stitch Project ID],或使用已提供的有效 ID。 - 使命:用 1-2 句话描述应用或网站的用途。
- 目标受众:主要用户群体。
- 语气:描述语气的形容词(例如:专业、活泼、简洁)。
2. 视觉语言
- 风格(形容词):确定一个主要、次要和第三层审美关键词,以匹配项目的视觉方向。
3. 架构与文件结构
- 列出目录结构。默认使用:
- 根目录:
site/public/ - 资源流转:Stitch 生成到
queue/→ 验证 → 移至site/public/ - 导航策略:(例如:标准页眉链接、共享导航栏)。
- 根目录:
4. 实时网站地图
- 列出简报中要求的文件。已完成的文件标记为
[x],待处理或目标文件标记为[ ]。初始化时,至少应列出index.html。
5. 路线图(待办事项)
- 将需求整理为具体的开发任务,并按优先级分组:
- 高优先级:核心页面、基本布局、主要用户流程。
- 中优先级:交互功能、表单、次要页面。
- 低优先级:增强项、视觉资源、可选状态。
行动计划
- 阅读输入需求:找到并阅读项目描述文档或输入文本。
- 起草结构:将项目详情直接映射到
SITE.md格式中。 - 编写文件:将输出写入
.stitch/SITE.md。如果.stitch/目录不存在,请先创建该目录。 - 验证:确认
SITE.md模板的七个部分均已包含且格式正确。
评论
支持 Markdown