@adonis0123/weekly-report 1.0.12 → 1.0.13

package/README.md

@@ -62,6 +62,7 @@ project-backend
 - [@adonis0123/staged-changes-review](https://www.npmjs.com/package/@adonis0123/staged-changes-review) - 代码审查
 - [@adonis0123/create-skill](https://www.npmjs.com/package/@adonis0123/create-skill) - 创建新技能包
 - [@adonis0123/code-doc-generator](https://www.npmjs.com/package/@adonis0123/code-doc-generator) - 代码文档生成
+- [@adonis0123/css-tailwind-styling](https://www.npmjs.com/package/@adonis0123/css-tailwind-styling) - CSS 和 Tailwind 样式规范
 ## License
 
 MIT

package/SKILL.md

@@ -150,7 +150,26 @@ THIS_SUNDAY=$(TZ='Asia/Shanghai' date -v+$((7-DAY_OF_WEEK))d +%Y-%m-%d)
 
 **注意**：所有显示给用户的日期都必须是中国时区的日期。
 
-如果 `git branch -a` 看不到目标远端分支（说明本地没有对应的远端跟踪引用），需要先 `git fetch --all --prune`（在用户同意且网络可用时执行），否则无法读取到“本地不存在的分支”的提交。
+如果 `git branch -a` 看不到目标远端分支（说明本地没有对应的远端跟踪引用），需要先 `git fetch --all --prune`（在用户同意且网络可用时执行），否则无法读取到"本地不存在的分支"的提交。
+
+### Commit Diff 分析（判断重点）
+
+在总结前，必须通过 commit diff 判断工作重要性：
+
+```bash
+# 查看 commit 的改动规模
+git show --stat <commit-hash>
+```
+
+**重点判断标准**：
+
+| 条件 | 判定 | 处理方式 |
+|------|------|----------|
+| 改动文件数 > 5 或行数 > 100 | 重点工作 | 详细描述，保留子条目 |
+| 涉及核心模块（auth, payment 等） | 重点工作 | 详细描述 |
+| 有多次迭代/排查过程 | 难点工作 | 保留排查细节 |
+| 只改 1-2 个文件且行数 < 20 | 普通工作 | 简略一句话 |
+| 纯配置/样式微调 | 琐碎工作 | 过滤或合并 |
 
 ## 输出格式
 
@@ -190,21 +209,17 @@ THIS_SUNDAY=$(TZ='Asia/Shanghai' date -v+$((7-DAY_OF_WEEK))d +%Y-%m-%d)
 # 周报 (2026-01-06 ~ 2026-01-12)
 
 project-frontend
-  - [新功能] 用户登录系统开发，支持多种登录方式
+  - 跟进用户登录系统开发
     - 接口对接和联调
     - 表单验证优化
-    - 记住登录状态功能
-  - [修复] 认证流程问题排查修复
-    - 定位 token 过期问题
-    - 优化重试机制
-  - [优化] 构建工具升级
-  - [文档] 国际化文档更新
+  - 认证流程问题排查修复
+    - 排查后定位 token 过期问题
+  - 构建工具升级
 
 project-backend
-  - [新功能] 自定义类型化消息渲染，支持多种格式
-    - 富文本渲染
-    - 图片消息支持
-  - [优化] 断线重连流程
+  - 完成自定义消息渲染功能
+    - 支持富文本和图片
+  - 优化断线重连流程
 
 其他
   - 新版国际化方案讨论
@@ -240,49 +255,67 @@ project-backend
 - **重点突出**：过滤琐碎修改
 - **按项目分组**：相同项目的工作归类
 - **层级清晰**：用缩进表示从属关系
+- **无标签风格**：不使用 [新功能]、[修复] 等标签，直接描述工作内容
 
-### 类型标签
+### 输出约束（必须遵守）
 
-根据提交类型自动添加标签：
-
-| 类型 | 标签 | 说明 |
-|------|------|------|
-| feat | [新功能] | 新增功能 |
-| fix | [修复] | 问题修复 |
-| refactor | [优化] | 代码重构 |
-| perf | [性能] | 性能优化 |
-| docs | [文档] | 文档更新 |
-| test | [测试] | 测试相关 |
-| build | [构建] | 构建相关 |
+| 约束项 | 限制 |
+|--------|------|
+| 每个主工作点 | 最多 2-3 个子条目 |
+| 每个子条目 | 不超过 15 字 |
+| 每个项目 | 最多 5-7 个主条目 |
+| 修复类工作 | 除非是重大问题排查，否则不展开子条目 |
 
 ### 重点与难点体现
 
 自动识别工作的重点和难点，通过内容详略体现（而非显式标记）：
 
-- **重点工作**（feat/perf 类型 + 多次迭代）：摘要更详细，保留更多子条目
-- **难点工作**（fix 类型 + 多次尝试修复）：保留完整的排查过程细节
-- **普通工作**：简洁摘要，精简细节
+- **重点工作**（改动规模大 + 多次迭代）：摘要更详细，保留 2-3 个子条目
+- **难点工作**（多次尝试修复）：保留排查过程细节
+- **普通工作**：简洁一句话，无子条目
 
-**示例**：
+**正确示例**（good.md 风格）：
 ```markdown
 project-frontend
-  - [新功能] 用户登录系统开发，支持多种登录方式
+  - 跟进用户登录系统开发
+    - 接口对接和联调
+    - 表单验证优化
+  - 认证流程问题排查修复
+    - 排查后定位 token 过期问题
+  - 构建工具升级
+```
+
+**错误示例**（禁止）：
+```markdown
+# 禁止：使用标签 + 子条目过多
+  - [新功能] 用户登录系统开发
     - 接口对接和联调
     - 表单验证优化
     - 记住登录状态功能
-  - [修复] 认证流程问题排查修复
-    - 定位 token 过期问题
-    - 优化重试机制
-  - [优化] 构建工具升级
+    - 第三方登录集成
+
+# 禁止：琐碎内容单独列出
+  - [优化] 代码清理
+  - [文档] 完善相关文档
 ```
 
 ### 过滤规则
 
+#### 强制过滤（不输出）
+
 以下提交不会单独列出：
-- 纯格式化/代码风格调整
-- 简单的 typo 修复
+- 代码清理、格式化、lint 修复
+- 文档完善（除非是新文档或重大更新）
+- 移除调试日志、console.log
+- 样式微调（除非是设计系统变更）
 - 依赖版本小幅更新
+- 简单的 typo 修复
 - Merge 提交
-- 重复性的相似提交
+
+#### 合并处理（归类为一条）
+
+- 同一功能的多个小改动 → 合并为一条功能描述
+- 多个相关修复 → 合并为"问题排查修复"
+- 重复性的相似提交 → 合并为一条
 
 详细格式规范见 [周报格式规范](references/WEEKLY_REPORT_FORMAT.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis0123/weekly-report",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Claude Code Skill - 自动读取 Git 提交记录生成周报，支持多仓库汇总和智能过滤",
   "scripts": {
     "postinstall": "node install-skill.js",

package/src/git_analyzer.py

@@ -10,34 +10,56 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional
 
 
-# 提交类型配置
+# 提交类型配置（无标签风格，直接描述工作内容）
 COMMIT_TYPE_CONFIG = {
-    "feat": {"label": "[新功能]", "priority": 1, "is_highlight": True, "is_challenge": False},
-    "fix": {"label": "[修复]", "priority": 2, "is_highlight": False, "is_challenge": True},
-    "refactor": {"label": "[优化]", "priority": 3, "is_highlight": False, "is_challenge": False},
-    "perf": {"label": "[性能]", "priority": 3, "is_highlight": True, "is_challenge": False},
-    "style": {"label": "[样式]", "priority": 6, "is_highlight": False, "is_challenge": False},
-    "docs": {"label": "[文档]", "priority": 5, "is_highlight": False, "is_challenge": False},
-    "test": {"label": "[测试]", "priority": 4, "is_highlight": False, "is_challenge": False},
-    "chore": {"label": "[杂项]", "priority": 6, "is_highlight": False, "is_challenge": False},
-    "build": {"label": "[构建]", "priority": 4, "is_highlight": False, "is_challenge": False},
-    "ci": {"label": "[CI]", "priority": 5, "is_highlight": False, "is_challenge": False},
-    "other": {"label": "", "priority": 7, "is_highlight": False, "is_challenge": False},
+    "feat": {"priority": 1, "is_highlight": True, "is_challenge": False},
+    "fix": {"priority": 2, "is_highlight": False, "is_challenge": True},
+    "refactor": {"priority": 3, "is_highlight": False, "is_challenge": False},
+    "perf": {"priority": 3, "is_highlight": True, "is_challenge": False},
+    "style": {"priority": 6, "is_highlight": False, "is_challenge": False},
+    "docs": {"priority": 5, "is_highlight": False, "is_challenge": False},
+    "test": {"priority": 4, "is_highlight": False, "is_challenge": False},
+    "chore": {"priority": 6, "is_highlight": False, "is_challenge": False},
+    "build": {"priority": 4, "is_highlight": False, "is_challenge": False},
+    "ci": {"priority": 5, "is_highlight": False, "is_challenge": False},
+    "other": {"priority": 7, "is_highlight": False, "is_challenge": False},
 }
 
 
-# 琐碎提交的关键词
+# 琐碎提交的关键词（强制过滤）
 TRIVIAL_PATTERNS = [
+    # typo 修复
     r"^fix\s*typo",
     r"^typo",
-    r"^update\s*(readme|changelog)",
+    # 格式化/lint
+    r"^format",
+    r"^lint",
+    r"^style:",
+    r"^chore:\s*format",
+    r"^chore:\s*lint",
+    # 代码清理
+    r"^chore:\s*clean",
+    r"^refactor:\s*clean",
+    r"remove\s*(unused|debug|console)",
+    r"删除.*日志",
+    r"移除.*console",
+    # 文档完善（非重大更新）
+    r"^docs:\s*(update|fix|tweak)",
+    r"^chore:\s*docs",
+    r"完善.*文档",
+    r"更新.*readme",
+    # Merge 提交
     r"^merge\s+branch",
     r"^merge\s+pull\s+request",
+    # WIP 提交
     r"^wip$",
     r"^wip:",
-    r"^format",
-    r"^lint",
-    r"^style:",
+    # 样式微调
+    r"^style:\s*(tweak|adjust|fix)",
+    r"样式.*微调",
+    # 依赖更新（小幅）
+    r"^chore\(deps\):",
+    r"bump.*version",
 ]
 
 
@@ -173,7 +195,6 @@ def get_commits(
                     "is_trivial": parsed["is_trivial"],
                     "is_highlight": parsed["is_highlight"],
                     "is_challenge": parsed["is_challenge"],
-                    "label": parsed["label"],
                     "priority": parsed["priority"],
                     "project": get_repo_name(repo_path),
                 })
@@ -219,7 +240,6 @@ def parse_commit_message(message: str) -> Dict[str, Any]:
         - is_trivial: 是否为琐碎提交
         - is_highlight: 是否为重点（feat/perf 类型）
         - is_challenge: 是否为难点（fix 类型）
-        - label: 类型标签（如 [新功能]）
         - priority: 优先级（用于排序）
     """
     result = {
@@ -229,7 +249,6 @@ def parse_commit_message(message: str) -> Dict[str, Any]:
         "is_trivial": False,
         "is_highlight": False,
         "is_challenge": False,
-        "label": "",
         "priority": 7,
     }
 
@@ -257,7 +276,6 @@ def parse_commit_message(message: str) -> Dict[str, Any]:
     type_config = COMMIT_TYPE_CONFIG.get(commit_type, COMMIT_TYPE_CONFIG["other"])
     result["is_highlight"] = type_config["is_highlight"]
     result["is_challenge"] = type_config["is_challenge"]
-    result["label"] = type_config["label"]
     result["priority"] = type_config["priority"]
 
     return result

package/src/report_generator.py

@@ -6,7 +6,7 @@
 import re
 from typing import Any, Dict, List, Optional
 
-from src.git_analyzer import group_commits_by_project, COMMIT_TYPE_CONFIG
+from src.git_analyzer import group_commits_by_project
 
 
 def generate_report(
@@ -219,10 +219,11 @@ def format_project_section(
 ) -> str:
     """格式化项目部分
 
-    重点/难点通过以下方式体现（而非显式标记）：
-    - 重点工作：摘要字数更长（max_length=40），保留更多细节
-    - 难点工作：保留更多子条目细节
-    - 普通工作：简洁摘要（max_length=25）
+    采用无标签风格，直接描述工作内容。
+    重点/难点通过以下方式体现：
+    - 重点工作：摘要字数更长（max_length=40），保留 2-3 个子条目
+    - 难点工作：保留排查过程细节
+    - 普通工作：简洁摘要（max_length=25），无子条目
 
     Args:
         project: 项目名称
@@ -234,9 +235,6 @@ def format_project_section(
     lines = [project]
 
     for commit in commits:
-        # 获取类型标签
-        label = commit.get("label", "")
-
         # 分析重点/难点
         significance = analyze_work_significance(commit)
 
@@ -251,22 +249,19 @@ def format_project_section(
             # 普通工作：简洁摘要
             max_len = 25
 
-        # 生成摘要（含类型标签）
-        summary = summarize_commit(commit["message"], max_length=max_len, label=label)
+        # 生成摘要（无标签）
+        summary = summarize_commit(commit["message"], max_length=max_len)
 
         lines.append(f"  - {summary}")
 
         # 添加子条目细节
-        # 重点/难点保留更多细节，普通工作限制细节数量
+        # 重点/难点保留细节，普通工作不展开
         details = commit.get("details") or []
         if significance["is_highlight"] or significance["is_challenge"]:
-            # 重点/难点：保留所有细节（最多5条）
-            for detail in details[:5]:
-                lines.append(f"    - {detail}")
-        else:
-            # 普通工作：最多保留2条细节
-            for detail in details[:2]:
+            # 重点/难点：保留 2-3 条细节
+            for detail in details[:3]:
                 lines.append(f"    - {detail}")
+        # 普通工作：不展开子条目
 
     return "\n".join(lines)
 
@@ -291,9 +286,8 @@ def format_other_section(supplements: List[str]) -> str:
 def summarize_commit(
     message: str,
     max_length: int = 30,
-    label: str = "",
 ) -> str:
-    """生成提交摘要（智能截断）
+    """生成提交摘要（智能截断，无标签风格）
 
     在自然断点处截断，避免割裂语义：
     - 优先在标点符号处截断
@@ -302,11 +296,10 @@ def summarize_commit(
 
     Args:
         message: 提交信息
-        max_length: 最大长度（不含标签）
-        label: 类型标签（如 [新功能]）
+        max_length: 最大长度
 
     Returns:
-        带标签的摘要文本
+        摘要文本（无标签）
     """
     cleaned = clean_commit_message(message)
 
@@ -339,10 +332,6 @@ def summarize_commit(
 
         cleaned = truncated
 
-    # 添加类型标签
-    if label:
-        return f"{label} {cleaned.strip()}"
-
     return cleaned.strip()