archgraph-argo 0.7.9 → 0.8.1

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

@@ -0,0 +1,32 @@
+---
+description: "公众号发布：将 ArchGraph 项目的文章（洞察报告、官宣介绍、开发者社区等）撰写为符合微信公众号格式的 Markdown，并通过 wechat-public-cli 创建草稿、跟进公众号后台手动发布流程。Use when: 发布公众号文章、创建公众号草稿、微信公众平台、wechat、公众号发布员、撰写 .wechat.md 文章。"
+name: "公众号发布员"
+model: "Qwen3.7-Plus"
+tools: [read, edit, search, execute]
+user-invocable: true
+argument-hint: "要发布的文章主题或源文档路径"
+---
+你是 ArchGraph 项目的「公众号发布员」，专职把项目文章发布到微信公众号。
+
+## 职责
+1. 阅读源内容（洞察报告、官宣介绍、开发者社区等文档），提炼并撰写为符合微信公众号格式的 Markdown 文章。
+2. 通过本地 wechat-public-cli 创建公众号草稿。
+3. 返回草稿 media_id，并说明公众号后台手动发布的跟进步骤。
+
+## 约束
+- 只用 `wechat:draft` 创建草稿。**禁止**运行 `wechat:publish` / `wechat:sendall` / `freepublish`：本公众号是个人未认证订阅号（appid wxdf79e7cb44995aa3），这些 API 永远返回 48001 api unauthorized，只能登录公众号后台「草稿箱」手动发布。
+- 文章内容必须基于仓库内已有文档，不得凭空编造。
+- 不得打印或泄露 `wechat-public.config.json` 中的 appid/secret 等凭据。
+- 发布前需确认当前公网 IP 已加入公众号后台 IP 白名单（否则 token 刷新报 40164）。
+
+## 工作方法
+1. 定位源文档，并参考 `docs/*.wechat.md` 既有文章的格式与文风。
+2. 撰写 `docs/<主题>.wechat.md`，YAML frontmatter 至少含 `title` / `author` / `digest`，并按需含 `banner_path`（相对文章目录）、`open_comment`、`source_url`。
+3. 若 `tests/wechat-article.test.js` 尚无对应验收用例，先补一条 GIVEN-WHEN-THEN 用例，再运行 `node --test tests/wechat-article.test.js` 通过。
+4. 创建草稿（banner_path 相对文章文件目录解析）：
+   ```powershell
+   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"
+   ```
+
+## 输出格式
+返回：文章路径、草稿 media_id（或确切失败原因）、状态（草稿已创建 / BLOCKED）。并提醒：API 发布不可用，需在公众号后台「草稿箱」手动发布。

package/argo/rules/archgraph.instructions.md

@@ -44,6 +44,23 @@ applyTo: "**"
 6. 每个 `Business Actor` 的 `name` 必须全局唯一，不能与其他 `Business Actor` 的 `name` 冲突。
 </OrganizationGuideline>
 
+<SessionMemorySummarization>
+每次会话结束（收工）前，必须执行一次短期记忆总结，并将总结写入长期记忆，防止跨会话遗忘：
+1. 先读取短期（会话）记忆：查看 `/memories/session/` 下本次会话的记录；若为空，则依据本次会话的实际工作内容进行总结。
+2. 生成结构化总结，至少包含：本次目标、已完成的关键进展、关键决策及其原因、遗留问题与待办、可复用的经验与教训。
+3. 将总结写入长期记忆：
+   - 若本次工作属于某个 `Business Actor` 的角色工作，按 `<OrganizationGuideline>` 写入该 Actor 名下挂载的长期记忆 View；
+4. 总结必须简洁、去重：优先更新已有记忆文件，仅在必要时新建；禁止把会话中的冗余过程内容原文复制进长期记忆。
+</SessionMemorySummarization>
+
+<MemoryTriggerTiming>
+除「会话结束」外，以下时机必须即时触发长期记忆写入，不得攒到会话结束：
+1. 踩坑/纠错当场记：解决一个耗时问题、发现环境或平台限制（如编码坑、权限限制、命令陷阱）后，立即写入一条简短记录，说明「现象 + 原因 + 解法或规避方式」。
+2. 关键决策当下记：做出影响后续走向的技术/架构决策时，立即记录「决策 + 理由 + 被否掉的备选方案」，保证理由在决策当下最清晰。
+3. 任务/切片/里程碑完成时：每完成一个 feature、一个切片或一次 commit 后，立即登记「commit id + 文件路径 + 关键进展」，与 `<IntentArchitectureFirst>` 第4条呼应，不得攒到会话结束。
+以上即时记录同样遵守 `<SessionMemorySummarization>` 第4条的简洁、去重要求。
+</MemoryTriggerTiming>
+
 <ToolsGuideline>
 你必须通过ARGO MCP server提供的工具来进行意图架构的读写操作，禁止直接修改意图架构的源文件：
 1. getSystemArchitecture: 语义化读取架构（推荐带 query.purpose + query.intent，而非全量读取）。

package/install-argo.ps1

@@ -8,6 +8,9 @@ param(
     [string]$OpenCodeSkillsRoot = "$env:USERPROFILE\.config\opencode\skills",
     [string]$OpenCodeAgentsPath = "$env:USERPROFILE\.config\opencode\AGENTS.md",
     [string]$OpenCodeConfigPath = "$env:USERPROFILE\.config\opencode\opencode.json",
+    [string]$CopilotAgentsRoot = "$env:USERPROFILE\.copilot\agents",
+    [string]$CursorAgentsRoot = "$env:USERPROFILE\.cursor\agents",
+    [string]$OpenCodeAgentsRoot = "$env:USERPROFILE\.config\opencode\agents",
     [switch]$SkipEnv,
     [switch]$SkipDeps,
     [switch]$SkipMcp,
@@ -24,6 +27,24 @@ function Copy-Tree {
     Copy-Item -Recurse -Force -Path (Join-Path $Source '*') -Destination $Destination
 }
 
+function Copy-Agents {
+    param(
+        [string]$Source,
+        [string]$Destination,
+        [switch]$AsMd
+    )
+    New-Item -ItemType Directory -Force -Path $Destination | Out-Null
+    $files = @(Get-ChildItem -Path (Join-Path $Source '*.agent.md') -ErrorAction SilentlyContinue)
+    foreach ($file in $files) {
+        if ($AsMd) {
+            $targetName = ($file.BaseName -replace '\.agent$', '') + '.md'
+        } else {
+            $targetName = $file.Name
+        }
+        Copy-Item -Force -Path $file.FullName -Destination (Join-Path $Destination $targetName)
+    }
+}
+
 function Write-McpConfig {
     param(
         [string]$Path,
@@ -107,46 +128,56 @@ Write-Host '==> Deploying Argo toolchain'
 
 $schemaSrc = Join-Path $argoDir 'schema'
 $schemaDest = Join-Path $ArgoRoot 'schema'
-Write-Host "[1/6] argo\schema -> $schemaDest"
+Write-Host "[1/12] argo\schema -> $schemaDest"
 Copy-Tree -Source $schemaSrc -Destination $schemaDest
 
 $scriptsSrc = Join-Path $argoDir 'scripts'
 $scriptsDest = Join-Path $ArgoRoot 'scripts'
-Write-Host "[2/6] argo\scripts -> $scriptsDest"
+Write-Host "[2/12] argo\scripts -> $scriptsDest"
 Copy-Tree -Source $scriptsSrc -Destination $scriptsDest
 
 $defaultsSrc = Join-Path $argoDir 'defaults'
 $defaultsDest = Join-Path $ArgoRoot 'defaults'
-Write-Host "[3/6] argo\defaults -> $defaultsDest"
+Write-Host "[3/12] 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/6] argo\skills\argo-init -> $skillDest"
+Write-Host "[4/12] 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/6] argo\rules\archgraph.instructions.md -> $ruleDest"
+Write-Host "[5/12] 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/6] argo\package.json -> $depsDest"
+Write-Host "[6/12] argo\package.json -> $depsDest"
 Copy-Item -Force -Path $depsSrc -Destination $depsDest
 
 $cursorSkillDest = Join-Path $CursorSkillsRoot 'argo-init'
-Write-Host "[7/10] argo\skills\argo-init -> $cursorSkillDest (Cursor)"
+Write-Host "[7/12] argo\skills\argo-init -> $cursorSkillDest (Cursor)"
 Copy-Tree -Source $skillSrc -Destination $cursorSkillDest
 
 $openCodeSkillDest = Join-Path $OpenCodeSkillsRoot 'argo-init'
-Write-Host "[8/10] argo\skills\argo-init -> $openCodeSkillDest (OpenCode)"
+Write-Host "[8/12] argo\skills\argo-init -> $openCodeSkillDest (OpenCode)"
 Copy-Tree -Source $skillSrc -Destination $openCodeSkillDest
 
-Write-Host "[9/10] argo\rules\archgraph.instructions.md -> $OpenCodeAgentsPath (OpenCode global AGENTS.md)"
+Write-Host "[9/12] 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)"
+Copy-Agents -Source $agentsSrc -Destination $CopilotAgentsRoot
+
+Write-Host "[11/12] argo\agents -> $CursorAgentsRoot (Cursor user-level, renamed to .md)"
+Copy-Agents -Source $agentsSrc -Destination $CursorAgentsRoot -AsMd
+
+Write-Host "[12/12] argo\agents -> $OpenCodeAgentsRoot (OpenCode user-level, renamed to .md)"
+Copy-Agents -Source $agentsSrc -Destination $OpenCodeAgentsRoot -AsMd
+
 if ($SkipDeps) {
     Write-Host 'Skipped dependency install (-SkipDeps).'
 } elseif (Get-Command npm -ErrorAction SilentlyContinue) {

package/package.json

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