跳转至

端到端验证

跑完以下检查,确认你的环境就绪。

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. 接下来

读你的角色专属指南:

第一周建议:用一个真实任务跑完整链路,遇到不顺立刻反馈。