@hmharness/agent 0.14.15 → 0.14.16

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export { buildSystemPrompt } from './prompt.ts';
 export { strings, type Locale, type Strings } from './i18n.ts';
 export { makeSpawnTool, MAX_SPAWN_DEPTH, type SpawnBase } from './spawn.ts';
 export { buildRegistry, contextPack, makeApproval, nativeRegistry, runAgentTask, spawnBase, toServerConfig, type AgentTaskOptions, type RunnerEvents, } from './runner.ts';
+export * from './skills-conformance.ts';

package/dist/index.js

@@ -6,3 +6,4 @@ export { buildSystemPrompt } from "./prompt.js";
 export { strings } from "./i18n.js";
 export { makeSpawnTool, MAX_SPAWN_DEPTH } from "./spawn.js";
 export { buildRegistry, contextPack, makeApproval, nativeRegistry, runAgentTask, spawnBase, toServerConfig, } from "./runner.js";
+export * from "./skills-conformance.js";

package/dist/skills-conformance.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @hmharness/agent - Agent Skills Conformance (P1-06)
+ *
+ * The audit called for: "官方 SKILL.md 格式 + scripts/references/assets +
+ * cross-runtime fixtures"
+ *
+ * Validates skill definitions against the Agent Skills spec so they can
+ * migrate across hmharness / Codex / Claude Code / Goose / other clients.
+ */
+export interface SkillManifest {
+    name: string;
+    description: string;
+    /** optional metadata */
+    version?: string;
+    /** entry point script (relative to skill dir) */
+    entry?: string;
+    /** supported file structure */
+    files: {
+        'SKILL.md': boolean;
+        'scripts/'?: boolean;
+        'references/'?: boolean;
+        'assets/'?: boolean;
+    };
+}
+export interface ConformanceResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    /** conformance level achieved */
+    level: 'full' | 'partial' | 'none';
+}
+/**
+ * Validate a SKILL.md content against the Agent Skills format.
+ * Pure - testable.
+ */
+export declare function validateSkillMd(content: string): ConformanceResult;
+/**
+ * Check a skill directory structure for conformance.
+ * Pure - testable.
+ */
+export declare function validateSkillStructure(files: string[]): ConformanceResult;
+/**
+ * Generate a cross-runtime compatibility report for a skill.
+ * Pure - testable.
+ */
+export declare function crossRuntimeReport(skill: {
+    name: string;
+    hasSkillMd: boolean;
+    hasScripts: boolean;
+    hasReferences: boolean;
+    hasAssets: boolean;
+    entryLanguage?: string;
+}): string;

package/dist/skills-conformance.js

@@ -0,0 +1,77 @@
+/**
+ * @hmharness/agent - Agent Skills Conformance (P1-06)
+ *
+ * The audit called for: "官方 SKILL.md 格式 + scripts/references/assets +
+ * cross-runtime fixtures"
+ *
+ * Validates skill definitions against the Agent Skills spec so they can
+ * migrate across hmharness / Codex / Claude Code / Goose / other clients.
+ */
+/**
+ * Validate a SKILL.md content against the Agent Skills format.
+ * Pure - testable.
+ */
+export function validateSkillMd(content) {
+    const errors = [];
+    const warnings = [];
+    // must have YAML-like frontmatter
+    if (!content.startsWith('---')) {
+        errors.push('SKILL.md must start with YAML frontmatter (---)');
+    }
+    else {
+        const end = content.indexOf('---', 3);
+        if (end === -1) {
+            errors.push('SKILL.md frontmatter not closed');
+        }
+        else {
+            const fm = content.slice(3, end);
+            if (!/name\s*:/.test(fm))
+                errors.push('frontmatter missing "name" field');
+            if (!/description\s*:/.test(fm))
+                errors.push('frontmatter missing "description" field');
+        }
+    }
+    // must have some content after frontmatter
+    const body = content.replace(/^---[\s\S]*?---/, '').trim();
+    if (body.length < 10)
+        warnings.push('SKILL.md body is very short (<10 chars)');
+    // check for common sections
+    if (!/## (usage|how to use|instructions)/i.test(body))
+        warnings.push('no usage/instructions section found');
+    const valid = errors.length === 0;
+    const level = valid ? (warnings.length === 0 ? 'full' : 'partial') : 'none';
+    return { valid, errors, warnings, level };
+}
+/**
+ * Check a skill directory structure for conformance.
+ * Pure - testable.
+ */
+export function validateSkillStructure(files) {
+    const errors = [];
+    const warnings = [];
+    if (!files.includes('SKILL.md'))
+        errors.push('SKILL.md not found');
+    if (!files.some(f => f.startsWith('scripts/')))
+        warnings.push('no scripts/ directory (optional but recommended)');
+    if (!files.some(f => f.startsWith('references/')))
+        warnings.push('no references/ directory (optional)');
+    const valid = errors.length === 0;
+    const level = valid ? (warnings.length === 0 ? 'full' : 'partial') : 'none';
+    return { valid, errors, warnings, level };
+}
+/**
+ * Generate a cross-runtime compatibility report for a skill.
+ * Pure - testable.
+ */
+export function crossRuntimeReport(skill) {
+    const lines = [`Skill: ${skill.name}`];
+    lines.push(`  SKILL.md: ${skill.hasSkillMd ? '✅' : '❌'} (required)`);
+    lines.push(`  scripts/: ${skill.hasScripts ? '✅' : '⚠️ optional'}`);
+    lines.push(`  references/: ${skill.hasReferences ? '✅' : '⚠️ optional'}`);
+    lines.push(`  assets/: ${skill.hasAssets ? '✅' : '⚠️ optional'}`);
+    if (skill.entryLanguage)
+        lines.push(`  entry: ${skill.entryLanguage}`);
+    const compatible = skill.hasSkillMd;
+    lines.push(`  Cross-runtime: ${compatible ? '✅ compatible with Agent Skills spec' : '❌ not compatible'}`);
+    return lines.join('\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.14.15",
+  "version": "0.14.16",
   "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
   "type": "module",
   "main": "dist/index.js",