mission-claw

Mission Claw 是一款专为 AI Agent 设计的活动记录与效能追踪工具，通过本地化的 CLI 客户端与 Web 仪表板，帮助开发者系统化记录任务执行过程、监控 Token 消耗并追踪项目整体进度。

核心用法
该 Skill 本质上是一份使用指南，指导用户通过 mclaw CLI 工具将 Agent 完成的重要任务（如功能开发、Bug 修复、配置变更等）记录到本地 Mission Claw 服务中。使用时需先全局安装 mclaw 工具（npm install -g mission-claw），并确保本地服务已启动（默认端口 3100/3101）。记录内容支持任务描述、执行状态（completed/in_progress/failed）、耗时、输入/输出 Token 数等元数据，可通过 session_status 工具获取当前会话的 Token 使用情况。除命令行外，也支持直接通过 HTTP API 向 localhost:3100/api/activity 发送 JSON 数据。

显著优点
首先，纯文档型设计确保了极高的安全性，Skill 本身不包含任何可执行代码，仅提供标准化的操作指引，彻底杜绝了代码注入或恶意执行风险。其次，本地化架构让数据完全处于用户控制之下，所有日志数据仅存储在本地服务中，无需上传至第三方云端，有效保护了敏感的项目信息与商业数据。再者，专门的 Token 追踪功能填补了 Agent 开发中的监控空白，能够精确记录每次任务的资源消耗，为成本控制和效能优化提供数据支撑。此外，轻量级的 CLI 设计与 Web 仪表板相结合，既满足了自动化脚本集成的需求，又提供了直观的数据可视化界面。

潜在缺点与局限性
作为 T3 级别的社区开源项目（个人开发者维护），其长期维护稳定性与功能迭代速度存在不确定性，不适合对 SLA 要求极高的企业级生产环境。功能层面相对单一，仅专注于活动记录与基础统计，缺乏复杂的数据分析、告警通知或团队协作的高级功能。使用门槛方面，需要用户手动安装 Node.js 依赖并维护本地服务进程，对于非技术用户或容器化部署环境不够友好。另外，数据存储在本地意味着缺乏跨设备的同步能力，也无法实现团队级的集中化日志管理。

适合的目标群体
主要面向独立开发者、小型技术团队以及 AI Agent 研究者，特别是那些需要详细追踪 LLM Token 消耗、优化 API 调用成本的场景。适合用于个人项目管理、Agent 行为审计、开发过程复盘等用途。对于注重数据隐私、不希望将开发日志上传至云端托管服务的用户尤为合适。

使用风险
性能与稳定性方面，依赖本地 Node.js 服务的运行状态，若服务未启动或端口冲突将导致记录失败。依赖管理上，mclaw CLI 通过 npm 全局安装，版本更新需要手动维护，且作为个人开源项目，存在供应链安全风险（尽管 Skill 本身安全）。数据持久性风险在于，若本地服务未配置数据备份，系统故障可能导致历史日志丢失。此外，该工具仅提供记录功能，不具备数据加密或访问控制机制，在多用户共享的开发环境中需注意权限管理。