sync(agent-skills): update website docs to match codegen v10.5.0-beta.4#125
Merged
Conversation
- Bump version from 0.0.1-beta.1 to 0.0.2-beta.1 - Configinfo → UpdateRequest API across all pages - Add AppType enum, SetSource(), AddListenerProgress() coverage - Add 2 new skills: generalupdate-migration, generalupdate-security-audit - Add developer integration roadmap and unified verification checklist - Update Bowl section: BowlContext + LaunchAsync (v10.5.0-beta.4) - Update DiffPipelineBuilder differential engine section - Add detailed strategy decision tree with 19 combinations - Add anti-pattern checklists to all skill pages - Update English i18n to match Chinese docs - Register new pages in sidebars.js Co-Authored-By: Claude <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR synchronizes the Agent Skills documentation (CN + EN) with the updated skill/codegen surface targeting GeneralUpdate.Core 10.5.0-beta.4, and registers two new Agent Skills pages in the Docusaurus sidebar.
Changes:
- Bumps the documented Agent Skills suite version to
0.0.2-beta.1and updates all pages fromConfiginfo→UpdateRequestand other v10.5 API changes. - Adds two new skills/pages: migration and security audit, and wires them into
website/sidebars.js. - Expands each skill page with additional checklists/anti-pattern guidance and updated examples.
Reviewed changes
Copilot reviewed 17 out of 17 changed files in this pull request and generated 11 comments.
Show a summary per file
| File | Description |
|---|---|
| website/sidebars.js | Registers the new Agent Skills pages in the sidebar. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/overview.md | EN overview updated to v10.5 docs + adds roadmap/checklists + lists new pages. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-init.md | EN init guide migrated to UpdateRequest/v10.5 features + adds checklists. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-ui.md | EN UI skill updated for v10.5 + adds verification/anti-pattern sections. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-strategy.md | EN strategy guide updated to v10.5 + expands decision tree/checklists. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-advanced.md | EN advanced guide updated to v10.5 + expands pipeline/diff/bowl/AOT sections. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-troubleshoot.md | EN troubleshooting expanded with symptom collection + BM25 search workflow. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-migration.md | New EN migration page for v9→v10.5 and dev→beta.4 paths. |
| website/i18n/en/docusaurus-plugin-content-docs/current/agent-skills/generalupdate-security-audit.md | New EN security audit matrix + report template/checklist. |
| website/docs/agent-skills/overview.md | CN overview updated to v10.5 docs + adds roadmap/checklists + lists new pages. |
| website/docs/agent-skills/generalupdate-init.md | CN init guide migrated to UpdateRequest/v10.5 features + adds checklists. |
| website/docs/agent-skills/generalupdate-ui.md | CN UI skill updated for v10.5 + adds verification/anti-pattern sections. |
| website/docs/agent-skills/generalupdate-strategy.md | CN strategy guide updated to v10.5 + expands decision tree/checklists. |
| website/docs/agent-skills/generalupdate-advanced.md | CN advanced guide updated to v10.5 + expands pipeline/diff/bowl/AOT sections. |
| website/docs/agent-skills/generalupdate-troubleshoot.md | CN troubleshooting expanded with symptom collection + BM25 search workflow. |
| website/docs/agent-skills/generalupdate-migration.md | New CN migration page for v9→v10.5 and dev→beta.4 paths. |
| website/docs/agent-skills/generalupdate-security-audit.md | New CN security audit matrix + report template/checklist. |
Comments suppressed due to low confidence (1)
website/docs/agent-skills/generalupdate-advanced.md:248
- 这里引用了
GeneralUpdate.Differential.Matchers，但仓库里现有的差分示例/文档（如website/docs/doc/GeneralUpdate.Core.md）里DefaultCleanMatcher/DefaultDirtyMatcher是通过GeneralUpdate.Core.Differential引入的。当前using很可能不正确，用户照抄会编译失败。
using GeneralUpdate.Differential.Matchers;
// 自定义清理匹配器
var cleanMatcher = new DefaultCleanMatcher(); // 或实现 ICleanMatcher
var dirtyMatcher = new DefaultDirtyMatcher(); // 或实现 IDirtyMatcher
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ├── Match found → Provide root cause + fix + code | ||
| └── No match → Execute 6-step universal diagnostic | ||
| 2. Symptom Matching | ||
| ├── Priority: python3 scripts/search.py "<symptom>" --domain issue |
| ├── 找到匹配的 Q/C/H/M/L → 给出根因 + 修复 + 代码 | ||
| └── 未找到匹配 → 执行通用诊断流程（6步骤） | ||
| 2. 症状匹配 | ||
| ├── 优先：python3 scripts/search.py "<症状>" --domain issue |
- Fix namespace: GeneralUpdate.Differential.Matchers → GeneralUpdate.Core.Differential - Fix log glob: generalupdate-trace *.log → generalupdate-trace-*.log - Fix skill path: skills/ → .claude/skills/ in search commands - Fix event count: 6 → 7 events (missing AddListenerProgress) Co-Authored-By: Claude <noreply@anthropic.com>
<T> outside backticks was parsed as JSX tag by Docusaurus MDX, causing CI build failure. Added backticks around Hooks<T>() and Strategy<T>(). Co-Authored-By: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sync the Agent Skills website documentation pages with the
tmpgeneralupdate-skill-codegensource changes.Changes
Version bump: v0.0.1-beta.1 → v0.0.2-beta.1 (targets NuGet
GeneralUpdate.Core 10.5.0-beta.4)API migration across all pages:
Configinfo→UpdateRequest(GeneralUpdate.Core.Configuration)AppTypefrom class → enum (addedOssClient/OssUpgrade)SetSource(),AuthScheme,AddListenerProgress(),DiffPipelineBuilderBowlContext+LaunchAsync()(v10.5 fully functional)New pages (2 new skills):
generalupdate-migration.md— v9.x → v10 / dev-branch → stable migrationgeneralupdate-security-audit.md— 14-item security audit matrixAdded content:
Infrastructure:
sidebars.js🤖 Generated with Claude Code