@sakanano-moe/agenthelm 6.5.2 → 6.6.0

package/runtime/plugins/agents-init/skills/agents-init/index.html

@@ -0,0 +1,357 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>agents-init v6 · 云端 Skills</title>
+  <meta name="description" content="创建或迁移通用项目骨架与 Project Profile；随包管理生命周期、扩展能力与 Opinion。">
+  <style>
+    :root {
+      color-scheme: light;
+      --ink: #171717;
+      --muted: #625f59;
+      --paper: #fbfaf6;
+      --panel: #ffffff;
+      --line: #d8d1c1;
+      --accent: #0f766e;
+      --accent-strong: #134e4a;
+      --soft: #edf7f5;
+      --warn: #f2c94c;
+    }
+
+    * {
+      box-sizing: border-box;
+    }
+
+    body {
+      margin: 0;
+      background: var(--paper);
+      color: var(--ink);
+      font-family: "Avenir Next", "Gill Sans", "Noto Sans SC", sans-serif;
+      line-height: 1.7;
+    }
+
+    a {
+      color: var(--accent-strong);
+      text-underline-offset: 0.18em;
+    }
+
+    .wrap {
+      width: min(980px, calc(100% - 32px));
+      margin: 0 auto;
+      padding: 38px 0 64px;
+    }
+
+    nav {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 10px;
+      align-items: center;
+      justify-content: space-between;
+      padding-bottom: 22px;
+      border-bottom: 1px solid var(--line);
+      color: var(--muted);
+      font-size: 14px;
+    }
+
+    .crumb {
+      font-weight: 700;
+    }
+
+    .links {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+    }
+
+    .pill {
+      display: inline-flex;
+      align-items: center;
+      min-height: 34px;
+      padding: 6px 11px;
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      background: #fff;
+      text-decoration: none;
+      font-weight: 700;
+    }
+
+    header {
+      padding: 42px 0 30px;
+    }
+
+    .eyebrow {
+      margin: 0 0 10px;
+      color: var(--accent-strong);
+      font-size: 13px;
+      font-weight: 800;
+      letter-spacing: 0.08em;
+      text-transform: uppercase;
+    }
+
+    h1 {
+      margin: 0;
+      font-family: Georgia, "Noto Serif SC", serif;
+      font-size: clamp(38px, 7vw, 78px);
+      line-height: 1;
+      letter-spacing: 0;
+    }
+
+    .lead {
+      max-width: 760px;
+      margin: 20px 0 0;
+      color: var(--muted);
+      font-size: 18px;
+    }
+
+    .meta {
+      display: grid;
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+      gap: 10px;
+      margin: 26px 0 0;
+    }
+
+    .meta div {
+      padding: 12px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: #fff;
+    }
+
+    .meta strong,
+    .meta span {
+      display: block;
+    }
+
+    .meta strong {
+      font-size: 12px;
+      color: var(--muted);
+    }
+
+    .meta span {
+      margin-top: 4px;
+      font-weight: 800;
+    }
+
+    main {
+      display: grid;
+      gap: 22px;
+    }
+
+    section {
+      padding: 24px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--panel);
+    }
+
+    h2 {
+      margin: 0 0 12px;
+      font-size: 22px;
+      line-height: 1.25;
+    }
+
+    p,
+    ul,
+    ol {
+      margin: 0;
+      color: var(--muted);
+    }
+
+    ul,
+    ol {
+      padding-left: 20px;
+    }
+
+    li + li {
+      margin-top: 5px;
+    }
+
+    code {
+      padding: 0.1em 0.28em;
+      border-radius: 4px;
+      background: rgba(242, 201, 76, 0.25);
+      color: #24221e;
+      font-family: "SFMono-Regular", Consolas, monospace;
+      font-size: 0.92em;
+    }
+
+    .resource-grid {
+      display: grid;
+      grid-template-columns: repeat(3, minmax(0, 1fr));
+      gap: 12px;
+    }
+
+    .resource {
+      display: block;
+      min-height: 94px;
+      padding: 14px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--soft);
+      text-decoration: none;
+    }
+
+    .resource strong,
+    .resource span {
+      display: block;
+    }
+
+    .resource strong {
+      color: var(--accent-strong);
+    }
+
+    .resource span {
+      margin-top: 6px;
+      color: var(--muted);
+      font-size: 14px;
+      font-weight: 400;
+    }
+
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      overflow-wrap: anywhere;
+    }
+
+    th,
+    td {
+      padding: 10px;
+      border-bottom: 1px solid var(--line);
+      text-align: left;
+      vertical-align: top;
+    }
+
+    th {
+      color: var(--accent-strong);
+      font-size: 14px;
+    }
+
+    footer {
+      margin-top: 26px;
+      color: var(--muted);
+      font-size: 14px;
+    }
+
+    @media (max-width: 760px) {
+      .meta,
+      .resource-grid {
+        grid-template-columns: 1fr;
+      }
+
+      section {
+        padding: 18px;
+      }
+    }
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <nav>
+      <a class="crumb" href="../../index.html">← 云端 Skills</a>
+      <div class="links">
+        <a class="pill" href="./SKILL.md">SKILL.md</a>
+        <a class="pill" href="./skill.json">skill.json</a>
+        <a class="pill" href="./AGENT.template.md">AGENT.template.md</a>
+      </div>
+    </nav>
+
+    <header>
+      <p class="eyebrow">Skill · agents-init</p>
+      <h1>agents-init v6</h1>
+      <p class="lead">创建或迁移通用项目骨架与 Project Profile；写入前验证随包的 <code>project-orchestrator</code>、<code>agent-pack</code> 与 <code>opinion-manager</code>。</p>
+      <div class="meta" aria-label="Skill 元数据">
+        <div><strong>版本</strong><span>6.3.0</span></div>
+        <div><strong>状态</strong><span>stable</span></div>
+        <div><strong>更新</strong><span>2026-09-29</span></div>
+        <div><strong>语言</strong><span>zh-CN</span></div>
+      </div>
+    </header>
+
+    <main>
+      <section>
+        <h2>资源入口</h2>
+        <div class="resource-grid">
+          <a class="resource" href="./SKILL.md">
+            <strong>AI 原文</strong>
+            <span>执行入口与初始化流程，适合 Agent 直接读取。</span>
+          </a>
+          <a class="resource" href="./skill.json">
+            <strong>机器元数据</strong>
+            <span>版本、路径、标签、输入输出等结构化信息。</span>
+          </a>
+          <a class="resource" href="./AGENT.template.md">
+            <strong>模板文件</strong>
+            <span>v6 骨架契约、职责边界与迁移规则。</span>
+          </a>
+        </div>
+      </section>
+
+      <section>
+        <h2>文件分工</h2>
+        <table>
+          <thead>
+            <tr>
+              <th>文件</th>
+              <th>作用</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr><td><code>SKILL.md</code></td><td>AI Agent 的执行入口，说明触发方式、流程和必读文件。</td></tr>
+            <tr><td><code>AGENT.template.md</code></td><td>项目骨架、Project Profile 与迁移契约。</td></tr>
+            <tr><td><code>skill.json</code></td><td>机器可读元数据，用于索引、安装、版本检查和自动发现。</td></tr>
+            <tr><td><code>index.html</code></td><td>浏览器可读页面。</td></tr>
+          </tbody>
+        </table>
+      </section>
+
+      <section>
+        <h2>适用场景</h2>
+        <ul>
+          <li>新仓库需要统一的 Agent 入口与 Project Profile。</li>
+          <li>旧版 agents-init 项目（含 v5 project-runtime Profile）需要迁移到 v6 职责边界。</li>
+          <li>项目准备通过 project-orchestrator 管理 Task/Case 与 Git，通过 agent-pack 管理 Skill 与 MCP，通过 opinion-manager 管理 Agent 行为规则。</li>
+          <li>公开模板需要排除个人规则、凭据与私有路径。</li>
+        </ul>
+      </section>
+
+      <section>
+        <h2>输入信息</h2>
+        <table>
+          <thead>
+            <tr>
+              <th>字段</th>
+              <th>必填</th>
+              <th>说明</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr><td>项目名称</td><td>是</td><td>仓库或产品的名称。</td></tr>
+            <tr><td>项目类型</td><td>是</td><td>代码、文档、工作流或其他可组合类型。</td></tr>
+            <tr><td>技术栈</td><td>是</td><td>可从仓库文件确认的语言与框架。</td></tr>
+            <tr><td>运行环境</td><td>是</td><td>本地、容器、远程或混合。</td></tr>
+            <tr><td>Agent 客户端</td><td>是</td><td>Codex、Cursor、Claude Code 等入口。</td></tr>
+            <tr><td>项目命令</td><td>否</td><td>不能确认时保留 TODO，不由模板臆造。</td></tr>
+          </tbody>
+        </table>
+      </section>
+
+      <section>
+        <h2>标准流程</h2>
+        <ol>
+          <li>扫描仓库并确认可证实的 Project Profile 字段。</li>
+          <li>预览 v6 文件计划和所有路径冲突。</li>
+          <li>确认后运行无覆盖初始化器。</li>
+          <li>解析 JSON 并检查 Agent 路由一致性。</li>
+          <li>由随包 agent-pack 后续导入或同步 Skill/MCP。</li>
+          <li>由随包 opinion-manager 提供直接用模板、选择部分条目、从空白开始；另可基于已授权记忆提出候选。完整内容集中确认。</li>
+        </ol>
+      </section>
+    </main>
+
+    <footer>
+      <span>路径：plugins/agents-init/skills/agents-init/ · License: MIT</span>
+    </footer>
+  </div>
+</body>
+</html>

package/runtime/plugins/agents-init/skills/agents-init/launcher.sh

@@ -0,0 +1,93 @@
+#!/bin/sh
+# 项目入口（由 agents-init 生成，文件名可以改）：./<本文件> 打开项目菜单，
+# ./<本文件> --help 查看不进菜单时可用的命令。不调用模型，不联网下载代码。
+#
+# 按顺序查找 agenthelm 运行时，找到第一个就交给它：
+#   1. 环境变量 AGENTHELM_BIN 指向的命令
+#   2. 用户运行时目录 ${XDG_DATA_HOME:-~/.local/share}/agenthelm/current
+#   3. PATH 上的 agenthelm
+#   4. 已安装的 AI 客户端里随插件带来的 agent-pack（需要 Python 3.11+）
+# 都找不到时说明原因和下一步，退出码 3。
+set -u
+LAUNCHER_API=1
+root=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+
+python_ok() {
+  "$1" -c 'import sys; sys.exit(0 if sys.version_info >= (3, 11) else 1)' >/dev/null 2>&1
+}
+
+find_python() {
+  for candidate in "${AGENTHELM_PYTHON:-}" python3 python; do
+    [ -n "$candidate" ] || continue
+    command -v "$candidate" >/dev/null 2>&1 || continue
+    if python_ok "$candidate"; then
+      printf '%s\n' "$candidate"
+      return 0
+    fi
+  done
+  return 1
+}
+
+if [ -n "${AGENTHELM_BIN:-}" ]; then
+  if [ -x "$AGENTHELM_BIN" ] || command -v "$AGENTHELM_BIN" >/dev/null 2>&1; then
+    exec "$AGENTHELM_BIN" project --project "$root" --via-launcher "$LAUNCHER_API" "$@"
+  fi
+  echo "AGENTHELM_BIN 指向的命令不存在：${AGENTHELM_BIN}" >&2
+  echo "  · 改正或删除这个环境变量后重试" >&2
+  exit 3
+fi
+
+current="${XDG_DATA_HOME:-$HOME/.local/share}/agenthelm/current/bin/agenthelm"
+if [ -x "$current" ]; then
+  exec "$current" project --project "$root" --via-launcher "$LAUNCHER_API" "$@"
+fi
+
+if command -v agenthelm >/dev/null 2>&1; then
+  exec agenthelm project --project "$root" --via-launcher "$LAUNCHER_API" "$@"
+fi
+
+python=$(find_python) || python=""
+if [ -n "$python" ]; then
+  # 客户端插件缓存：Claude Code、Codex 为 <插件>/<版本>/，Cursor 为本地目录；取版本最高的一个。
+  best=$("$python" - "$HOME" "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" "${CODEX_HOME:-$HOME/.codex}" <<'PY'
+import re, sys
+from pathlib import Path
+home, claude, codex = map(Path, sys.argv[1:4])
+patterns = [(claude / "plugins/cache/agenthelm/agent-pack", "*/runtime/agenthelm.py"),
+            (codex / "plugins/cache/agenthelm/agent-pack", "*/runtime/agenthelm.py"),
+            (home / ".cursor/plugins/local/agent-pack", "runtime/agenthelm.py")]
+def key(path):
+    match = re.search(r"/(\d+)\.(\d+)\.(\d+)/runtime/", path.as_posix())
+    return tuple(map(int, match.groups())) if match else (0, 0, 0)
+found = [path for base, pattern in patterns for path in base.glob(pattern)]
+print(max(found, key=key) if found else "")
+PY
+)
+  if [ -n "$best" ]; then
+    exec "$python" "$best" project --project "$root" --via-launcher "$LAUNCHER_API" "$@"
+  fi
+fi
+
+{
+  echo "打不开项目菜单：本机还没有 agenthelm 运行时。"
+  if [ -z "$python" ]; then
+    old=$(python3 -c 'import platform; print(platform.python_version())' 2>/dev/null || true)
+    if [ -n "$old" ]; then
+      echo "原因：找到的 Python 是 ${old}，需要 3.11 或更高版本（agenthelm 的日常功能只需要它，不需要 AI 客户端）。"
+    else
+      echo "原因：没有找到 Python 3.11 或更高版本（agenthelm 的日常功能只需要它，不需要 AI 客户端）。"
+    fi
+    echo "下一步："
+    echo "  1. 安装 Python 3.11+（macOS 可用 python.org 安装包或 Homebrew；Linux 用发行版的包管理器）"
+    echo "  2. 已装在别处时：export AGENTHELM_PYTHON=/path/to/python3"
+    echo "  3. 然后安装运行时（见下）"
+  else
+    echo "原因：没有找到 agenthelm 运行时；日常使用只需要 Python 3.11+，不需要 AI 客户端。"
+  fi
+  echo "安装运行时（只需一次，之后打开菜单不再联网）："
+  echo "  · 联网：npx @sakanano-moe/agenthelm runtime install --apply"
+  echo "  · 离线：解压发布包（agenthelm-v<版本>.tar.gz）后运行"
+  echo "      python3 <解压目录>/plugins/agent-pack/runtime/agenthelm.py runtime install --apply"
+  echo "  · 已有运行时：export AGENTHELM_BIN=/path/to/agenthelm"
+} >&2
+exit 3

package/runtime/plugins/agents-init/skills/agents-init/project.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://skill.sakanano.moe/skills/agents-init/project.schema.json",
+  "title": "agents-init Project Profile",
+  "description": "由 project-orchestrator、agent-pack 与 opinion-manager 消费的可移植项目发现契约，位于 .agents/moe.sakanano.agent-pack/project.json。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "name", "profile", "runtime", "opinion", "capabilities", "work", "privacy"],
+  "properties": {
+    "$schema": {"type": "string", "format": "uri-reference"},
+    "schema_version": {"const": "1.0"},
+    "initializer_version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"},
+    "name": {"type": "string", "minLength": 1},
+    "profile": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["project_type", "vcs", "stack", "runtime", "agent_cli"],
+      "properties": {
+        "project_type": {"$ref": "#/$defs/stringArray"},
+        "vcs": {"type": "string", "minLength": 1},
+        "stack": {"$ref": "#/$defs/stringArray"},
+        "runtime": {"type": "string", "minLength": 1},
+        "agent_cli": {"$ref": "#/$defs/stringArray"}
+      }
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["skill", "plugin", "capability_manager", "required", "commit_policy", "push_policy"],
+      "properties": {
+        "skill": {"const": "project-orchestrator"},
+        "plugin": {"const": "project-orchestrator"},
+        "capability_manager": {"const": "agent-pack"},
+        "distribution": {"enum": ["marketplace", "bundled", "external"]},
+        "required": {"type": "boolean"},
+        "commit_policy": {"enum": ["explicit", "project-policy"]},
+        "push_policy": {"enum": ["explicit", "project-policy"]}
+      }
+    },
+    "opinion": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["provider", "project_overlay", "strict_mode"],
+      "properties": {
+        "provider": {"type": ["string", "null"]},
+        "project_overlay": {"type": ["string", "null"]},
+        "strict_mode": {"enum": ["smart", "strict", "disabled"]},
+        "loading_mode": {"enum": ["tiered", "full"]}
+      }
+    },
+    "memory": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["provider"],
+      "properties": {
+        "provider": {"enum": ["project-orchestrator", "project"]},
+        "root": {"anyOf": [{"$ref": "#/$defs/relativePath"}, {"type": "null"}]},
+        "index_command": {"type": ["string", "null"]},
+        "check_command": {"type": ["string", "null"]},
+        "policy": {"anyOf": [{"$ref": "#/$defs/relativePath"}, {"type": "null"}]}
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["plugin_roots", "plugin_dirs", "skill_roots", "mcp_sources", "destination_skill_root", "destination_mcp"],
+      "properties": {
+        "plugin_roots": {"$ref": "#/$defs/pathArray"},
+        "plugin_dirs": {"$ref": "#/$defs/pathArray"},
+        "skill_roots": {"$ref": "#/$defs/pathArray"},
+        "mcp_sources": {"$ref": "#/$defs/pathArray"},
+        "native_mcp_sources": {"$ref": "#/$defs/pathArray"},
+        "credential_env_file": {
+          "anyOf": [{"$ref": "#/$defs/relativePath"}, {"type": "null"}]
+        },
+        "mcp_client_policy": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "include": {"$ref": "#/$defs/stringArray"},
+              "exclude": {"$ref": "#/$defs/stringArray"}
+            },
+            "not": {"required": ["include", "exclude"]}
+          }
+        },
+        "destination_skill_root": {"$ref": "#/$defs/relativePath"},
+        "destination_mcp": {"$ref": "#/$defs/relativePath"}
+      }
+    },
+    "work": {
+      "type": "object", "additionalProperties": true,
+      "properties": {
+        "mode": {"enum": ["case-workspace", "legacy"]},
+        "task": {"type": ["object", "null"]},
+        "legacy_task": {"type": ["object", "null"]},
+        "case": {
+          "type": ["object", "null"], "additionalProperties": true,
+          "properties": {
+            "root": {"$ref": "#/$defs/relativePath"},
+            "artifact_mode": {"enum": ["case-local", "external-references"]}
+          }
+        },
+        "assets": {
+          "type": ["object", "null"], "additionalProperties": true,
+          "properties": {
+            "roots": {"$ref": "#/$defs/pathArray"}
+          }
+        }
+      }
+    },
+    "entry": {
+      "type": ["object", "null"],
+      "additionalProperties": true,
+      "description": "人用入口：不经过 AI Agent 打开项目菜单。缺省时仍可用 agenthelm project。",
+      "properties": {
+        "api": {"type": "integer", "minimum": 1, "description": "项目入口的接口版本；运行时不支持时启动器提示更新"},
+        "launcher": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$", "description": "根目录启动器的文件名"},
+        "about": {"type": "string"},
+        "guide": {"$ref": "#/$defs/relativePath"},
+        "tools": {"$ref": "#/$defs/relativePath"},
+        "where": {
+          "type": "array",
+          "items": {"type": "object", "required": ["label", "path"],
+                    "properties": {"label": {"type": "string"}, "path": {"type": "string"}}}
+        },
+        "start": {"$ref": "#/$defs/stringArray"},
+        "items": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["command"],
+          "properties": {
+            "command": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+            "write": {"type": "boolean"},
+            "status_map": {
+              "type": "object",
+              "additionalProperties": {"enum": ["active", "waiting", "captured", "suspended", "done", "abandoned"]}
+            }
+          }
+        }
+      }
+    },
+    "privacy": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["forbidden_default_reads", "generated_outputs"],
+      "properties": {
+        "forbidden_default_reads": {"$ref": "#/$defs/pathArray"},
+        "generated_outputs": {"$ref": "#/$defs/pathArray"}
+      }
+    }
+  },
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": {"type": "string", "minLength": 1},
+      "uniqueItems": true
+    },
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "not": {"pattern": "^(?:/|~|[A-Za-z]:[\\\\/])"}
+    },
+    "pathArray": {
+      "type": "array",
+      "items": {"$ref": "#/$defs/relativePath"},
+      "uniqueItems": true
+    }
+  }
+}