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:
2026-05-23 21:20:39 +08:00
parent 4083fadb2a
commit 3491827fbc
2 changed files with 913 additions and 104 deletions
+62 -23
View File
@@ -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() {
ls -la projects/ | grep -E '^P[0-9]+_' | sort | tail -1 | sed 's/P\([0-9]*\)_.*$/\1/'
# 兼容 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
echo "- [${PROJECT_NUM}_${PROJECT_NAME}](${PROJECT_DIR})" >> 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
**Based On**: ErrLens AI Programming Project
**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