核心功能
Jira Work Log Skill 是一款面向开发者和项目管理人员的工时记录工具,通过 OpenClaw 框架与自托管 Jira 实例深度集成。该工具提供完整的命令行交互体验,支持连接测试、工单列表查询、交互式工时录入、每日日志模板生成及 Apple 提醒系统集成。
显著优点
1. 零遗忘设计:通过 /jira reminder 设置 Apple 提醒,结合 /jira today 每日模板,建立完整的工作记录习惯闭环
2. 极简交互体验:/jira log 支持交互式工单选择,无需记忆复杂命令;支持自然时间格式(如 "1h 30m")
3. 安全优先架构:强制使用 API Token 而非密码,配置文件隔离设计明确提示版本控制排除
4. 开发者友好:Python 3.7+ 轻量依赖,提供完整的故障排查指南和权限修复脚本
潜在局限
- 部署门槛:需自托管 Jira 实例(企业版),不适用 Atlassian Cloud 用户
- 网络依赖:配置示例显示需代理设置(
--proxy http://localhost:2080),暗示可能存在网络环境限制 - 生态封闭:Apple Reminders 集成仅限 macOS/iOS 用户,跨平台支持不足
- 配置复杂度:涉及 API Token 申请、JSON 手动配置、Python 环境管理等多步骤设置
适合人群
- 使用自托管 Jira(Data Center/Server 版)的软件开发团队
- 需要严格工时追踪的敏捷开发成员
- 习惯命令行工作流的工程师和技术管理者
- 对数据主权有要求、倾向本地部署的企业用户
常规风险
- 凭证泄露风险:
jira_config.json包含明文 API Token,需严格遵循.gitignore排除 - 令牌过期:Atlassian API Token 无固定有效期但可被撤销,需建立轮换机制
- 时区配置错误:默认 Tehran 时区需根据实际地理位置调整,否则影响工时统计准确性
- 代理配置残留:安装命令中的硬编码代理地址若未清理可能导致生产环境异常