什么是 HarnSpec？

更快交付，更高质量。人类和 AI 都能理解的精简 Spec。

HarnSpec 将敏捷原则引入 SDD（Spec 驱动开发）——小而聚焦的文档（<2,000 Token），让你和 AI 保持一致。

可以将其视为"项目管理的 Markdown"：简单、结构化、机器可读。

快速开始

# 尝试教程项目
npx harnspec init --example dark-theme
cd dark-theme && npm install && npm start

# 或添加到现有项目
npm install -g harnspec && harnspec init

可视化你的项目：

harnspec board    # 看板视图
harnspec stats    # 项目指标
harnspec ui       # Web UI 在 localhost:3000

下一步： 使用 AI 创建第一个 Spec（10 分钟教程）

为什么选择 HarnSpec？

高速度 + 高质量。 其他 SDD 框架增加了流程开销（多步骤工作流、僵化模板）。Vibe 编码很快但混乱（没有共识）。HarnSpec 找到了最佳平衡点：

• 快速迭代 - 随代码一起成长的活文档
• AI 性能 - 小 Spec = 更好的 AI 输出（上下文腐化是真实存在的）
• 始终最新 - 足够轻量，你真的会去更新它们

📖 与 Spec Kit、OpenSpec、Kiro 对比 →

功能特性

功能	描述
📊 看板	`harnspec board` - 可视化项目跟踪
🔍 智能搜索	`harnspec search` - 按内容或元数据查找 Spec
🔗 依赖关系	使用 `depends_on` 和 `related` 跟踪 Spec 关系
🎨 Web UI	`harnspec ui` - 基于浏览器的仪表板
📈 项目统计	`harnspec stats` - 健康指标和瓶颈检测
🤖 AI 原生	CLI + Agent Skills 用于 AI 助手

AI 集成

通过 CLI + Agent Skills 与任何 AI 编码助手（Claude Code, Cursor, Windsurf, GitHub Copilot 等）配合使用：

harnspec skill install

兼容： VS Code Copilot、Cursor、Windsurf、Claude Code、Gemini CLI 等。

📖 完整 AI 集成指南 →

你将获得什么

• 核心 CLI：管理 Spec、跟踪状态并可视化依赖关系。
• Agent Skills：教导 AI 助手如何运行 SDD 方法论。
• 可视化模式：用于浏览项目 Spec 图的精美 Web 界面。

一个简单示例

HarnSpec 只是一个带有 frontmatter 的 Markdown 文件：

./specs/001-user-auth-api/README.md

---
status: in-progress
created: 2025-11-07
priority: high
tags: [api, auth]
---

# 用户认证 API

## 目标
为移动应用启用安全的用户登录和会话管理。

## 关键场景
1. 用户使用邮箱/密码登录 → 接收 JWT Token
2. 用户使用 Token 访问受保护端点 → 获取数据
3. 用户 Token 过期 → 接收 401，必须重新认证

## 验收标准
- [ ] 登录端点在成功时返回有效的 JWT
- [ ] JWT 包含用户 ID 和过期时间
- [ ] 受保护端点验证 JWT 签名

## 非目标
- 社交登录（未来功能）
- 密码重置（单独的 Spec）

文档

📖 完整文档 · CLI 参考 · 第一原则 · 常见问题

社区

💬 讨论区 · 🐛 问题反馈 · 🤝 贡献指南

下一步

• 快速开始：安装 CLI 并创建你的第一个 Spec。
• 为什么选择 HarnSpec？：了解 HarnSpec 相对于其他工具的优势。
• 理解 HarnSpec：深入了解上下文经济 (Context Economy) 哲学。
• AI 集成：将 HarnSpec 连接到你的 AI 编码助手。