feat(命令): 新增时间轴数据维护 Skill 命令
This commit is contained in:
120
.claude/commands/timeline.md
Normal file
120
.claude/commands/timeline.md
Normal file
@@ -0,0 +1,120 @@
|
||||
---
|
||||
name: timeline
|
||||
description: 维护软考高项时间轴数据
|
||||
---
|
||||
|
||||
# 时间轴数据维护
|
||||
|
||||
维护 `src/data/timeline-items.json` 的时间轴数据。
|
||||
|
||||
## 核心数据结构
|
||||
|
||||
```typescript
|
||||
interface TimelineItem {
|
||||
id: string; // TL001, TL002...
|
||||
timeText: string; // "2035年", "2021年3月"
|
||||
sortKey: string; // "20350000", "20210300"
|
||||
timePrecision: 'year' | 'month' | 'day';
|
||||
theme: string; // 主题/章节
|
||||
excerpt: string; // 原文摘录(必须保真)
|
||||
sourceAnchor?: string; // 来源锚点
|
||||
sourceAnchorType?: 'meeting' | 'document' | 'organization' | 'person' | 'policy' | 'report' | 'other';
|
||||
sourcePosition?: string; // 教材定位
|
||||
}
|
||||
```
|
||||
|
||||
## sortKey 生成规则
|
||||
|
||||
- 年: `2035年` → `20350000`
|
||||
- 年月: `2021年3月` → `20210300`
|
||||
- 年月日: `2021年3月15日` → `20210315`
|
||||
|
||||
## 时间类型判断
|
||||
|
||||
**提出时间 vs 目标时间:**
|
||||
- 提出时间: 政策/文件发布时间
|
||||
- 目标时间: "到XX年实现"的目标年份
|
||||
|
||||
示例:
|
||||
```
|
||||
"《十四五规划和2035年远景目标纲要》提出..."
|
||||
→ 挂载到 2021年(提出时间)
|
||||
|
||||
"到2035年基本实现现代化"
|
||||
→ 挂载到 2035年(目标时间)
|
||||
```
|
||||
|
||||
## 原文摘录规范
|
||||
|
||||
**必须遵守:**
|
||||
- 保留原文句式
|
||||
- 只修正明显 OCR 错字(如"深人"→"深入")
|
||||
- 不改写、不总结、不替换
|
||||
- 不确定的内容必须标记或询问
|
||||
|
||||
## 操作流程
|
||||
|
||||
1. 读取 `src/data/timeline-items.json`
|
||||
2. 校验数据(ID唯一性、sortKey格式、原文校对)
|
||||
3. 执行修改
|
||||
4. 更新 `src/data/changelog.json`
|
||||
5. 询问用户是否提交
|
||||
6. 运行 `npm run build` 检查
|
||||
7. 提交推送
|
||||
|
||||
## 注意事项
|
||||
|
||||
- `excerpt` 必须是原文,只修正OCR错字
|
||||
- 同类主题统一命名
|
||||
- 提交格式: `feat(时间轴): 添加XX年XX主题节点`
|
||||
|
||||
## 常见错误
|
||||
|
||||
### ❌ 错误示例
|
||||
|
||||
**时间类型混淆:**
|
||||
```json
|
||||
// 错误:将远景目标年份当作提出时间
|
||||
{ "timeText": "2035年", "excerpt": "《...2035年远景目标纲要》提出..." }
|
||||
```
|
||||
|
||||
**sortKey 格式错误:**
|
||||
```json
|
||||
// 错误:月份未补零
|
||||
{ "timeText": "2021年3月", "sortKey": "202103" }
|
||||
```
|
||||
|
||||
**原文改写:**
|
||||
```json
|
||||
// 错误:用摘要替代原文
|
||||
{ "excerpt": "提出了数字化转型目标" }
|
||||
```
|
||||
|
||||
### ✅ 正确示例
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "TL004",
|
||||
"timeText": "2021年",
|
||||
"sortKey": "20210000",
|
||||
"timePrecision": "year",
|
||||
"theme": "产业数字化转型",
|
||||
"excerpt": "《中华人民共和国国民经济和社会发展第十四个五年规划和2035年远景目标纲要》明确提出了推进产业数字化转型,实施"上云用数赋智"行动,推动数据赋能全产业链协同转型。",
|
||||
"sourceAnchor": "《中华人民共和国国民经济和社会发展第十四个五年规划和2035年远景目标纲要》",
|
||||
"sourceAnchorType": "document"
|
||||
}
|
||||
```
|
||||
|
||||
## 快速检查清单
|
||||
|
||||
添加新节点前必须确认:
|
||||
|
||||
- [ ] ID 按序递增且唯一
|
||||
- [ ] timeText 与 sortKey 匹配
|
||||
- [ ] timePrecision 正确
|
||||
- [ ] excerpt 为校对后的原文
|
||||
- [ ] theme 命名统一
|
||||
- [ ] sourceAnchor 准确
|
||||
- [ ] 已更新 changelog
|
||||
- [ ] 构建通过
|
||||
- [ ] 用户确认提交
|
||||
Reference in New Issue
Block a user