mzaxdandClaude
ffce190ac3
新增文件： - .claude/agents/content-explorer-agent.md：批量探索项目内容 - .claude/agents/api-submitter-agent.md：处理 API 提交和状态更新 架构变更： - 探索逻辑和提交逻辑分离到独立的 agent 上下文 - 主上下文只保留调度逻辑和统计信息 - 支持可配置批次大小（--batch=N 参数） - 数据字段格式统一（links、tags、explorationData） 解决上下文堆积问题，主上下文不再随任务数线性增长 Co-Authored-By: Claude <noreply@anthropic.com>
97 lines
2.5 KiB
Markdown
97 lines
2.5 KiB
Markdown
# 项目内容标准模板
|
|
|
|
此文档定义了项目探索时需要收集的内容结构和质量标准。
|
|
|
|
## 必需内容
|
|
|
|
### 1. 基本信息
|
|
- **中文名称**：项目的中文名称（如果原项目是英文，需要翻译）
|
|
- **英文名称**：原始项目名称（保持原文）
|
|
- **中文描述**：1-2句话概括项目功能（10-500字）
|
|
- **英文描述**：项目功能的英文描述
|
|
|
|
### 2. 详细内容（Markdown格式）
|
|
- **项目简介**：背景、目的、解决的问题
|
|
- **核心功能**：主要功能列表或说明
|
|
- **技术栈**：使用的技术、框架、工具
|
|
- **使用场景**：适用场景和用例
|
|
- **特点亮点**：与同类项目的差异化特点
|
|
|
|
### 3. 标签（1-10个）
|
|
- 技术标签：如 `NLP`, `Computer Vision`, `React`
|
|
- 应用标签：如 `聊天机器人`, `数据分析`
|
|
- 状态标签：如 `活跃维护`, `实验性项目`
|
|
|
|
### 4. 外部链接（至少1个）
|
|
- **GitHub链接**：如果项目在GitHub上
|
|
- **官网链接**：项目官方网站或文档
|
|
- **Demo链接**：在线演示地址
|
|
- **论文链接**：如果有相关论文
|
|
|
|
## 内容质量标准
|
|
|
|
### 描述质量
|
|
- ✅ 清晰说明项目是做什么的
|
|
- ✅ 突出项目的核心价值
|
|
- ✅ 避免营销术语，保持客观
|
|
- ❌ 避免直接复制README第一句
|
|
|
|
### 内容完整性
|
|
- ✅ 从README中提取关键信息
|
|
- ✅ 重新组织内容，使其更易读
|
|
- ✅ 添加必要的上下文说明
|
|
- ❌ 不要机械翻译，要符合中文表达习惯
|
|
|
|
### 链接有效性
|
|
- ✅ 所有链接都必须可访问
|
|
- ✅ 优先使用GitHub仓库链接
|
|
- ✅ 包含文档或Demo链接
|
|
|
|
## 动态数据处理
|
|
|
|
以下数据**不应**写入内容中（使用GitHub Badge显示）：
|
|
- Star/Fork数量
|
|
- 最近更新时间
|
|
- 贡献者数量
|
|
- Issue/PR数量
|
|
|
|
## 内容来源优先级
|
|
|
|
1. **README.md** - 主要信息来源
|
|
2. **官网/文档** - 补充说明
|
|
3. **代码结构** - 理解技术实现
|
|
4. **Issues/Discussions** - 了解用户反馈
|
|
|
|
## 示例格式
|
|
|
|
### 详细版（适用于复杂项目）
|
|
```markdown
|
|
## 背景
|
|
[项目背景和动机]
|
|
|
|
## 核心功能
|
|
### 功能1
|
|
[详细说明]
|
|
|
|
### 功能2
|
|
[详细说明]
|
|
|
|
## 技术架构
|
|
[技术选型和架构说明]
|
|
|
|
## 使用场景
|
|
- 场景1
|
|
- 场景2
|
|
|
|
## 项目特点
|
|
- 特点1
|
|
- 特点2
|
|
```
|
|
|
|
## 注意事项
|
|
|
|
1. **保持客观**：避免过度夸大或营销语言
|
|
2. **用户视角**：从用户角度描述价值，而非技术实现细节
|
|
3. **持续更新**：此标准会根据需要调整
|
|
4. **灵活应用**：根据项目实际情况动态调整内容结构
|