hicaosen/generator
plugins/quickspec/skills/generator/SKILL.md
将产品需求文档（PRD）转化为精确的、编码 Agent 可直接执行的实现规格文档。 触发：用户要生成 spec / 规格文档 / 实现方案，或要把 PRD 转成可执行规格。 不触发：写 PRD、改 PRD、代码 review、或非文档生成任务。
data-ai
Updated Apr 28, 2026
$ install --global
skillsauthnpx skillsauth add hicaosen/skills generatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 28, 2026, 3:49 AM121.8s1 file scanned
SKILL.md
- name:
- generator
- description:
- >
- argument-hint:
- <PRD 来源：文件路径 | 文本内容>
Spec 生成工作流
将产品需求文档（PRD）转化为精确的、编码 Agent 可直接执行的实现规格文档。
执行原则
- 严格按步骤顺序执行 — 不跳步、不并行
- 编排器只做调度 — 调用子 skill → 读取返回状态 → 分支决策 → 用户确认
- 质量门禁由子 skill 自行负责 — 编排器不读质量门禁文件、不核对检查项、不修复产出
- 检查点必须暂停 — 等待用户明确确认后才继续
- 每步产出物写入文件 — 子 skill 写入文件，后续步骤的子 skill 从文件读取输入
执行流程
初始化
- 使用 Bash 工具生成 6 位随机字符：
openssl rand -hex 3 - 创建工作目录：
mkdir -p specs/spec-{随机字符}/ - 定义
{workspace}变量为工作目录的绝对路径 - 使用 TaskCreate 创建 5 个 task
调度循环
对每个步骤，执行以下流程：
调用子 skill：
Task 1 (prd-loader): 传入 "{workspace} {用户原始输入}" 作为参数
其他 Task: 传入 {workspace} 绝对路径作为参数
读取子 skill 返回值中的 [STATUS] 字段：
success → TaskUpdate completed → 如果有检查点，展示 [SUMMARY] 并等待用户确认 → 下一步
partial → 展示 [SUMMARY] 和 [WARNINGS]，AskUserQuestion 询问：
用户继续 → TaskUpdate completed → 检查点检查 → 下一步
用户要求修正 → 根据用户指导调整后重新执行当前步骤
用户放弃 → 终止工作流
failed → 展示 [SUMMARY] 和 [ISSUES]，AskUserQuestion 询问：
用户选择重试 → 重新调用当前步骤的子 skill
用户放弃 → 终止工作流
Task 1 完成后，从返回值中读取 [FEATURE-NAME]，供后续步骤引用。
检查点步骤: Task 2 (prd-analyzer), Task 3 (codebase-mapper), Task 5 (spec-reviewer)
无检查点步骤: Task 1 (prd-loader), Task 4 (spec-creator)
步骤与内部 skill 的对应关系
| 步骤 | 内部 skill | 输入文件 | 输出文件 | 检查点 |
|------|-----------|----------|----------|--------|
| Task 1: 加载 PRD | prd-loader | 用户原始输入 | prd-source.md | — |
| Task 2: PRD 分析 | prd-analyzer | prd-source.md | prd-analysis.md | 用户确认分析结果 |
| Task 3: 代码库映射 | codebase-mapper | prd-analysis.md | codebase-mapping.md | 用户确认映射结果 |
| Task 4: 生成规格 | spec-creator | prd-analysis.md + codebase-mapping.md | {feature-name}-spec.md | — |
| Task 5: 质量审查 | spec-reviewer | prd-source.md + prd-analysis.md + {feature-name}-spec.md | review-report.md | 展示审查结果 |
所有输入输出文件路径相对于 {workspace}。
Task 5 返工处理
如果 spec-reviewer 返回的 STATUS 为 failed（即审查结论为 NEEDS_REVISION）：
- 使用 Skill 工具重新调用
spec-creator，传入{workspace}路径- spec-creator 会检测到
review-report.md存在，自动进入返工模式
- spec-creator 会检测到
- 读取 spec-creator 返回值中的 [STATUS]
- 如果仍然 failed，向用户报告并请求指导（不做第二次返工）
返工后不再重新执行 spec-reviewer 审查，信任 spec-creator 的质量门禁自检和 review-report 中的修复指导。
输出交付（编排器直接执行）
所有步骤完成后，编排器直接执行交付：
- 读取
{workspace}/review-report.md，确认审查结论为 PASS 或 PASS_WITH_NOTES - 从
{workspace}/prd-source.md元数据头获取feature-name - 确认输出路径（默认
specs/{feature-name}-spec.md） - 如果 specs/ 目录不存在，使用 Bash 创建
- 将
{workspace}/{feature-name}-spec.md的内容复制到输出路径 - 向用户展示：
- 输出文件路径
- 工作目录路径（包含所有中间产出物）
- spec 文档摘要（功能数量、任务数量）
- 提示用户可以将此 spec 交给 coding agent 执行
内部 skill 调用方式
本工作流的内部 skill（prd-loader、prd-analyzer、codebase-mapper、spec-creator、spec-reviewer）不为用户独立调用而设计。编排器通过以下方式使用它们：
- 使用 Skill 工具 调用
{skill-name}prd-loader：传入{workspace} {用户原始输入}- 其他子 skill：传入
{workspace}绝对路径
- 各步骤 skill 均设置了
context: fork，在独立的上下文窗口中执行 - 子代理通过
$ARGUMENTS获取参数，从文件读取输入、写入产出文件 - 子代理完成后返回结构化状态：
[STATUS]、[OUTPUT]、[FEATURE-NAME]、[WARNINGS]、[ISSUES]、[SUMMARY]- 编排器仅消费
[STATUS]、[FEATURE-NAME]、[SUMMARY]、[WARNINGS]、[ISSUES]，[OUTPUT]字段用于日志和调试
- 编排器仅消费
- 编排器根据返回状态做调度决策，不做质量门禁核对
依赖
prd-loader— PRD 内容加载（步骤 1）prd-analyzer— PRD 5-zone 分析（步骤 2）codebase-mapper— 代码库上下文映射（步骤 3）spec-creator— 规格文档生成（步骤 4，含返工模式）spec-reviewer— 规格文档质量审查（步骤 5）
Related Skills
hicaosen/victoriatraces-api
development
VerifiedTrustedCommunity
VictoriaTraces HTTP API reference for querying distributed traces via Jaeger-compatible API. This skill should be used when searching traces, listing services/operations, getting trace details by ID, querying service dependencies, constructing HTTP requests to VictoriaTraces, or working with Jaeger API endpoints for distributed tracing analysis.
SKILL.mdUpdated Apr 28, 2026
hicaosen/victoriametrics-api
development
VerifiedTrustedCommunity
VictoriaMetrics HTTP API reference for querying metrics, exporting/importing data, TSDB stats, and administrative operations. This skill should be used when constructing HTTP requests to VictoriaMetrics, understanding query endpoints (/api/v1/query, /api/v1/query_range, /api/v1/export, /api/v1/import), response formats, checking cardinality, creating snapshots, or integrating with VictoriaMetrics API.
SKILL.mdUpdated Apr 28, 2026
hicaosen/victorialogs-api
development
VerifiedTrustedCommunity
VictoriaLogs HTTP API reference for querying logs, hits stats, field discovery, live tailing, and log statistics. This skill should be used when constructing HTTP requests to VictoriaLogs, understanding query endpoints (/select/logsql/query, /select/logsql/tail, /select/logsql/hits, /select/logsql/field_names), response formats, or integrating with VictoriaLogs API for log search and analysis.
SKILL.mdUpdated Apr 28, 2026
hicaosen/promql
testing
VerifiedTrustedCommunity
PromQL query language fundamentals for Prometheus and Prometheus-compatible systems. Use for understanding PromQL instant/range vectors, label matchers, aggregation operators, offset/@ modifiers, or when targeting non-VictoriaMetrics Prometheus systems. For VictoriaMetrics-specific features like default_rollup, rollup, or outlier detection, use the metricsql skill.
SKILL.mdUpdated Apr 28, 2026