docs: make devops skill plan-first and jj-aware
Some checks failed
publish-site / deploy-public-site (push) Has been cancelled
preview-slot-reclaim / reclaim (push) Has been cancelled

This commit is contained in:
2026-03-13 13:18:48 +08:00
parent acb77a821c
commit ccfdda4342
6 changed files with 490 additions and 27 deletions

View File

@@ -53,10 +53,29 @@ Use this at session start before any implementation:
- automatic自动修复+提测循环,最终合并仍需工程师确认
- semi-automatic修复后先人工 review再提测循环
- manual全流程人工确认
可选:指定 reviewer、提测命令、部署环境、健康检查地址。
4) 固定 issue 触发来源issue 编号 / 评论触发 / app/CLI 选择 / 仅扫描不编码)
可选目标基线分支、分支命名规则、Plan 存储路径、指定 reviewer、提测命令、部署环境、健康检查地址、jj 策略。
可选(推荐):主环境 URL、共享 QA URL、预览槽位池如 preview-a/preview-b和预览 URL 模板。
```
## Plan Summary Template
Use this comment or PR note after the MajorAgent has created the plan:
```text
[issue-plan-summary-v1]
已生成执行计划:
- issue: #<number>
- status: <selected|planned|...>
- target base: <branch>
- working branch: <branch>
- allowed scope: <paths>
- expected behavior: <summary>
- verification: <unit/integration/e2e/smoke>
- assigned agent: <major|sub|test>
未完成前不会进入代码修改。
```
## Review Request Template (Semi-Automatic)
```text
@@ -65,6 +84,7 @@ Use this at session start before any implementation:
- issue: #<number>
- branch: <branch>
- commit: <sha>
- pr: <url>
- change summary: <summary>
- risk: <risk notes>
- test plan: <plan>
@@ -79,12 +99,14 @@ Use this at session start before any implementation:
- issue: #<number>
- branch: <branch>
- commit: <sha>
- pr: <url>
- pipeline/test run: <url>
- environment: <env/version>
- preview slot: <slot>
- preview url: <url>
- deploy scope: <skip|client_only|server_only|full_stack|infra_only>
- server strategy: <reused-shared|dedicated-branch-server>
- e2e: <passed|failed|waived-with-approval>
- verify steps: <steps>
如失败或结果不符合预期,将继续同分支迭代修复。
```
@@ -121,6 +143,7 @@ Use this at session start before any implementation:
- issue: #<number>
- branch: <branch>
- target: <target branch>
- pr: <url>
- review status: <approved/pending>
- test status: <passed/failed>
- release evidence: <links>
@@ -133,6 +156,7 @@ Use this at session start before any implementation:
[issue-verified-close-v1]
已修复并发布。
- commit: <sha>
- pr: <url>
- tests: <summary>
- deploy: <pipeline/run url>
- verify: <how verified>