Skip to content

Commit 9b1b584

Browse files
author
zhangwei
committed
chore: update ai-engineering
1 parent 3597cd3 commit 9b1b584

25 files changed

Lines changed: 1307 additions & 257 deletions

‎.agents/skills/api-example-release-iteration/SKILL.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Identify before editing:
1717
- Verification budget and available platform hosts.
1818
- Target RTC SDK version for each platform. Platforms may remain on different release lines.
1919

20-
Android, iOS, macOS, and Windows are required by default. Contract may choose the appropriate full/audio/Compose/UIKit/Objective-C project for each platform; marking a platform not required needs an explicit waiver reason.
20+
Android, iOS, macOS, and Windows are required by default. Their targets are fixed to `Android/APIExample/`, `iOS/APIExample/`, `macOS/`, and `windows/`. Audio, Compose, SwiftUI, and Objective-C variants are outside this workflow; marking a primary platform not required needs an explicit waiver reason.
2121

2222
## Source Route
2323

@@ -60,7 +60,7 @@ python3 docs/ai-engineering/tools/orchestrate_case_execution.py init \
6060

6161
`--target-sdk-version` supplies the baseline for all four platforms. Repeat `--platform-sdk-version platform=x.y.z` only for platforms whose target differs. The execution package and manifest store the resolved four-platform mapping, so staggered platform releases never require script or repository-profile changes.
6262

63-
The default `docs/ai-engineering/repository-profile.json` supplies repository-specific SDK package names and version sources. Use `--repository-profile` only for a checked-in alternative profile. The execution package records its repository-relative path and SHA-256.
63+
The default `docs/ai-engineering/repository-profile.json` supplies repository-specific SDK package names and version sources. Use `--repository-profile` only for a checked-in alternative profile. The execution package, input snapshots, and acceptance manifest record its repository-relative path and SHA-256; the standalone validator recomputes release checks from that binding.
6464

6565
For a new requirement not yet actionable in the matrix, also pass `--sdk-family "<family>"` and repeat `--key-api "<API>"` as needed.
6666

@@ -102,7 +102,7 @@ python3 docs/ai-engineering/tools/orchestrate_case_execution.py assemble \
102102

103103
## Platform Rules
104104

105-
- Contract selects the target project and allowed files for each platform.
105+
- Contract preserves the fixed primary target project and defines allowed files for each platform.
106106
- The dispatcher runs platform roles from that target project. In a shared checkout it refreshes the package/dependency snapshot, completes and reconciles one Implementation before starting the next, derives that role's cumulative net repository delta, and rejects changes outside Contract paths.
107107
- Each Implementation agent follows only its platform/project instructions.
108108
- Platform source files, dependencies, and build scripts are never shared across roots.
@@ -117,7 +117,7 @@ On macOS, Windows Verification may perform repository-local static review only.
117117

118118
## Matrix And Release
119119

120-
Each platform Implementation may propose zero or more matrix updates. `DONE` requires final `PASS`, platform parity/build `PASS`, and no skipped checks. Release data is limited to repository SDK-version consistency. Jenkins packaging, QA validation, artifact distribution, and external website publication are outside this workflow and must not be recorded as manifest gates.
120+
Each platform Implementation may propose zero or more matrix updates. `DONE` requires final `PASS`, platform parity/build `PASS`, and no skipped checks. Release data is limited to repository SDK-version consistency. An externally injected SDK without a trustworthy tracked version source keeps its platform SDK check and final acceptance `BLOCKED`; build success is not version evidence. Jenkins packaging, QA validation, artifact distribution, and external website publication are outside this workflow and must not be recorded as manifest gates.
121121

122122
## Final Output
123123

‎.github/workflows/ai-engineering-checks.yml‎

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
name: AI Engineering Checks
22

33
# Guards the AI engineering assets (AGENTS.md routing, SKILL.md bundles) and the
4-
# orchestration tooling under docs/ai-engineering/tools/. These checks are file-only:
5-
# they never build a platform sample, so they stay fast enough to run on every PR.
4+
# orchestration tooling under docs/ai-engineering/tools/. These checks are file-only
5+
# and run on every host family used by verification; platform builds remain in Azure.
66

77
on:
88
push:
@@ -36,9 +36,16 @@ concurrency:
3636

3737
jobs:
3838
checks:
39-
name: Lint assets and run tooling tests
40-
runs-on: ubuntu-latest
39+
name: Tooling checks (${{ matrix.os }})
40+
runs-on: ${{ matrix.os }}
4141
timeout-minutes: 15
42+
strategy:
43+
fail-fast: false
44+
matrix:
45+
os:
46+
- ubuntu-latest
47+
- macos-latest
48+
- windows-latest
4249
env:
4350
PYTHONDONTWRITEBYTECODE: '1'
4451
steps:
@@ -52,13 +59,13 @@ jobs:
5259
python-version: '3.11'
5360

5461
- name: Lint AI engineering assets
55-
run: python3 docs/ai-engineering/tools/lint_agent_assets.py
62+
run: python docs/ai-engineering/tools/lint_agent_assets.py
5663

5764
- name: Run AI engineering tooling tests
58-
run: |
59-
python3 -m unittest \
60-
docs/ai-engineering/tools/lint_agent_assets_test.py \
61-
docs/ai-engineering/tools/validate_acceptance_manifest_test.py \
62-
docs/ai-engineering/tools/generate_case_backlog_test.py \
63-
docs/ai-engineering/tools/prepare_case_execution_test.py \
64-
docs/ai-engineering/tools/orchestrate_case_execution_test.py
65+
run: >
66+
python -m unittest
67+
docs/ai-engineering/tools/lint_agent_assets_test.py
68+
docs/ai-engineering/tools/validate_acceptance_manifest_test.py
69+
docs/ai-engineering/tools/generate_case_backlog_test.py
70+
docs/ai-engineering/tools/prepare_case_execution_test.py
71+
docs/ai-engineering/tools/orchestrate_case_execution_test.py

0 commit comments

Comments
 (0)