67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
# 日期跟踪实施摘要
|
|
|
|
本文档解释了在 `apps/` 和 `tools/` 重构之后，`date_added` 支持如何融入当前仓库结构。
|
|
|
|
## 现有功能
|
|
|
|
### 前置元数据支持
|
|
|
|
新技能可以在 `SKILL.md` 前置元数据中包含 `date_added` 字段:
|
|
|
|
```yaml
|
|
---
|
|
name: skill-name
|
|
description: "Description"
|
|
date_added: "2026-03-06"
|
|
---
|
|
```
|
|
|
|
### 验证器支持
|
|
|
|
活跃的验证器理解 `date_added`:
|
|
|
|
- `tools/scripts/validate_skills.py` 检查 `YYYY-MM-DD` 格式
|
|
- 支持的 JS 验证/测试辅助工具在相关的地方知道该字段
|
|
|
|
### 索引和 Web 应用程序支持
|
|
|
|
- `tools/scripts/generate_index.py` 将 `date_added` 导出到 `skills_index.json`
|
|
- `npm run app:setup` 将生成的索引复制到 `apps/web-app/public/skills.json`
|
|
- Web 应用程序可以在 UI 显示它的任何地方渲染该字段
|
|
|
|
### 维护脚本
|
|
|
|
- `tools/scripts/manage_skill_dates.py` 管理技能日期
|
|
- `tools/scripts/generate_skills_report.py` 从当前技能元数据生成 JSON 报告
|
|
|
|
## 规范文档
|
|
|
|
日期跟踪的规范文档现在位于:
|
|
|
|
- [`skills-date-tracking.md`](skills-date-tracking.md)
|
|
- [`../contributors/skill-template.md`](../contributors/skill-template.md)
|
|
- [`../contributors/skill-anatomy.md`](../contributors/skill-anatomy.md)
|
|
|
|
使用这些文件作为真实来源，而不是旧的根级文档名称。
|
|
|
|
## 常用命令
|
|
|
|
```bash
|
|
# 查看当前日期覆盖范围
|
|
python tools/scripts/manage_skill_dates.py list
|
|
|
|
# 添加缺失的日期
|
|
python tools/scripts/manage_skill_dates.py add-missing
|
|
|
|
# 更新一个技能
|
|
python tools/scripts/manage_skill_dates.py update skill-name 2026-03-06
|
|
|
|
# 生成报告
|
|
python tools/scripts/generate_skills_report.py --output reports/skills_report.json
|
|
```
|
|
|
|
## 注意事项
|
|
|
|
- 随着新的社区技能添加，仓库范围的覆盖范围可能会随时间变化，因此本文档避免硬编码计数
|
|
- `date_added` 是有用的元数据，但操作贡献者门槛仍然是 `npm run validate`；严格验证是遗留清理的单独加固目标
|