feat(skill): 更新 Skill 文件为 v2.0 新框架结构
- ai-collab-setup/SKILL.md: 升级为 v2.0 - 采用 R/W/RW/- 四态权限体系 - 新增 read_only_paths 和 forbidden_paths 配置 - 工作流增加 retry 和 escalation 机制 - 新增提示词模板(code-style.md、doc-template.md、bug-report.md) - 目录结构新增 src/server/、src/config/、src/types/ - add-subproject/SKILL.md: 升级为 v2.0 - 目录结构新增 src/server/、src/config/、src/types/ 子目录 - 示例任务增加完整的 feedback/round1.md 格式 - impact.md 增加影响的功能模块和环境依赖变更段落 - 脚本兼容 Windows PowerShell 和 Linux/macOS - ENVIRONMENT.md 默认使用 pnpm 包管理器
This commit is contained in:
@@ -11,7 +11,7 @@ description: "Adds a new subproject to the existing '1 Human + 2 AI' collaborati
|
||||
- 项目目录结构(src/、tests/、docs/)
|
||||
- 环境配置文件(ENVIRONMENT.md)
|
||||
- README.md 占位文件
|
||||
- 示例任务目录
|
||||
- 示例任务目录(含 task.md、acceptance.md、impact.md、feedback/)
|
||||
|
||||
## 使用方法
|
||||
|
||||
@@ -40,6 +40,9 @@ add-subproject --project_name="web_admin" --project_number="P03"
|
||||
projects/
|
||||
└── P03_web_admin/ # 新项目目录
|
||||
├── src/ # Dev AI 工作区
|
||||
│ ├── server/ # NestJS 后端(如需要)
|
||||
│ ├── config/ # 构建配置
|
||||
│ ├── types/ # 全局类型
|
||||
│ └── README.md
|
||||
├── tests/ # QA AI 工作区
|
||||
│ └── README.md
|
||||
@@ -55,19 +58,27 @@ projects/
|
||||
review/
|
||||
└── active/
|
||||
└── P03-001/ # 新项目的第一个任务
|
||||
├── task.md
|
||||
├── acceptance.md
|
||||
├── impact.md
|
||||
└── feedback/
|
||||
├── task.md # 任务描述(人类创建,AI 只读)
|
||||
├── acceptance.md # 验收标准
|
||||
├── impact.md # 变更影响范围
|
||||
└── feedback/ # 测试反馈
|
||||
└── round1.md
|
||||
```
|
||||
|
||||
## 执行命令
|
||||
|
||||
```bash
|
||||
# 获取下一个项目编号
|
||||
# 获取下一个项目编号(PowerShell 兼容版本)
|
||||
get_next_project_number() {
|
||||
# 兼容 Linux/macOS
|
||||
if command -v ls >/dev/null 2>&1; then
|
||||
ls -la projects/ | grep -E '^P[0-9]+_' | sort | tail -1 | sed 's/P\([0-9]*\)_.*$/\1/'
|
||||
# 兼容 Windows PowerShell
|
||||
elif command -v powershell >/dev/null 2>&1; then
|
||||
powershell -Command "(Get-ChildItem projects -Directory | Where-Object { $_.Name -match '^P\d+_' } | Sort-Object Name | Select-Object -Last 1).Name -replace 'P(\d+)_.*', '$1'"
|
||||
else
|
||||
echo "0"
|
||||
fi
|
||||
}
|
||||
|
||||
# 创建项目目录
|
||||
@@ -76,7 +87,7 @@ 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}
|
||||
mkdir -p "${PROJECT_DIR}"/{src/{server,config,types},tests,docs}
|
||||
|
||||
# 创建 ENVIRONMENT.md
|
||||
cat > "${PROJECT_DIR}/ENVIRONMENT.md" << EOF
|
||||
@@ -84,12 +95,13 @@ cat > "${PROJECT_DIR}/ENVIRONMENT.md" << EOF
|
||||
|
||||
## 依赖
|
||||
- Node.js >= 20.x
|
||||
- pnpm >= 9.0.0
|
||||
|
||||
## 安装
|
||||
npm install
|
||||
pnpm install
|
||||
|
||||
## 运行
|
||||
npm start
|
||||
pnpm dev
|
||||
EOF
|
||||
|
||||
# 创建文档
|
||||
@@ -122,8 +134,8 @@ cat > "${PROJECT_DIR}/docs/03_接口定义.md" << EOF
|
||||
EOF
|
||||
|
||||
# 创建 README.md
|
||||
echo "# ${PROJECT_NAME}" > "${PROJECT_DIR}/src/README.md"
|
||||
echo "# tests" > "${PROJECT_DIR}/tests/README.md"
|
||||
echo "# ${PROJECT_NAME} - src" > "${PROJECT_DIR}/src/README.md"
|
||||
echo "# ${PROJECT_NAME} - tests" > "${PROJECT_DIR}/tests/README.md"
|
||||
|
||||
# 创建示例任务
|
||||
mkdir -p "review/active/${PROJECT_NUM}-001/feedback"
|
||||
@@ -166,25 +178,45 @@ cat > "review/active/${PROJECT_NUM}-001/impact.md" << EOF
|
||||
|---------|---------|---------|
|
||||
| ${PROJECT_DIR}/ | 新增 | LOW |
|
||||
|
||||
## 影响的功能模块
|
||||
- [x] 项目初始化
|
||||
|
||||
## 需要回归测试的场景
|
||||
- 无(新项目)
|
||||
|
||||
## 环境依赖变更
|
||||
- 无
|
||||
EOF
|
||||
|
||||
cat > "review/active/${PROJECT_NUM}-001/feedback/round1.md" << EOF
|
||||
# ${PROJECT_NUM}-001 - 第一轮测试反馈
|
||||
|
||||
## 测试结果
|
||||
- 通过:0
|
||||
- 失败:0
|
||||
## 基本信息
|
||||
- 测试时间: $(date +%Y-%m-%d)
|
||||
- 测试项目: ${PROJECT_NUM}_${PROJECT_NAME}
|
||||
- 测试环境: 待配置
|
||||
|
||||
## 测试结果概览
|
||||
| 指标 | 数值 |
|
||||
|------|------|
|
||||
| 测试用例总数 | 0 |
|
||||
| 通过 | 0 |
|
||||
| 失败 | 0 |
|
||||
| 跳过 | 0 |
|
||||
| 代码覆盖率 | 0% |
|
||||
|
||||
## 反馈
|
||||
待执行测试
|
||||
待 Dev AI 完成开发后执行测试
|
||||
EOF
|
||||
|
||||
# 更新 README.md
|
||||
# 更新 README.md(如果存在)
|
||||
if [ -f README.md ]; then
|
||||
echo "- [${PROJECT_NUM}_${PROJECT_NAME}](${PROJECT_DIR})" >> README.md
|
||||
fi
|
||||
|
||||
echo "✅ 子项目 ${PROJECT_NUM}_${PROJECT_NAME} 创建成功!"
|
||||
echo "📖 请阅读 AGENTS.md 了解协作规则"
|
||||
echo "🚀 在 review/active/${PROJECT_NUM}-001/ 下查看示例任务结构"
|
||||
```
|
||||
|
||||
## 使用场景
|
||||
@@ -203,12 +235,19 @@ echo "✅ 子项目 ${PROJECT_NUM}_${PROJECT_NAME} 创建成功!"
|
||||
|
||||
skill 执行后:
|
||||
1. 检查 `projects/${PROJECT_NUM}_${PROJECT_NAME}/` 目录结构
|
||||
2. 修改 `ENVIRONMENT.md` 配置项目依赖
|
||||
3. 更新 `docs/` 目录的文档内容
|
||||
4. 开始在 `review/active/${PROJECT_NUM}-001/` 任务下工作
|
||||
2. 阅读 `review/active/${PROJECT_NUM}-001/task.md` 示例任务
|
||||
3. 根据实际需求修改 `task.md` 为真实任务
|
||||
4. Dev AI 开始开发
|
||||
|
||||
---
|
||||
|
||||
**Version**: 1.0
|
||||
**Version**: 2.0
|
||||
**Created**: 2026-05-22
|
||||
**Updated**: 2026-05-23
|
||||
**Based On**: ErrLens AI Programming Project
|
||||
**Changes from v1**:
|
||||
- 目录结构新增 src/server/、src/config/、src/types/ 子目录
|
||||
- 示例任务增加完整的 feedback/round1.md 格式(含基本信息表格)
|
||||
- impact.md 增加「影响的功能模块」和「环境依赖变更」段落
|
||||
- 脚本兼容 Windows PowerShell 和 Linux/macOS
|
||||
- ENVIRONMENT.md 默认使用 pnpm 包管理器
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user