Add P03_errlens_web subproject
This commit is contained in:
@@ -0,0 +1,214 @@
|
|||||||
|
---
|
||||||
|
name: "add-subproject"
|
||||||
|
description: "Adds a new subproject to the existing '1 Human + 2 AI' collaboration framework. Invoke when you need to add a new subproject like web admin, data entry program, etc."
|
||||||
|
---
|
||||||
|
|
||||||
|
# 添加子项目 Skill
|
||||||
|
|
||||||
|
## 功能
|
||||||
|
|
||||||
|
在现有的"1人+2AI"协作框架中动态添加新的子项目,自动创建:
|
||||||
|
- 项目目录结构(src/、tests/、docs/)
|
||||||
|
- 环境配置文件(ENVIRONMENT.md)
|
||||||
|
- README.md 占位文件
|
||||||
|
- 示例任务目录
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 参数说明
|
||||||
|
|
||||||
|
| 参数 | 类型 | 必填 | 说明 |
|
||||||
|
|------|------|------|------|
|
||||||
|
| project_name | string | 是 | 子项目名称,如 "web_admin"、"data_entry" |
|
||||||
|
| project_number | string | 否 | 项目编号,如 "P03",默认自动生成 |
|
||||||
|
|
||||||
|
### 调用方式
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 方式1:仅提供项目名称(自动分配编号)
|
||||||
|
# skill 会自动检测现有项目编号,分配下一个编号
|
||||||
|
add-subproject --project_name="web_admin"
|
||||||
|
|
||||||
|
# 方式2:指定项目编号
|
||||||
|
add-subproject --project_name="web_admin" --project_number="P03"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 创建的内容
|
||||||
|
|
||||||
|
### 目录结构
|
||||||
|
```
|
||||||
|
projects/
|
||||||
|
└── P03_web_admin/ # 新项目目录
|
||||||
|
├── src/ # Dev AI 工作区
|
||||||
|
│ └── README.md
|
||||||
|
├── tests/ # QA AI 工作区
|
||||||
|
│ └── README.md
|
||||||
|
├── docs/ # 项目文档
|
||||||
|
│ ├── 01_需求概要.md
|
||||||
|
│ ├── 02_架构设计.md
|
||||||
|
│ └── 03_接口定义.md
|
||||||
|
└── ENVIRONMENT.md # 环境配置
|
||||||
|
```
|
||||||
|
|
||||||
|
### 任务目录
|
||||||
|
```
|
||||||
|
review/
|
||||||
|
└── active/
|
||||||
|
└── P03-001/ # 新项目的第一个任务
|
||||||
|
├── task.md
|
||||||
|
├── acceptance.md
|
||||||
|
├── impact.md
|
||||||
|
└── feedback/
|
||||||
|
└── round1.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## 执行命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 获取下一个项目编号
|
||||||
|
get_next_project_number() {
|
||||||
|
ls -la projects/ | grep -E '^P[0-9]+_' | sort | tail -1 | sed 's/P\([0-9]*\)_.*$/\1/'
|
||||||
|
}
|
||||||
|
|
||||||
|
# 创建项目目录
|
||||||
|
PROJECT_NAME="web_admin"
|
||||||
|
NEXT_NUM=$(get_next_project_number)
|
||||||
|
PROJECT_NUM="P$(printf '%02d' $((NEXT_NUM + 1)))"
|
||||||
|
PROJECT_DIR="projects/${PROJECT_NUM}_${PROJECT_NAME}"
|
||||||
|
|
||||||
|
mkdir -p "${PROJECT_DIR}"/{src,tests,docs}
|
||||||
|
|
||||||
|
# 创建 ENVIRONMENT.md
|
||||||
|
cat > "${PROJECT_DIR}/ENVIRONMENT.md" << EOF
|
||||||
|
# ${PROJECT_NUM}_${PROJECT_NAME} - 环境准备
|
||||||
|
|
||||||
|
## 依赖
|
||||||
|
- Node.js >= 20.x
|
||||||
|
|
||||||
|
## 安装
|
||||||
|
npm install
|
||||||
|
|
||||||
|
## 运行
|
||||||
|
npm start
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# 创建文档
|
||||||
|
cat > "${PROJECT_DIR}/docs/01_需求概要.md" << EOF
|
||||||
|
# ${PROJECT_NUM}_${PROJECT_NAME} - 需求概要
|
||||||
|
|
||||||
|
## 项目概述
|
||||||
|
|
||||||
|
## 功能需求
|
||||||
|
|
||||||
|
## 非功能需求
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > "${PROJECT_DIR}/docs/02_架构设计.md" << EOF
|
||||||
|
# ${PROJECT_NUM}_${PROJECT_NAME} - 架构设计
|
||||||
|
|
||||||
|
## 技术选型
|
||||||
|
|
||||||
|
## 架构图
|
||||||
|
|
||||||
|
## 模块划分
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > "${PROJECT_DIR}/docs/03_接口定义.md" << EOF
|
||||||
|
# ${PROJECT_NUM}_${PROJECT_NAME} - 接口定义
|
||||||
|
|
||||||
|
## API 列表
|
||||||
|
|
||||||
|
## 数据结构
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# 创建 README.md
|
||||||
|
echo "# ${PROJECT_NAME}" > "${PROJECT_DIR}/src/README.md"
|
||||||
|
echo "# tests" > "${PROJECT_DIR}/tests/README.md"
|
||||||
|
|
||||||
|
# 创建示例任务
|
||||||
|
mkdir -p "review/active/${PROJECT_NUM}-001/feedback"
|
||||||
|
|
||||||
|
cat > "review/active/${PROJECT_NUM}-001/task.md" << EOF
|
||||||
|
# ${PROJECT_NUM}-001 - 项目初始化
|
||||||
|
|
||||||
|
## 任务信息
|
||||||
|
- 任务编号:${PROJECT_NUM}-001
|
||||||
|
- 项目:${PROJECT_NUM}_${PROJECT_NAME}
|
||||||
|
- 创建时间:$(date +%Y-%m-%d)
|
||||||
|
- 状态:TODO
|
||||||
|
|
||||||
|
## 任务描述
|
||||||
|
完成 ${PROJECT_NAME} 项目的初始化工作。
|
||||||
|
|
||||||
|
## 交付物
|
||||||
|
- 项目目录结构
|
||||||
|
- 基础配置文件
|
||||||
|
- README 文档
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > "review/active/${PROJECT_NUM}-001/acceptance.md" << EOF
|
||||||
|
# ${PROJECT_NUM}-001 - 验收标准
|
||||||
|
|
||||||
|
## 功能验收
|
||||||
|
- [ ] 项目目录结构完整
|
||||||
|
- [ ] ENVIRONMENT.md 已创建
|
||||||
|
- [ ] 文档目录已初始化
|
||||||
|
|
||||||
|
## 测试覆盖要求
|
||||||
|
- 无需测试(初始化任务)
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > "review/active/${PROJECT_NUM}-001/impact.md" << EOF
|
||||||
|
# ${PROJECT_NUM}-001 - 变更影响范围
|
||||||
|
|
||||||
|
## 修改的文件
|
||||||
|
| 文件路径 | 修改类型 | 影响等级 |
|
||||||
|
|---------|---------|---------|
|
||||||
|
| ${PROJECT_DIR}/ | 新增 | LOW |
|
||||||
|
|
||||||
|
## 需要回归测试的场景
|
||||||
|
- 无(新项目)
|
||||||
|
EOF
|
||||||
|
|
||||||
|
cat > "review/active/${PROJECT_NUM}-001/feedback/round1.md" << EOF
|
||||||
|
# ${PROJECT_NUM}-001 - 第一轮测试反馈
|
||||||
|
|
||||||
|
## 测试结果
|
||||||
|
- 通过:0
|
||||||
|
- 失败:0
|
||||||
|
|
||||||
|
## 反馈
|
||||||
|
待执行测试
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# 更新 README.md
|
||||||
|
echo "- [${PROJECT_NUM}_${PROJECT_NAME}](${PROJECT_DIR})" >> README.md
|
||||||
|
|
||||||
|
echo "✅ 子项目 ${PROJECT_NUM}_${PROJECT_NAME} 创建成功!"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 使用场景
|
||||||
|
|
||||||
|
**何时调用此 skill:**
|
||||||
|
- ✅ 添加新的 Web 管理程序
|
||||||
|
- ✅ 添加数据录入程序
|
||||||
|
- ✅ 添加任何新的子项目模块
|
||||||
|
- ✅ 扩展现有项目架构
|
||||||
|
|
||||||
|
**不适用场景:**
|
||||||
|
- ❌ 项目尚未初始化(需先调用 ai-collab-setup)
|
||||||
|
- ❌ 修改现有项目结构
|
||||||
|
|
||||||
|
## 后续步骤
|
||||||
|
|
||||||
|
skill 执行后:
|
||||||
|
1. 检查 `projects/${PROJECT_NUM}_${PROJECT_NAME}/` 目录结构
|
||||||
|
2. 修改 `ENVIRONMENT.md` 配置项目依赖
|
||||||
|
3. 更新 `docs/` 目录的文档内容
|
||||||
|
4. 开始在 `review/active/${PROJECT_NUM}-001/` 任务下工作
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Version**: 1.0
|
||||||
|
**Created**: 2026-05-22
|
||||||
|
**Based On**: ErrLens AI Programming Project
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
# P03_errlens_web - 环境准备
|
||||||
|
|
||||||
|
## 依赖
|
||||||
|
- Node.js >= 20.x
|
||||||
|
|
||||||
|
## 安装
|
||||||
|
npm install
|
||||||
|
|
||||||
|
## 运行
|
||||||
|
npm start
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
# P03_errlens_web - 需求概要
|
||||||
|
|
||||||
|
## 项目概述
|
||||||
|
|
||||||
|
## 功能需求
|
||||||
|
|
||||||
|
## 非功能需求
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
# P03_errlens_web - 架构设计
|
||||||
|
|
||||||
|
## 技术选型
|
||||||
|
|
||||||
|
## 架构图
|
||||||
|
|
||||||
|
## 模块划分
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
# P03_errlens_web - 接口定义
|
||||||
|
|
||||||
|
## API 列表
|
||||||
|
|
||||||
|
## 数据结构
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# errlens_web
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
# tests
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
# P03-001 - 验收标准
|
||||||
|
|
||||||
|
## 功能验收
|
||||||
|
- [ ] 项目目录结构完整
|
||||||
|
- [ ] ENVIRONMENT.md 已创建
|
||||||
|
- [ ] 文档目录已初始化
|
||||||
|
|
||||||
|
## 测试覆盖要求
|
||||||
|
- 无需测试(初始化任务)
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
# P03-001 - 第一轮测试反馈
|
||||||
|
|
||||||
|
## 测试结果
|
||||||
|
- 通过:0
|
||||||
|
- 失败:0
|
||||||
|
|
||||||
|
## 反馈
|
||||||
|
待执行测试
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
# P03-001 - 变更影响范围
|
||||||
|
|
||||||
|
## 修改的文件
|
||||||
|
| 文件路径 | 修改类型 | 影响等级 |
|
||||||
|
|---------|---------|---------|
|
||||||
|
| projects/P03_errlens_web/ | 新增 | LOW |
|
||||||
|
|
||||||
|
## 需要回归测试的场景
|
||||||
|
- 无(新项目)
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
# P03-001 - 项目初始化
|
||||||
|
|
||||||
|
## 任务信息
|
||||||
|
- 任务编号:P03-001
|
||||||
|
- 项目:P03_errlens_web
|
||||||
|
- 创建时间:2026-05-22
|
||||||
|
- 状态:TODO
|
||||||
|
|
||||||
|
## 任务描述
|
||||||
|
完成 errlens_web 项目的初始化工作。
|
||||||
|
|
||||||
|
## 交付物
|
||||||
|
- 项目目录结构
|
||||||
|
- 基础配置文件
|
||||||
|
- README 文档
|
||||||
Reference in New Issue
Block a user