Agent Skills

本目录存放 JY 项目专用 Agent Skills，供 Cursor、Claude Code 等开发工具快速理解：

• 项目架构与数据流
• 运维与环境（SSH、MySQL、systemd、Nginx）
• 部署流程（jy-site 静态站、jy-admin 管理端、文档站）
• 内容发布链路（管理端 → 构建 → 线上博客）
• Agent 在本仓库的开发规范

Skill 列表

Skill	文件	何时加载
项目架构	jy-architecture/SKILL.md	问整体结构、三端关系、静态边界
设计原理	jy-principles/SKILL.md	问为什么这样设计、技术选型
运维环境	jy-ops/SKILL.md	SSH、服务器目录、MySQL、日志
部署公开站	jy-deploy-site/SKILL.md	jy-site 构建、上传、GitHub Actions
部署管理端	jy-deploy-admin/SKILL.md	standalone 包、systemd、Nginx 反代
内容发布	jy-publish-flow/SKILL.md	写文章、待发布、构建并部署
Agent 开发规范	jy-agent-dev/SKILL.md	在本仓库改代码前的必读

详细运维文档见 运维与部署；本目录的 Skill 是浓缩版，给 Agent 快速建立上下文。

安装到 Cursor

方式一：符号链接（推荐，文档更新自动生效）

在 monorepo 根目录执行：

mkdir -p .cursor/skills
for d in docs/skills/jy-*/; do
  name=$(basename "$d")
  ln -sf "../../$d" ".cursor/skills/$name"
done

方式二：复制到个人 skills

cp -R docs/skills/jy-* ~/.cursor/skills/

方式三：直接引用路径

在对话中 @docs/skills/jy-architecture/SKILL.md 或让 Agent 读取对应文件。

与 .cursor/skills/ 的关系

位置	用途
docs/skills/	文档源，可浏览、可版本管理、可部署到 doc.jianyi.my
.cursor/skills/	Cursor 自动发现的 skill 目录（可链到 docs）

已有项目级 skill（如 jy-safe-edits、jy-admin-antd）仍在 .cursor/skills/，与本目录互补：

• docs/skills/ → 架构 / 运维 / 部署 / 发布全貌
• .cursor/skills/ → 具体编码规范（Ant Design 表单、安全改动等）

维护约定

1. 改部署流程时，同步更新对应 SKILL.md 和 docs/ops/*.md。
2. Skill 保持精简（单文件建议 < 200 行），细节链到 ops 文档。
3. description frontmatter 写清 WHAT + WHEN，便于 Agent 自动匹配。
4. 不要把密码、Token、真实密钥写进 Skill。