@apolloyh/apollo-agent 0.1.3 → 0.1.5

package/dist/brand.d.ts

@@ -1,7 +1,7 @@
 /** Product identity — single source of truth for display strings. */
 export declare const PRODUCT: {
     readonly name: "Apollo";
-    readonly version: "0.1.3";
+    readonly version: "0.1.5";
     readonly tagline: "Your personal agent — answer first, act when needed.";
     readonly packageName: "@apolloyh/apollo-agent";
     readonly userAgent: "ApolloAgent/0.1";

package/dist/brand.js

@@ -1,7 +1,7 @@
 /** Product identity — single source of truth for display strings. */
 export const PRODUCT = {
     name: "Apollo",
-    version: "0.1.3",
+    version: "0.1.5",
     tagline: "Your personal agent — answer first, act when needed.",
     packageName: "@apolloyh/apollo-agent",
     userAgent: "ApolloAgent/0.1",

package/dist/cli-input.d.ts

@@ -0,0 +1,16 @@
+export type PastedTextBlock = {
+    id: number;
+    label: string;
+    marker: string;
+    text: string;
+};
+export type InputView = {
+    cursorLine: number;
+    cursorWidth: number;
+    lines: string[];
+};
+export declare function createPastedTextBlock(text: string, id: number): PastedTextBlock | undefined;
+export declare function resolvePastedText(value: string, blocks: ReadonlyMap<string, PastedTextBlock>): string;
+export declare function pastedTextPreview(value: string, blocks: ReadonlyMap<string, PastedTextBlock>): string;
+export declare function renderInputView(value: string, cursor: number, width: number, blocks: ReadonlyMap<string, PastedTextBlock>): InputView;
+//# sourceMappingURL=cli-input.d.ts.map

package/dist/cli-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.d.ts","sourceRoot":"","sources":["../src/cli-input.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAMF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAQ3F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAErG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,MAAM,CAErG;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAC3C,SAAS,CAyCX"}

package/dist/cli-input.js

@@ -0,0 +1,68 @@
+const MIN_FOLDED_PASTE_LINES = 6;
+const MIN_FOLDED_PASTE_CHARS = 1000;
+const FIRST_MARKER = 0xf0000;
+export function createPastedTextBlock(text, id) {
+    const lineCount = text.split("\n").length;
+    if (lineCount < MIN_FOLDED_PASTE_LINES && Array.from(text).length < MIN_FOLDED_PASTE_CHARS) {
+        return undefined;
+    }
+    const marker = String.fromCodePoint(FIRST_MARKER + id);
+    const size = lineCount > 1 ? `+${lineCount} lines` : `+${Array.from(text).length} chars`;
+    return { id, label: `[Pasted text #${id} ${size}]`, marker, text };
+}
+export function resolvePastedText(value, blocks) {
+    return Array.from(value, (character) => blocks.get(character)?.text ?? character).join("");
+}
+export function pastedTextPreview(value, blocks) {
+    return Array.from(value, (character) => blocks.get(character)?.label ?? character).join("");
+}
+export function renderInputView(value, cursor, width, blocks) {
+    const characters = Array.from(value);
+    const positions = [];
+    const lines = [""];
+    let line = 0;
+    let column = 0;
+    const newLine = () => {
+        lines.push("");
+        line += 1;
+        column = 0;
+    };
+    const appendCharacter = (character) => {
+        if (character === "\n") {
+            newLine();
+            return;
+        }
+        const rendered = character === "\t" ? "  " : character;
+        for (const outputCharacter of rendered) {
+            const characterWidth = displayWidth(outputCharacter);
+            if (column > 0 && column + characterWidth > width)
+                newLine();
+            lines[line] += outputCharacter;
+            column += characterWidth;
+        }
+    };
+    characters.forEach((character, index) => {
+        const block = blocks.get(character);
+        if (block && column > 0 && column + displayWidth(block.label) > width)
+            newLine();
+        positions[index] = { line, width: column };
+        for (const outputCharacter of block?.label ?? character)
+            appendCharacter(outputCharacter);
+    });
+    positions[characters.length] = { line, width: column };
+    const cursorPosition = positions[Math.max(0, Math.min(cursor, characters.length))] ?? { line: 0, width: 0 };
+    return {
+        cursorLine: cursorPosition.line,
+        cursorWidth: cursorPosition.width,
+        lines,
+    };
+}
+function displayWidth(text) {
+    let length = 0;
+    for (const character of text)
+        length += isWideCharacter(character) ? 2 : 1;
+    return length;
+}
+function isWideCharacter(character) {
+    return /[\u1100-\u115F\u2E80-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE10-\uFE19\uFE30-\uFE6F\uFF00-\uFF60\uFFE0-\uFFE6]/u.test(character);
+}

package/dist/index.js

@@ -3,6 +3,7 @@ import { stdin, stdout } from "node:process";
 import readline from "node:readline/promises";
 import { ASCII_LOGO, PRODUCT } from "./brand.js";
 import { parseArgs } from "./cli-args.js";
+import { createPastedTextBlock, pastedTextPreview, renderInputView, resolvePastedText, } from "./cli-input.js";
 import { ensureUserEnvFile, loadAgentConfig, loadEnvFile, loadLlmConfig, MISSING_AUTH_TOKEN_MESSAGE, } from "./config.js";
 import { pickSpinnerVerb } from "./constants/spinner-verbs.js";
 import { QueryEngine } from "./runtime/query-engine.js";
@@ -23,6 +24,7 @@ let activeVerb = "Thinking";
 let assistantResponseStarted = false;
 /** Prevent double green/red outcome lines in one user turn */
 let outcomePrintedThisTurn = false;
+let pastedTextSequence = 0;
 const slashCommands = [
     { command: "/help", usage: "/help", description: "Show slash commands" },
     { command: "/skill", usage: "/skill", description: "List installed skills" },
@@ -1032,6 +1034,7 @@ async function readCliLine(options) {
     let previousRawMode = false;
     let renderedCursorLine = 0;
     let pasteBuffer;
+    const pastedTextBlocks = new Map();
     const pasteStart = "\x1b[200~";
     const pasteEnd = "\x1b[201~";
     const complete = (value) => {
@@ -1055,8 +1058,9 @@ async function readCliLine(options) {
         if (liveStatusLine)
             lines.push(liveStatusLine);
         lines.push(renderInputBorder("top", options.color));
-        const view = inputView(buffer, cursor, Math.max(20, (stdout.columns ?? 100) - 4));
-        lines.push(`${renderInputPrompt(options.color)}${view.text}`);
+        const view = renderInputView(buffer, cursor, inputContentWidth(), pastedTextBlocks);
+        lines.push(`${renderInputPrompt(options.color)}${view.lines[0] ?? ""}`);
+        lines.push(...view.lines.slice(1).map((line) => `  ${line}`));
         if (paletteOpen) {
             const filtered = filterSlashCommands(buffer);
             lines.push(...renderSlashPaletteLines(selected, options.color, filtered, buffer));
@@ -1088,21 +1092,23 @@ async function readCliLine(options) {
         const lines = linesForState();
         stdout.write(lines.join("\n"));
         renderedLines = lines.length;
-        renderedCursorLine = renderLiveStatusLine(options.color) ? 2 : 1;
+        const view = renderInputView(buffer, cursor, inputContentWidth(), pastedTextBlocks);
+        renderedCursorLine = (renderLiveStatusLine(options.color) ? 2 : 1) + view.cursorLine;
         const rowsBelowInput = lines.length - 1 - renderedCursorLine;
-        const view = inputView(buffer, cursor, Math.max(20, (stdout.columns ?? 100) - 4));
         stdout.write(`\x1b[${rowsBelowInput}A\r\x1b[${3 + view.cursorWidth}G`);
     };
     const finish = (value) => {
         clearRendered();
-        if (value) {
-            if (options.history.at(-1) !== value)
-                options.history.push(value);
+        const resolvedValue = resolvePastedText(value, pastedTextBlocks);
+        if (resolvedValue) {
+            if (options.history.at(-1) !== resolvedValue)
+                options.history.push(resolvedValue);
             if (options.history.length > 100)
                 options.history.splice(0, options.history.length - 100);
-            stdout.write(`${renderInputBorder("top", options.color)}\n${renderInputPrompt(options.color)}${submittedInputLabel(value)}\n${renderInputBorder("bottom", options.color)}\n`);
+            const preview = pastedTextPreview(value, pastedTextBlocks).replace(/\n/g, " ↵ ").replace(/\t/g, "  ");
+            stdout.write(`${renderInputBorder("top", options.color)}\n${renderInputPrompt(options.color)}${preview === value ? submittedInputLabel(resolvedValue) : preview}\n${renderInputBorder("bottom", options.color)}\n`);
         }
-        complete(value);
+        complete(resolvedValue);
     };
     const cancelForModal = () => {
         clearRendered();
@@ -1240,11 +1246,11 @@ async function readCliLine(options) {
                 if (historyIndex === options.history.length)
                     historyDraft = buffer;
                 historyIndex -= 1;
-                buffer = options.history[historyIndex] ?? "";
+                setBuffer(options.history[historyIndex] ?? "");
             }
             else if (chunk === "\x1b[B" && historyIndex < options.history.length) {
                 historyIndex += 1;
-                buffer = historyIndex === options.history.length ? historyDraft : options.history[historyIndex] ?? "";
+                setBuffer(historyIndex === options.history.length ? historyDraft : options.history[historyIndex] ?? "");
             }
             cursor = Array.from(buffer).length;
             closePalette();
@@ -1271,13 +1277,31 @@ async function readCliLine(options) {
         render();
     };
     const insertText = (text) => {
-        const safeText = stripTerminalEscapes(text).replace(/\r\n?/g, "\n");
+        const safeText = stripTerminalEscapes(text)
+            .replace(/\r\n?/g, "\n")
+            .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, "");
         const characters = Array.from(buffer);
-        const inserted = Array.from(safeText);
+        const block = createPastedTextBlock(safeText, pastedTextSequence + 1);
+        if (block) {
+            pastedTextSequence += 1;
+            pastedTextBlocks.set(block.marker, block);
+        }
+        const inserted = block ? [block.marker] : Array.from(safeText);
         characters.splice(cursor, 0, ...inserted);
         buffer = characters.join("");
         cursor += inserted.length;
     };
+    function setBuffer(value) {
+        const block = createPastedTextBlock(value, pastedTextSequence + 1);
+        if (block) {
+            pastedTextSequence += 1;
+            pastedTextBlocks.set(block.marker, block);
+            buffer = block.marker;
+        }
+        else {
+            buffer = value;
+        }
+    }
     const handleData = (chunk) => {
         let rest = chunk;
         while (rest) {
@@ -1644,30 +1668,8 @@ function truncateDisplay(text, width) {
     }
     return `${result}…`;
 }
-function inputView(value, cursor, width) {
-    const characters = Array.from(value);
-    const normalize = (text) => text.replace(/\n/g, " ↵ ").replace(/\t/g, "  ");
-    const before = normalize(characters.slice(0, cursor).join(""));
-    const after = normalize(characters.slice(cursor).join(""));
-    if (displayLength(before) >= width) {
-        const visible = takeDisplayEnd(before, width - 1);
-        return { text: `…${visible}`, cursorWidth: 1 + displayLength(visible) };
-    }
-    const remaining = Math.max(0, width - displayLength(before));
-    const visibleAfter = remaining > 0 ? truncateDisplay(after, remaining) : "";
-    return { text: `${before}${visibleAfter}`, cursorWidth: displayLength(before) };
-}
-function takeDisplayEnd(text, width) {
-    const result = [];
-    let length = 0;
-    for (const char of Array.from(text).reverse()) {
-        const charWidth = displayLength(char);
-        if (length + charWidth > width)
-            break;
-        result.push(char);
-        length += charWidth;
-    }
-    return result.reverse().join("");
+function inputContentWidth() {
+    return Math.max(20, Math.min(stdout.columns ?? 100, 100) - 4);
 }
 function submittedInputLabel(value) {
     if (!value.includes("\n"))

package/dist/skills/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/skills/skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAE7B,MAAM,EAAE,WAAW;IAEhD,OAAO,CAAC,SAAS;IAQX,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoBtF,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAY/E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCvG,OAAO,CAAC,OAAO;YAKD,WAAW;CAuB1B"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/skills/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAE7B,MAAM,EAAE,WAAW;IAEhD,OAAO,CAAC,SAAS;IAMX,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoBtF,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAY/E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAaxC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IA2CvG,OAAO,CAAC,OAAO;YAKD,WAAW;CAuB1B"}

package/dist/skills/skills.js

@@ -1,7 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { safeRealResolve, truncate } from "../utils.js";
+import { truncate } from "../utils.js";
 export class SkillManager {
     config;
     catalogCache;
@@ -10,11 +9,7 @@ export class SkillManager {
         this.config = config;
     }
     skillDirs() {
-        const bundled = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../src/skills");
-        return Array.from(new Set([
-            ...this.config.skills.directories.map((dir) => path.resolve(this.config.workspaceRoot, dir)),
-            bundled,
-        ]));
+        return Array.from(new Set(this.config.skills.directories.map((dir) => path.resolve(this.config.workspaceRoot, dir))));
     }
     async search(query) {
         const results = [];
@@ -60,9 +55,13 @@ export class SkillManager {
         return truncate(body, 20000);
     }
     async installLocal(sourcePath, requestedName) {
-        // Confine the source to the workspace (rejects ../ and symlink escapes) so the
-        // install can't copy arbitrary files (e.g. /etc/passwd) into a skill dir that skill_read exposes.
-        const source = await safeRealResolve(this.config.workspaceRoot, sourcePath);
+        // Local skill sources may live outside the active workspace (for example in a
+        // package cache or /tmp). Resolve the selected source canonically, while the
+        // installation target remains confined to the configured skills directory.
+        const requestedSource = path.isAbsolute(sourcePath)
+            ? sourcePath
+            : path.resolve(this.config.workspaceRoot, sourcePath);
+        const source = await fs.realpath(requestedSource);
         const stat = await fs.stat(source);
         const skillFile = stat.isDirectory() ? path.join(source, "SKILL.md") : source;
         if (path.basename(skillFile) !== "SKILL.md") {

package/dist/tools/builtin.js

@@ -331,12 +331,12 @@ export function createBuiltinRegistry(options) {
     });
     registry.register({
         name: "skill_install",
-        description: "Install a local skill into the first configured skills directory. Source must be a SKILL.md file or a directory containing SKILL.md.",
+        description: "Install a local skill into the first configured skills directory. The source may be outside the workspace and must be a SKILL.md file or a directory containing SKILL.md.",
         risk: "high",
         input_schema: {
             type: "object",
             properties: {
-                sourcePath: { type: "string", description: "Path to SKILL.md or a directory containing SKILL.md." },
+                sourcePath: { type: "string", description: "Local path, including outside the workspace, to SKILL.md or a directory containing SKILL.md." },
                 name: { type: "string", description: "Optional installed skill name." },
             },
             required: ["sourcePath"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apolloyh/apollo-agent",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "Apollo — your personal agent. Answer first, act when needed. Claude Code–style Task subagents.",
   "bin": {
@@ -20,7 +20,6 @@
   },
   "files": [
     "dist",
-    "src/skills/tech-research-skill",
     "README.md",
     "docs/sdk.md",
     ".apollo/config.example.json",

package/src/skills/tech-research-skill/SKILL.md

@@ -1,200 +0,0 @@
----
-name: tech-research-skill
-description: "技术方向、行业领域、产品赛道、GitHub 仓库和开源项目的调查、研究、竞品分析、趋势分析和报告生成。Use when the user asks to investigate, research, evaluate, compare, analyze, score, summarize, or report on a technology direction, market/domain niche, AI infra, agent, RAG, LLM, devtool, data, security, web3, GitHub repository, GitHub URL, or open-source project. Handles GitHub repo search, repo health, issues/commits, implementation patterns, competitor landscape, market trend research, evidence sources, Markdown report output, and downloadable report links."
----
-
-# Tech Research Skill
-
-Use this skill for both:
-
-- **Direction research**: investigate a technology direction, industry/domain, product category, or open-source theme.
-- **Repository research**: investigate one or more GitHub repositories or open-source projects.
-
-Default to this skill for prompts like "调查数字人方向", "分析 RAG agent 赛道", "研究某 GitHub 项目", "竞品分析", "趋势分析", "开源项目尽调", or "生成研究报告".
-
-## Tool Location
-
-The shell tools live in the same directory as this `SKILL.md`.
-
-Set the tool directory from the loaded skill path:
-
-```sh
-TECH_RESEARCH_SKILL_DIR="$(dirname "$SKILL_PATH")"
-```
-
-If the current shell is already running from this skill directory, use:
-
-```sh
-TECH_RESEARCH_SKILL_DIR="."
-```
-
-Do not use absolute paths. Do not run exploratory `find`, `ls`, or `echo $CLAUDE_SKILL_DIR` just to locate these tools. If path context is uncertain, call `skill_read` for `tech-research-skill` and derive the directory from the returned path.
-
-Tool role labels:
-
-- `repo_search`: `"$TECH_RESEARCH_SKILL_DIR/repo-fetch" --search "<query>" --per-page 10`
-- `repo_fetch`: `"$TECH_RESEARCH_SKILL_DIR/repo-fetch" owner/repo --include issues,commits`
-- `repo_analyze`: `"$TECH_RESEARCH_SKILL_DIR/repo-analyze"` reads `repo-fetch` JSON from stdin and emits deterministic local health signals. It does not call an LLM, does not use network, and does not require model credentials.
-- `repo_report_generate`: `"$TECH_RESEARCH_SKILL_DIR/report-generate" --template investment --format markdown --output <report>.md` renders `repo-analyze` JSON into Markdown or HTML. It does not call an LLM.
-
-These role labels are not separate executable filenames. The executable scripts are `repo-fetch`, `repo-analyze`, and `report-generate`.
-
-The outer agent is responsible for the actual judgment: repository health interpretation, implementation-pattern analysis, competitor analysis, market/trend synthesis, opportunity mapping, and final recommendation. Treat `repo-analyze` output as structured evidence, not as the final answer.
-
-## GitHub API Token
-
-`repo-fetch` uses the GitHub REST API. Unauthenticated requests are rate-limited quickly, so prefer a local token.
-
-Supported environment variables:
-
-```sh
-GITHUB_TOKEN=<github personal access token>
-GH_TOKEN=<github personal access token>
-```
-
-`repo-fetch` also loads a local `.env` file from this skill directory. That `.env` file is ignored by git and may contain:
-
-```sh
-GITHUB_TOKEN=<github personal access token>
-```
-
-Never hardcode a GitHub token into `repo-fetch`, `SKILL.md`, reports, examples, command output, or committed files. If a token appears in chat/logs/source, tell the user to revoke and rotate it.
-
-## Workflow A: Technology Direction Research
-
-Use this workflow when the user provides a field, technology direction, product category, or market/domain.
-
-### Turn Budget Rules
-
-Finish with a report instead of continuing to search. For a normal direction investigation:
-
-- Run at most 4 GitHub search queries.
-- Fetch details for at most 4 representative repositories.
-- Fetch/search at most 5 web sources.
-- If GitHub or web search quality is poor twice, stop searching and write the report with limitations.
-- Do not run `date`, `ls docs`, or other housekeeping commands before writing the report.
-- Prefer a concise evidence-backed report over exhaustive searching.
-- Once there is enough evidence for a directional judgment, immediately write the Markdown report to the repository-root `docs/` directory. If the current working directory is `agent`, use `../docs/<filename>.md`; if the current working directory is this skill directory, use `../../../../docs/<filename>.md`. Do not write `docs/<filename>.md` from the `agent` directory, because that creates `agent/docs` and the frontend will not treat it as the canonical report location.
-
-1. Frame the topic:
-   - Normalize the topic name.
-   - Identify adjacent keywords and English/Chinese search terms.
-   - Decide whether the user needs build advice, investment analysis, competitor analysis, learning research, or a general trend report.
-
-2. Search GitHub first:
-
-```sh
-"$TECH_RESEARCH_SKILL_DIR/repo-fetch" --search "<topic keywords> stars:>100" --per-page 10
-```
-
-Select 5-10 representative repositories:
-
-- Most-starred or widely used projects.
-- Recently active challengers.
-- Different implementation approaches.
-- Commercially relevant SDKs, frameworks, or infrastructure.
-- Niche projects that reveal emerging use cases.
-
-Do not rely only on stars. Prefer repos with recent commits, active issues/PRs, releases, real users, and clear positioning.
-
-3. Analyze representative repositories:
-
-```sh
-"$TECH_RESEARCH_SKILL_DIR/repo-fetch" owner/repo --include issues,commits \
-  | "$TECH_RESEARCH_SKILL_DIR/repo-analyze"
-```
-
-`repo-analyze` only computes local deterministic signals from the fetched GitHub data. The agent must read the JSON and perform the higher-level health analysis itself.
-
-4. Search the web for trend evidence:
-   - Use current authoritative sources: official docs, standards bodies, foundation pages, vendor announcements, market reports, funding/news coverage, developer surveys, ecosystem reports, benchmarks, regulation/compliance updates.
-   - Collect source URLs and dates.
-   - Distinguish observed evidence from inference.
-
-5. Produce a report with this structure:
-   - **Executive Judgment**: high/medium/low potential and why.
-   - **GitHub Landscape**: repo table, implementation approaches, health, risks.
-   - **Competitor Analysis**: direct open-source, commercial products, infrastructure platforms, substitutes.
-   - **Trend and Market Signals**: drivers, tailwinds, headwinds, 6-18 month outlook.
-   - **Opportunity Map**: underserved users, product wedges, technical differentiation, distribution/community angles.
-   - **Recommendation**: build/watch/avoid, MVP scope, validation experiments, what to monitor.
-   - **Evidence Sources**: final section with every repo, GitHub query, issue/commit dataset, and web page used.
-
-## Workflow B: GitHub Repository Research
-
-Use this workflow when the user gives a GitHub URL, `owner/repo`, or asks for open-source project health.
-
-Convert GitHub URLs to `owner/repo`.
-
-Fetch and analyze:
-
-```sh
-"$TECH_RESEARCH_SKILL_DIR/repo-fetch" owner/repo --include issues,commits \
-  | "$TECH_RESEARCH_SKILL_DIR/repo-analyze" \
-  | "$TECH_RESEARCH_SKILL_DIR/report-generate" --template weekly --format markdown
-```
-
-For investment or opportunity analysis:
-
-```sh
-"$TECH_RESEARCH_SKILL_DIR/repo-fetch" owner/repo --include issues,commits \
-  | "$TECH_RESEARCH_SKILL_DIR/repo-analyze" \
-  | "$TECH_RESEARCH_SKILL_DIR/report-generate" --template investment --format markdown
-```
-
-The generated repository report is a starting template. For user-facing research, the agent should expand it with its own analysis, web evidence, competitor context, and a final evidence-source section.
-
-## Report Output
-
-Always write final user-facing reports as Markdown under the repository root `docs/` directory, not under `agent/docs`.
-
-Canonical report locations by current working directory:
-
-```sh
-# If cwd is the agent root:
-DOCS_DIR="../docs"
-
-# If cwd is this skill directory:
-DOCS_DIR="../../../../docs"
-```
-
-Before writing, choose the path from the actual cwd. Never use `docs/<filename>.md` when cwd is `agent`.
-
-Use a lowercase slug plus timestamp when useful:
-
-```text
-../docs/digital-human-research-20260611-153000.md
-../docs/repo-health-owner-repo-20260611-153000.md
-```
-
-Do not put an absolute path in the report instructions.
-
-Use the dedicated file-writing tool when available. Do not use shell redirection or here-docs for writing the report if a `write_file` tool exists.
-
-Use a simple stable filename when no timestamp is available, such as `../docs/digital-human-research.md` from the agent root. It is better to overwrite a topic report than to spend a turn checking the clock or listing directories.
-
-
-Every final report must end with:
-
-```md
-## Evidence Sources
-```
-
-Include:
-
-- GitHub repositories used as evidence.
-- GitHub search queries that shaped repo selection.
-- Issue/commit datasets used.
-- Web pages, articles, docs, market reports, announcements, and search results used for trend or competitor claims.
-- Source names, URLs, and publication/access dates when available.
-
-Do not put download links inside the Markdown report file, and do not manually add download links in the web frontend final answer. The frontend chat route appends report links after the assistant message once it detects the generated file. If a manual link is ever needed outside the frontend, the `file` query parameter must be only the basename in `docs`, not a path.
-
-## Quality Bar
-
-- Use real repositories and real external sources; do not invent competitors or metrics.
-- Cite GitHub repos and web sources with links.
-- Prefer evidence-backed judgment over generic commentary.
-- Separate facts from inference.
-- Call out uncertainty, missing credentials, GitHub API limits, failed fetches, and weak evidence.
-- If the user asks in Chinese, answer in Chinese unless they request otherwise.

package/src/skills/tech-research-skill/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Tech Research"
-  short_description: "Research tech directions, repos, competitors, and trends"
-  default_prompt: "Use $tech-research-skill to research a technology direction or GitHub repository and produce an evidence-backed report."