OpenSpec 入门指南:规范驱动的 AI 辅助开发

OpenSpec 入门指南:规范驱动的 AI 辅助开发 让 AI 辅助开发从「靠谱」到「确定」 前言 AI 编码助手(如 Claude Code、Cursor 等)功能强大,但当需求只存在于对话历史中时,AI 的输出往往不可预测。OpenSpec 正是为了解决这一问题而生的——它添加了一个轻量级的规范层,让开发者和 AI 在写代码之前先对齐「要做什么」。 1. 什么是 OpenSpec? 1.1 核心定位 OpenSpec 是一个规范驱动的开发框架(Spec-Driven Development, SDD),专门为 AI 编码助手设计。它的核心理念是: → fluid not rigid (灵活而非僵化) → iterative not waterfall(迭代而非瀑布) → easy not complex (简单而非复杂) → built for brownfield (支持存量项目) → scalable (从小项目到企业级) 1.2 解决什么问题? 传统开发 使用 OpenSpec AI 理解模糊,代码来回改 先对齐规范,再写代码 需求变更是「口头约定」 需求写入 spec文档,可追溯 AI 实现与预期不符 基于 artifacts 验证实现 多人协作时理解不一致 规范即文档,团队共享 1.3 核心优势 对齐后再开发 — 开发者和 AI 在代码编写前对齐需求 保持组织性 — 每个变更都有独立的文件夹,包含 proposal、specs、design、tasks 工作流畅 — 随时更新任何 artifact,不受严格阶段限制 工具无关 — 支持 20+ 款 AI 编码助手 2. 快速开始 2.1 环境要求 Node.js 20.19.0 或更高版本 2.2 安装与初始化 # 全局安装 OpenSpec npm install -g @fission-ai/openspec@latest # 进入你的项目目录并初始化 cd your-project openspec init 提示: OpenSpec 也支持 pnpm、yarn、bun 和 nix。详见官方安装文档。 ...

May 17, 2026 · iyangming

Claude Skills 入门与进阶指南

Claude Skills 入门与进阶指南 解锁 Claude 的专业化能力 前言 Claude 是一款强大的 AI 助手,但当遇到专业领域任务时,默认能力可能不够精准。Skills(技能) 系统让你可以给 Claude 加载特定的指令集,让它在特定任务上表现出专家级水平。 本文基于 Anthropic Skills 仓库 的开源实现,带你从零掌握 Skills 的概念、用法和创建方法。 1. 什么是 Skills? 1.1 核心概念 Skills 是包含指令、脚本和资源的文件夹,Claude 会动态加载它们来提升在特定任务上的表现。Skills 教会 Claude 如何以可重复的方式完成特定任务,例如: 按照公司品牌指南创建文档 使用组织特定的工作流程分析数据 自动化个人任务 1.2 Skills vs 普通提示 对比项 普通对话 使用 Skills 每次任务 重复说明要求 自动加载专业指令 知识一致性 依赖每次描述 规范化、专业化 触发方式 手动描述 自动识别场景 可复用性 低 高,开箱即用 1.3 工作原理 Skills 使用渐进式披露(Progressive Disclosure)三层加载: ┌────────────────────────────────────────────┐ │ Layer 1: Metadata(name + description) │ │ ~100 words,常驻上下文 │ ├────────────────────────────────────────────┤ │ Layer 2: SKILL.md body │ │ <500 行,技能触发时加载 │ ├────────────────────────────────────────────┤ │ Layer 3: Bundled Resources(脚本/资源) │ │ 按需加载,脚本可直接执行 │ └────────────────────────────────────────────┘ 2. 快速开始 2.1 在 Claude Code 中使用 Claude Code 支持插件市场,可以直接安装官方 Skills: ...

May 17, 2026 · iyangming

Awesome Claude Code 指南:海量资源一网打尽

Awesome Claude Code 指南:海量资源一网打尽 来自 44K+ Stars 的 Claude Code 资源宝库 前言 Awesome Claude Code 是一个精心策划的 Claude Code 资源集合,包含高质量的 Skills、Agents、Hooks、Status Lines、Orchestrators、开发工具,以及 Claude Code 团队持续推出的新功能。 这个仓库获得了 44K+ Stars,证明了它在开发者社区的受欢迎程度。本文将带你全面了解这个资源宝库。 1. 仓库概览 指标 数值 Stars 44,000+ Forks 3,700+ 资源数量 500+ 分类 Skills、Agents、Hooks、Slash Commands 等 2. 资源分类 2.1 Agent Skills(智能体技能) Agent Skills 是 Claude Code 的核心扩展,让 Claude 在特定任务上表现出专家级水平。 热门 Skills: Skill 作者 说明 AgentSys avifenesh 工作流自动化系统,包含插件、agents 和 skills Book Factory Robert Guss 完整的书籍创作流水线 Skills Claude Code MCP Enhanced - 增强的 MCP 服务器集成 2.2 Slash Commands(斜杠命令) 通过斜杠命令快速执行特定任务。 ...

May 17, 2026 · iyangming