每日日志

1. 📌 Skill基础信息

• Skill名称: at-daily-log
• 简称: 每日工作日志
• 来源: 社区第三方 (kairyou)
• 运行宿主: 只能在使用 agent-tools 框架的 Agent 工具中运行（如 Claude-Code CLI 等）
• 核心定位: 自动汇总指定日期范围内的 Git 提交记录，生成结构化的每日工作日报，适合开发者进行日常工作追踪和总结。

2. 🧩 内部核心组成

该 Skill 主要通过解析 Git 仓库的提交记录，智能聚合相关变更，生成简明的工作日志。

核心能力组件:

• Git 提交分析引擎: 扫描多个 Git 仓库，按作者和日期筛选非合并提交
• 工作项智能聚合: 根据提交主题和变更路径，将相关提交聚合成完整的工作项
• 多项目支持: 支持同时分析多个配置的工作项目
• Markdown 输出生成: 生成格式统一的 Markdown 格式日报

配置依赖:

• ~/.agent-tools/config.jsonc 配置文件
• 可选的 workProjects 项目路径配置
• 可选的日志输出路径配置

3. 🛠 安装与启用方式

安装命令:

skills install --user kairyou/agent-tools

前置要求:

1. 已安装 agent-tools 框架
2. 本地存在 Git 仓库
3. (可选) 配置 ~/.agent-tools/config.jsonc 文件定义工作项目

启用方式:

在支持的 Agent 工具中直接调用技能命令：

/at-daily-log [<日期>|<日期范围>]

4. 📋 标准工作流

1. 输入解析: 用户输入日期或日期范围（支持自然语言如"昨天"、"上周"）
2. 项目范围确定:

- 默认包含当前 Git 仓库和配置的项目

- 支持通过对话指定特定项目

1. 数据收集:

- 获取每个仓库的作者信息

- 刷新上游分支（非强制）

- 收集指定日期范围内的提交记录

1. 工作项构建:

- 排除合并提交

- 根据提交主题和变更路径聚合相关提交

- 忽略格式化、版本号变更等非实质性变更

1. 输出生成:

- 生成 Markdown 格式的日报

- 按项目分组显示工作成果

1. 记录选项:

- 生成草稿（预览）

- 记录到文件（自动处理文件标记和更新）

5. ⚠️ 关键限制、缺陷、注意事项

平台限制:

• 依赖本地 Git 环境，无法直接处理远程仓库 URL
• 需要正确的 Git 用户配置（user.name）

Token 消耗: 中等，取决于扫描的仓库数量和提交历史量

适合项目类型:

• 本地开发的 Git 项目
• 中小型代码库
• 个人或小团队项目

不适合场景:

• 大型分布式团队项目
• 无 Git 版本控制的项目
• 需要精确工时统计的场景

已知坑点:

• 未配置上游分支的分支可能无法正确识别提交
• 作者名称必须完全匹配（大小写敏感）
• 无法识别未提交的更改

生产环境适用性: 适合个人和小团队使用，但需要稳定的 Git 配置和环境

6. ✅ 适用场景 & ❌ 不适合场景

✅ 适用场景:

• 个人开发者日常工作总结
• 小团队项目进度跟踪
• 需要自动化生成工作日报的场景
• 多项目并行开发的情况

❌ 不适合场景:

• 需要精确工时统计和绩效评估
• 大型企业级项目管理
• 非 Git 版本控制的项目
• 需要实时协作和审批流程的场景
• 对安全性和权限控制要求极高的环境

skills install --user kairyou/agent-tools