Speclint是什么
Speclint 是一款专注于需求规范文档质量评估的工具。它在 AI 助手介入之前，从五个关键维度对需求规范进行评分，分数范围为 0-100，帮助团队在项目初期发现潜在问题。不同于依赖 AI 的模糊判断，Speclint 使用确定性的正则表达式进行评分，避免 AI 幻觉带来的误判，确保结果的可重复性和客观性。
该工具不仅提供网页端使用，还支持命令行（CLI）、GitHub Action 自动化集成，以及 MCP 服务端部署，方便开发者和团队灵活应用。
Speclint的核心优势
- 无 AI 幻觉干扰：完全基于正则表达式匹配，评分结果稳定可靠。
- 五个维度评分：涵盖清晰度、一致性、完整性、可验证性和格式规范。
- 支持多种使用方式：
- Web 端直接使用
- CLI 本地运行
- GitHub Action 集成至 CI/CD 流程
- MCP 服务端部署
适用人群
产品经理与需求分析师
适合用于撰写需求文档后进行自检，确保需求表述清晰、无歧义。
开发与测试团队
可帮助在开发前识别需求模糊或缺失的问题，减少后期返工。
DevOps 与自动化团队
借助 GitHub Action 或 MCP 服务端集成，可将需求评分自动化嵌入开发流程，提高整体协作效率。
使用方式对比
| 使用方式 | 特点 | 适用场景 |
|---|---|---|
| Web 端 | 简单易用，无需安装 | 个人快速评分 |
| CLI | 本地运行，适合集成脚本 | 团队内部流程自动化 |
| GitHub Action | 自动化评分，支持 PR 检查 | CI/CD 流程中的质量门禁 |
| MCP 服务端 | 企业级部署，支持内部网络使用 | 保密项目或大规模团队协作 |
评分维度简析
Speclint 从以下五个方面对需求规范进行系统性评分：
- 清晰度：需求是否表达明确，无歧义。
- 一致性：术语和描述是否统一、逻辑连贯。
- 完整性：是否涵盖所有关键信息和边界条件。
- 可验证性：是否可以被测试用例覆盖和验证。
- 格式规范：是否遵循标准格式和文档结构。
这些维度通过预设规则和正则表达式进行检测，帮助用户建立标准化、高质量的需求文档体系。