Cursor 智能体学习实验仓
动机
我需要一个体量小、MIT 许可的仓库，用 vibe coding 和实验把 Cursor 智能体配置吃透——不只读规则和 hook 的概念，而是接线、弄坏、再拼起来，看它们如何组合。
问题
多数智能体教程停在 prompt。真实工作里你需要仓库原生的配置：能留下来的基线（规则）、有名字的流程（skills）、聚焦的委派（子智能体）、轻量的项目意图（AGENTS.md），以及围绕编辑和 shell 的自动化（hooks）。没有地图和可运行示例，你只能一次次从零搭同一套东西。
关键收获
把一条工作流命名成 skill，和底下的脚本一样重要——把「规划→实现→验证」这类流程和具体的 `/skill-name` 入口写进框架文档，才能把临时聊天变成可教的东西。把 shell、hook、MCP 拆成独立示例后，边界就一目了然。我刻意优先清晰度而非生产级加固，这样示例复制到真项目里仍然顺手。
摄影：Christopher Gower，来源 Unsplash。
我发布了 cursor-agent-learning，当作刻意设计的实验场：文档加上可运行的 .cursor/ 示例，让智能体配置和代码库的其它部分一样——可版本管理、可写进文档、可以放心试错。
为什么是实验仓，而不是一篇博文
Cursor 提供多根操纵杆，决定智能体在仓库里如何表现。缺口往往不在于这些能力是否存在，而在于有没有一个地方能把它们放在一起试。我做这个项目，是为了读完概念就能切到可用的规则或 skill、做练习、调 hook，而不污染生产应用。目标是可重复的结构，而不是一次性演示。
仓库里有什么
文档是主轴：主 vibe coding 指南、速查、进阶主题（规则引用、多文件 skill、编排、审计与拦截类 hook）、排错、技巧、跨工具对照，以及一份较长的智能体框架文档，把流程和具体 skill 对上号。还有动手练习和可选日程（含 14 天路线和更短的强化版），让练习跟着概念走，而不是扫一眼就忘。
.cursor/ 下有示例规则（常驻、按文件、@ 提及）、用 /skill-name 调用的 skills、子智能体定义，以及从 hooks.json 接好的 hook 脚本。根目录与嵌套的 AGENTS.md 展示轻量项目说明如何与更深的定制并存。
核心交付类工作流
框架文档按软件如何真正交付来归类 skill：带「规划→实现→验证」的功能开发、带验证的修 bug、先调研再实现、以及偏安全的审查路径。对应课程里「核心交付」那一段（内部大纲的第一至四块），让你选路线时不必猜聊天里怎样算「做对」。
人工门禁与产品型生命周期
除了理想路径写代码，仓库还包含需要人明确点头再往下走的模式：带审批的发布、人机协同的从想法到落地，以及把需求、测试、反馈环当作叙事主体的敏捷式生命周期。到这里，智能体辅助不再假装团队只有一个人在线程里打字。
MCP、hook 与边界在哪
有专门一线讲 MCP 协助：拉文档、敏捷 + MCP 的组合，以及相关 skills，用来判断何时该让外部工具进环、何时仅靠仓库上下文就够。另一条线对比 shell、hook 脚本与 MCP 工具——三种触碰模型外世界的方式——用示例把取舍摆清楚，而不是停留在概念层。
磁盘上的记忆与长叙事
两种模式把会话边界往外推。本地 Markdown「记忆」类 skill 演示如何把笔记写进仓库里的文件、跨聊天保留，让智能体不必每次重学同一套约束。更完整的叙事 skill（project-vibe-master-workflow）用拆开的磁盘状态走通端到端故事，便于暂停、恢复，把工作当成项目日志而不是单条对话记录。
我现在怎么概括
规则定基线，skills 封装流程，子智能体隔离任务，AGENTS.md 把项目意图收在一个文件里，hooks 在护栏下把智能体接到你的工具链。这个仓库就是那些操纵杆的地图，附带可复制示例和一条学习路径——我想系统学习时会打开它，而不是指望下一条 prompt 能记住一切。