@adonis0123/weekly-report 1.0.5

package/.claude-skill.json

@@ -0,0 +1,46 @@
+{
+  "name": "weekly-report",
+  "version": "1.0.6",
+  "package": "@adonis0123/weekly-report",
+  "files": {
+    "references": "references/",
+    "src": "src/"
+  },
+  "targets": {
+    "claude-code": {
+      "enabled": true,
+      "paths": {
+        "global": ".claude/skills",
+        "project": ".claude/skills"
+      }
+    },
+    "cursor": {
+      "enabled": true,
+      "paths": {
+        "global": ".cursor/skills",
+        "project": ".cursor/skills"
+      }
+    },
+    "windsurf": {
+      "enabled": false,
+      "paths": {
+        "global": ".windsurf/skills",
+        "project": ".windsurf/skills"
+      }
+    },
+    "aider": {
+      "enabled": false,
+      "paths": {
+        "global": ".aider/skills",
+        "project": ".aider/skills"
+      }
+    },
+    "custom": {
+      "enabled": false,
+      "paths": {
+        "global": ".ai-skills",
+        "project": ".ai-skills"
+      }
+    }
+  }
+}

package/README.md

@@ -0,0 +1,63 @@
+# @adonis0123/weekly-report
+
+> Claude Code 技能 - 自动读取 Git 提交记录生成周报
+
+[![npm version](https://img.shields.io/npm/v/@adonis0123/weekly-report.svg)](https://www.npmjs.com/package/@adonis0123/weekly-report)
+
+## 安装
+
+```bash
+npm install -g @adonis0123/weekly-report
+```
+
+## 使用
+
+在任意 Git 项目目录中，对 Claude Code 说：
+
+```
+/weekly-report
+```
+
+## 功能
+
+- 自动读取 Git 提交记录
+- 支持多仓库汇总
+- 智能过滤琐碎提交（typo、merge、format）
+- 按项目分组生成结构化周报
+- 灵活时间范围（本周、上周、自定义）
+- 周报自动保存到 `~/.weekly-reports/`
+
+## 输出示例
+
+```markdown
+# 周报 (2026-01-06 ~ 2026-01-12)
+
+project-frontend
+  - 构建工具升级改造
+  - 核心功能开发流程跟进
+
+project-backend
+  - 自定义类型化消息渲染
+  - 断线重连流程梳理
+```
+
+## 配置
+
+配置文件：`~/.weekly-reports/config.json`
+
+```json
+{
+  "repos": [
+    { "name": "project-a", "path": "/path/to/project-a" }
+  ]
+}
+```
+
+## 更多技能
+
+- [@adonis0123/agent-browser](https://www.npmjs.com/package/@adonis0123/agent-browser) - 浏览器自动化
+- [@adonis0123/react-best-practices](https://www.npmjs.com/package/@adonis0123/react-best-practices) - React 最佳实践
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: weekly-report
+description: 自动读取 Git 提交记录生成周报。用于生成工作周报、项目总结、团队协作汇报。支持多仓库汇总。
+allowed-tools: Read, Write, Bash(git:*), Bash(python:*)
+metadata:
+  author: adonis
+  version: "1.0.0"
+---
+
+# 周报生成技能
+
+自动读取 Git 提交记录，按项目分组生成结构化周报。
+
+## 功能特性
+
+- 自动读取 Git 提交记录
+- 支持多仓库汇总
+- 自动识别当前用户 (`git config user.name`)
+- 按项目分组，生成结构化周报
+- 过滤琐碎提交（typo、merge、format 等）
+- 支持添加补充说明
+- 周报统一存储在 `~/.weekly-reports/` 目录
+
+## 使用方式
+
+### 基本用法
+
+在任意 Git 项目目录中执行：
+
+```
+/weekly-report
+```
+
+### 执行流程
+
+1. **选择时间范围**
+   - 本周 (显示具体日期，如 2026-01-06 ~ 2026-01-12)
+   - 上周 (显示具体日期，如 2025-12-30 ~ 2026-01-05)
+   - 前半年 (显示具体日期，如 2025-07-13 ~ 2026-01-13)
+   - 自定义周报（输入周一日期）
+   - 自定义时间段（输入起始日期，截止到今天）
+
+   **重要**：选择时必须显示具体的日期范围，让用户确认是否正确
+
+2. **选择仓库**（如已配置多仓库）
+   - 显示已配置的仓库列表
+   - 可多选要包含的仓库
+   - 可添加当前目录为新仓库
+
+3. **添加补充内容**（可选）
+   - 输入额外的工作内容
+   - 如：参与会议、技术分享等
+
+4. **生成周报**
+   - 读取选定仓库的 Git 提交（必须覆盖所有分支/远端跟踪分支，避免漏提交）
+   - 按项目分组
+   - 过滤琐碎提交
+   - 生成 Markdown 格式周报
+   - 周报保存到 `~/.weekly-reports/{year}/week-{week}.md`
+   - 时间段报告保存到 `~/.weekly-reports/periods/{start_date}_to_{end_date}.md`
+
+## Git 提交读取（重要）
+
+为避免“只读取当前分支而漏掉其它分支（例如 `credits-lite*`）”的问题，读取提交时必须使用 `--all`（覆盖本地分支 + 远端跟踪分支），并确保截止时间包含结束日当天：
+
+```bash
+# 关键点：
+# - 用 --all 覆盖所有本地 refs（包含 remotes/origin/*）
+# - --until 用 “结束日 23:59:59” 避免漏掉结束日当天提交
+# - --author 建议用 name + email 联合匹配，避免不同身份写法漏掉本人提交
+
+AUTHOR_PATTERN="(your-name|your@email.com)"  # 或仅用你的 name/email
+git log --all \
+  --author="$AUTHOR_PATTERN" \
+  --since="$START_DATE 00:00:00" \
+  --until="$END_DATE 23:59:59" \
+  --pretty=format:"%H|%s|%an|%ad" \
+  --date=short
+```
+
+如果 `git branch -a` 看不到目标远端分支（说明本地没有对应的远端跟踪引用），需要先 `git fetch --all --prune`（在用户同意且网络可用时执行），否则无法读取到“本地不存在的分支”的提交。
+
+## 输出格式
+
+周报采用层级列表结构，**必须包含日期范围标题**，按项目分组：
+
+### 周报格式
+
+```markdown
+# 周报 (2026-01-06 ~ 2026-01-12)
+
+项目名称
+  - 主要工作点（10字以内）
+    - 补充说明（可选）
+  - 另一个工作点
+
+其他
+  - 不属于特定项目的工作内容
+```
+
+### 时间段报告格式
+
+```markdown
+# 工作总结 (2025-07-13 ~ 2026-01-13)
+
+项目名称
+  - 主要工作点（10字以内）
+    - 补充说明（可选）
+  - 另一个工作点
+
+其他
+  - 不属于特定项目的工作内容
+```
+
+### 示例输出
+
+```markdown
+# 周报 (2026-01-06 ~ 2026-01-12)
+
+project-frontend
+  - 构建工具升级改造
+  - 核心功能开发流程跟进
+    - 方案合理性优化
+  - 脚本国际化优化
+
+project-backend
+  - 自定义类型化消息渲染
+  - 断线重连流程梳理
+
+其他
+  - 新版国际化方案讨论
+```
+
+## 配置文件
+
+配置文件位于 `~/.weekly-reports/config.json`：
+
+```json
+{
+  "repos": [
+    {
+      "name": "project-a",
+      "path": "/home/user/projects/project-a"
+    },
+    {
+      "name": "project-b",
+      "path": "/home/user/projects/project-b"
+    }
+  ],
+  "default_author": "auto",
+  "output_format": "markdown"
+}
+```
+
+## 总结原则
+
+### 必须遵守
+
+- **事实导向**：只总结实际完成的工作
+- **简洁精炼**：主要工作点控制在 10 字以内
+- **重点突出**：过滤琐碎修改
+- **按项目分组**：相同项目的工作归类
+- **层级清晰**：用缩进表示从属关系
+
+### 过滤规则
+
+以下提交不会单独列出：
+- 纯格式化/代码风格调整
+- 简单的 typo 修复
+- 依赖版本小幅更新
+- Merge 提交
+- 重复性的相似提交
+
+详细格式规范见 [周报格式规范](references/WEEKLY_REPORT_FORMAT.md)

package/install-skill.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// shared/src/install-skill.ts
+var import_fs2 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
+var import_os2 = __toESM(require("os"));
+var import_child_process = require("child_process");
+
+// shared/src/utils.ts
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_os = __toESM(require("os"));
+var CWD = process.env.INIT_CWD || process.cwd();
+var DEFAULT_TARGET = {
+  name: "claude-code",
+  paths: {
+    global: ".claude/skills",
+    project: ".claude/skills"
+  }
+};
+function getEnabledTargets(config) {
+  if (!config.targets) {
+    return [DEFAULT_TARGET];
+  }
+  return Object.entries(config.targets).filter(([_, target]) => target.enabled).map(([name, target]) => ({
+    name,
+    paths: target.paths
+  }));
+}
+function extractSkillName(packageName) {
+  if (packageName.startsWith("@")) {
+    return packageName.split("/")[1] || packageName;
+  }
+  return packageName;
+}
+function detectInstallLocation(targetPaths, isGlobal) {
+  if (isGlobal) {
+    return {
+      type: "personal",
+      base: import_path.default.join(import_os.default.homedir(), targetPaths.global)
+    };
+  }
+  let projectRoot = CWD;
+  while (projectRoot !== import_path.default.dirname(projectRoot)) {
+    const hasPackageJson = import_fs.default.existsSync(import_path.default.join(projectRoot, "package.json"));
+    const hasGit = import_fs.default.existsSync(import_path.default.join(projectRoot, ".git"));
+    const isInNodeModules = projectRoot.includes("/node_modules/") || import_path.default.basename(projectRoot) === "node_modules";
+    if ((hasPackageJson || hasGit) && !isInNodeModules) {
+      break;
+    }
+    projectRoot = import_path.default.dirname(projectRoot);
+  }
+  const finalIsInNodeModules = projectRoot.includes("/node_modules/") || import_path.default.basename(projectRoot) === "node_modules";
+  if (finalIsInNodeModules) {
+    console.warn("\u26A0 Warning: Could not find project root directory, using current directory");
+    projectRoot = CWD;
+  }
+  return {
+    type: "project",
+    base: import_path.default.join(projectRoot, targetPaths.project)
+  };
+}
+function isGlobalInstall() {
+  return process.env.npm_config_global === "true";
+}
+function copyDir(src, dest) {
+  import_fs.default.mkdirSync(dest, { recursive: true });
+  const entries = import_fs.default.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = import_path.default.join(src, entry.name);
+    const destPath = import_path.default.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      import_fs.default.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+function ensureDir(dir) {
+  if (!import_fs.default.existsSync(dir)) {
+    import_fs.default.mkdirSync(dir, { recursive: true });
+  }
+}
+function removeDir(dir) {
+  if (import_fs.default.existsSync(dir)) {
+    import_fs.default.rmSync(dir, { recursive: true, force: true });
+  }
+}
+function readSkillConfig(dir) {
+  const configPath = import_path.default.join(dir, ".claude-skill.json");
+  if (!import_fs.default.existsSync(configPath)) {
+    throw new Error(".claude-skill.json not found");
+  }
+  return JSON.parse(import_fs.default.readFileSync(configPath, "utf-8"));
+}
+
+// shared/src/install-skill.ts
+function fetchFromRemote(tempDir, remoteSource) {
+  try {
+    console.log(`  \u{1F310} Fetching latest from ${remoteSource}...`);
+    (0, import_child_process.execSync)(`npx degit ${remoteSource} "${tempDir}" --force`, {
+      stdio: "pipe",
+      timeout: 6e4
+    });
+    if (import_fs2.default.existsSync(import_path2.default.join(tempDir, "SKILL.md"))) {
+      console.log("  \u2713 Fetched latest version from remote");
+      return true;
+    }
+    console.warn("  \u26A0 Remote fetch succeeded but SKILL.md not found");
+    return false;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.warn(`  \u26A0 Could not fetch from remote: ${message}`);
+    console.log("  \u2139 Using bundled version as fallback");
+    return false;
+  }
+}
+function getSourceDir(config, packageDir) {
+  if (!config.remoteSource) {
+    return {
+      sourceDir: packageDir,
+      cleanup: () => {
+      },
+      isRemote: false
+    };
+  }
+  const tempDir = import_path2.default.join(import_os2.default.tmpdir(), `skill-fetch-${Date.now()}`);
+  const remoteSuccess = fetchFromRemote(tempDir, config.remoteSource);
+  if (remoteSuccess) {
+    return {
+      sourceDir: tempDir,
+      cleanup: () => {
+        try {
+          import_fs2.default.rmSync(tempDir, { recursive: true, force: true });
+        } catch {
+        }
+      },
+      isRemote: true
+    };
+  }
+  try {
+    import_fs2.default.rmSync(tempDir, { recursive: true, force: true });
+  } catch {
+  }
+  return {
+    sourceDir: packageDir,
+    cleanup: () => {
+    },
+    isRemote: false
+  };
+}
+function updateManifest(skillsDir, config, targetName, isRemote) {
+  const manifestPath = import_path2.default.join(skillsDir, ".skills-manifest.json");
+  let manifest = { skills: {} };
+  if (import_fs2.default.existsSync(manifestPath)) {
+    try {
+      manifest = JSON.parse(import_fs2.default.readFileSync(manifestPath, "utf-8"));
+    } catch {
+      console.warn("  Warning: Could not parse existing manifest, creating new one");
+      manifest = { skills: {} };
+    }
+  }
+  const skillName = extractSkillName(config.name);
+  manifest.skills[config.name] = {
+    version: config.version,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    package: config.package || config.name,
+    path: import_path2.default.join(skillsDir, skillName),
+    target: targetName,
+    ...config.remoteSource && { source: config.remoteSource }
+  };
+  import_fs2.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+}
+function installToTarget(target, config, sourceDir, isRemote) {
+  var _a;
+  console.log(`
+\u{1F4E6} Installing to ${target.name}...`);
+  const isGlobal = isGlobalInstall();
+  const location = detectInstallLocation(target.paths, isGlobal);
+  const skillName = extractSkillName(config.name);
+  const targetDir = import_path2.default.join(location.base, skillName);
+  const altTargetDir = import_path2.default.join(location.base, config.name);
+  console.log(`  Type: ${location.type}${isGlobal ? " (global)" : " (project)"}`);
+  console.log(`  Directory: ${targetDir}`);
+  if (import_fs2.default.existsSync(altTargetDir) && altTargetDir !== targetDir) {
+    console.log("  \u{1F9F9} Cleaning up alternative path format...");
+    removeDir(altTargetDir);
+    console.log(`  \u2713 Removed directory: ${config.name}`);
+  }
+  ensureDir(targetDir);
+  const skillMdSource = import_path2.default.join(sourceDir, "SKILL.md");
+  if (!import_fs2.default.existsSync(skillMdSource)) {
+    throw new Error("SKILL.md is required but not found");
+  }
+  import_fs2.default.copyFileSync(skillMdSource, import_path2.default.join(targetDir, "SKILL.md"));
+  console.log("  \u2713 Copied SKILL.md");
+  const filesToCopy = config.files || {};
+  for (const [source, dest] of Object.entries(filesToCopy)) {
+    const sourcePath = import_path2.default.join(sourceDir, source);
+    if (!import_fs2.default.existsSync(sourcePath)) {
+      console.warn(`  \u26A0 Warning: ${source} not found, skipping`);
+      continue;
+    }
+    const destPath = import_path2.default.join(targetDir, dest);
+    if (import_fs2.default.statSync(sourcePath).isDirectory()) {
+      copyDir(sourcePath, destPath);
+      console.log(`  \u2713 Copied directory: ${source}`);
+    } else {
+      const destDir = import_path2.default.dirname(destPath);
+      ensureDir(destDir);
+      import_fs2.default.copyFileSync(sourcePath, destPath);
+      console.log(`  \u2713 Copied file: ${source}`);
+    }
+  }
+  updateManifest(location.base, config, target.name, isRemote);
+  if ((_a = config.hooks) == null ? void 0 : _a.postinstall) {
+    console.log("  \u{1F527} Running postinstall hook...");
+    try {
+      (0, import_child_process.execSync)(config.hooks.postinstall, {
+        cwd: targetDir,
+        stdio: "pipe"
+      });
+      console.log("  \u2713 Postinstall hook completed");
+    } catch {
+      console.warn("  \u26A0 Warning: postinstall hook failed");
+    }
+  }
+  console.log(`  \u2705 Installed to ${target.name}`);
+  return targetDir;
+}
+function installSkill() {
+  console.log("\u{1F680} Installing AI Coding Skill...\n");
+  const packageDir = __dirname;
+  const config = readSkillConfig(packageDir);
+  const enabledTargets = getEnabledTargets(config);
+  if (enabledTargets.length === 0) {
+    console.warn("\u26A0 No targets enabled in configuration");
+    console.warn("Please enable at least one target in .claude-skill.json");
+    return;
+  }
+  console.log(`Installing skill "${config.name}" to ${enabledTargets.length} target(s):`);
+  enabledTargets.forEach((target) => {
+    console.log(`  \u2022 ${target.name}`);
+  });
+  const { sourceDir, cleanup, isRemote } = getSourceDir(config, packageDir);
+  if (isRemote) {
+    console.log(`
+\u{1F4E1} Source: Remote (${config.remoteSource})`);
+  } else {
+    console.log("\n\u{1F4E6} Source: Bundled (local)");
+  }
+  try {
+    const installedPaths = [];
+    for (const target of enabledTargets) {
+      try {
+        const installPath = installToTarget(target, config, sourceDir, isRemote);
+        installedPaths.push({ target: target.name, path: installPath });
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`
+\u274C Failed to install to ${target.name}:`, message);
+      }
+    }
+    console.log("\n" + "=".repeat(60));
+    console.log("\u2705 Installation Complete!");
+    console.log("=".repeat(60));
+    if (installedPaths.length > 0) {
+      console.log("\nInstalled to:");
+      installedPaths.forEach(({ target, path: installPath }) => {
+        console.log(`  \u2022 ${target}: ${installPath}`);
+      });
+      console.log("\n\u{1F4D6} Next Steps:");
+      console.log("  1. Restart your AI coding tool(s)");
+      console.log('  2. Ask: "What skills are available?"');
+      console.log("  3. Start using your skill!");
+    }
+  } finally {
+    cleanup();
+  }
+}
+try {
+  installSkill();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error("\n\u274C Failed to install skill:", message);
+  console.error("\nTroubleshooting:");
+  console.error("- Ensure .claude-skill.json exists and is valid JSON");
+  console.error("- Ensure SKILL.md exists");
+  console.error("- Check file permissions for target directories");
+  console.error("- Verify at least one target is enabled in .claude-skill.json");
+  console.error("- Try running with sudo for global installation (if needed)");
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@adonis0123/weekly-report",
+  "version": "1.0.5",
+  "description": "Claude Code Skill - 自动读取 Git 提交记录生成周报，支持多仓库汇总和智能过滤",
+  "scripts": {
+    "postinstall": "node install-skill.js",
+    "preuninstall": "node uninstall-skill.js",
+    "test": "node install-skill.js && echo 'Installation test completed.'"
+  },
+  "files": [
+    "SKILL.md",
+    "references/",
+    "src/",
+    "install-skill.js",
+    "uninstall-skill.js",
+    ".claude-skill.json",
+    "utils.js"
+  ],
+  "keywords": [
+    "claude-code",
+    "skill",
+    "weekly-report",
+    "git",
+    "commit-analyzer",
+    "automation"
+  ],
+  "author": "adonis",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Adonis0123/agent-skill-npm-boilerplate.git",
+    "directory": "packages/weekly-report"
+  },
+  "homepage": "https://github.com/Adonis0123/agent-skill-npm-boilerplate/tree/main/packages/weekly-report"
+}