agent-skill-installer 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# codex-workbench
+
+用于迭代维护个人 Codex 能力资产的工作仓库。
+
+## 目录结构
+
+```text
+.
+├── skills/      # 各个 skill 的主目录（一项能力一个子目录）
+├── scripts/     # 跨 skill 的通用脚本
+├── templates/   # 可复用模板（提交信息、报告、提示词等）
+└── docs/        # 设计说明与维护文档
+```
+
+## 当前 Skills
+
+- `codex-session-daily-report`
+- `git-commit-helper`
+
+## npm CLI（npx 安装 skills）
+
+本仓库已提供可执行 CLI，包名/命令名为 `agent-skill-installer`。
+
+```bash
+# 查看可安装 skills
+npx agent-skill-installer list
+
+# 安装一个 skill（默认安装到 ~/.codex/skills）
+npx agent-skill-installer install git-commit-helper
+
+# 一次安装多个 skills
+npx agent-skill-installer install git-commit-helper codex-session-daily-report
+
+# 安装到自定义目录
+npx agent-skill-installer install git-commit-helper --dest ~/.codex/skills
+
+# 覆盖已存在 skill
+npx agent-skill-installer install git-commit-helper --force
+```
+
+发布到 npm 后，其他人即可直接使用上述 `npx` 命令。
+
+## 约定
+
+1. 单一 skill 放在 `skills/<skill-name>/`。
+2. 每个 skill 至少包含 `SKILL.md`。
+3. 优先小步提交，每次只做一个明确意图的变更。

package/bin/cli.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs/promises");
+const path = require("node:path");
+const os = require("node:os");
+
+const REPO_ROOT = path.resolve(__dirname, "..");
+const SKILLS_SOURCE_DIR = path.join(REPO_ROOT, "skills");
+const DEFAULT_DEST = path.join(os.homedir(), ".codex", "skills");
+
+function printHelp() {
+  console.log(`agent-skill-installer
+
+Usage:
+  npx agent-skill-installer list
+  npx agent-skill-installer install <skill...> [--dest <path>] [--force]
+
+Commands:
+  list                   List installable skills in this package.
+  install <skill...>     Install one or more skills to ~/.codex/skills by default.
+
+Options:
+  --dest <path>          Custom destination directory.
+  --force                Overwrite destination if a skill already exists.
+  -h, --help             Show this help.
+`);
+}
+
+async function dirExists(targetPath) {
+  try {
+    const stat = await fs.stat(targetPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+async function getAvailableSkills() {
+  const entries = await fs.readdir(SKILLS_SOURCE_DIR, { withFileTypes: true });
+  const skills = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+
+    const skillDir = path.join(SKILLS_SOURCE_DIR, entry.name);
+    const skillFile = path.join(skillDir, "SKILL.md");
+
+    try {
+      await fs.access(skillFile);
+      skills.push(entry.name);
+    } catch {
+      // Skip folders that are not valid skills.
+    }
+  }
+
+  return skills.sort();
+}
+
+function parseInstallArgs(args) {
+  const parsed = {
+    names: [],
+    dest: DEFAULT_DEST,
+    force: false
+  };
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+
+    if (arg === "--dest") {
+      const value = args[i + 1];
+      if (!value || value.startsWith("-")) {
+        throw new Error("Missing value for --dest");
+      }
+      parsed.dest = path.resolve(value);
+      i += 1;
+      continue;
+    }
+
+    if (arg === "--force") {
+      parsed.force = true;
+      continue;
+    }
+
+    if (arg === "-h" || arg === "--help") {
+      parsed.help = true;
+      continue;
+    }
+
+    if (arg.startsWith("-")) {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+
+    parsed.names.push(arg);
+  }
+
+  return parsed;
+}
+
+async function listSkills() {
+  const skills = await getAvailableSkills();
+
+  if (skills.length === 0) {
+    console.log("No installable skills found in this package.");
+    return;
+  }
+
+  console.log("Installable skills:");
+  for (const skill of skills) {
+    console.log(`- ${skill}`);
+  }
+}
+
+async function installSkills(rawArgs) {
+  const parsed = parseInstallArgs(rawArgs);
+  if (parsed.help) {
+    printHelp();
+    return;
+  }
+
+  if (parsed.names.length === 0) {
+    throw new Error("Please provide at least one skill name to install.");
+  }
+
+  const available = new Set(await getAvailableSkills());
+  for (const name of parsed.names) {
+    if (!available.has(name)) {
+      throw new Error(`Skill "${name}" not found. Run "list" to view available skills.`);
+    }
+  }
+
+  await fs.mkdir(parsed.dest, { recursive: true });
+
+  for (const name of parsed.names) {
+    const from = path.join(SKILLS_SOURCE_DIR, name);
+    const to = path.join(parsed.dest, name);
+    const exists = await dirExists(to);
+
+    if (exists && !parsed.force) {
+      throw new Error(
+        `Destination already exists for "${name}": ${to} (use --force to overwrite)`
+      );
+    }
+
+    if (exists && parsed.force) {
+      await fs.rm(to, { recursive: true, force: true });
+    }
+
+    await fs.cp(from, to, { recursive: true });
+    console.log(`Installed "${name}" -> ${to}`);
+  }
+
+  console.log("Done. Restart Codex to pick up new skills.");
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  if (!command || command === "-h" || command === "--help") {
+    printHelp();
+    return;
+  }
+
+  if (command === "list") {
+    await listSkills();
+    return;
+  }
+
+  if (command === "install") {
+    await installSkills(args.slice(1));
+    return;
+  }
+
+  throw new Error(`Unknown command: ${command}`);
+}
+
+main().catch((error) => {
+  console.error(`Error: ${error.message}`);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "agent-skill-installer",
+  "version": "0.1.0",
+  "description": "Install one or more Codex skills from this package via npx.",
+  "bin": {
+    "agent-skill-installer": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "check": "node bin/cli.js list"
+  },
+  "keywords": [
+    "codex",
+    "skills",
+    "cli"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/skills/codex-session-daily-report/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: codex-session-daily-report
+description: Read Codex session files for a target date, summarize completed work from assistant final answers, and produce a concise daily report. Use when the user asks to summarize today's Codex activity, generate a daily report from `~/.codex/sessions`, or review completed outcomes across sessions.
+---
+
+# Codex Session Daily Report
+
+Produce a daily report from local Codex sessions.
+
+## Workflow
+
+1. Resolve target date.
+- If user says `today`, use an absolute date (e.g. `2026-03-02`).
+
+2. Read session files for that date.
+
+```bash
+ls -1 ~/.codex/sessions/2026/03/02/*.jsonl
+```
+
+3. Extract completed assistant outputs only (`final_answer`).
+
+```bash
+for f in ~/.codex/sessions/2026/03/02/*.jsonl; do
+  jq -r 'select(.type=="response_item" and .payload.type=="message" and .payload.role=="assistant" and .payload.phase=="final_answer")
+    | .timestamp + "\t" + ((.payload.content // [])
+    | map(select(.type=="output_text") | .text)
+    | join(" ") | gsub("[\n\r\t]+";" ") | gsub(" +";" "))' "$f"
+done
+```
+
+4. Summarize by主题 and result.
+- Merge similar tasks into one topic line.
+- Keep key evidence: file paths, tests, and commit hashes if present.
+- Keep neutral language and avoid guessing.
+
+5. Output daily report only (not logs).
+
+## Output Format
+
+Use this structure:
+
+1. 日期：`YYYY-MM-DD`
+2. 今日业务事项：按主题列 2-6 条
+3. 关键产出：代码改动/测试结论/提交哈希
+4. 风险与待办：未完成项、潜在误判点
+
+## Constraints
+
+- Prefer `assistant final_answer` over commentary.
+- Do not output raw JSONL unless user explicitly asks.
+- Keep report concise and factual.
+- If no completed entries are found, state that clearly.

package/skills/codex-session-daily-report/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Codex Session Daily Report"
+  short_description: "Generate daily reports from Codex session history."
+  default_prompt: "Use $codex-session-daily-report to read today's Codex sessions and output a concise daily report."

package/skills/git-commit-helper/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: git-commit-helper
+description: "严格生成与校验中文 Git 提交信息，固定格式为 type(scope): summary，type 仅允许 feat/fix/refactor/perf/style/test/docs/chore，summary 必须用祈使句、不超过 50 字符、不得以句号结尾且不得包含 and/&/multiple changes。使用该技能于编写提交说明、检查提交文本是否合规，或执行使用 codex (codex-ice@gmail.com) 身份的提交时。"
+---
+
+# Git Commit Helper
+
+## 概览
+
+按固定规范生成中文提交信息，并在提交前进行格式校验。
+统一使用作者身份：`codex <codex-ice@gmail.com>`。
+
+## 工作流
+
+1. 先查看暂存变更，确认本次提交只表达一个意图：`git diff --cached --name-status`。
+2. 选择 `type`，必须是以下之一：`feat` `fix` `refactor` `perf` `style` `test` `docs` `chore`。
+3. 写首行：`<type>(<scope>): <summary>`。
+4. 首行后可选正文；若 `type=perf`，必须写正文说明优化原因。
+5. 使用脚本校验：`python3 scripts/validate_commit_message.py --file <msg-file>`。
+6. 通过校验后提交，并固定作者身份：
+   `git -c user.name='codex' -c user.email='codex-ice@gmail.com' commit -F <msg-file>`。
+
+## 强制规则
+
+1. 格式必须严格为：`<type>(<scope>): <summary>`。
+2. `type` 只能从这 8 个值中选择：`feat` `fix` `refactor` `perf` `style` `test` `docs` `chore`。
+3. `summary` 必须满足：
+   - 使用祈使句。
+   - 不超过 50 字符。
+   - 不要句号（`。` 或 `.`）。
+   - 不要出现 `and`、`&`、`multiple changes`。
+   - 使用中文表达。
+4. 提交文本（`summary` 与可选正文）使用中文。
+5. `perf` 类型必须在正文说明优化原因。
+
+## 示例
+
+正确：
+- `fix(album): 避免滚动时重复渲染`
+- `docs(api): 补充鉴权参数说明`
+
+错误：
+- `update code`
+- `fix bug and refactor logic`
+- `optimize`
+
+## 脚本资源
+
+- `scripts/validate_commit_message.py`
+  校验提交文本是否符合本技能的强制规则。

package/skills/git-commit-helper/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Git Commit Helper"
+  short_description: "Generate Chinese Git commit messages with strict checks"
+  default_prompt: "Use $git-commit-helper to draft a Chinese commit message and validate it before committing as codex <codex-ice@gmail.com>."

package/skills/git-commit-helper/scripts/validate_commit_message.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+"""Validate commit message for git-commit-helper skill rules."""
+
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+ALLOWED_TYPES = ("feat", "fix", "refactor", "perf", "style", "test", "docs", "chore")
+HEADER_RE = re.compile(
+    r"^(?P<type>feat|fix|refactor|perf|style|test|docs|chore)"
+    r"\((?P<scope>[a-z0-9][a-z0-9-]*)\): (?P<summary>.+)$"
+)
+CJK_RE = re.compile(r"[\u4e00-\u9fff]")
+FORBIDDEN_SUMMARY_PATTERNS = (
+    re.compile(r"\band\b", re.IGNORECASE),
+    re.compile(r"&"),
+    re.compile(r"multiple changes", re.IGNORECASE),
+)
+FORBIDDEN_ENDINGS = (".", "。")
+MAX_SUMMARY_LEN = 50
+
+
+def load_message(args: argparse.Namespace) -> str:
+    if args.message and args.file:
+        raise ValueError("--message 与 --file 只能二选一")
+    if not args.message and not args.file:
+        raise ValueError("必须提供 --message 或 --file")
+
+    if args.message:
+        return args.message
+
+    content = Path(args.file).read_text(encoding="utf-8")
+    return content.rstrip("\n")
+
+
+def validate_commit_message(message: str) -> list[str]:
+    errors: list[str] = []
+    lines = message.splitlines()
+
+    if not lines:
+        return ["提交信息不能为空"]
+
+    header = lines[0].strip()
+    if not header:
+        return ["提交首行不能为空"]
+
+    match = HEADER_RE.match(header)
+    commit_type = None
+    summary = ""
+    if not match:
+        errors.append("首行格式必须为 <type>(<scope>): <summary>")
+    else:
+        commit_type = match.group("type")
+        summary = match.group("summary").strip()
+
+    if len(lines) > 1 and lines[1] != "":
+        errors.append("若包含正文，第 2 行必须为空行")
+
+    body = "\n".join(lines[2:]).strip() if len(lines) > 2 else ""
+
+    if commit_type and commit_type not in ALLOWED_TYPES:
+        errors.append("type 必须是 feat/fix/refactor/perf/style/test/docs/chore 之一")
+
+    if summary:
+        if len(summary) > MAX_SUMMARY_LEN:
+            errors.append("summary 长度不能超过 50 字符")
+        if summary.endswith(FORBIDDEN_ENDINGS):
+            errors.append("summary 结尾不能使用句号")
+        if not CJK_RE.search(summary):
+            errors.append("summary 必须使用中文")
+
+        for pattern in FORBIDDEN_SUMMARY_PATTERNS:
+            if pattern.search(summary):
+                errors.append("summary 不能包含 and / & / multiple changes")
+                break
+
+    if body and not CJK_RE.search(body):
+        errors.append("正文需使用中文")
+
+    if commit_type == "perf" and not body:
+        errors.append("perf 类型必须提供正文说明优化原因")
+
+    return errors
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="校验提交信息是否符合 git-commit-helper 规则",
+    )
+    parser.add_argument("--message", help="直接传入提交信息文本")
+    parser.add_argument("--file", help="从文件读取提交信息")
+    args = parser.parse_args()
+
+    try:
+        message = load_message(args)
+    except Exception as exc:  # noqa: BLE001
+        print(f"参数错误: {exc}")
+        return 2
+
+    errors = validate_commit_message(message)
+    if errors:
+        print("校验失败:")
+        for idx, err in enumerate(errors, start=1):
+            print(f"{idx}. {err}")
+        return 1
+
+    print("校验通过")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())