@optima-chat/optima-agent 0.5.0 → 0.5.1

package/dist/src/validation/yaml-validator.d.ts

@@ -0,0 +1,25 @@
+import type { Validator, ValidationResult } from "./types.js";
+import { type SkillYamlFrontmatter } from "./schema.js";
+export declare class YamlValidator implements Validator<SkillYamlFrontmatter> {
+    /**
+     * 从内容中提取 YAML frontmatter
+     */
+    private extractFrontmatter;
+    /**
+     * 解析 YAML 内容
+     */
+    private parseYaml;
+    /**
+     * 从 YAML 错误中提取行号
+     */
+    private extractLineNumber;
+    /**
+     * 验证 YAML frontmatter
+     */
+    validate(content: string, filePath: string): ValidationResult;
+    /**
+     * 解析配置（验证成功后调用）
+     */
+    parse(content: string): SkillYamlFrontmatter | null;
+}
+//# sourceMappingURL=yaml-validator.d.ts.map

package/dist/src/validation/yaml-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/yaml-validator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQpF,qBAAa,aAAc,YAAW,SAAS,CAAC,oBAAoB,CAAC;IACnE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAmH7D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;CAiBpD"}

package/dist/src/validation/yaml-validator.js

@@ -0,0 +1,177 @@
+/**
+ * YAML 配置验证器
+ */
+import yaml from "js-yaml";
+import { ZodError } from "zod";
+import { SkillYamlFrontmatterSchema } from "./schema.js";
+import { generateSuggestionsFromZodError, generateYamlSyntaxSuggestions, generateSkillConfigSuggestions, } from "./suggestions.js";
+export class YamlValidator {
+    /**
+     * 从内容中提取 YAML frontmatter
+     */
+    extractFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            return null;
+        }
+        return {
+            yaml: match[1],
+            line: 1, // frontmatter 从第一行开始
+        };
+    }
+    /**
+     * 解析 YAML 内容
+     */
+    parseYaml(yamlContent) {
+        try {
+            const data = yaml.load(yamlContent);
+            return { data };
+        }
+        catch (error) {
+            return { data: null, error: error };
+        }
+    }
+    /**
+     * 从 YAML 错误中提取行号
+     */
+    extractLineNumber(error) {
+        // js-yaml 的错误消息通常包含 "at line X, column Y"
+        const match = error.message.match(/at line (\d+)/);
+        if (match) {
+            return parseInt(match[1], 10);
+        }
+        return undefined;
+    }
+    /**
+     * 验证 YAML frontmatter
+     */
+    validate(content, filePath) {
+        const errors = [];
+        const warnings = [];
+        // 1. 检查是否存在 frontmatter
+        const frontmatter = this.extractFrontmatter(content);
+        if (!frontmatter) {
+            errors.push({
+                type: "syntax",
+                filePath,
+                message: "未找到 YAML frontmatter",
+                details: "SKILL.md 文件应该以 YAML frontmatter 开头（用 --- 包裹）",
+                suggestions: [
+                    "在文件开头添加 YAML frontmatter",
+                    "格式应为: ---\\n配置内容\\n---",
+                    "参考示例: .claude/skills/planning-with-files/SKILL.md",
+                ],
+                examplePath: ".claude/skills/planning-with-files/SKILL.md",
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 2. 解析 YAML
+        const { data, error: yamlError } = this.parseYaml(frontmatter.yaml);
+        if (yamlError) {
+            const line = this.extractLineNumber(yamlError);
+            errors.push({
+                type: "syntax",
+                filePath,
+                message: "YAML 语法错误",
+                details: yamlError.message,
+                line,
+                suggestions: generateYamlSyntaxSuggestions(yamlError.message),
+                examplePath: ".claude/skills/planning-with-files/SKILL.md",
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 3. 使用 Zod 验证 schema
+        try {
+            SkillYamlFrontmatterSchema.parse(data);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                for (const issue of error.issues) {
+                    const zodSuggestions = generateSuggestionsFromZodError(error);
+                    const skillSuggestions = generateSkillConfigSuggestions(issue.path.map(String));
+                    errors.push({
+                        type: "schema",
+                        filePath,
+                        message: issue.message,
+                        path: issue.path.map(String),
+                        suggestions: [...zodSuggestions, ...skillSuggestions],
+                        examplePath: ".claude/skills/planning-with-files/SKILL.md",
+                    });
+                }
+            }
+            else {
+                errors.push({
+                    type: "schema",
+                    filePath,
+                    message: "未知的验证错误",
+                    details: String(error),
+                    suggestions: ["请检查配置文件格式"],
+                });
+            }
+            return { valid: false, errors, warnings };
+        }
+        // 4. 语义检查和警告
+        if (!data.description) {
+            warnings.push({
+                type: "semantic",
+                filePath,
+                message: "建议添加 description 字段",
+                suggestions: ["description 可以帮助用户理解 skill 的功能", "建议填写清晰的功能描述"],
+            });
+        }
+        // 检查 hooks 中的命令
+        if (data.hooks) {
+            for (const [eventType, configs] of Object.entries(data.hooks)) {
+                if (Array.isArray(configs)) {
+                    for (const config of configs) {
+                        if (config.hooks) {
+                            for (const hook of config.hooks) {
+                                if (hook.command && hook.command.includes("${CLAUDE_PLUGIN_ROOT}")) {
+                                    // 检查命令中的路径引用
+                                    const scriptPath = hook.command.match(/\$\{CLAUDE_PLUGIN_ROOT\}\/(.+?)(?:\s|$)/)?.[1];
+                                    if (scriptPath) {
+                                        warnings.push({
+                                            type: "semantic",
+                                            filePath,
+                                            message: `确保脚本文件存在: ${scriptPath}`,
+                                            path: ["hooks", eventType, "hooks", "command"],
+                                            suggestions: [
+                                                "检查脚本文件是否在 skill 目录中",
+                                                "确保脚本文件有执行权限（chmod +x）",
+                                            ],
+                                        });
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * 解析配置（验证成功后调用）
+     */
+    parse(content) {
+        const frontmatter = this.extractFrontmatter(content);
+        if (!frontmatter) {
+            return null;
+        }
+        const { data, error } = this.parseYaml(frontmatter.yaml);
+        if (error) {
+            return null;
+        }
+        try {
+            return SkillYamlFrontmatterSchema.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=yaml-validator.js.map

package/dist/src/validation/yaml-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-validator.js","sourceRoot":"","sources":["../../../src/validation/yaml-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",