archgraph-argo 0.9.2 → 0.9.3

package/argo/agents/wechat-publisher.agent.md

@@ -28,5 +28,16 @@ argument-hint: "要发布的文章主题或源文档路径"
    node "d:\Projects\_tools\wechat-cli-src\obsidian-wechat-public-platform-master\dist\wechat-public-cli.js" wechat:draft --file "<文章绝对路径>" --config "d:\Projects\archgraph\wechat-public.config.json" --css "d:\Projects\_tools\wechat-cli-src\obsidian-wechat-public-platform-master\custom.css"
    ```
 
+## 文风要求（人味优先，去 AI 味）
+
+发布公众号文章前，必须按以下要求降低「AI 味」、增加「人味」，否则读者不会看：
+
+- 禁止 AI 套话与八股：删掉「首先/其次/最后」「综上所述」「总而言之」「值得注意的是」「赋能」「抓手」「闭环」「底层逻辑」等空洞词，去掉「本文将从以下 N 个方面展开」式开场。
+- 去掉机械排比与对仗堆砌；段落要短，句子长短交错，像人说话，不像机器列清单。
+- 多点人味：加入真实场景、具体例子、第一人称视角、设问、适度的口语与幽默；用具体数字和细节代替抽象概括。
+- 开门见山直给观点与结论，少绕弯子；结尾给出可行动的判断，而非泛泛展望。
+- 标题与摘要（digest）同样要有人味，避免口号式、震惊体式标题。
+- 每篇至少通读一遍，找出并改写任何读起来像机器生成的句子。
+
 ## 输出格式
 返回：文章路径、草稿 media_id（或确切失败原因）、状态（草稿已创建 / BLOCKED）。并提醒：API 发布不可用，需在公众号后台「草稿箱」手动发布。

package/argo/plugins/argo-wakeup.js

@@ -0,0 +1,27 @@
+// Argo wakeup gate plugin for opencode.
+//
+// Injects an unconditional "wakeup gate" as the FIRST system instruction of
+// every session, so the agent identifies its Business Actor and restores its
+// long-term memory before responding to anything (including greetings and
+// casual questions). The rule also lives in argo/rules/archgraph.instructions.md,
+// but that file is long and can be skimmed; this hook guarantees a short,
+// high-salience gate sits at the top of the system prompt on session start.
+
+const WAKEUP_GATE = [
+  "WAKEUP GATE (unconditional; applies to the very first message of every session, including greetings, casual chat, and questions; never skip or defer).",
+  "1. Your very FIRST tool call must be an ARGO MCP query listing all Business Actors (getSystemArchitecture, purpose \"audit\", subject \"Business Actor\") to identify which Business Actor you are.",
+  "2. Restore that Actor's long-term memory (the SUBVIEW hierarchy mounted under it) before responding.",
+  "3. If the ARGO MCP is unavailable or errors, say so explicitly first. Only after this gate may you respond or act.",
+].join("\n");
+
+export default async function argoWakeupPlugin() {
+  return {
+    "experimental.chat.system.transform": async (_input, output) => {
+      const system = Array.isArray(output.system) ? output.system : [];
+      if (system.some((entry) => entry.includes("WAKEUP GATE"))) {
+        return;
+      }
+      output.system = [WAKEUP_GATE, ...system];
+    },
+  };
+}

package/argo/rules/archgraph.instructions.md

@@ -4,6 +4,14 @@ name: "ArchGraph ARGO Workflow Rules"
 applyTo: "**"
 ---
 
+<WakeupGuideline>
+STEP 0 — UNCONDITIONAL STARTUP GATE. This applies to the very first message of every session, including greetings, casual chat, and questions; it may never be skipped, deferred, or treated as optional.
+1. Your very FIRST tool call in the session MUST be an ARGO MCP query that lists all `Business Actor`s (getSystemArchitecture with purpose "audit" and subject "Business Actor"). Identify which `Business Actor` you are. If you are not sure, consult your human partner to confirm your role before doing anything else.
+2. Restore your long-term memory: the SUBVIEW hierarchy mounted under that `Business Actor` element — the Views whose `parent_element_id` points to this Actor, plus the elements, relationships, and further nested sub-views inside them (NOT the View that merely includes the Actor in its `included_elements`) — and load it into session memory.
+3. If the `agent` attribute of the confirmed Actor differs from your current Agent type, switch to that Agent type, or delegate to an Agent of that type per `<CoperationGuideline>` item 2.
+4. If the ARGO MCP is unavailable or errors, state that explicitly to the user before doing anything else. Only after completing this gate may you respond to the user or take any other action.
+</WakeupGuideline>
+
 <CoreRules>
 The following are non-negotiable red lines (MUST) for this Agent and must never be skipped at any time; details are expanded in the corresponding `<...>` sections.
 1. Before modifying anything in the repository, you MUST first locate (or create) the corresponding architecture element and View in the graph through the ARGO MCP. See `<IntentArchitectureFirst>`.
@@ -20,11 +28,6 @@ Your cognitive architecture is composed of ArchiMate 3.2 elements and their exte
 2. For the definitions of element or relationship types, see: ~/.argo/schema/archimate3.2.md
 </Ontology>
 
-<WakeupGuideline>
-1. When you are started, first identify which `Business Actor` you are, then find your long-term memory — the SUBVIEW hierarchy mounted under that `Business Actor` element (the Views whose `parent_element_id` points to this Actor, plus the elements, relationships, and further nested sub-views inside them; NOT the View that merely includes the Actor in its `included_elements`) — and restore it into your session memory.
-2. If you are not sure, query all existing `Business Actor`s, then consult your human partner to confirm your role. If the Agent type (the `agent` attribute) corresponding to the confirmed role differs from the current Agent type, switch to that Agent type, or delegate to an Agent of that type per `<CoperationGuideline>` item 2.
-</WakeupGuideline>
-
 <ExplorationGuideline>
 1. When exploring context, explore in small steps: keep each query shallow, and after each query decide the next exploration direction based on the result.
 2. When you receive multiple similar or conflicting pieces of information, prefer the context closest to your current task and avoid wasting time on irrelevant context.

package/install-argo.ps1

@@ -10,7 +10,9 @@ param(
     [string]$OpenCodeConfigPath = "$env:USERPROFILE\.config\opencode\opencode.json",
     [string]$CopilotAgentsRoot = "$env:USERPROFILE\.copilot\agents",
     [string]$CursorAgentsRoot = "$env:USERPROFILE\.cursor\agents",
+    [string]$CursorRulesRoot = "$env:USERPROFILE\.cursor\rules",
     [string]$OpenCodeAgentsRoot = "$env:USERPROFILE\.config\opencode\agents",
+    [string]$PluginsRoot = "$env:USERPROFILE\.argo\plugins",
     [switch]$SkipEnv,
     [switch]$SkipDeps,
     [switch]$SkipMcp,
@@ -93,6 +95,34 @@ function Convert-AgentFile {
     [System.IO.File]::WriteAllText($DestinationFile, $result, (New-Object System.Text.UTF8Encoding $false))
 }
 
+function Convert-RuleFile {
+    param(
+        [string]$SourceFile,
+        [string]$DestinationFile
+    )
+    $content = Get-Content $SourceFile -Raw -Encoding UTF8
+    $m = [regex]::Match($content, '(?s)^---\s*\r?\n(.*?)\r?\n---\s*\r?\n(.*)$')
+    if (-not $m.Success) {
+        Copy-Item -Force -Path $SourceFile -Destination $DestinationFile
+        return
+    }
+    $front = $m.Groups[1].Value
+    $body = $m.Groups[2].Value
+
+    $desc = ''
+    $dm = [regex]::Match($front, '(?m)^description:\s*(.*)$')
+    if ($dm.Success) { $desc = $dm.Groups[1].Value.Trim().Trim('"').Trim("'") }
+
+    # Cursor .mdc rule: description + alwaysApply so it is injected into every
+    # request. The rule body (WakeupGuideline + CoreRules + ...) is kept verbatim.
+    $newFront = "---`r`n"
+    if ($desc) { $newFront += "description: `"$($desc -replace '"','\"')`"`r`n" }
+    $newFront += "alwaysApply: true`r`n---`r`n"
+
+    $result = $newFront + "`r`n" + $body
+    [System.IO.File]::WriteAllText($DestinationFile, $result, (New-Object System.Text.UTF8Encoding $false))
+}
+
 function Write-McpConfig {
     param(
         [string]$Path,
@@ -129,6 +159,39 @@ function Write-McpConfig {
     [System.IO.File]::WriteAllText($Path, $json, (New-Object System.Text.UTF8Encoding $false))
 }
 
+function Register-OpenCodePlugin {
+    param(
+        [string]$ConfigPath,
+        [string]$PluginFilePath
+    )
+
+    $root = [ordered]@{}
+    if (Test-Path $ConfigPath) {
+        try {
+            $existing = Get-Content $ConfigPath -Raw | ConvertFrom-Json
+            foreach ($p in $existing.PSObject.Properties) {
+                $root[$p.Name] = $p.Value
+            }
+        } catch {
+            # Ignore an unparseable existing file and start fresh.
+        }
+    }
+
+    $url = 'file:///' + (($PluginFilePath -replace '\\', '/').TrimStart('/'))
+    $plugins = @()
+    if ($root.Contains('plugin') -and $null -ne $root['plugin']) {
+        $plugins = @($root['plugin'])
+    }
+    if ($plugins -notcontains $url) {
+        $plugins += $url
+    }
+    $root['plugin'] = $plugins
+
+    New-Item -ItemType Directory -Force -Path (Split-Path $ConfigPath) | Out-Null
+    $json = $root | ConvertTo-Json -Depth 10
+    [System.IO.File]::WriteAllText($ConfigPath, $json, (New-Object System.Text.UTF8Encoding $false))
+}
+
 function Add-AgentsRule {
     param(
         [string]$AgentsPath,
@@ -176,56 +239,66 @@ Write-Host '==> Deploying Argo toolchain'
 
 $schemaSrc = Join-Path $argoDir 'schema'
 $schemaDest = Join-Path $ArgoRoot 'schema'
-Write-Host "[1/12] argo\schema -> $schemaDest"
+Write-Host "[1/14] argo\schema -> $schemaDest"
 Copy-Tree -Source $schemaSrc -Destination $schemaDest
 
 $scriptsSrc = Join-Path $argoDir 'scripts'
 $scriptsDest = Join-Path $ArgoRoot 'scripts'
-Write-Host "[2/12] argo\scripts -> $scriptsDest"
+Write-Host "[2/14] argo\scripts -> $scriptsDest"
 Copy-Tree -Source $scriptsSrc -Destination $scriptsDest
 
 $defaultsSrc = Join-Path $argoDir 'defaults'
 $defaultsDest = Join-Path $ArgoRoot 'defaults'
-Write-Host "[3/12] argo\defaults -> $defaultsDest"
+Write-Host "[3/14] argo\defaults -> $defaultsDest"
 Copy-Tree -Source $defaultsSrc -Destination $defaultsDest
 
 $skillSrc = Join-Path (Join-Path $argoDir 'skills') 'argo-init'
 $skillDest = Join-Path $SkillsRoot 'argo-init'
-Write-Host "[4/12] argo\skills\argo-init -> $skillDest"
+Write-Host "[4/14] argo\skills\argo-init -> $skillDest"
 Copy-Tree -Source $skillSrc -Destination $skillDest
 
 $ruleSrc = Join-Path (Join-Path $argoDir 'rules') 'archgraph.instructions.md'
 $ruleDest = Join-Path $PromptsRoot 'archgraph.instructions.md'
-Write-Host "[5/12] argo\rules\archgraph.instructions.md -> $ruleDest"
+Write-Host "[5/14] argo\rules\archgraph.instructions.md -> $ruleDest"
 New-Item -ItemType Directory -Force -Path $PromptsRoot | Out-Null
 Copy-Item -Force -Path $ruleSrc -Destination $ruleDest
 
 $depsSrc = Join-Path $argoDir 'package.json'
 $depsDest = Join-Path $ArgoRoot 'package.json'
-Write-Host "[6/12] argo\package.json -> $depsDest"
+Write-Host "[6/14] argo\package.json -> $depsDest"
 Copy-Item -Force -Path $depsSrc -Destination $depsDest
 
 $cursorSkillDest = Join-Path $CursorSkillsRoot 'argo-init'
-Write-Host "[7/12] argo\skills\argo-init -> $cursorSkillDest (Cursor)"
+Write-Host "[7/14] argo\skills\argo-init -> $cursorSkillDest (Cursor)"
 Copy-Tree -Source $skillSrc -Destination $cursorSkillDest
 
 $openCodeSkillDest = Join-Path $OpenCodeSkillsRoot 'argo-init'
-Write-Host "[8/12] argo\skills\argo-init -> $openCodeSkillDest (OpenCode)"
+Write-Host "[8/14] argo\skills\argo-init -> $openCodeSkillDest (OpenCode)"
 Copy-Tree -Source $skillSrc -Destination $openCodeSkillDest
 
-Write-Host "[9/12] argo\rules\archgraph.instructions.md -> $OpenCodeAgentsPath (OpenCode global AGENTS.md)"
+Write-Host "[9/14] argo\rules\archgraph.instructions.md -> $OpenCodeAgentsPath (OpenCode global AGENTS.md)"
 Add-AgentsRule -AgentsPath $OpenCodeAgentsPath -RulePath $ruleSrc
 
 $agentsSrc = Join-Path $argoDir 'agents'
-Write-Host "[10/12] argo\agents -> $CopilotAgentsRoot (Copilot user-level)"
+Write-Host "[10/14] argo\agents -> $CopilotAgentsRoot (Copilot user-level)"
 Copy-Agents -Source $agentsSrc -Destination $CopilotAgentsRoot
 
-Write-Host "[11/12] argo\agents -> $CursorAgentsRoot (Cursor user-level, converted to .md)"
+Write-Host "[11/14] argo\agents -> $CursorAgentsRoot (Cursor user-level, converted to .md)"
 Copy-Agents -Source $agentsSrc -Destination $CursorAgentsRoot -Target cursor
 
-Write-Host "[12/12] argo\agents -> $OpenCodeAgentsRoot (OpenCode user-level, converted to .md)"
+Write-Host "[12/14] argo\agents -> $OpenCodeAgentsRoot (OpenCode user-level, converted to .md)"
 Copy-Agents -Source $agentsSrc -Destination $OpenCodeAgentsRoot -Target opencode
 
+$pluginsSrc = Join-Path $argoDir 'plugins'
+Write-Host "[13/14] argo\plugins -> $PluginsRoot (Argo opencode plugins)"
+Copy-Tree -Source $pluginsSrc -Destination $PluginsRoot
+
+$cursorRuleSrc = Join-Path (Join-Path $argoDir 'rules') 'archgraph.instructions.md'
+$cursorRuleDest = Join-Path $CursorRulesRoot 'archgraph.mdc'
+Write-Host "[14/14] argo\rules\archgraph.instructions.md -> $cursorRuleDest (Cursor global rule, alwaysApply)"
+New-Item -ItemType Directory -Force -Path $CursorRulesRoot | Out-Null
+Convert-RuleFile -SourceFile $cursorRuleSrc -DestinationFile $cursorRuleDest
+
 if ($SkipDeps) {
     Write-Host 'Skipped dependency install (-SkipDeps).'
 } elseif (Get-Command npm -ErrorAction SilentlyContinue) {
@@ -347,5 +420,12 @@ if ($SkipMcp) {
     Write-Host "argo MCP config written -> $OpenCodeConfigPath"
 }
 
+$wakeupPluginPath = Join-Path $PluginsRoot 'argo-wakeup.js'
+if (Test-Path $wakeupPluginPath) {
+    Write-Host '==> Registering argo-wakeup plugin in OpenCode'
+    Register-OpenCodePlugin -ConfigPath $OpenCodeConfigPath -PluginFilePath $wakeupPluginPath
+    Write-Host "argo-wakeup plugin registered -> $OpenCodeConfigPath"
+}
+
 Write-Host ''
 Write-Host 'Argo deployment complete.'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archgraph-argo",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Deploy the ArchGraph ARGO toolchain, skills, and rules (schema, scripts, argo-init skill, global rule) with one command.",
   "license": "MIT",
   "bin": {
@@ -11,6 +11,7 @@
     "argo/schema",
     "argo/defaults",
     "argo/agents",
+    "argo/plugins",
     "argo/skills/argo-init",
     "argo/rules",
     "argo/package.json",