|
|
11 uur geleden | |
|---|---|---|
| development | 4 dagen geleden | |
| implementation | 5 dagen geleden | |
| requirements | 5 dagen geleden | |
| test | 4 dagen geleden | |
| README.md | 11 uur geleden |
仓库:
https://code.sapit.com.cn/sapit-skills/skills.git用途:把《标准交付流程 V2.0》装进 WorkBuddy,让 AI 按咱们的规范干活
四个岗位各一个技能包,装进 WorkBuddy 后,AI 在对应场景会自动按规范办事——该拒绝的拒绝(材料不全不硬写),该停的停(先出骨架等人确认),该标来源的标来源。
| 技能包 | 谁用 | 干什么 |
|---|---|---|
sapit-req-example |
需求分析师 | 写需求说明书、出功能清单、估人天 |
sapit-dev-example |
开发工程师 | 表结构设计、编码、代码审查 |
sapit-qa-example |
测试工程师 | 写测试用例、缺陷根因分析 |
sapit-ops-example |
实施工程师 | 部署方案、部署脚本、环境排查 |
跟以前模板的区别:以前是 Word/Excel 模板,你不填它不会说话;现在是 AI 的作业手册,你不按规范来它会提醒你。
code.sapit.com.cnGit Bash / macOS / Linux
git clone https://code.sapit.com.cn/sapit-skills/skills.git ~/sapit-skills
PowerShell
git clone https://code.sapit.com.cn/sapit-skills/skills.git $env:USERPROFILE\sapit-skills
注意:不要直接 clone 到
~/.workbuddy/skills/里,原因见第五节。
Git Bash
mkdir -p ~/.workbuddy/skills
cp -r ~/sapit-skills/*/sapit-*-example ~/.workbuddy/skills/
PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.workbuddy\skills" | Out-Null
Get-ChildItem "$env:USERPROFILE\sapit-skills\*\sapit-*-example" -Directory |
Copy-Item -Destination "$env:USERPROFILE\.workbuddy\skills" -Recurse -Force
关掉重开。技能是启动时加载的,不重启不生效。
随便开个对话,问一句:
你现在能用哪些交付技能?
能说出四个技能名就装好了。
C:\Users\你的用户名\.workbuddy\skills\
├── sapit-req-example\
│ ├── SKILL.md
│ └── references\
│ ├── 模板-需求说明书.md
│ ├── 模板-功能清单.md
│ ├── 模板-成本预估.md
│ ├── 分段提示词.md
│ └── 复核清单.md
├── sapit-dev-example\
├── sapit-qa-example\
└── sapit-ops-example\
必须是这个层级:skills/ 下面直接就是技能目录,技能目录里直接就是 SKILL.md。多一层或少一层都加载不到。
技能靠描述匹配自动触发,你正常提需求即可:
| 你说 | 触发 |
|---|---|
| "帮我写需求说明书,材料在附件里" | sapit-req |
| "按 F-003 设计请假模块的表结构" | sapit-dev |
| "根据 F-003 写测试用例" | sapit-qa |
| "出一份 v1.2.0 的部署方案" | sapit-ops |
正常情况,AI 不会直接开写,而是先做三件事:
如果它没这么做,直接说"按规范来",或者点名:"用 sapit-req 写"。
你:按 F-003 设计请假模块的表结构,技术栈 Spring Boot 3.2 + MySQL 8.0
它会先输出:ER 图 + 建库 SQL + 与现有表的冲突点,然后问你要不要继续写代码。
而不是上来就给你一堆 Java 类。
仓库按岗位分了两层目录(requirements/ development/ test/ implementation/),方便以后同一岗位放多个技能。
但 WorkBuddy 只认一层:skills/<技能名>/SKILL.md。
如果直接 git clone 到 ~/.workbuddy/skills/,会变成:
~/.workbuddy/skills/skills/requirements/sapit-req-example/SKILL.md
四层,AI 找不到。
所以要 clone 到别处,再把技能目录平铺复制进去。
技能包会持续改(补模板、调阈值、加场景)。
cd ~/sapit-skills
git pull
cp -r */sapit-*-example ~/.workbuddy/skills/
复制时选"覆盖"即可。然后重启 WorkBuddy。
如果提示文件被占用,先关掉 WorkBuddy 再复制。
cd ~/sapit-skills
git checkout -b fix/需求模板补充导出按钮
# 改文件
git add .
git commit -m "fix: 需求模板补充导出按钮的跨业务影响说明"
git push origin fix/需求模板补充导出按钮
然后在 GitLab 上提合并请求。
| 想改的东西 | 改哪个文件 |
|---|---|
| AI 的判断流程、拒绝条件 | <技能>/SKILL.md |
| 文档模板、格式 | <技能>/references/模板-xxx.md |
| 检查项、红线 | <技能>/references/复核清单.md |
| 提示词 | <技能>/references/分段提示词.md 或 模板与提示词.md |
注意:改完 SKILL.md 后,如果里面提到 references/ 的文件名,路径要对得上,否则 AI 读不到。
装了没反应
~/.workbuddy/skills/sapit-req-example/SKILL.md 这个文件存不存在SKILL.md,大小写也要对提示找不到 references 里的文件
复制时漏了 references 目录。重新复制:
rm -rf ~/.workbuddy/skills/sapit-req-example
cp -r ~/sapit-skills/requirements/sapit-req-example ~/.workbuddy/skills/
只想装一个岗位的
cp -r ~/sapit-skills/test/sapit-qa-example ~/.workbuddy/skills/
装了会不会让 AI 变啰嗦
不会。技能只在匹配场景加载,写代码时不会突然跟你讲需求模板。
团队里每个人都要装吗
各自装各自的。技能是本地文件,不共享状态。
1. 这是示例版(-example)。 里面的阈值(需求推断占比 ≤30%、用例覆盖率 ≥80%)是按经验拍的,还没经过一线数据校准。用的时候如果觉得卡得太死或太松,直接改,改完提交上来。
2. 技能管不了的事。 它能让 AI 按规范产出文档,但管不了"客户口头答应下周给材料结果拖了一个月"这种事。流程是底线,项目还是人做的。
有问题在群里问,或者直接提 issue。