@kairyou/agent-tools 0.16.0 → 0.18.0

package/README.md

@@ -1,6 +1,6 @@
 # Agent Tools
 
-Reusable Agent Skills, plus integrations (statusline, provider usage, vision) that install into Codex, Claude Code, and opencode.
+Reusable Agent Skills, plus runtime capabilities (statusline, provider usage, vision) for Codex, Claude Code, and opencode.
 
 Requires Node.js >= 22.
 
@@ -56,7 +56,7 @@ Usage:
 
 ### at-zentao
 
-Work ZenTao (禅道) bugs/tasks end to end: fix, verify, stage; asks before committing and before writing status back.
+Work ZenTao (禅道) bugs/tasks end to end, read linked story context, or log task hours; asks before committing and before writing back.
 
 ```bash
 npx -y skills@latest add kairyou/agent-tools --skill at-zentao -g -y
@@ -67,11 +67,12 @@ Usage:
 - `/at-zentao bugs` — list bugs assigned to you (the configured account); pick one or several (several = batch mode)
 - `/at-zentao tasks` — same, for tasks
 - `/at-zentao bug <id>` — work a specific bug
-- `/at-zentao task <id>` — work a specific task
+- `/at-zentao task <id> [request]` — work a specific task or log hours with a natural-language request
+- `/at-zentao story <id>` — read requirement scope and acceptance context without writing back
 
 Config: `~/.agent-tools/config.jsonc` → `"zentao": { "url", "account", "password" }`. The password can be entered directly or referenced with `"password": { "env": "ZENTAO_PASSWORD" }`; never paste credentials or tokens into chat.
 
-## Integrations
+## Capabilities
 
 Runtime capabilities, installed per agent:
 
@@ -80,7 +81,7 @@ npx -y @kairyou/agent-tools@latest <capability> -a <agent...>
 # npx -y github:kairyou/agent-tools <capability> -a <agent...>  # Or the latest code from GitHub (needs Git)
 ```
 
-`--dry-run` previews, `--uninstall` unwires the integration from the agent, and
+`--dry-run` previews, `--uninstall` removes the capability from the agent, and
 re-running the install command updates. The installer only touches config
 entries it wrote itself, and `config.jsonc` updates only add missing default
 keys without touching your edits or comments.

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md)
 
-可复用的 Agent Skills, 以及可装入 Codex, Claude Code 与 opencode 的 integrations: statusline, provider usage 与跨模型识图.
+可复用的 Agent Skills, 以及适用于 Codex, Claude Code 与 opencode 的 runtime capabilities: statusline, provider usage 与跨模型识图.
 
 需要 Node.js >= 22.
 
@@ -56,7 +56,7 @@ npx -y skills@latest add kairyou/agent-tools --skill at-simplify -g -y
 
 ### at-zentao
 
-读取禅道 bug/task 并端到端处理: 修复, 验证, 暂存; 提交和回写状态前均需确认.
+读取禅道 bug/task 并端到端处理, 补充关联 story 上下文, 或记录任务工时; 提交和回写前均需确认.
 
 ```bash
 npx -y skills@latest add kairyou/agent-tools --skill at-zentao -g -y
@@ -67,11 +67,12 @@ npx -y skills@latest add kairyou/agent-tools --skill at-zentao -g -y
 - `/at-zentao bugs` — 列出指派给你(配置的账号)的 bug, 挑一个或多个(多个 = 批量模式)
 - `/at-zentao tasks` — 同上, 任务清单
 - `/at-zentao bug <id>` — 直接处理指定 bug
-- `/at-zentao task <id>` — 直接处理指定 task
+- `/at-zentao task <id> [请求]` — 处理指定 task, 或用自然语言记录工时
+- `/at-zentao story <id>` — 只读查看研发需求范围和验收信息
 
 配置: `~/.agent-tools/config.jsonc` → `"zentao": { "url", "account", "password" }`. 密码可以直接填写, 也可以使用 `"password": { "env": "ZENTAO_PASSWORD" }` 引用环境变量; 不要在对话中粘贴凭据或 token.
 
-## Integrations
+## Capabilities
 
 Runtime capability, 按 agent 选装:
 
@@ -80,7 +81,7 @@ npx -y @kairyou/agent-tools@latest <capability> -a <agent...>
 # npx -y github:kairyou/agent-tools <capability> -a <agent...>  # 或用 GitHub 上的最新代码(需 Git)
 ```
 
-`--dry-run` 预览, `--uninstall` 解除对应集成, 重新执行安装命令即为更新.
+`--dry-run` 预览, `--uninstall` 移除对应 capability, 重新执行安装命令即为更新.
 安装器只改动自己写入的配置项, 更新 `config.jsonc` 时只补充缺失的默认键,
 不会动你的修改和注释.
 

package/{integrations → capabilities}/vision/mcp-server.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Vision MCP stdio server. Thin shell over ./lib: registers the
 // inspect_image tool, translates results/errors, and nothing else. Launched by
-// hosts as `agent-tools mcp-vision` (or `node integrations/vision/mcp-server.mjs`).
+// hosts as `agent-tools mcp-vision` (or `node capabilities/vision/mcp-server.mjs`).
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/log/hook.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// integrations/log/hook.mjs
+// capabilities/log/hook.mjs
 import { spawnSync } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -865,7 +865,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/log/hook.mjs
+// capabilities/log/hook.mjs
 var MAX_SNAPSHOT_BYTES = 512 * 1024;
 var MIN_RESULT_SUMMARY_LENGTH = 24;
 var DAILY_ITEM_TARGET_CHARS = 160;

package/dist/log/opencode-plugin.mjs

@@ -1,4 +1,4 @@
-// integrations/log/opencode-plugin.mjs
+// capabilities/log/opencode-plugin.mjs
 import { spawn } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/statusline/claude-statusline.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// integrations/statusline/claude-statusline.mjs
+// capabilities/statusline/claude-statusline.mjs
 import { execFileSync, spawn } from "node:child_process";
 import fs from "node:fs";
 import { basename, dirname, join } from "node:path";
@@ -865,7 +865,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/statusline/claude-statusline.mjs
+// capabilities/statusline/claude-statusline.mjs
 var SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
 var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(SCRIPT_DIR, "..", "..");
 var DEFAULT_CONFIG_FILE = join(AGENT_TOOLS_HOME, "config.jsonc");

package/dist/usage/cli.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-// integrations/usage/cli.mjs
+// capabilities/usage/cli.mjs
 import { queryAgentProviderUsage } from "./core.mjs";
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 import { readFile, writeFile, mkdir, open, stat } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -868,7 +868,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 var CODEX_HOME = process.env.CODEX_HOME || join(homedir(), ".codex");
 var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(homedir(), ".agent-tools");
 var AUTH_PATH = join(CODEX_HOME, "auth.json");
@@ -931,7 +931,7 @@ async function debugLog(event) {
 }
 var HOOK_SNAPSHOT_MAX_AGE_MS = 10 * 6e4;
 
-// integrations/usage/cli.mjs
+// capabilities/usage/cli.mjs
 function parseAgent(argv) {
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];

package/dist/usage/codex-hook.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// integrations/usage/codex-hook.mjs
+// capabilities/usage/codex-hook.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

package/dist/usage/core.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
-// integrations/usage/core.mjs
+// capabilities/usage/core.mjs
 import { fileURLToPath, pathToFileURL as pathToFileURL2 } from "node:url";
 import { spawn } from "node:child_process";
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 import { readFile, writeFile, mkdir, open, stat } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -869,7 +869,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/usage/lib/config.mjs
+// capabilities/usage/lib/config.mjs
 var CODEX_HOME = process.env.CODEX_HOME || join(homedir(), ".codex");
 var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(homedir(), ".agent-tools");
 var AUTH_PATH = join(CODEX_HOME, "auth.json");
@@ -954,7 +954,7 @@ async function newApiQuotaScale() {
   return Number.isFinite(scale) && scale > 0 ? scale : 0;
 }
 
-// integrations/usage/lib/urls.mjs
+// capabilities/usage/lib/urls.mjs
 function isOfficialBaseUrl(baseUrl) {
   if (!baseUrl) return true;
   const clean = baseUrl.replace(/\/+$/, "");
@@ -994,7 +994,7 @@ function hostIncludes(baseUrl, value) {
   }
 }
 
-// integrations/usage/lib/cache.mjs
+// capabilities/usage/lib/cache.mjs
 import { writeFile as writeFile2, mkdir as mkdir2, open as open2, unlink, rename, stat as stat2, utimes } from "node:fs/promises";
 import { createHash, randomUUID } from "node:crypto";
 import { dirname as dirname2, join as join2 } from "node:path";
@@ -1142,12 +1142,12 @@ async function acquireWriteLock({ timeoutMs = 500, staleMs = 5e3 } = {}) {
   return null;
 }
 
-// integrations/usage/lib/routes.mjs
+// capabilities/usage/lib/routes.mjs
 import { readdir } from "node:fs/promises";
 import { basename, extname, isAbsolute, join as join3 } from "node:path";
 import { pathToFileURL } from "node:url";
 
-// integrations/usage/lib/http.mjs
+// capabilities/usage/lib/http.mjs
 import { createContext, runInContext } from "node:vm";
 var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
 var SHIELD_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36";
@@ -1307,7 +1307,7 @@ async function requestJson(url, options = {}) {
   throw new Error(`${name} unavailable`);
 }
 
-// integrations/usage/lib/format.mjs
+// capabilities/usage/lib/format.mjs
 var ONE_API_HARD_LIMIT_SENTINEL_USD = 1e6;
 var RESET_TIME_FIELDS = Object.freeze({
   // Sub2API rate-limit entries returned alongside quota usage.
@@ -1591,7 +1591,7 @@ function formatUsageLine(root) {
   return parts.join(" | ");
 }
 
-// integrations/usage/lib/routes.mjs
+// capabilities/usage/lib/routes.mjs
 async function subscriptionUrl(baseUrl) {
   const clean = baseUrl.replace(/\/+$/, "");
   const url = clean.endsWith("/v1") ? `${clean}/usage` : `${clean}/v1/usage`;
@@ -1834,7 +1834,7 @@ async function orderedUsageRoutes(context) {
   return [cached.route, ...routeIds.filter((id) => id !== cached.route)].map((id) => registry[id]).filter(Boolean);
 }
 
-// integrations/usage/lib/context.mjs
+// capabilities/usage/lib/context.mjs
 import { existsSync as existsSync2 } from "node:fs";
 function stripInlineComment(value) {
   let inSingle = false;
@@ -1938,7 +1938,7 @@ function normalizeUsageContext(input) {
   };
 }
 
-// integrations/usage/core.mjs
+// capabilities/usage/core.mjs
 function parseArgs(argv) {
   const opts = { mode: "hook", agent: "codex", silent: false };
   let modeSet = false;

package/dist/usage/opencode-plugin.mjs

@@ -1,4 +1,4 @@
-// integrations/usage/opencode-plugin.mjs
+// capabilities/usage/opencode-plugin.mjs
 import { queryProviderUsage } from "./core.mjs";
 var DEFAULT_REFRESH_MS = 6e4;
 function firstString(value, keys) {

package/dist/usage/opencode-tui.mjs

@@ -1,4 +1,4 @@
-// integrations/usage/opencode-tui.mjs
+// capabilities/usage/opencode-tui.mjs
 import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";

package/dist/vision/cli.mjs

@@ -1,13 +1,13 @@
-// integrations/vision/lib/cli.mjs
+// capabilities/vision/lib/cli.mjs
 import fs4 from "node:fs";
 import path5 from "node:path";
 import { fileURLToPath } from "node:url";
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 import crypto3 from "node:crypto";
 import path4 from "node:path";
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -871,7 +871,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/vision/lib/errors.mjs
+// capabilities/vision/lib/errors.mjs
 var ERROR_CODES = Object.freeze({
   CONFIG: "config_error",
   INPUT: "input_error",
@@ -899,7 +899,7 @@ function toVisionError(err, fallbackCode = ERROR_CODES.PROVIDER_HTTP) {
   return new VisionError(fallbackCode, message, { cause: err });
 }
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 var PROVIDERS = Object.freeze(["openai-compatible", "anthropic-compatible"]);
 var CONFIG_DEFAULTS = Object.freeze({
   timeoutMs: 3e4,
@@ -1037,7 +1037,7 @@ function loadVisionConfig({ file, env = process.env } = {}) {
   };
 }
 
-// integrations/vision/lib/image-source.mjs
+// capabilities/vision/lib/image-source.mjs
 import fs2 from "node:fs";
 import os2 from "node:os";
 import path2 from "node:path";
@@ -1285,7 +1285,7 @@ async function loadImageSource(source, { maxImageBytes, timeoutMs, fetchImpl } =
   throw new VisionError(ERROR_CODES.INPUT, `Unsupported image_source.type: ${JSON.stringify(source.type)}`);
 }
 
-// integrations/vision/lib/rate-limit.mjs
+// capabilities/vision/lib/rate-limit.mjs
 import crypto from "node:crypto";
 import fs3 from "node:fs";
 import path3 from "node:path";
@@ -1442,7 +1442,7 @@ function createLimiter(config, now = Date.now, { stateFile = null } = {}) {
   return stateFile ? createSharedLimiter(config, now, stateFile) : createProcessLimiter(config, now);
 }
 
-// integrations/vision/lib/redact.mjs
+// capabilities/vision/lib/redact.mjs
 var MASK = "***";
 function redactSecrets(text, secrets) {
   if (typeof text !== "string" || text.length === 0) return text;
@@ -1454,7 +1454,7 @@ function redactSecrets(text, secrets) {
   return out;
 }
 
-// integrations/vision/lib/providers/shared.mjs
+// capabilities/vision/lib/providers/shared.mjs
 import crypto2 from "node:crypto";
 async function* encodeBase64(readable) {
   let carry = Buffer.alloc(0);
@@ -1667,7 +1667,7 @@ async function postJson({ url, headers, body, timeoutMs, fetchImpl, providerLabe
   }
 }
 
-// integrations/vision/lib/providers/anthropic-compatible.mjs
+// capabilities/vision/lib/providers/anthropic-compatible.mjs
 function messagesUrl(baseUrl) {
   return baseUrl.endsWith("/v1") ? `${baseUrl}/messages` : `${baseUrl}/v1/messages`;
 }
@@ -1718,7 +1718,7 @@ async function inspectWithAnthropicCompatible({ config, image, questions, fetchI
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/providers/openai-compatible.mjs
+// capabilities/vision/lib/providers/openai-compatible.mjs
 function replyText2(json) {
   const message = json?.choices?.[0]?.message;
   if (typeof message?.content === "string") return message.content;
@@ -1765,7 +1765,7 @@ async function inspectWithOpenAICompatible({ config, image, questions, fetchImpl
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 var PROVIDER_IMPL = {
   "openai-compatible": inspectWithOpenAICompatible,
   "anthropic-compatible": inspectWithAnthropicCompatible
@@ -1849,7 +1849,7 @@ function createVisionService({ config, fetchImpl, now, limiterStateFile } = {})
   return { config: resolved, inspect };
 }
 
-// integrations/vision/lib/cli.mjs
+// capabilities/vision/lib/cli.mjs
 function printHelp() {
   const lines = [];
   for (const line of fs4.readFileSync(fileURLToPath(import.meta.url), "utf8").split("\n")) {

package/dist/vision/mcp-server.mjs

@@ -30952,11 +30952,11 @@ var StdioServerTransport = class {
   }
 };
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 import crypto3 from "node:crypto";
 import path4 from "node:path";
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -31820,7 +31820,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// integrations/vision/lib/errors.mjs
+// capabilities/vision/lib/errors.mjs
 var ERROR_CODES = Object.freeze({
   CONFIG: "config_error",
   INPUT: "input_error",
@@ -31848,7 +31848,7 @@ function toVisionError(err, fallbackCode = ERROR_CODES.PROVIDER_HTTP) {
   return new VisionError(fallbackCode, message, { cause: err });
 }
 
-// integrations/vision/lib/config.mjs
+// capabilities/vision/lib/config.mjs
 var PROVIDERS = Object.freeze(["openai-compatible", "anthropic-compatible"]);
 var CONFIG_DEFAULTS = Object.freeze({
   timeoutMs: 3e4,
@@ -31986,7 +31986,7 @@ function loadVisionConfig({ file: file2, env = process.env } = {}) {
   };
 }
 
-// integrations/vision/lib/image-source.mjs
+// capabilities/vision/lib/image-source.mjs
 import fs2 from "node:fs";
 import os2 from "node:os";
 import path2 from "node:path";
@@ -32234,7 +32234,7 @@ async function loadImageSource(source, { maxImageBytes, timeoutMs, fetchImpl } =
   throw new VisionError(ERROR_CODES.INPUT, `Unsupported image_source.type: ${JSON.stringify(source.type)}`);
 }
 
-// integrations/vision/lib/rate-limit.mjs
+// capabilities/vision/lib/rate-limit.mjs
 import crypto from "node:crypto";
 import fs3 from "node:fs";
 import path3 from "node:path";
@@ -32391,7 +32391,7 @@ function createLimiter(config2, now = Date.now, { stateFile = null } = {}) {
   return stateFile ? createSharedLimiter(config2, now, stateFile) : createProcessLimiter(config2, now);
 }
 
-// integrations/vision/lib/redact.mjs
+// capabilities/vision/lib/redact.mjs
 var MASK = "***";
 function redactSecrets(text, secrets) {
   if (typeof text !== "string" || text.length === 0) return text;
@@ -32403,7 +32403,7 @@ function redactSecrets(text, secrets) {
   return out;
 }
 
-// integrations/vision/lib/providers/shared.mjs
+// capabilities/vision/lib/providers/shared.mjs
 import crypto2 from "node:crypto";
 async function* encodeBase64(readable) {
   let carry = Buffer.alloc(0);
@@ -32616,7 +32616,7 @@ async function postJson({ url: url2, headers, body, timeoutMs, fetchImpl, provid
   }
 }
 
-// integrations/vision/lib/providers/anthropic-compatible.mjs
+// capabilities/vision/lib/providers/anthropic-compatible.mjs
 function messagesUrl(baseUrl) {
   return baseUrl.endsWith("/v1") ? `${baseUrl}/messages` : `${baseUrl}/v1/messages`;
 }
@@ -32667,7 +32667,7 @@ async function inspectWithAnthropicCompatible({ config: config2, image, question
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/providers/openai-compatible.mjs
+// capabilities/vision/lib/providers/openai-compatible.mjs
 function replyText2(json2) {
   const message = json2?.choices?.[0]?.message;
   if (typeof message?.content === "string") return message.content;
@@ -32714,7 +32714,7 @@ async function inspectWithOpenAICompatible({ config: config2, image, questions,
   return normalizeAnswers(text, questions);
 }
 
-// integrations/vision/lib/inspect.mjs
+// capabilities/vision/lib/inspect.mjs
 var PROVIDER_IMPL = {
   "openai-compatible": inspectWithOpenAICompatible,
   "anthropic-compatible": inspectWithAnthropicCompatible
@@ -32798,7 +32798,7 @@ function createVisionService({ config: config2, fetchImpl, now, limiterStateFile
   return { config: resolved, inspect };
 }
 
-// integrations/vision/mcp-server.mjs
+// capabilities/vision/mcp-server.mjs
 var TOOL_DESCRIPTION = [
   "Use the configured vision model when the user's task depends on visible content and only a local image path or http(s) URL is available, direct inspection failed, or the user explicitly requested the provider.",
   "If the prompt already contains actual image content or a host image viewer returned it, inspect that content directly; a bare path or URL without a visual task is not a reason to call this.",

package/docs/en/repository-structure.md

@@ -4,7 +4,7 @@
 agent-tools/
 ├── .claude-plugin/    # Claude Code/plugin ecosystem manifest.
 ├── .codex-plugin/     # Codex plugin manifest.
-├── integrations/      # Installable capabilities, one directory each.
+├── capabilities/      # Runtime capabilities, one directory each.
 │   ├── statusline/    # Agent status line: branch, model, usage.
 │   ├── usage/         # Provider balance / quota display.
 │   └── vision/        # Cross-model image understanding.
@@ -13,8 +13,8 @@ agent-tools/
 │   │   ├── at-commit/   # Conventional Commit message skill.
 │   │   ├── at-review/   # Review local or hosted changes for bugs and regressions.
 │   │   └── at-simplify/ # Reduce complexity and duplication in changes.
-│   └── integrations/  # Skills that integrate external systems.
-│       └── at-zentao/   # Self-contained ZenTao workflow and secure API script.
+│   └── systems/       # Self-contained Skills for external systems.
+│       └── at-zentao/   # Self-contained ZenTao development and time-entry workflow.
 ├── docs/              # Advanced guides and contributor reference.
 ├── tools/             # Maintainer-only upstream sync and repository tooling.
 └── scripts/           # Install, sync, validation, and maintenance scripts.

package/docs/zh-CN/repository-structure.md

@@ -4,7 +4,7 @@
 agent-tools/
 ├── .claude-plugin/    # Claude Code/plugin 生态的 manifest.
 ├── .codex-plugin/     # Codex plugin manifest.
-├── integrations/      # 可安装的 capability, 一个一目录.
+├── capabilities/      # Runtime capabilities, 一个一目录.
 │   ├── statusline/    # Agent 状态栏: 分支, 模型, 用量.
 │   ├── usage/         # Provider 余额/额度显示.
 │   └── vision/        # 跨模型识图.
@@ -13,8 +13,8 @@ agent-tools/
 │   │   ├── at-commit/   # 生成 Conventional Commits message.
 │   │   ├── at-review/   # 审查本地或托管改动中的 bug 与回归风险.
 │   │   └── at-simplify/ # 减少改动中的冗余和复杂度.
-│   └── integrations/  # 对接外部系统的 skills.
-│       └── at-zentao/   # 自包含的禅道工作流和安全 API 脚本.
+│   └── systems/       # 面向外部系统的自包含 Skills.
+│       └── at-zentao/   # 自包含的禅道研发事项与工时工作流.
 ├── docs/              # 高级指南和贡献者参考.
 ├── tools/             # 仅供维护者使用的上游同步和仓库工具.
 └── scripts/           # 安装, 同步, 校验和仓库维护脚本.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kairyou/agent-tools",
-  "version": "0.16.0",
-  "description": "Reusable Agent Skills, plus integrations (statusline, provider usage, vision) that install into Codex, Claude Code, and opencode.",
+  "version": "0.18.0",
+  "description": "Reusable Agent Skills, plus runtime capabilities (statusline, provider usage, vision) for Codex, Claude Code, and opencode.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "config.default.jsonc",
     "docs/",
     "dist/",
-    "integrations/",
+    "capabilities/",
     "scripts/",
     "skills/"
   ],

package/scripts/build.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // Bundles everything that ships to ~/.agent-tools into dist/<capability>.
-// Installed artifacts are always built output; integrations/ holds the sources.
+// Installed artifacts are always built output; capabilities/ holds the sources.
 
 import fs from "node:fs";
 import path from "node:path";
@@ -13,16 +13,16 @@ const DIST = path.join(ROOT, "dist");
 const TARGETS = {
   statusline: {
     entryPoints: {
-      "claude-statusline": path.join(ROOT, "integrations", "statusline", "claude-statusline.mjs"),
+      "claude-statusline": path.join(ROOT, "capabilities", "statusline", "claude-statusline.mjs"),
     },
   },
   usage: {
     entryPoints: {
-      core: path.join(ROOT, "integrations", "usage", "core.mjs"),
-      cli: path.join(ROOT, "integrations", "usage", "cli.mjs"),
-      "codex-hook": path.join(ROOT, "integrations", "usage", "codex-hook.mjs"),
-      "opencode-plugin": path.join(ROOT, "integrations", "usage", "opencode-plugin.mjs"),
-      "opencode-tui": path.join(ROOT, "integrations", "usage", "opencode-tui.mjs"),
+      core: path.join(ROOT, "capabilities", "usage", "core.mjs"),
+      cli: path.join(ROOT, "capabilities", "usage", "cli.mjs"),
+      "codex-hook": path.join(ROOT, "capabilities", "usage", "codex-hook.mjs"),
+      "opencode-plugin": path.join(ROOT, "capabilities", "usage", "opencode-plugin.mjs"),
+      "opencode-tui": path.join(ROOT, "capabilities", "usage", "opencode-tui.mjs"),
     },
     // core.mjs detects "run as a script" via process.argv[1]; inlining it into
     // the other entries would re-trigger that check inside their bundles, so it
@@ -31,21 +31,21 @@ const TARGETS = {
   },
   vision: {
     entryPoints: {
-      "mcp-server": path.join(ROOT, "integrations", "vision", "mcp-server.mjs"),
-      cli: path.join(ROOT, "integrations", "vision", "lib", "cli.mjs"),
+      "mcp-server": path.join(ROOT, "capabilities", "vision", "mcp-server.mjs"),
+      cli: path.join(ROOT, "capabilities", "vision", "lib", "cli.mjs"),
     },
   },
   log: {
     entryPoints: {
-      hook: path.join(ROOT, "integrations", "log", "hook.mjs"),
-      "opencode-plugin": path.join(ROOT, "integrations", "log", "opencode-plugin.mjs"),
+      hook: path.join(ROOT, "capabilities", "log", "hook.mjs"),
+      "opencode-plugin": path.join(ROOT, "capabilities", "log", "opencode-plugin.mjs"),
     },
   },
 };
 
-// Repo-shipped usage routes (a fork can commit integrations/usage/routes/*.mjs
+// Repo-shipped usage routes (a fork can commit capabilities/usage/routes/*.mjs
 // to distribute custom gateways to everyone who installs). Absent upstream.
-const USAGE_ROUTES_DIR = path.join(ROOT, "integrations", "usage", "routes");
+const USAGE_ROUTES_DIR = path.join(ROOT, "capabilities", "usage", "routes");
 if (fs.existsSync(USAGE_ROUTES_DIR)) {
   for (const file of fs.readdirSync(USAGE_ROUTES_DIR).filter((n) => n.endsWith(".mjs"))) {
     TARGETS.usage.entryPoints[`routes/${file.slice(0, -4)}`] = path.join(USAGE_ROUTES_DIR, file);

package/scripts/install.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // agent-tools installer: wires statusline / usage into each agent's config.
 // Runtime-dependent skills are installed with their capability. Standalone
-// workflow/integration skills are still handled by `npx skills add`.
+// Standalone skills are still handled by `npx skills add`.
 //
 // Capabilities (all global for now — they target the user-level config):
 //   statusline  Claude Code statusLine script (claude only).
@@ -68,7 +68,7 @@ const PACKAGE_VERSION = (() => {
   }
 })();
 // Everything copied into ~/.agent-tools is built output from dist/ (see
-// scripts/build.mjs); integrations/ holds the sources.
+// scripts/build.mjs); capabilities/ holds the sources.
 const SOURCE = {
   logHook: path.join(REPO_ROOT, "dist", "log", "hook.mjs"),
   logOpencodePlugin: path.join(REPO_ROOT, "dist", "log", "opencode-plugin.mjs"),
@@ -100,12 +100,12 @@ const AGENT_CAPS = {
 };
 const VISION_MCP_NAME = "agent-tools-vision";
 const VISION_SKILL_NAME = "at-vision";
-// The at-vision skill ships inside the vision capability dir (integrations/vision),
+// The at-vision skill ships inside the vision capability dir (capabilities/vision),
 // not skills/: it is unusable without the MCP server, so it must not surface
 // as an independently installable skill.
-const VISION_SKILL_SRC = path.join(REPO_ROOT, "integrations", "vision", "skills", VISION_SKILL_NAME);
+const VISION_SKILL_SRC = path.join(REPO_ROOT, "capabilities", "vision", "skills", VISION_SKILL_NAME);
 const USAGE_SKILL_NAME = "at-usage";
-const USAGE_SKILL_SRC = path.join(REPO_ROOT, "integrations", "usage", "skills", USAGE_SKILL_NAME);
+const USAGE_SKILL_SRC = path.join(REPO_ROOT, "capabilities", "usage", "skills", USAGE_SKILL_NAME);
 const VISION_BUNDLED_MCP_SERVER = path.join(REPO_ROOT, "dist", "vision", "mcp-server.mjs");
 const VISION_BUNDLED_CLI = path.join(REPO_ROOT, "dist", "vision", "cli.mjs");
 const INSTALL_STATE_PATH = path.join(INSTALL_ROOT, "install-state.json");
@@ -292,7 +292,7 @@ function syncUsageRoutesDir(dryRun) {
 function parseArgs(argv) {
   const opts = {
     agents: [],
-    integrations: [],
+    capabilities: [],
     settings: null,
     codexHooks: null,
     opencodeConfigDir: null,
@@ -343,15 +343,15 @@ function parseArgs(argv) {
           console.error(`Unknown option: ${a}`);
           process.exit(2);
         }
-        opts.integrations.push(a);
+        opts.capabilities.push(a);
     }
   }
   if (opts.agents.length === 0) opts.agents = ["claude"];
-  if (!opts.help && opts.integrations.length === 0) {
+  if (!opts.help && opts.capabilities.length === 0) {
     console.error(`Missing capability (available: ${ALL_CAPS.join(", ")})`);
     process.exit(2);
   }
-  for (const name of opts.integrations) {
+  for (const name of opts.capabilities) {
     if (!ALL_CAPS.includes(name)) {
       console.error(`Unknown capability: ${name} (available: ${ALL_CAPS.join(", ")})`);
       process.exit(2);
@@ -361,14 +361,14 @@ function parseArgs(argv) {
 }
 
 function wants(opts, cap) {
-  return opts.integrations.length === 0 || opts.integrations.includes(cap);
+  return opts.capabilities.length === 0 || opts.capabilities.includes(cap);
 }
 
 function validateAgentCapabilities(opts) {
   const invalid = [];
   for (const agent of opts.agents) {
     const supported = AGENT_CAPS[agent] || [];
-    for (const cap of opts.integrations) {
+    for (const cap of opts.capabilities) {
       if (!supported.includes(cap)) invalid.push(`${cap} -a ${agent}`);
     }
   }
@@ -1181,7 +1181,7 @@ function cleanupVisionRuntimeIfUnused(opts) {
     try {
       fs.rmdirSync(path.dirname(VISION_RATE_LIMIT_STATE));
     } catch {
-      // The shared cache directory may contain state for other integrations.
+      // The shared cache directory may contain state for other capabilities.
     }
   }
   console.log(`  removed unused vision runtime ${VISION_RUNTIME_DIR}`);
@@ -1218,7 +1218,7 @@ function main() {
 }
 
 // Standalone vision commands dispatch before capability parsing so image
-// paths and questions are never mistaken for integrations.
+// paths and questions are never mistaken for capabilities.
 const subcommand = process.argv[2];
 if (subcommand === "inspect-image") {
   const { runInspectImageCli } = await import(

package/skills/{integrations → systems}/at-zentao/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: at-zentao
-description: "Work ZenTao bugs/tasks end to end: fetch details, confirm understanding, fix, verify, stage with git add, then ask before committing and before writing status back to ZenTao. Supports single items and sequential batches. Use when the user references ZenTao (禅道) bugs or tasks."
-argument-hint: "bug <id> | task <id> | bugs | tasks | export bug|task <id>"
+description: "Work ZenTao bugs/tasks end to end, log task hours, or read a linked story as development context: fetch details, handle the user's request, verify changes, and ask before committing or writing back to ZenTao. Supports single items and sequential batches. Use when the user references ZenTao (禅道) bugs, tasks, stories, requirements, or task hours."
+argument-hint: "bug <id> [request] | task <id> [request] | story <id> | bugs | tasks | export bug|task <id>"
 ---
 
 # ZenTao Bug/Task Workflow
@@ -70,6 +70,7 @@ node <skill-root>/scripts/zentao-cli.mjs list bugs
 node <skill-root>/scripts/zentao-cli.mjs list tasks
 node <skill-root>/scripts/zentao-cli.mjs get bug <id>
 node <skill-root>/scripts/zentao-cli.mjs get task <id>
+node <skill-root>/scripts/zentao-cli.mjs get story <id>
 node <skill-root>/scripts/zentao-cli.mjs get bug <id> --download-dir <path>
 ```
 
@@ -84,6 +85,7 @@ confirmation steps below:
 node <skill-root>/scripts/zentao-cli.mjs comment bug <id>
 node <skill-root>/scripts/zentao-cli.mjs comment task <id>
 node <skill-root>/scripts/zentao-cli.mjs resolve bug <id>
+node <skill-root>/scripts/zentao-cli.mjs log-hours task <id>
 node <skill-root>/scripts/zentao-cli.mjs finish task <id>
 ```
 
@@ -92,28 +94,43 @@ Input shapes:
 ```json
 {"comment":"Root cause and result."}
 {"resolution":"fixed","resolvedBuild":"trunk","comment":"Root cause and result, commit abc1234."}
+{"date":"2026-08-11","consumed":2,"left":14,"work":"Implemented the first part of the task."}
 {"currentConsumed":1.5,"realStarted":"2026-08-11 09:00:00","finishedDate":"2026-08-11 10:30:00"}
 ```
 
 For `duplicate`, also pass `"duplicateBug": <id>`. Send JSON through stdin,
 not as a command-line argument. The CLI handles UTF-8 form encoding and
 computes a task's total consumed hours from its current ZenTao value.
+`log-hours` defaults `date` to today, requires positive remaining hours,
+and keeps the task open. Use `finish` when the task is complete.
 
 ## Usage
 
 - `/at-zentao bug <id>` — handle a single bug.
 - `/at-zentao task <id>` — handle a single task.
+- `/at-zentao story <id>` — read requirement scope and acceptance context.
+  This mode is read-only; do not implement a Story status or comment workflow.
 - `/at-zentao bugs` — list bugs assigned to the configured account; let the
   user select one or more.
 - `/at-zentao tasks` — list assigned tasks and let the user select.
 - `/at-zentao export bug <id>` or `export task <id>` — create a read-only,
   self-contained handoff bundle.
 
+Treat text after an item id as a natural-language request. Phrases such as
+`填工时`, `记录工时`, `log hours`, and `worklog` enter task time-entry mode;
+users do not need to know the internal `log-hours` CLI command. Reuse any date,
+hours, or work description already supplied instead of asking twice.
+
 If a list response includes pager data showing more items than returned, tell
 the user the shown and total counts. Do not silently imply the list is complete.
 Do not browse through products/projects; start from assigned lists or an
 explicit item id.
 
+When a fetched Bug or Task has a positive `story` id, fetch that Story before
+planning the implementation. Use its `spec` and `verify` fields to identify
+scope, acceptance criteria, constraints, and non-goals. Keep the Bug or Task as
+the unit of work: never change, close, activate, or comment on the Story.
+
 ## Per-item workflow
 
 Follow these steps in order:
@@ -147,10 +164,16 @@ Bug resolutions are `fixed`, `notrepro`, `duplicate`, `bydesign`, `external`,
 write-back comment is one sentence containing root cause, change summary, and
 the commit hash when committed.
 
-For tasks, default to comment only. Offer `finish` only for a simple task
-completed in one sitting, and ask the user for `currentConsumed`; never invent
-hours. For multi-day work or per-day time records, comment and direct the user
-to ZenTao's web UI.
+For tasks, ask whether to record the current work after the verified result.
+For an incomplete task, collect the actual `consumed` hours and work date. When
+the task has a numeric current `left`, suggest the new `left` by subtracting the
+current entry and make that estimate editable in the confirmation; ask only
+when no reliable suggestion is possible. Draft `work` from the verified result
+when context is available. It is optional, so mention the omission without
+blocking the write when there is nothing useful to add. For a completed task,
+collect `currentConsumed` and draft a `finish` write. Never infer consumed
+hours. Show all submitted values and require the same explicit ZenTao
+confirmation before either write.
 
 ## Export mode
 

package/skills/{integrations → systems}/at-zentao/scripts/zentao-cli.mjs

@@ -355,6 +355,13 @@ function itemKind(value) {
   return value;
 }
 
+function detailKind(value) {
+  if (value !== "bug" && value !== "task" && value !== "story") {
+    throw new CliError("usage_error", "detail type must be bug, task, or story");
+  }
+  return value;
+}
+
 function pick(source, keys) {
   const output = {};
   for (const key of keys) if (source?.[key] !== undefined) output[key] = source[key];
@@ -367,7 +374,7 @@ function normalizeDetail(kind, response) {
   if (!detail || typeof detail !== "object") {
     throw new CliError("response_error", `ZenTao response has no ${kind} detail`);
   }
-  return { raw: detail, safe: pick(detail, [
+  const fields = [
     "id",
     "title",
     "name",
@@ -380,15 +387,24 @@ function normalizeDetail(kind, response) {
     "product",
     "project",
     "execution",
+    "story",
     "type",
     "openedDate",
     "deadline",
-  ]) };
+  ];
+  if (kind === "task") {
+    fields.push("estimate", "consumed", "left", "realStarted", "finishedDate");
+  } else if (kind === "story") {
+    fields.push("stage", "category", "plan", "estimate", "spec", "verify", "source", "sourceNote");
+  }
+  return { raw: detail, safe: pick(detail, fields) };
 }
 
 function attachmentUrls(detail) {
   const found = new Set();
-  const html = [detail.steps, detail.desc].filter((entry) => typeof entry === "string").join("\n");
+  const html = [detail.steps, detail.desc, detail.spec, detail.verify]
+    .filter((entry) => typeof entry === "string")
+    .join("\n");
   for (const match of html.matchAll(/(?:src|href)=["']([^"']*\/file-(?:read|download)-\d+[^"']*)["']/gi)) {
     found.add(match[1].replaceAll("&", "&"));
   }
@@ -461,18 +477,64 @@ function legacyResult(response) {
   return { ok: true, result, ...(typeof message === "string" ? { message: message.slice(0, 500) } : {}) };
 }
 
+async function workhourVariant(client, id) {
+  const variants = [
+    { route: `task-recordworkhour-${id}.json`, dateField: "date[1]", legacy: false },
+    { route: `task-recordestimate-${id}.json`, dateField: "dates[1]", legacy: true },
+  ];
+  for (const variant of variants) {
+    try {
+      decodeLegacy(await client.json(variant.route));
+      return variant;
+    } catch (error) {
+      const unavailable = error instanceof CliError && (
+        (error.code === "http_error" && error.status === 404) ||
+        error.code === "response_error"
+      );
+      if (!unavailable) throw error;
+    }
+  }
+  throw new CliError(
+    "unsupported_version",
+    "ZenTao exposes neither recordWorkhour nor recordEstimate for this task"
+  );
+}
+
 function localDateTime(date = new Date()) {
   const part = (value) => String(value).padStart(2, "0");
   return `${date.getFullYear()}-${part(date.getMonth() + 1)}-${part(date.getDate())} ${part(date.getHours())}:${part(date.getMinutes())}:${part(date.getSeconds())}`;
 }
 
+function localDate(date = new Date()) {
+  return localDateTime(date).slice(0, 10);
+}
+
+function effortDate(value) {
+  const date = value === undefined ? localDate() : value;
+  if (typeof date !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(date)) {
+    throw new CliError("usage_error", "date must use YYYY-MM-DD");
+  }
+  const [year, month, day] = date.split("-").map(Number);
+  const parsed = new Date(year, month - 1, day);
+  if (
+    parsed.getFullYear() !== year ||
+    parsed.getMonth() !== month - 1 ||
+    parsed.getDate() !== day
+  ) {
+    throw new CliError("usage_error", "date must be a valid calendar date");
+  }
+  if (date > localDate()) throw new CliError("usage_error", "date cannot be in the future");
+  return date;
+}
+
 function help() {
   return `Usage:
   zentao-cli.mjs doctor
   zentao-cli.mjs list <bugs|tasks>
-  zentao-cli.mjs get <bug|task> <id> [--download-dir <path>]
+  zentao-cli.mjs get <bug|task|story> <id> [--download-dir <path>]
   zentao-cli.mjs resolve bug <id>          # JSON on stdin
   zentao-cli.mjs comment <bug|task> <id>   # {"comment":"..."} on stdin
+  zentao-cli.mjs log-hours task <id>       # JSON on stdin
   zentao-cli.mjs finish task <id>          # JSON on stdin`;
 }
 
@@ -497,20 +559,21 @@ export async function run(argv, { env = process.env } = {}) {
     const singular = plural.slice(0, -1);
     const data = decodeLegacy(await client.json(`my-work-${singular}.json`));
     const fields = singular === "bug"
-      ? ["id", "title", "severity", "pri", "status", "project", "product"]
-      : ["id", "name", "title", "pri", "status", "project", "execution", "module"];
+      ? ["id", "title", "severity", "pri", "status", "project", "product", "story"]
+      : ["id", "name", "title", "pri", "status", "project", "execution", "module", "story", "estimate", "consumed", "left", "realStarted", "finishedDate"];
     const items = Array.isArray(data?.[plural]) ? data[plural].map((item) => pick(item, fields)) : [];
     return { items, ...(data?.pager ? { pager: pick(data.pager, ["recTotal", "recPerPage", "pageID", "pageTotal"]) } : {}) };
   }
 
   if (command === "get") {
-    const kind = itemKind(args[0]);
+    const kind = detailKind(args[0]);
     const id = positiveId(args[1]);
     let directory;
     if (args[2] === "--download-dir" && args[3]) directory = path.resolve(args[3]);
     else if (args.length > 2) throw new CliError("usage_error", "get accepts only --download-dir <path>");
     else directory = fs.mkdtempSync(path.join(os.tmpdir(), `agent-tools-zentao-${kind}-${id}-`));
-    const detail = normalizeDetail(kind, await client.json(`api.php/v1/${kind}s/${id}`));
+    const resource = kind === "story" ? "stories" : `${kind}s`;
+    const detail = normalizeDetail(kind, await client.json(`api.php/v1/${resource}/${id}`));
     const attachments = await downloadAttachments(client, detail.raw, directory);
     return { item: detail.safe, attachments };
   }
@@ -551,6 +614,38 @@ export async function run(argv, { env = process.env } = {}) {
     return legacyResult(response);
   }
 
+  if (command === "log-hours") {
+    if (args[0] !== "task") throw new CliError("usage_error", "log-hours supports tasks only");
+    const id = positiveId(args[1]);
+    const input = await readInput();
+    const consumed = Number(input.consumed);
+    const left = Number(input.left);
+    if (!Number.isFinite(consumed) || consumed <= 0) {
+      throw new CliError("usage_error", "consumed must be positive");
+    }
+    if (!Number.isFinite(left) || left <= 0) {
+      throw new CliError("usage_error", "left must be positive; use finish to complete a task");
+    }
+    if (input.work !== undefined && typeof input.work !== "string") {
+      throw new CliError("usage_error", "work must be a string when provided");
+    }
+    const date = effortDate(input.date);
+    const variant = await workhourVariant(client, id);
+    const fields = {
+      [variant.dateField]: date,
+      "work[1]": input.work?.trim(),
+      "consumed[1]": consumed,
+      "left[1]": left,
+    };
+    if (variant.legacy) fields["id[1]"] = 1;
+    const response = await client.json(variant.route, {
+      method: "POST",
+      headers: { "content-type": "application/x-www-form-urlencoded" },
+      body: formBody(fields),
+    });
+    return legacyResult(response);
+  }
+
   if (command === "finish") {
     if (args[0] !== "task") throw new CliError("usage_error", "finish supports tasks only");
     const id = positiveId(args[1]);