端到端验证¶
跑完以下检查,确认你的环境就绪。
1. 一键脚本(跨平台)¶
node tools/verify-env.mjs --role <pm|backend|frontend|qa|ops|manager>
逐项检查:工具就位 / czerp-team-mcp 网关已接入(~/.claude.json,由 claude mcp add 写入)/ 代码仓库 / marketplace 已添加。
2. 手工验证(推荐都跑一遍)¶
2.1 SKILL 触发¶
在 Claude Code 输:
我现在要开始实现 CZPRJ-1024 这个故事
预期 AI 自动加载 user-story-to-implementation skill,并尝试调 PingCode MCP 拉故事。
2.2 PingCode MCP¶
通过 PingCode MCP 拉一下 CZKB 知识库总体技术方案页(short_id -wKmAMVC,先按取数手册换内部 page id 再取正文)
预期返回 markdown 内容。
2.3 Slash Command¶
/openspec-new test-change-001
预期生成 openspec/changes/test-change-001/ 骨架(不要提交,玩完删掉)。
2.4 角色对应¶
按你的角色随便问一句:
| 角色 | 验证问句 | 预期触发的 skill |
|---|---|---|
| PM | "帮我把这段 Notion 资料整理成用户故事" | notion-research-distill + user-story-author |
| 后端 | "我要在 OMS 加一个订单导出接口,给我个 CRUD 骨架" | crud-scaffold |
| 前端 | "用 Avue 写一个订单列表页" | avue-and-element + http-and-api |
| QA | "给 CZPRJ-1024 起 5 条测试用例" | testcase-author |
| 运维 | "test 环境 czerp-oms Pod 一直 CrashLoop 怎么排查" | k8s-troubleshooting |
| 技术/项目经理 | "帮我给本 Sprint 出一个容量分配草案" | sprint-planning(/sprint-plan) |
如果 AI 没引用对应 skill,可能是触发词没匹配 — 在对话里显式说 "use skill X" 强制触发,或在本仓库 skill 的 description 里补触发词。
3. 完成标志¶
- [ ] PingCode MCP(经 MCPJungle 网关)能拉故事
- [ ] OpenSpec 命令能跑
- [ ] 你的角色对应 skill 能被触发
- [ ] Gitee MCP 能拿你最近的 PR 信息
四项都过 = onboarding 完成。Codex 用户额外确认 codex plugin add 成功、对应 skill 能触发。
4. 接下来¶
读你的角色专属指南:
docs/02_roles/pm/docs/02_roles/backend/docs/02_roles/frontend/docs/02_roles/qa/docs/02_roles/ops/docs/02_roles/manager/
第一周建议:用一个真实任务跑完整链路,遇到不顺立刻反馈。