| name | engineering-logger |
| description | 工程开发过程记录。任务完成后把工作摘要追加到 logs/daily/YYYY-MM-DD.md,可选提交到 Git。触发:用户完成一项具体任务(写代码/文档/执行 SOP/做分析)、用户明确要求记录日志、用户输入 "记录日志" 或 /log。 |
| metadata | {"audience":"developers","workflow":"software-development","category":"productivity"} |
engineering-logger
职责
把当天完成的工作事项追加到 logs/daily/YYYY-MM-DD.md,便于后续回溯和周报汇总。
实现绑定(重要)
本 skill 调用 tools/logger.py 的 Python 实现作为主路径。tools/git-logger.sh 是 Python 实现的 git 提交辅助脚本(可在 CI 或交互式命令行中独立使用,本 skill 不直接调用)。
| 调用路径 | 实现 | 责任 |
|---|
| 主路径(本 skill) | tools/logger.py | 读/写/追加 daily 日志;调用 git 子进程或由 Claude 直接 Bash git 命令 |
| 辅助路径 | tools/git-logger.sh | 命令行独立使用(非 skill 场景),带彩色输出 |
如需改变实现,以本 skill 为单一真相源。
触发条件
满足以下任一:
- 用户刚完成一项具体任务(代码提交、SOP 编写、案例沉淀、架构变更)
- 用户明确要求"记录日志"、"更新日志"、"写个工作总结"
- 用户输入
/log 或 /git-log
执行步骤
1. 定位日志文件
- 路径:
logs/daily/YYYY-MM-DD.md(YYYY-MM-DD 为今天日期)
- 若不存在:从
logs/templates/daily-template.md 创建
2. 追加「今日活动」表
一条任务一行,格式:
| HH:MM | 模块 | 活动摘要 | 状态 |
字段说明:
- HH:MM:24h 格式当前时间
- 模块:任务所属模块(Desense 分析 / SOP 系统 / 工具开发 / 知识库 / 架构 / 案例库 / Git 管理)
- 活动摘要:一句话描述完成的工作,附带关键结果(改善 N dB / 新增 N 文件 / 修复 N bug 等)
- 状态:✅ 完成
3. 追加「详细记录」(复杂任务)
复杂任务(如 SOP 编写、架构变更、问题排查闭环)在## 详细记录章节追加:
### [HH:MM] 活动标题
- **模块**:模块名称
- **任务**:具体做了什么
- **关键产出**:创建/修改的文件(带路径)
- **备注**:需要注意的事项(可选)
4. Git 提交(视分支决策)
分支策略:
| 分支 | 策略 |
|---|
main / master | 允许提交,但要求提交消息明确 |
echo-dev | 允许自动提交(历史 Echo 习惯) |
| 其他分支 | 建议,让用户确认 |
提交消息格式:
docs: 更新日志 - YYYY-MM-DD <简要概括>
不再对主分支设硬性禁止(当前仓库主分支就是 main),由用户最终决定。
追加规则
- 只追加,不覆盖:已有内容不修改,只在末尾追加
- 一条任务一条记录:不合并
- 简洁摘要:每条 ≤ 2 行
- 文件路径要带:涉及文件时写出路径(相对仓库根)
示例
追加表格
| 14:30 | SOP 系统 | 创建 W24-02 v2.1,新增步骤 2.5 OIS 排查 | ✅ 完成 |
| 15:00 | 工具开发 | harmonic_calc.py 增加批量计算 | ✅ 完成 |
追加详细
### [14:30] AS2 后摄 Wide WiFi 2.4G Desense 排查
- **模块**:Desense 分析 / SOP 系统
- **任务**:排查 AS2 RC 场景 WiFi 2.4G 全频段 4~7 dB,定位到 OIS Driver IC
- **关键产出**:
- `knowledge/sops/W24/W24-02.md` v2.0 → v2.1(新增步骤 2.5)
- `knowledge/cases/AS2-RC-WiFi24-OIS.md` 新建案例
- **经验教训**:子功能排查应前置于时钟/电源排查(零成本)
与其他模块的关系
| 模块 | 关系 |
|---|
tools/logger.py | 主实现,本 skill 的代码入口 |
tools/git-logger.sh | 独立 CLI,不由 skill 调用 |
/diagnose 命令 | 诊断完成后可触发本 skill 记录 |
/formal 命令 | 生成正式报告后可触发本 skill 记录 |
设计备注
- v1(Echo 版)硬编码"仅 echo-dev 分支自动提交"。Claude Code 版(2026-04-27)放宽:允许 main/主分支提交,但由用户最终确认
- v1 未明确实现绑定(Python 还是 bash)。Claude Code 版明确:主路径用 Python,bash 工具仅供交互式独立使用
版本:v2.0(2026-04-27 架构审计后)