@liangjie559567/ultrapower 5.6.0 → 5.6.2

package/scripts/validate-skill-frontmatter.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+
+const skillsDir = 'skills';
+const errors = [];
+
+const dirs = readdirSync(skillsDir, { withFileTypes: true })
+  .filter(d => d.isDirectory())
+  .map(d => d.name);
+
+for (const dir of dirs) {
+  const skillPath = join(skillsDir, dir, 'SKILL.md');
+  try {
+    const content = readFileSync(skillPath, 'utf-8');
+
+    if (!content.startsWith('---')) {
+      errors.push(`${dir}: Missing frontmatter`);
+      continue;
+    }
+
+    const frontmatterEnd = content.indexOf('---', 3);
+    if (frontmatterEnd === -1) {
+      errors.push(`${dir}: Unclosed frontmatter`);
+      continue;
+    }
+
+    const frontmatter = content.slice(3, frontmatterEnd);
+
+    if (!frontmatter.includes('name:')) {
+      errors.push(`${dir}: Missing 'name' field`);
+    }
+    if (!frontmatter.includes('description:')) {
+      errors.push(`${dir}: Missing 'description' field`);
+    }
+  } catch (err) {
+    errors.push(`${dir}: ${err.message}`);
+  }
+}
+
+if (errors.length > 0) {
+  console.error('❌ Skill frontmatter validation failed:\n');
+  errors.forEach(e => console.error(`  - ${e}`));
+  process.exit(1);
+}
+
+console.log(`✅ All ${dirs.length} skills have valid frontmatter`);

package/skills/release/SKILL.md

@@ -35,11 +35,12 @@ description: ultrapower 的自动化发布工作流
 > ⚠️ `CLAUDE.md` 是开发规范文档，版本引用不同步会导致开发者参考错误的规范版本。
 > ⚠️ `docs/REFERENCE.md` 存在两处数量声明（TOC 第 12 行 + 正文第 280 行），新增 skill/agent/hook 时必须同步更新两处，否则会出现文档内部不一致（k-047）。
 
-### 2. 运行测试
+### 2. 运行测试和验证
 ```bash
 npm run test:run
+npm run validate:skills
 ```
-继续前所有 231+ 个测试必须通过。
+所有测试必须通过，所有 skill 必须有有效的 frontmatter。
 
 ### 3. 提交版本升级
 ```bash
@@ -78,9 +79,10 @@ claude plugin marketplace update omc
 
 ### 6. 发布到 npm（CI 已自动完成，手动备用）
 ```bash
-npm publish --access public
+npm publish --access public --no-provenance
 ```
 > ⚠️ npm 不允许覆盖已发布版本，版本号必须先升级再发布。
+> ⚠️ `--provenance` 仅在 GitHub Actions 中可用，本地发布必须使用 `--no-provenance`。
 
 ### 7. 创建 GitHub Release（CI 已自动完成，手动备用）
 ```bash

package/skills/writing-skills/graphviz-conventions.dot

@@ -1,172 +1,172 @@
-digraph STYLE_GUIDE {
-    // The style guide for our process DSL, written in the DSL itself
-
-    // Node type examples with their shapes
-    subgraph cluster_node_types {
-        label="NODE TYPES AND SHAPES";
-
-        // Questions are diamonds
-        "Is this a question?" [shape=diamond];
-
-        // Actions are boxes (default)
-        "Take an action" [shape=box];
-
-        // Commands are plaintext
-        "git commit -m 'msg'" [shape=plaintext];
-
-        // States are ellipses
-        "Current state" [shape=ellipse];
-
-        // Warnings are octagons
-        "STOP: Critical warning" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-
-        // Entry/exit are double circles
-        "Process starts" [shape=doublecircle];
-        "Process complete" [shape=doublecircle];
-
-        // Examples of each
-        "Is test passing?" [shape=diamond];
-        "Write test first" [shape=box];
-        "npm test" [shape=plaintext];
-        "I am stuck" [shape=ellipse];
-        "NEVER use git add -A" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-    }
-
-    // Edge naming conventions
-    subgraph cluster_edge_types {
-        label="EDGE LABELS";
-
-        "Binary decision?" [shape=diamond];
-        "Yes path" [shape=box];
-        "No path" [shape=box];
-
-        "Binary decision?" -> "Yes path" [label="yes"];
-        "Binary decision?" -> "No path" [label="no"];
-
-        "Multiple choice?" [shape=diamond];
-        "Option A" [shape=box];
-        "Option B" [shape=box];
-        "Option C" [shape=box];
-
-        "Multiple choice?" -> "Option A" [label="condition A"];
-        "Multiple choice?" -> "Option B" [label="condition B"];
-        "Multiple choice?" -> "Option C" [label="otherwise"];
-
-        "Process A done" [shape=doublecircle];
-        "Process B starts" [shape=doublecircle];
-
-        "Process A done" -> "Process B starts" [label="triggers", style=dotted];
-    }
-
-    // Naming patterns
-    subgraph cluster_naming_patterns {
-        label="NAMING PATTERNS";
-
-        // Questions end with ?
-        "Should I do X?";
-        "Can this be Y?";
-        "Is Z true?";
-        "Have I done W?";
-
-        // Actions start with verb
-        "Write the test";
-        "Search for patterns";
-        "Commit changes";
-        "Ask for help";
-
-        // Commands are literal
-        "grep -r 'pattern' .";
-        "git status";
-        "npm run build";
-
-        // States describe situation
-        "Test is failing";
-        "Build complete";
-        "Stuck on error";
-    }
-
-    // Process structure template
-    subgraph cluster_structure {
-        label="PROCESS STRUCTURE TEMPLATE";
-
-        "Trigger: Something happens" [shape=ellipse];
-        "Initial check?" [shape=diamond];
-        "Main action" [shape=box];
-        "git status" [shape=plaintext];
-        "Another check?" [shape=diamond];
-        "Alternative action" [shape=box];
-        "STOP: Don't do this" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-        "Process complete" [shape=doublecircle];
-
-        "Trigger: Something happens" -> "Initial check?";
-        "Initial check?" -> "Main action" [label="yes"];
-        "Initial check?" -> "Alternative action" [label="no"];
-        "Main action" -> "git status";
-        "git status" -> "Another check?";
-        "Another check?" -> "Process complete" [label="ok"];
-        "Another check?" -> "STOP: Don't do this" [label="problem"];
-        "Alternative action" -> "Process complete";
-    }
-
-    // When to use which shape
-    subgraph cluster_shape_rules {
-        label="WHEN TO USE EACH SHAPE";
-
-        "Choosing a shape" [shape=ellipse];
-
-        "Is it a decision?" [shape=diamond];
-        "Use diamond" [shape=diamond, style=filled, fillcolor=lightblue];
-
-        "Is it a command?" [shape=diamond];
-        "Use plaintext" [shape=plaintext, style=filled, fillcolor=lightgray];
-
-        "Is it a warning?" [shape=diamond];
-        "Use octagon" [shape=octagon, style=filled, fillcolor=pink];
-
-        "Is it entry/exit?" [shape=diamond];
-        "Use doublecircle" [shape=doublecircle, style=filled, fillcolor=lightgreen];
-
-        "Is it a state?" [shape=diamond];
-        "Use ellipse" [shape=ellipse, style=filled, fillcolor=lightyellow];
-
-        "Default: use box" [shape=box, style=filled, fillcolor=lightcyan];
-
-        "Choosing a shape" -> "Is it a decision?";
-        "Is it a decision?" -> "Use diamond" [label="yes"];
-        "Is it a decision?" -> "Is it a command?" [label="no"];
-        "Is it a command?" -> "Use plaintext" [label="yes"];
-        "Is it a command?" -> "Is it a warning?" [label="no"];
-        "Is it a warning?" -> "Use octagon" [label="yes"];
-        "Is it a warning?" -> "Is it entry/exit?" [label="no"];
-        "Is it entry/exit?" -> "Use doublecircle" [label="yes"];
-        "Is it entry/exit?" -> "Is it a state?" [label="no"];
-        "Is it a state?" -> "Use ellipse" [label="yes"];
-        "Is it a state?" -> "Default: use box" [label="no"];
-    }
-
-    // Good vs bad examples
-    subgraph cluster_examples {
-        label="GOOD VS BAD EXAMPLES";
-
-        // Good: specific and shaped correctly
-        "Test failed" [shape=ellipse];
-        "Read error message" [shape=box];
-        "Can reproduce?" [shape=diamond];
-        "git diff HEAD~1" [shape=plaintext];
-        "NEVER ignore errors" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
-
-        "Test failed" -> "Read error message";
-        "Read error message" -> "Can reproduce?";
-        "Can reproduce?" -> "git diff HEAD~1" [label="yes"];
-
-        // Bad: vague and wrong shapes
-        bad_1 [label="Something wrong", shape=box];  // Should be ellipse (state)
-        bad_2 [label="Fix it", shape=box];  // Too vague
-        bad_3 [label="Check", shape=box];  // Should be diamond
-        bad_4 [label="Run command", shape=box];  // Should be plaintext with actual command
-
-        bad_1 -> bad_2;
-        bad_2 -> bad_3;
-        bad_3 -> bad_4;
-    }
+digraph STYLE_GUIDE {
+    // The style guide for our process DSL, written in the DSL itself
+
+    // Node type examples with their shapes
+    subgraph cluster_node_types {
+        label="NODE TYPES AND SHAPES";
+
+        // Questions are diamonds
+        "Is this a question?" [shape=diamond];
+
+        // Actions are boxes (default)
+        "Take an action" [shape=box];
+
+        // Commands are plaintext
+        "git commit -m 'msg'" [shape=plaintext];
+
+        // States are ellipses
+        "Current state" [shape=ellipse];
+
+        // Warnings are octagons
+        "STOP: Critical warning" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+
+        // Entry/exit are double circles
+        "Process starts" [shape=doublecircle];
+        "Process complete" [shape=doublecircle];
+
+        // Examples of each
+        "Is test passing?" [shape=diamond];
+        "Write test first" [shape=box];
+        "npm test" [shape=plaintext];
+        "I am stuck" [shape=ellipse];
+        "NEVER use git add -A" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+    }
+
+    // Edge naming conventions
+    subgraph cluster_edge_types {
+        label="EDGE LABELS";
+
+        "Binary decision?" [shape=diamond];
+        "Yes path" [shape=box];
+        "No path" [shape=box];
+
+        "Binary decision?" -> "Yes path" [label="yes"];
+        "Binary decision?" -> "No path" [label="no"];
+
+        "Multiple choice?" [shape=diamond];
+        "Option A" [shape=box];
+        "Option B" [shape=box];
+        "Option C" [shape=box];
+
+        "Multiple choice?" -> "Option A" [label="condition A"];
+        "Multiple choice?" -> "Option B" [label="condition B"];
+        "Multiple choice?" -> "Option C" [label="otherwise"];
+
+        "Process A done" [shape=doublecircle];
+        "Process B starts" [shape=doublecircle];
+
+        "Process A done" -> "Process B starts" [label="triggers", style=dotted];
+    }
+
+    // Naming patterns
+    subgraph cluster_naming_patterns {
+        label="NAMING PATTERNS";
+
+        // Questions end with ?
+        "Should I do X?";
+        "Can this be Y?";
+        "Is Z true?";
+        "Have I done W?";
+
+        // Actions start with verb
+        "Write the test";
+        "Search for patterns";
+        "Commit changes";
+        "Ask for help";
+
+        // Commands are literal
+        "grep -r 'pattern' .";
+        "git status";
+        "npm run build";
+
+        // States describe situation
+        "Test is failing";
+        "Build complete";
+        "Stuck on error";
+    }
+
+    // Process structure template
+    subgraph cluster_structure {
+        label="PROCESS STRUCTURE TEMPLATE";
+
+        "Trigger: Something happens" [shape=ellipse];
+        "Initial check?" [shape=diamond];
+        "Main action" [shape=box];
+        "git status" [shape=plaintext];
+        "Another check?" [shape=diamond];
+        "Alternative action" [shape=box];
+        "STOP: Don't do this" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+        "Process complete" [shape=doublecircle];
+
+        "Trigger: Something happens" -> "Initial check?";
+        "Initial check?" -> "Main action" [label="yes"];
+        "Initial check?" -> "Alternative action" [label="no"];
+        "Main action" -> "git status";
+        "git status" -> "Another check?";
+        "Another check?" -> "Process complete" [label="ok"];
+        "Another check?" -> "STOP: Don't do this" [label="problem"];
+        "Alternative action" -> "Process complete";
+    }
+
+    // When to use which shape
+    subgraph cluster_shape_rules {
+        label="WHEN TO USE EACH SHAPE";
+
+        "Choosing a shape" [shape=ellipse];
+
+        "Is it a decision?" [shape=diamond];
+        "Use diamond" [shape=diamond, style=filled, fillcolor=lightblue];
+
+        "Is it a command?" [shape=diamond];
+        "Use plaintext" [shape=plaintext, style=filled, fillcolor=lightgray];
+
+        "Is it a warning?" [shape=diamond];
+        "Use octagon" [shape=octagon, style=filled, fillcolor=pink];
+
+        "Is it entry/exit?" [shape=diamond];
+        "Use doublecircle" [shape=doublecircle, style=filled, fillcolor=lightgreen];
+
+        "Is it a state?" [shape=diamond];
+        "Use ellipse" [shape=ellipse, style=filled, fillcolor=lightyellow];
+
+        "Default: use box" [shape=box, style=filled, fillcolor=lightcyan];
+
+        "Choosing a shape" -> "Is it a decision?";
+        "Is it a decision?" -> "Use diamond" [label="yes"];
+        "Is it a decision?" -> "Is it a command?" [label="no"];
+        "Is it a command?" -> "Use plaintext" [label="yes"];
+        "Is it a command?" -> "Is it a warning?" [label="no"];
+        "Is it a warning?" -> "Use octagon" [label="yes"];
+        "Is it a warning?" -> "Is it entry/exit?" [label="no"];
+        "Is it entry/exit?" -> "Use doublecircle" [label="yes"];
+        "Is it entry/exit?" -> "Is it a state?" [label="no"];
+        "Is it a state?" -> "Use ellipse" [label="yes"];
+        "Is it a state?" -> "Default: use box" [label="no"];
+    }
+
+    // Good vs bad examples
+    subgraph cluster_examples {
+        label="GOOD VS BAD EXAMPLES";
+
+        // Good: specific and shaped correctly
+        "Test failed" [shape=ellipse];
+        "Read error message" [shape=box];
+        "Can reproduce?" [shape=diamond];
+        "git diff HEAD~1" [shape=plaintext];
+        "NEVER ignore errors" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
+
+        "Test failed" -> "Read error message";
+        "Read error message" -> "Can reproduce?";
+        "Can reproduce?" -> "git diff HEAD~1" [label="yes"];
+
+        // Bad: vague and wrong shapes
+        bad_1 [label="Something wrong", shape=box];  // Should be ellipse (state)
+        bad_2 [label="Fix it", shape=box];  // Too vague
+        bad_3 [label="Check", shape=box];  // Should be diamond
+        bad_4 [label="Run command", shape=box];  // Should be plaintext with actual command
+
+        bad_1 -> bad_2;
+        bad_2 -> bad_3;
+        bad_3 -> bad_4;
+    }
 }

package/templates/axiom/scripts/Check-Memory.ps1

@@ -1,68 +1,68 @@
-
-param (
-    [Parameter(Mandatory=$true)]
-    [string]$SessionId,
-    
-    [int]$Threshold = 2
-)
-
-$ErrorActionPreference = "SilentlyContinue"
-
-# 1. Define Paths
-$AgentRoot = Resolve-Path "$PSScriptRoot\..\.."
-$MemoryDir = Join-Path $AgentRoot ".agent\memory"
-$TargetFile = Join-Path $MemoryDir "active_context.md"
-$StatusFile = Join-Path $MemoryDir "watchdog_status.lock"
-$TempFile = Join-Path $MemoryDir "watchdog_status.tmp"
-
-# 2. Check Context Load (Latest PB File Size)
-$Status = "NORMAL"
-$SizeMB = 0
-
-# Path to Axiom Conversations Directory
-# Dynamic detection for Windows ($env:USERPROFILE) and macOS/Linux ($env:HOME)
-$HomeDir = if ($env:USERPROFILE) { $env:USERPROFILE } else { $env:HOME }
-$ConversationsDir = Join-Path $HomeDir ".gemini\axiom\conversations"
-
-if (Test-Path $ConversationsDir) {
-    # Get the most recently modified .pb file
-    $LatestPb = Get-ChildItem -Path $ConversationsDir -Filter "*.pb" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
-    
-    if ($LatestPb) {
-        $SizeBytes = $LatestPb.Length
-        $SizeMB = [math]::Round($SizeBytes / 1MB, 4)
-        
-        Write-Host " [Watchdog] Monitoring: $($LatestPb.Name) ($SizeMB MB)" -ForegroundColor DarkGray
-        
-        # Threshold handling
-        if ($SizeMB -ge $Threshold) {
-            $Status = "CRITICAL"
-        } elseif ($SizeMB -ge ($Threshold * 0.8)) {
-            $Status = "WARNING"
-        }
-    } else {
-         Write-Host " [Watchdog] No .pb files found to monitor." -ForegroundColor Yellow
-    }
-} else {
-    Write-Host " [Watchdog] Conversations directory not found: $ConversationsDir" -ForegroundColor Red
-}
-
-# 3. Create JSON Payload
-$Payload = @{
-    status = $Status
-    size_mb = $SizeMB
-    limit_mb = $Threshold
-    timestamp = [int64]((Get-Date).ToUniversalTime() - (Get-Date "1970-01-01")).TotalSeconds
-    session_id = $SessionId
-} | ConvertTo-Json -Compress
-
-# 4. Atomic Write
-try {
-    $Payload | Set-Content -Path $TempFile -Encoding UTF8 -Force
-    Move-Item -Path $TempFile -Destination $StatusFile -Force
-} catch {
-    # Silent fail, maybe log if verbose
-    if ($PSBoundParameters['Verbose']) {
-        Write-Error $_
-    }
-}
+
+param (
+    [Parameter(Mandatory=$true)]
+    [string]$SessionId,
+    
+    [int]$Threshold = 2
+)
+
+$ErrorActionPreference = "SilentlyContinue"
+
+# 1. Define Paths
+$AgentRoot = Resolve-Path "$PSScriptRoot\..\.."
+$MemoryDir = Join-Path $AgentRoot ".agent\memory"
+$TargetFile = Join-Path $MemoryDir "active_context.md"
+$StatusFile = Join-Path $MemoryDir "watchdog_status.lock"
+$TempFile = Join-Path $MemoryDir "watchdog_status.tmp"
+
+# 2. Check Context Load (Latest PB File Size)
+$Status = "NORMAL"
+$SizeMB = 0
+
+# Path to Axiom Conversations Directory
+# Dynamic detection for Windows ($env:USERPROFILE) and macOS/Linux ($env:HOME)
+$HomeDir = if ($env:USERPROFILE) { $env:USERPROFILE } else { $env:HOME }
+$ConversationsDir = Join-Path $HomeDir ".gemini\axiom\conversations"
+
+if (Test-Path $ConversationsDir) {
+    # Get the most recently modified .pb file
+    $LatestPb = Get-ChildItem -Path $ConversationsDir -Filter "*.pb" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
+    
+    if ($LatestPb) {
+        $SizeBytes = $LatestPb.Length
+        $SizeMB = [math]::Round($SizeBytes / 1MB, 4)
+        
+        Write-Host " [Watchdog] Monitoring: $($LatestPb.Name) ($SizeMB MB)" -ForegroundColor DarkGray
+        
+        # Threshold handling
+        if ($SizeMB -ge $Threshold) {
+            $Status = "CRITICAL"
+        } elseif ($SizeMB -ge ($Threshold * 0.8)) {
+            $Status = "WARNING"
+        }
+    } else {
+         Write-Host " [Watchdog] No .pb files found to monitor." -ForegroundColor Yellow
+    }
+} else {
+    Write-Host " [Watchdog] Conversations directory not found: $ConversationsDir" -ForegroundColor Red
+}
+
+# 3. Create JSON Payload
+$Payload = @{
+    status = $Status
+    size_mb = $SizeMB
+    limit_mb = $Threshold
+    timestamp = [int64]((Get-Date).ToUniversalTime() - (Get-Date "1970-01-01")).TotalSeconds
+    session_id = $SessionId
+} | ConvertTo-Json -Compress
+
+# 4. Atomic Write
+try {
+    $Payload | Set-Content -Path $TempFile -Encoding UTF8 -Force
+    Move-Item -Path $TempFile -Destination $StatusFile -Force
+} catch {
+    # Silent fail, maybe log if verbose
+    if ($PSBoundParameters['Verbose']) {
+        Write-Error $_
+    }
+}

package/templates/axiom/scripts/Poll-Memory.ps1

@@ -1,36 +1,36 @@
-param([int]$Interval = 2)
-
-$HomeDir = if ($env:USERPROFILE) { $env:USERPROFILE } else { $env:HOME }
-if (-not $HomeDir) {
-    Write-Host "Error: Could not determine HOME directory." -ForegroundColor Red
-    exit 1
-}
-
-$TargetDir = Join-Path $HomeDir ".gemini\axiom\conversations"
-Write-Host "Polling $TargetDir every $Interval seconds..." -ForegroundColor Cyan
-
-$LastTime = $null
-$LastSize = 0
-
-while ($true) {
-    if (Test-Path $TargetDir) {
-        $Latest = Get-ChildItem -Path $TargetDir -Filter "*.pb" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
-        
-        if ($Latest) {
-            $CurrentTime = $Latest.LastWriteTime
-            $CurrentSize = $Latest.Length
-            
-            # If time changed or size changed
-            if ($LastTime -ne $CurrentTime -or $LastSize -ne $CurrentSize) {
-                $SizeMB = [math]::Round($CurrentSize / 1MB, 4)
-                Write-Host " [POLL] Change Detected: $($Latest.Name)" -ForegroundColor Yellow
-                Write-Host "    Time: $CurrentTime"
-                Write-Host "    Size: $SizeMB MB"
-                
-                $LastTime = $CurrentTime
-                $LastSize = $CurrentSize
-            }
-        }
-    }
-    Start-Sleep -Seconds $Interval
-}
+param([int]$Interval = 2)
+
+$HomeDir = if ($env:USERPROFILE) { $env:USERPROFILE } else { $env:HOME }
+if (-not $HomeDir) {
+    Write-Host "Error: Could not determine HOME directory." -ForegroundColor Red
+    exit 1
+}
+
+$TargetDir = Join-Path $HomeDir ".gemini\axiom\conversations"
+Write-Host "Polling $TargetDir every $Interval seconds..." -ForegroundColor Cyan
+
+$LastTime = $null
+$LastSize = 0
+
+while ($true) {
+    if (Test-Path $TargetDir) {
+        $Latest = Get-ChildItem -Path $TargetDir -Filter "*.pb" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
+        
+        if ($Latest) {
+            $CurrentTime = $Latest.LastWriteTime
+            $CurrentSize = $Latest.Length
+            
+            # If time changed or size changed
+            if ($LastTime -ne $CurrentTime -or $LastSize -ne $CurrentSize) {
+                $SizeMB = [math]::Round($CurrentSize / 1MB, 4)
+                Write-Host " [POLL] Change Detected: $($Latest.Name)" -ForegroundColor Yellow
+                Write-Host "    Time: $CurrentTime"
+                Write-Host "    Size: $SizeMB MB"
+                
+                $LastTime = $CurrentTime
+                $LastSize = $CurrentSize
+            }
+        }
+    }
+    Start-Sleep -Seconds $Interval
+}