Show HN: Event catalog from code in 2 commands

说明与用途

**项目简介（2‑3 句）**
Show HN: Event catalog from code in 2 commands 是一个通过两条命令即可从代码库中生成事件目录的工具，适合在 README 与实际工作流相匹配的场景下快速查看项目关键事件。

**价值**

• **快速可视化**：只需两条命令即可把代码提交、发布、issue 等事件整理成结构化目录，帮助团队快速了解项目历史与进度。
• **低学习成本**：无需复杂配置或额外依赖，适合原型开发、内部工具或临时审计。

**典型接入方式**

1. **克隆或在现有仓库中安装**：git clone https://github.com/…/event-catalog.git && cd event-catalog。
2. **运行两条命令**：

   ./generate-event-catalog.sh   # 解析 Git 日志、GitHub API 等
   ./show-catalog.sh             # 以 Markdown/HTML 输出目录

根据需要可在 CI/CD 脚本或本地开发环境中调用，输出文件可直接嵌入 README 或文档站点。

**生产可用性**

• **成熟度**：目前标记为 *Medium*，适合原型、内部流程或非关键业务使用。
• **风险与注意事项**：元数据提取信号稀疏，需在接入前手动检查许可证、维护状态、文档完整性以及 issue/PR 活跃度。
• **上线建议**：在内部测试环境验证生成结果的准确性后，再决定是否在生产环境使用；若用于关键业务，建议配合额外的监控和审计脚本。

实际用途

Show HN: Event catalog from code in 2 commands may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.