Files
agent-park/PROJECT_CONTENT_STANDARD.md
T
mzaxdandClaude ffce190ac3 refactor: 重构 discover-projects 命令采用双 Agent 协作架构实现上下文隔离
新增文件:
- .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>
2026-01-17 16:33:41 +08:00

2.5 KiB

项目内容标准模板

此文档定义了项目探索时需要收集的内容结构和质量标准。

必需内容

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 - 了解用户反馈

示例格式

详细版(适用于复杂项目)

## 背景
[项目背景和动机]

## 核心功能
### 功能1
[详细说明]

### 功能2
[详细说明]

## 技术架构
[技术选型和架构说明]

## 使用场景
- 场景1
- 场景2

## 项目特点
- 特点1
- 特点2

注意事项

  1. 保持客观:避免过度夸大或营销语言
  2. 用户视角:从用户角度描述价值,而非技术实现细节
  3. 持续更新:此标准会根据需要调整
  4. 灵活应用:根据项目实际情况动态调整内容结构