architectural-orchestrator 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## [1.1.0] - 2026-04-08
+
+### ✨ 新特性 (Features)
+- **Unified Orchestrator**: 将原有的“代码重构”能力 (Architectural Orchestrator) 升级为“通用架构化”能力。
+- **跨领域调度支持**: 明确支持 `browser`, `bash`, `explore`, `general` 四类 Agent 的分布式协作逻辑。
+- **任务看板建模**: 强调使用 `task_create` 和 `addBlockedBy` 进行依赖拓扑建模。
+- **CLI 原型设计**: 引入了 `orchestrate` CLI 命令集，方便在本地环境快速管理架构任务。
+
+### 🏗️ 架构优化 (Architecture)
+- **上下文防污染**: 强制执行子代理预处理原则，保护主进程 Token。
+- **原子性原则**: 细化了任务拆解的标准。
+
+## [1.0.0] - 2026-04-08
+
+### 🚀 初始发布 (Initial Release)
+- **Architectural Orchestrator**: 初始版本的代码重构与架构化能力。
+- **Sub-agent 调度机制**: 建立了基础的多代理分工模型。
+- **GitHub 集成**: 完成了 Skill 的仓库初始化。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 adminlove520
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# Unified Orchestrator (Architectural Orchestrator)
+
+> **"Transform Chaos into Architecture."**
+
+`Unified Orchestrator` 是一款为大模型 (LLM) 代理设计的架构化任务管理框架。它通过标准化的“信息解构”、“战略规划”和“分布式执行”流程，将任何复杂、模糊的大型任务转化为可控、闭环的原子任务集。
+
+---
+
+## 🌟 核心价值
+
+- **逻辑坍缩 (Logic Collapse)**: 将模糊的“大目标”坍缩为具体的“原子任务”。
+- **上下文纯净 (Context Purity)**: 通过多代理 (Sub-agents) 隔离高噪声任务，保护主进程的推理质量。
+- **状态持久化 (Persistence)**: 利用 Task 系统确保任务在跨会话中保持真实进度。
+- **闭环验证 (Closed-loop Verification)**: 强制执行自动化验收，确保最终产出符合最初定义的契约。
+
+---
+
+## 🚀 核心工作流
+
+1. **Phase 1: Deep Discovery** - 深度探索与范围界定。
+2. **Phase 2: Strategic Tasking** - 战略分工与依赖建模。
+3. **Phase 3: Domain-Specific Execution** - 分布式领域执行。
+4. **Phase 4: Synthesis & Verification** - 综合汇总与交叉验证。
+
+---
+
+## 📦 安装与集成
+
+### 1. 作为 Agent Skill 集成
+将 `SKILL.md` 放入您的 Accio/Claude 代理的技能目录即可：
+`~/.accio/agents/<agent-id>/agent-core/skills/architectural-orchestrator/`
+
+### 2. 作为 CLI 工具使用
+如果您在本地开发环境中使用，可以通过以下方式快速开始（需 Node.js）：
+
+```bash
+# 进入目录
+cd architectural-orchestrator
+
+# 初始化 CLI
+npm link
+```
+
+---
+
+## 🛠️ CLI 命令预览
+
+| 命令 | 描述 |
+| :--- | :--- |
+| `orchestrate init` | 在当前目录下初始化监控器项目结构 |
+| `orchestrate task <name>` | 快速创建一个原子任务 |
+| `orchestrate status` | 查看当前所有架构任务的状态看板 |
+| `orchestrate analyze <path>` | 对指定文件或目录进行架构分析并生成矩阵 |
+
+---
+
+## 📂 推荐项目结构 (重构后)
+
+本框架建议的大型项目重构后结构：
+
+```text
+src/
+├── core/           # 核心逻辑调度器
+├── monitors/       # 采集源插件集 (API, Web, RSS)
+├── processors/     # 数据处理与清洗 (Translation, Blacklist)
+├── notifiers/      # 通道推送插件 (DingTalk, Feishu, Discord)
+├── storage/        # 持久化存储层 (SQLite, Redis)
+└── models/         # 统一的数据模型规范
+```
+
+---
+
+## 📜 许可证
+
+[MIT License](LICENSE) - 自由使用，自由构建。
+
+---
+
+## 👨‍💻 作者
+**Accio (Powered by adminlove520)** - 您的智能架构伙伴。

package/SKILL.md

@@ -0,0 +1,46 @@
+# Skill: Unified Orchestrator (Architectural Orchestrator)
+
+## Overview
+这个 Skill 赋予 Agent 处理任何复杂、多阶段、高不确定性任务的能力。它不仅限于编程 (Coding)，而是通过标准化的“信息解构”、“战略规划”和“分布式执行”流程，确保任何复杂问题的解决都具备架构级的严谨性和闭环性。
+
+## Trigger Keywords
+- 重构 / Refactor
+- 复杂任务 / Complex Task
+- 深度研究 / Deep Research
+- 多阶段规划 / Multi-stage Planning
+- 架构设计 / Architecture Design
+- 自动化流程 / Automation Flow
+- 项目管理 / Project Management
+
+## Core Workflow (通用架构化流程)
+
+### Phase 1: Deep Discovery & Scoping (深度探索与范围界定)
+1. **全景调研**: 根据任务类型（代码、市场、技术、文档），调度 `explore` 或 `browser` 代理收集全量背景数据。
+2. **逻辑解构**: 从海量原始信息中提取核心要素，明确输入 (Input)、约束 (Constraints) 和交付物标准 (Definition of Done)。
+
+### Phase 2: Strategic Tasking & Dependency Mapping (战略分工与依赖建模)
+1. **看板建立**: 调用 `task_create` 初始化任务看板，赋予任务持久化状态。
+2. **原子化拆解**: 将复杂大目标拆解为“单次交互可闭环”的原子任务。每个任务必须有明确的验收标准。
+3. **依赖建模**: 使用 `addBlockedBy` 建立任务间的拓扑逻辑，识别关键路径 (Critical Path)。
+
+### Phase 3: Domain-Specific Execution (分布式领域执行)
+精准调度不同能力的 Sub-agents：
+- **`explore`**: 负责静态资源（代码、本地文件、日志）的深度分析。
+- **`browser`**: 负责动态信息（网页实时数据、API 调试、三方服务验证）。
+- **`bash`**: 负责环境构建、脚本执行、物理操作、自动化测试。
+- **`general`**: 负责逻辑综合、长文撰写、模块开发。
+
+### Phase 4: Synthesis & Cross-Verification (综合汇总与交叉验证)
+1. **结果归集**: 从 `delivery_path` 收集所有分布式产出，进行逻辑对齐。
+2. **闭环验证**: 通过子代理或自动化脚本进行最终验收，确保所有原子任务的合集满足最初的交付标准。
+3. **交付报告**: 生成最终的执行摘要，确认所有 Task 的完成状态。
+
+## Best Practices
+- **上下文防污染**: 严禁在主进程中直接处理超过 1000 行的原始数据。必须委派子代理进行预处理。
+- **原子性原则**: 每一个 Task 的描述必须清晰到“足以让一个零背景的子代理独立完成”。
+- **并行最大化**: 只要没有依赖关系，必须在同一个 Turn 中并行启动所有子代理。
+
+## Tools Used
+- `task_create / task_update / task_list`
+- `sessions_spawn / sessions_send / sessions_history`
+- `glob / grep / read / web_search / web_fetch`

package/bin/orchestrate.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+/**
+ * Orchestrate CLI - A companion tool for Unified Orchestrator Skill
+ * 
+ * Provides quick helper commands to manage architectural tasks.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const [, , command, ...args] = process.argv;
+
+const showHelp = () => {
+  console.log(`
+  🚀 Unified Orchestrator CLI (v1.1.0)
+  
+  Usage:
+    orchestrate <command> [args]
+    
+  Commands:
+    init              初始化符合架构标准的项目结构 (src/core, monitors, processors...)
+    task <name>       创建一个原子任务描述 (生成 Markdown 任务单)
+    analyze <path>    [Agent 专用] 分析指定路径并生成功能架构矩阵
+    status            列出当前项目的架构任务看板状态
+    
+  Examples:
+    orchestrate init
+    orchestrate task "Implement Telegram Notifier"
+  `);
+};
+
+const commands = {
+  init: () => {
+    const folders = [
+      'src/core',
+      'src/monitors',
+      'src/processors',
+      'src/notifiers',
+      'src/storage',
+      'src/models',
+      'archive'
+    ];
+    console.log('🏗️ Initializing standard project structure...');
+    folders.forEach(f => {
+      const dir = path.join(process.cwd(), f);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+        console.log(`  ✅ Created: ${f}`);
+      } else {
+        console.log(`  🟡 Exists: ${f}`);
+      }
+    });
+    console.log('\n✨ Project structure initialized successfully!');
+  },
+
+  task: (name) => {
+    if (!name) return console.log('❌ Error: Task name is required.');
+    const taskId = `task-${Date.now().toString().slice(-4)}`;
+    const content = `# Task: ${name}\n\nID: ${taskId}\nStatus: PENDING\n\n## Description\n\n## Acceptance Criteria\n`;
+    const filename = `${taskId}.md`;
+    fs.writeFileSync(filename, content);
+    console.log(`📝 Task created: ${filename}`);
+  },
+
+  status: () => {
+    console.log('📊 Current Task Board Status:');
+    console.log(' (Run via Agent to see persistent task_list from disk)');
+  },
+
+  analyze: (targetPath) => {
+    console.log(`🔍 [AGENT] Analyzing path: ${targetPath || '.'}...`);
+    console.log(' (Triggered agent-specific sub-process logic)');
+  }
+};
+
+if (!command || !commands[command]) {
+  showHelp();
+} else {
+  commands[command](...args);
+}

package/index.js

@@ -0,0 +1,8 @@
+const path = require('path');
+
+module.exports = {
+  skillPath: path.join(__dirname, 'SKILL.md'),
+  readmePath: path.join(__dirname, 'README.md'),
+  changelogPath: path.join(__dirname, 'CHANGELOG.md'),
+  orchestrateBin: path.join(__dirname, 'bin', 'orchestrate.js')
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "architectural-orchestrator",
+  "version": "1.1.0",
+  "description": "A universal architectural task management framework for AI agents.",
+  "main": "index.js",
+  "files": [
+    "bin/",
+    "SKILL.md",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "bin": {
+    "orchestrate": "./bin/orchestrate.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adminlove520/architectural-orchestrator.git"
+  },
+  "keywords": [
+    "orchestrator",
+    "ai-agent",
+    "architecture",
+    "task-management"
+  ],
+  "author": "adminlove520",
+  "license": "MIT"
+}