Agent Skills
› NeverSight/learn-skills.dev
› ac-spec-parser
ac-spec-parser
GitHub解析并验证YAML/JSON/Markdown格式的项目规范，提取结构化数据以支持功能生成与规划。适用于加载、校验、转换规格文件及提取需求场景。
Trigger Scenarios
加载YAML或JSON项目规范文件
验证项目结构是否符合Schema定义
从Markdown文档中提取功能与非功能需求
将不同格式的规格文件转换为统一结构化数据
Install
npx skills add NeverSight/learn-skills.dev --skill ac-spec-parser -g -y
SKILL.md
Frontmatter
{
"name": "ac-spec-parser",
"description": "Parse and validate project specifications. Use when loading YAML\/JSON specs, validating spec structure, extracting requirements, or converting between spec formats."
}
AC Spec Parser
Parse and validate project specifications for autonomous coding.
Purpose
Parses YAML/JSON/Markdown specifications into structured data for feature generation and planning.
Quick Start
from scripts.spec_parser import SpecParser
parser = SpecParser(project_dir)
spec = await parser.parse("spec.yaml")
print(spec.project_name)
print(spec.requirements)
Supported Formats
- YAML:
.yaml,.yml- Structured specifications - JSON:
.json- Machine-readable specs - Markdown:
.md- Human-readable specs with sections
Specification Schema
project:
name: "Project Name"
description: "What the project does"
type: "web-app|api|cli|library"
requirements:
functional:
- id: "REQ-001"
description: "User can login"
priority: "high|medium|low"
acceptance_criteria:
- "Valid credentials grant access"
- "Invalid credentials show error"
non_functional:
- id: "NFR-001"
description: "Response under 200ms"
category: "performance|security|usability"
technology:
language: "python|typescript|go"
framework: "fastapi|nextjs|gin"
database: "postgresql|mongodb"
constraints:
- "Must run on AWS"
- "Budget under $100/month"
Workflow
- Load: Read spec file from disk
- Parse: Convert to structured data
- Validate: Check required fields and schema
- Normalize: Standardize format for downstream use
- Export: Output to feature analyzer
Validation Rules
- Project name required
- At least one functional requirement
- All requirements have unique IDs
- Priority values are valid
- Technology stack is coherent
Integration
Used by:
ac-spec-generator: Generates feature list from parsed specac-feature-analyzer: Analyzes requirementsac-complexity-assessor: Estimates complexity
API Reference
See scripts/spec_parser.py for full implementation.
Version History
- e0220ca Current 2026-07-05 23:06
