playbook/antigravity-awesome-skills/docs_zh-CN/maintainers/date-tracking-implementation.md

日期跟踪实施摘要

本文档解释了在 apps/ 和 tools/ 重构之后，date_added 支持如何融入当前仓库结构。

现有功能

前置元数据支持

新技能可以在 SKILL.md 前置元数据中包含 date_added 字段:

---
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
• ../contributors/skill-template.md
• ../contributors/skill-anatomy.md

使用这些文件作为真实来源，而不是旧的根级文档名称。

常用命令

# 查看当前日期覆盖范围
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；严格验证是遗留清理的单独加固目标