project-report

Generate timestamped Markdown daily reports from multiple data sources.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/weiran-tech/agent-skills --skill project-report-weiran-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-report
Source: https://github.com/weiran-tech/agent-skills/tree/main/skills/project-report
Command: npx skills add https://github.com/weiran-tech/agent-skills --skill project-report-weiran-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

独立为单个项目生成日报报告的需求。它通过聚合来自多个源的数据(云效的 bugs、技术需求、Sentry 异常、SLS 统计等),为每个项目输出一个独立的 Markdown 报告,并按时间戳命名输出文件,确保按项目、时间和来源分离管理。

Core Features & Use Cases

  • 独立性:为每个项目生成独立的日报报告,不再合并多个项目的统计。
  • 配置化:每个项目有独立的 YAML 配置文件 config/{项目名}.yaml,可自定义 Sentry、SLS、阈值等参数。
  • 模块自动识别:未指定模块时自动启用所有非空模块(只要 Sentry/SLS 配置存在且非空就执行)。
  • 指定模块输出:通过 types 参数仅输出指定且非空的模块。
  • 输出格式与命名:按 {project}-{yyyy-mm-dd-hh-mm}.md 格式输出,UTF-8 编码,输出目录 report/temp/{project}/qa/。
  • 灵活数据源:支持 bugs、req、sentry、sls 四类数据源的组合与排错处理。

Quick Start

Run the project-report tool with your project name to generate a timestamped report.

Frequently Asked Questions about project-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate independent daily reports for individual projects from multiple data sources?

Generate independent daily reports by aggregating bugs, tech requirements, Sentry exceptions, and SLS statistics into a timestamped Markdown file per project. Each project uses a dedicated YAML configuration file for customized data thresholds.

Can I customize Sentry and SLS thresholds for each project report separately?

Yes, configurable SLS thresholds and Sentry parameters are supported per project. You define these custom settings in the config/{project}.yaml file, ensuring each daily report reflects project-specific monitoring rules.

How do I select specific data modules like Sentry or SLS when generating a project report?

Select specific data modules by passing the types parameter to output only designated non-empty modules. If left unspecified, the system automatically enables all available modules with valid Sentry or SLS configurations.

What format and encoding are used for the output project reports?

Project reports are output as UTF-8 encoded Markdown files. They are named using a {project}-{yyyy-mm-dd-hh-mm}.md timestamp format and saved directly to the report/temp/{project}/qa/ directory.

Does project-report work with YAML for configuring analytics data sources?

Yes, it uses pyyaml to parse per-project YAML configurations for analytics data sources. This setup allows flexible aggregation of bugs, tech requirements, Sentry, and SLS data into isolated Markdown outputs.

Why does my project report skip certain data sources during generation?

Data sources are skipped if their module configurations are empty or invalid. The report generator only executes modules where Sentry or SLS configurations exist and are non-empty, or when explicitly specified via the types parameter.