@arrislink/axon 1.0.1 → 1.0.2

package/README.md

@@ -10,14 +10,15 @@
 
 Axon is a unified AI-assisted development environment that solves context loss, wheel reinvention, and planning chaos in AI-powered programming. **Powered by [OpenCode](https://github.com/anomalyco/opencode) and [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)**, Axon orchestrates these powerful tools through specification-driven development and task management.
 
-## ✨ Features
-
-- **📝 Spec-Driven Development** - Define clear requirements before coding
-- **🔗 Task Traceability** - Every line of code maps to a specific task bead
-- **🎯 Knowledge Reuse** - Automatically match and apply validated skill templates
-- **💰 Cost Control** - Smart token usage tracking to prevent overspending
-- **🤖 Multi-Provider Support** - Integrate with OMO for 75+ LLM providers (Anthropic, OpenAI, Antigravity, etc.)
-- **🎭 Agent Orchestration** - Multiple AI agents collaborate intelligently
+## ✨ Why Axon?
+
+**Axon transforms AI from a "Code Autocompleter" into a "Development Partner".**
+
+- **🧠 Spec-First**: Don't just chat. Define requirements in `spec.md` to keep the AI focused.
+- **🗺️ Bead Planning**: Complex features are broken into atomic, dependency-sorted tasks (Beads).
+- **🤖 Agentic Execution**: **OpenCode** agents execute tasks one-by-one, ensuring context and quality.
+- **♻️ Skill Reuse**: Automatically apply proven patterns (e.g., "Secure Auth") from your team's library.
+- **🛡️ Enterprise Safe**: Token budgeting, Git safety checks, and multi-provider failover via **OMO**.
 
 ## 🎯 Applicable Scenarios
 

package/README.zh-CN.md

@@ -10,14 +10,15 @@
 
 Axon 是一个统一的 AI 辅助开发环境，解决 AI 编程中的上下文丢失、重复造轮子和规划失控问题。**由 [OpenCode](https://github.com/anomalyco/opencode) 和 [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode) 驱动**，Axon 通过规格驱动开发和任务管理来编排这些强大的工具。
 
-## ✨ 核心特性
-
-- **📝 规格驱动开发** - 先定义清晰需求，再编码
-- **🔗 任务可追溯性** - 每行代码对应明确的任务珠子
-- **🎯 知识复用** - 自动匹配并应用已验证的技能模板
-- **💰 成本控制** - 智能追踪 token 消耗，避免超支
-- **🤖 多提供商支持** - 集成 OMO，支持 75+ LLM 提供商（Anthropic、OpenAI、Antigravity 等）
-- **🎭 Agent 编排** - 多个 AI 代理智能协作
+## ✨ 为什么选择 Axon?
+
+**Axon 将 AI 从“代码补全工具”转变为真正的“开发合作伙伴”。**
+
+- **🧠 规格优先**: 拒绝随意对话。在 `spec.md` 中定义需求，让 AI 保持专注。
+- **🗺️ 珠子规划**: 将复杂功能拆解为原子的、按依赖排序的任务 (Beads)。
+- **🤖 代理执行**: **OpenCode** 智能体逐个执行任务，确保上下文完整和代码质量。
+- **♻️ 技能复用**: 自动应用团队库中经过验证的模式 (如“安全认证”)。
+- **🛡️ 企业级安全**: Token 预算控制、Git 安全检查以及通过 **OMO** 实现的多模型故障转移。
 
 ## 🎯 适用场景
 

package/dist/index.js

@@ -17439,9 +17439,185 @@ var init_orchestrator = __esm(() => {
   init_errors();
 });
 
+// src/core/skills/library.ts
+import { existsSync as existsSync7, mkdirSync as mkdirSync4 } from "fs";
+import { readdir, readFile, writeFile } from "fs/promises";
+import { join as join6, basename as basename2, dirname as dirname3 } from "path";
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return { metadata: {}, body: content };
+  }
+  const [, frontmatter, body] = match;
+  const metadata = {};
+  for (const line of frontmatter.split(`
+`)) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex > 0) {
+      const key = line.slice(0, colonIndex).trim();
+      let value = line.slice(colonIndex + 1).trim();
+      if (typeof value === "string" && value.startsWith("[") && value.endsWith("]")) {
+        try {
+          value = JSON.parse(value);
+        } catch {
+          const strValue = value;
+          const inner = strValue.slice(1, -1).trim();
+          if (inner) {
+            value = inner.split(",").map((s) => s.trim());
+          } else {
+            value = [];
+          }
+        }
+      }
+      metadata[key] = value;
+    }
+  }
+  return { metadata, body: body.trim() };
+}
+
+class SkillsLibrary {
+  skills = [];
+  indexed = false;
+  paths;
+  constructor(localPath, globalPath) {
+    this.paths = [localPath, globalPath].filter((p) => existsSync7(p));
+  }
+  async index() {
+    this.skills = [];
+    for (const basePath of this.paths) {
+      await this.indexDirectory(basePath);
+    }
+    this.indexed = true;
+  }
+  async indexDirectory(dir) {
+    if (!existsSync7(dir))
+      return;
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join6(dir, entry.name);
+      if (entry.isDirectory()) {
+        await this.indexDirectory(fullPath);
+      } else if (entry.name.endsWith(".md")) {
+        try {
+          const content = await readFile(fullPath, "utf-8");
+          const { metadata, body } = parseFrontmatter(content);
+          this.skills.push({
+            metadata: {
+              name: metadata["name"] || basename2(fullPath, ".md"),
+              description: metadata["description"] || "",
+              tags: metadata["tags"] || [],
+              models: metadata["models"] || [],
+              tokens_avg: Number(metadata["tokens_avg"]) || 2000,
+              difficulty: metadata["difficulty"] || "medium",
+              last_updated: metadata["last_updated"] || new Date().toISOString()
+            },
+            content: body,
+            path: fullPath
+          });
+        } catch {}
+      }
+    }
+  }
+  async search(query, limit = 5) {
+    if (!this.indexed) {
+      await this.index();
+    }
+    const queryLower = query.toLowerCase();
+    const results = [];
+    for (const skill of this.skills) {
+      let score = 0;
+      const matchedOn = [];
+      if (skill.metadata.name.toLowerCase().includes(queryLower)) {
+        score += 100;
+        matchedOn.push("name");
+      }
+      for (const tag of skill.metadata.tags) {
+        if (tag.toLowerCase().includes(queryLower)) {
+          score += 50;
+          if (!matchedOn.includes("tags"))
+            matchedOn.push("tags");
+        }
+      }
+      if (skill.metadata.description.toLowerCase().includes(queryLower)) {
+        score += 30;
+        matchedOn.push("description");
+      }
+      const contentMatches = (skill.content.toLowerCase().match(new RegExp(queryLower, "g")) || []).length;
+      if (contentMatches > 0) {
+        score += contentMatches * 10;
+        matchedOn.push("content");
+      }
+      if (score > 0) {
+        results.push({ skill, score, matchedOn });
+      }
+    }
+    return results.sort((a, b) => b.score - a.score).slice(0, limit);
+  }
+  async getByPath(path) {
+    if (!this.indexed) {
+      await this.index();
+    }
+    return this.skills.find((s) => s.path === path) || null;
+  }
+  async save(skill, targetPath) {
+    const dir = dirname3(targetPath);
+    if (!existsSync7(dir)) {
+      mkdirSync4(dir, { recursive: true });
+    }
+    const frontmatter = [
+      "---",
+      `name: ${skill.metadata.name}`,
+      `description: ${skill.metadata.description}`,
+      `tags: ${JSON.stringify(skill.metadata.tags)}`,
+      `models: ${JSON.stringify(skill.metadata.models)}`,
+      `tokens_avg: ${skill.metadata.tokens_avg}`,
+      `difficulty: ${skill.metadata.difficulty}`,
+      `last_updated: ${new Date().toISOString().split("T")[0]}`,
+      "---",
+      ""
+    ].join(`
+`);
+    const content = frontmatter + skill.content;
+    await writeFile(targetPath, content, "utf-8");
+    this.indexed = false;
+  }
+  async list(filter) {
+    if (!this.indexed) {
+      await this.index();
+    }
+    let result = [...this.skills];
+    if (filter?.tags?.length) {
+      result = result.filter((s) => s.metadata.tags.some((t) => filter.tags?.includes(t)));
+    }
+    if (filter?.difficulty) {
+      result = result.filter((s) => s.metadata.difficulty === filter.difficulty);
+    }
+    return result;
+  }
+  async getStats() {
+    if (!this.indexed) {
+      await this.index();
+    }
+    const byTag = {};
+    const byDifficulty = {};
+    for (const skill of this.skills) {
+      for (const tag of skill.metadata.tags) {
+        byTag[tag] = (byTag[tag] || 0) + 1;
+      }
+      byDifficulty[skill.metadata.difficulty] = (byDifficulty[skill.metadata.difficulty] || 0) + 1;
+    }
+    return {
+      total: this.skills.length,
+      byTag,
+      byDifficulty
+    };
+  }
+}
+var init_library = () => {};
+
 // src/core/beads/executor.ts
-import { existsSync as existsSync7, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { join as join7 } from "path";
 
 class BeadsExecutor {
   graph;
@@ -17449,15 +17625,18 @@ class BeadsExecutor {
   config;
   orchestrator;
   git;
+  skillsLibrary;
   constructor(config, projectRoot, apiKey) {
     this.config = config;
-    this.graphPath = join6(projectRoot, config.tools.beads.path, "graph.json");
+    this.graphPath = join7(projectRoot, config.tools.beads.path, "graph.json");
     this.graph = this.loadGraph();
     this.orchestrator = new AgentOrchestrator(config, apiKey);
     this.git = new GitOperations(projectRoot);
+    const localSkillsPath = join7(projectRoot, config.tools.skills.local_path);
+    this.skillsLibrary = new SkillsLibrary(localSkillsPath, config.tools.skills.global_path);
   }
   loadGraph() {
-    if (!existsSync7(this.graphPath)) {
+    if (!existsSync8(this.graphPath)) {
       throw new BeadsError("\u4EFB\u52A1\u56FE\u6587\u4EF6\u4E0D\u5B58\u5728", ["\u8FD0\u884C `ax plan` \u751F\u6210\u4EFB\u52A1\u56FE"]);
     }
     try {
@@ -17505,12 +17684,22 @@ class BeadsExecutor {
     logger.info(`\uD83D\uDCCB \u63CF\u8FF0: ${bead.description}`);
     this.updateBeadStatus(bead.id, "running");
     try {
-      const specPath = join6(this.config.tools.openspec.path, "spec.md");
-      const spec = existsSync7(specPath) ? readFileSync4(specPath, "utf-8") : "";
+      const specPath = join7(this.config.tools.openspec.path, "spec.md");
+      const spec = existsSync8(specPath) ? readFileSync4(specPath, "utf-8") : "";
+      let skills = [];
+      if (this.config.tools.skills.enabled) {
+        const query = `${bead.title} ${bead.skills_required.join(" ")}`;
+        const searchResults = await this.skillsLibrary.search(query, 3);
+        skills = searchResults.map((r) => r.skill);
+        if (skills.length > 0) {
+          logger.info(`\uD83D\uDCDA \u5339\u914D\u6280\u80FD\u6A21\u677F:`);
+          skills.forEach((s) => logger.info(`   - ${s.metadata.name}`));
+        }
+      }
       const result = await this.orchestrator.execute({
         bead,
         spec,
-        skills: []
+        skills
       });
       if (this.config.tools.beads.auto_commit && result.artifacts.files.length > 0) {
         await this.commitChanges(bead, result.artifacts.commits);
@@ -17592,6 +17781,7 @@ var init_executor = __esm(() => {
   init_git();
   init_errors();
   init_logger();
+  init_library();
 });
 
 // src/core/beads/index.ts
@@ -17650,7 +17840,7 @@ async function checkCompatibility() {
     compatible: true,
     required: ">=18.0.0"
   });
-  if (process.env.DEBUG) {
+  if (process.env["DEBUG"]) {
     logger.debug("Compatibility Checks:");
     checks.forEach((c) => {
       logger.debug(`  ${c.tool}: ${c.version} (Required: ${c.required})`);
@@ -24828,8 +25018,8 @@ specCommand.command("validate").description("\u9A8C\u8BC1\u89C4\u683C\u6587\u686
 });
 // src/commands/plan.ts
 init_source();
-import { existsSync as existsSync8, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4 } from "fs";
-import { join as join7, dirname as dirname3 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5 } from "fs";
+import { join as join8, dirname as dirname4 } from "path";
 init_errors();
 init_logger();
 var planCommand = new Command("plan").description("\u4ECE\u89C4\u683C\u6587\u6863\u751F\u6210\u4EFB\u52A1\u56FE").option("--visualize", "\u5728\u6D4F\u89C8\u5668\u4E2D\u53EF\u89C6\u5316").option("--output <path>", "\u81EA\u5B9A\u4E49\u8F93\u51FA\u8DEF\u5F84").option("--model <name>", "\u6307\u5B9A\u4F7F\u7528\u7684\u6A21\u578B").option("--dry-run", "\u53EA\u9A8C\u8BC1\uFF0C\u4E0D\u751F\u6210").action(async (options) => {
@@ -24844,8 +25034,8 @@ var planCommand = new Command("plan").description("\u4ECE\u89C4\u683C\u6587\u686
   }
   const configManager = new ConfigManager(projectRoot);
   const config = configManager.get();
-  const specPath = join7(projectRoot, config.tools.openspec.path, "spec.md");
-  if (!existsSync8(specPath)) {
+  const specPath = join8(projectRoot, config.tools.openspec.path, "spec.md");
+  if (!existsSync9(specPath)) {
     throw new AxonError("\u89C4\u683C\u6587\u6863\u4E0D\u5B58\u5728", "PLAN_ERROR", [
       "\u4F7F\u7528 `ax spec init` \u521B\u5EFA\u89C4\u683C\u6587\u6863"
     ]);
@@ -24873,10 +25063,10 @@ var planCommand = new Command("plan").description("\u4ECE\u89C4\u683C\u6587\u686
     throw new AxonError("\u4EFB\u52A1\u56FE\u9A8C\u8BC1\u5931\u8D25", "PLAN_ERROR");
   }
   spinner.succeed("\u4EFB\u52A1\u56FE\u9A8C\u8BC1\u901A\u8FC7");
-  const graphPath = options.output || join7(projectRoot, config.tools.beads.path, "graph.json");
-  const graphDir = dirname3(graphPath);
-  if (!existsSync8(graphDir)) {
-    mkdirSync4(graphDir, { recursive: true });
+  const graphPath = options.output || join8(projectRoot, config.tools.beads.path, "graph.json");
+  const graphDir = dirname4(graphPath);
+  if (!existsSync9(graphDir)) {
+    mkdirSync5(graphDir, { recursive: true });
   }
   writeFileSync4(graphPath, JSON.stringify(graph2, null, 2), "utf-8");
   logger.blank();
@@ -25032,180 +25222,9 @@ init_source();
 import { existsSync as existsSync10 } from "fs";
 import { join as join9, basename as basename3 } from "path";
 
-// src/core/skills/library.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync5 } from "fs";
-import { readdir, readFile, writeFile } from "fs/promises";
-import { join as join8, basename as basename2, dirname as dirname4 } from "path";
-function parseFrontmatter(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-  if (!match) {
-    return { metadata: {}, body: content };
-  }
-  const [, frontmatter, body] = match;
-  const metadata = {};
-  for (const line of frontmatter.split(`
-`)) {
-    const colonIndex = line.indexOf(":");
-    if (colonIndex > 0) {
-      const key = line.slice(0, colonIndex).trim();
-      let value = line.slice(colonIndex + 1).trim();
-      if (typeof value === "string" && value.startsWith("[") && value.endsWith("]")) {
-        try {
-          value = JSON.parse(value);
-        } catch {
-          const strValue = value;
-          const inner = strValue.slice(1, -1).trim();
-          if (inner) {
-            value = inner.split(",").map((s) => s.trim());
-          } else {
-            value = [];
-          }
-        }
-      }
-      metadata[key] = value;
-    }
-  }
-  return { metadata, body: body.trim() };
-}
+// src/core/skills/index.ts
+init_library();
 
-class SkillsLibrary {
-  skills = [];
-  indexed = false;
-  paths;
-  constructor(localPath, globalPath) {
-    this.paths = [localPath, globalPath].filter((p) => existsSync9(p));
-  }
-  async index() {
-    this.skills = [];
-    for (const basePath of this.paths) {
-      await this.indexDirectory(basePath);
-    }
-    this.indexed = true;
-  }
-  async indexDirectory(dir) {
-    if (!existsSync9(dir))
-      return;
-    const entries = await readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const fullPath = join8(dir, entry.name);
-      if (entry.isDirectory()) {
-        await this.indexDirectory(fullPath);
-      } else if (entry.name.endsWith(".md")) {
-        try {
-          const content = await readFile(fullPath, "utf-8");
-          const { metadata, body } = parseFrontmatter(content);
-          this.skills.push({
-            metadata: {
-              name: metadata["name"] || basename2(fullPath, ".md"),
-              description: metadata["description"] || "",
-              tags: metadata["tags"] || [],
-              models: metadata["models"] || [],
-              tokens_avg: Number(metadata["tokens_avg"]) || 2000,
-              difficulty: metadata["difficulty"] || "medium",
-              last_updated: metadata["last_updated"] || new Date().toISOString()
-            },
-            content: body,
-            path: fullPath
-          });
-        } catch {}
-      }
-    }
-  }
-  async search(query, limit = 5) {
-    if (!this.indexed) {
-      await this.index();
-    }
-    const queryLower = query.toLowerCase();
-    const results = [];
-    for (const skill of this.skills) {
-      let score = 0;
-      const matchedOn = [];
-      if (skill.metadata.name.toLowerCase().includes(queryLower)) {
-        score += 100;
-        matchedOn.push("name");
-      }
-      for (const tag of skill.metadata.tags) {
-        if (tag.toLowerCase().includes(queryLower)) {
-          score += 50;
-          if (!matchedOn.includes("tags"))
-            matchedOn.push("tags");
-        }
-      }
-      if (skill.metadata.description.toLowerCase().includes(queryLower)) {
-        score += 30;
-        matchedOn.push("description");
-      }
-      const contentMatches = (skill.content.toLowerCase().match(new RegExp(queryLower, "g")) || []).length;
-      if (contentMatches > 0) {
-        score += contentMatches * 10;
-        matchedOn.push("content");
-      }
-      if (score > 0) {
-        results.push({ skill, score, matchedOn });
-      }
-    }
-    return results.sort((a, b) => b.score - a.score).slice(0, limit);
-  }
-  async getByPath(path) {
-    if (!this.indexed) {
-      await this.index();
-    }
-    return this.skills.find((s) => s.path === path) || null;
-  }
-  async save(skill, targetPath) {
-    const dir = dirname4(targetPath);
-    if (!existsSync9(dir)) {
-      mkdirSync5(dir, { recursive: true });
-    }
-    const frontmatter = [
-      "---",
-      `name: ${skill.metadata.name}`,
-      `description: ${skill.metadata.description}`,
-      `tags: ${JSON.stringify(skill.metadata.tags)}`,
-      `models: ${JSON.stringify(skill.metadata.models)}`,
-      `tokens_avg: ${skill.metadata.tokens_avg}`,
-      `difficulty: ${skill.metadata.difficulty}`,
-      `last_updated: ${new Date().toISOString().split("T")[0]}`,
-      "---",
-      ""
-    ].join(`
-`);
-    const content = frontmatter + skill.content;
-    await writeFile(targetPath, content, "utf-8");
-    this.indexed = false;
-  }
-  async list(filter) {
-    if (!this.indexed) {
-      await this.index();
-    }
-    let result = [...this.skills];
-    if (filter?.tags?.length) {
-      result = result.filter((s) => s.metadata.tags.some((t) => filter.tags?.includes(t)));
-    }
-    if (filter?.difficulty) {
-      result = result.filter((s) => s.metadata.difficulty === filter.difficulty);
-    }
-    return result;
-  }
-  async getStats() {
-    if (!this.indexed) {
-      await this.index();
-    }
-    const byTag = {};
-    const byDifficulty = {};
-    for (const skill of this.skills) {
-      for (const tag of skill.metadata.tags) {
-        byTag[tag] = (byTag[tag] || 0) + 1;
-      }
-      byDifficulty[skill.metadata.difficulty] = (byDifficulty[skill.metadata.difficulty] || 0) + 1;
-    }
-    return {
-      total: this.skills.length,
-      byTag,
-      byDifficulty
-    };
-  }
-}
 // src/commands/skills.ts
 init_logger();
 init_errors();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arrislink/axon",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "AI-Powered Development Operating System with unified LLM provider support",
   "type": "module",
   "main": "dist/index.js",