[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M698YPWEET75NMDKJA407WZ6":3,"skill-same:01M698YPWEET75NMDKJA407WZ6":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":31,"publishedAt":53,"linkOnly":54,"markdownContent":55,"markdownBody":56,"frontMatter":57,"refName":58,"commitSha":59,"skillDirectory":60,"forksCount":61,"repositoryHtmlUrl":62,"repositoryHomepageUrl":63,"ownerHtmlUrl":64,"ownerBlogUrl":65,"ownerDescription":66,"updatedAt":67,"install":68,"resources":81},"01M698YPWEET75NMDKJA407WZ6","adk-unit-design",null,"Writes an as-built architecture document for one ADK code unit — purpose, execution flow, data flow, cross-class dependencies, extension points, and the parts that must not change — to `docs\u002Fdesign\u002F{topic}\u002F{unit}\u002Findex.md`. It describes the code as implemented, not a proposed design, and its reader is a developer about to change or extend that unit. Use when asked to \"write a design doc for {file}\", \"document the architecture of {class}\", \"document the extension points of {unit}\", or after adding a core class, node type, or plugin base. Don't use for documentation aimed at developers who only call the unit from their own application — that is a usage guide with runnable examples under `docs\u002Fguides\u002F` (use `adk-unit-guide`). Don't use to answer a framework-wide architecture question (use `adk-architecture`).","google\u002Fadk-python","google","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1342004?v=4","01M698VYEFDM0VJBZDYYJ2T83S","Google","01M698XZC2HCATT8VD5VAVZDTP",22217,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fadk-unit-design\u002FSKILL.md",[18,23,28],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":29,"categoryName":30,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000032","设计师",[32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52],"adk unit design","adk","unit","design","design doc","when","data flow","write a design doc","at","guides","only","write","question","node","doc","flow","code","documentation","architecture","change","docs","2026-11-10 10:12:30",false,"---\nname: adk-unit-design\ndescription: >-\n  Writes an as-built architecture document for one ADK code unit — purpose,\n  execution flow, data flow, cross-class dependencies, extension points, and\n  the parts that must not change — to `docs\u002Fdesign\u002F{topic}\u002F{unit}\u002Findex.md`. It\n  describes the code as implemented, not a proposed design, and its reader is a\n  developer about to change or extend that unit. Use when asked to \"write a\n  design doc for {file}\", \"document the architecture of {class}\", \"document the\n  extension points of {unit}\", or after adding a core class, node type, or\n  plugin base. Don't use for documentation aimed at developers who only call the\n  unit from their own application — that is a usage guide with runnable examples\n  under `docs\u002Fguides\u002F` (use `adk-unit-guide`). Don't use to answer a\n  framework-wide architecture question (use `adk-architecture`).\n---\n\n# ADK code unit design\n\nA unit design documents a code unit **as implemented**, the way a unit test\nexercises it as implemented. Nothing proposed or aspirational belongs in one.\nThe reader is deciding what they may safely change, so answer \"what breaks if I\ntouch this?\" — not \"how do I call this?\".\n\n## Inputs\n\nRequire the source file, or a class or method named inside it. Also read, when\nthey exist: the base classes and interfaces the unit implements, its unit tests\n(the best evidence of intended behaviour), and example usage.\n\n## Analyse before writing\n\nAnswer each of these from the source. Anything the code does not show stays out\nof the document — do not infer a design intent from a name.\n\n- Purpose and intended use of the unit.\n- Execution flow, and the data that flows in and out.\n- Upstream dependencies, and which classes depend on this unit.\n- Extension surfaces: abstract methods, hooks, callbacks, configurable fields.\n- Constraints — what a subclass or caller must not change, and why.\n- Operational limitations.\n\n## Where the document goes\n\nMirror the source path under `docs\u002Fdesign\u002F`, one directory per unit, document\nnamed `index.md`. Drop the leading underscore of a private module:\n\n| Source | Design document |\n| :--- | :--- |\n| `src\u002Fgoogle\u002Fadk\u002Fworkflow\u002F_function_node.py` | `docs\u002Fdesign\u002Fworkflow\u002Ffunction_node\u002Findex.md` |\n| `src\u002Fgoogle\u002Fadk\u002Fevents\u002Fevent.py` | `docs\u002Fdesign\u002Fevents\u002Fevent\u002Findex.md` |\n\nIf a document already exists at that path, update it in place and keep the\nexisting wording wherever the code has not changed, so the diff shows only what\nthe change actually altered.\n\n`docs\u002Fdesign\u002F` does not exist in this repository yet — the first design document\ncreates it. `docs\u002Fguides\u002F` is the established sibling tree; match its directory\nshape.\n\n## Link to GitHub, not to local paths\n\nThese documents render on GitHub, where a local filesystem path is dead.\nRewrite `{repo_root}\u002Fsrc\u002Fgoogle\u002Fadk\u002F{topic}\u002F{unit}.py#L93` as\n`https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fsrc\u002Fgoogle\u002Fadk\u002F{topic}\u002F{unit}.py#L93`.\n\n## Structure\n\nFollow [references\u002Fdesign-template.md](references\u002Fdesign-template.md) section by\nsection.\n","# ADK code unit design\n\nA unit design documents a code unit **as implemented**, the way a unit test\nexercises it as implemented. Nothing proposed or aspirational belongs in one.\nThe reader is deciding what they may safely change, so answer \"what breaks if I\ntouch this?\" — not \"how do I call this?\".\n\n## Inputs\n\nRequire the source file, or a class or method named inside it. Also read, when\nthey exist: the base classes and interfaces the unit implements, its unit tests\n(the best evidence of intended behaviour), and example usage.\n\n## Analyse before writing\n\nAnswer each of these from the source. Anything the code does not show stays out\nof the document — do not infer a design intent from a name.\n\n- Purpose and intended use of the unit.\n- Execution flow, and the data that flows in and out.\n- Upstream dependencies, and which classes depend on this unit.\n- Extension surfaces: abstract methods, hooks, callbacks, configurable fields.\n- Constraints — what a subclass or caller must not change, and why.\n- Operational limitations.\n\n## Where the document goes\n\nMirror the source path under `docs\u002Fdesign\u002F`, one directory per unit, document\nnamed `index.md`. Drop the leading underscore of a private module:\n\n| Source | Design document |\n| :--- | :--- |\n| `src\u002Fgoogle\u002Fadk\u002Fworkflow\u002F_function_node.py` | `docs\u002Fdesign\u002Fworkflow\u002Ffunction_node\u002Findex.md` |\n| `src\u002Fgoogle\u002Fadk\u002Fevents\u002Fevent.py` | `docs\u002Fdesign\u002Fevents\u002Fevent\u002Findex.md` |\n\nIf a document already exists at that path, update it in place and keep the\nexisting wording wherever the code has not changed, so the diff shows only what\nthe change actually altered.\n\n`docs\u002Fdesign\u002F` does not exist in this repository yet — the first design document\ncreates it. `docs\u002Fguides\u002F` is the established sibling tree; match its directory\nshape.\n\n## Link to GitHub, not to local paths\n\nThese documents render on GitHub, where a local filesystem path is dead.\nRewrite `{repo_root}\u002Fsrc\u002Fgoogle\u002Fadk\u002F{topic}\u002F{unit}.py#L93` as\n`https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fsrc\u002Fgoogle\u002Fadk\u002F{topic}\u002F{unit}.py#L93`.\n\n## Structure\n\nFollow [references\u002Fdesign-template.md](references\u002Fdesign-template.md) section by\nsection.\n",{"name":5,"description":7},"main","8cd3b12c8a5d658c5e0d3ea0731d8be34a092a4a",".agents\u002Fskills\u002Fadk-unit-design",4356,"https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python","https:\u002F\u002Fgoogle.github.io\u002Fadk-docs\u002F","https:\u002F\u002Fgithub.com\u002Fgoogle","https:\u002F\u002Fopensource.google\u002F","Google ❤️ Open Source","2026-11-14 14:38:36",{"source":8,"skillName":5,"commands":69,"prompt":79,"zipAvailable":80},[70,73,76],{"tool":71,"command":72},"npx","npx skills add google\u002Fadk-python --skill adk-unit-design",{"tool":74,"command":75},"bunx","bunx skills add google\u002Fadk-python --skill adk-unit-design",{"tool":77,"command":78},"pnpm","pnpm dlx skills add google\u002Fadk-python --skill adk-unit-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fadk-unit-design\u002FSKILL.md",true,[82],{"path":83,"resourceType":84,"resourceTypeDesc":85,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fdesign-template.md","REFERENCE","参考文档",1315,"https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fadk-unit-design\u002Freferences\u002Fdesign-template.md",[89,119,146,171,187,195],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":101,"publishedAt":53},"01M698ZJNXJCE7T81AK0Y5R01D","bigquery-graph","Skill for Graph Query Language (GQL) or SQL\u002FPGQ queries against a property graph.\nIncludes path finding, multi-hop traversal, topological connection, shortest path,\nnode reachability, edge connectivity, and semantic graph queries.","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fsrc\u002Fgoogle\u002Fadk\u002Fintegrations\u002Fbigquery\u002Fskills\u002Fbigquery-graph\u002FSKILL.md",[95,98],{"categoryNo":96,"categoryName":97,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":99,"categoryName":100,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000033","数据分析师",[102,103,104,9,105,33,106,107,108,109,45,110,111,112,113,114,115,116,117,118],"graph","bigquery","bigquery graph","for","sql","edge","graph query","hop","queries","language","query","connectivity","gql","semantic","multi","connection","path",{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":126,"publishedAt":53},"01M698ZEVMRDDFX2MH3GHQGSNW","bigquery-ai-ml","Leverages BigQuery's built-in machine learning and GenAI capabilities for advanced data analytics. Use when you need to write SQL queries that perform time-series forecasting, predict values, detect outliers or anomalies, find key drivers, perform semantic search or vector search, classify text, calculate similarity, summarize content, translate language, evaluate models, filter by semantic conditions, measure the causal effect of an intervention, compute correlations between columns, detect change points or structural breaks, extract trend or seasonality components, or leverage generative AI capabilities in BigQuery. Do not use for general BigQuery dataset, table, or job management requests.","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fsrc\u002Fgoogle\u002Fadk\u002Fintegrations\u002Fbigquery\u002Fskills\u002Fbigquery-ai-ml\u002FSKILL.md",[125],{"categoryNo":99,"categoryName":100,"taxonomyType":26,"taxonomyTypeDesc":27},[127,103,128,129,130,37,131,132,133,134,135,136,137,138,139,9,140,141,33,142,143,144,145],"ai ml","ml","bigquery ai ml","vector","generative","you","advanced","dataset","leverage","structural","time","effect","search","summarize","genai","generative ai","translate","components","capabilities",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":157,"publishedAt":53},"01M698ZCN6SZ9SJ8E9970M47FQ","code-review-skill","Reviews code with feedback tailored to the developer's profile in session state.","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fcontributing\u002Fsamples\u002Fenvironment_and_skills\u002Fskills_inject_state\u002Fskills\u002Fcode-review-skill\u002FSKILL.md",[152,155,156],{"categoryNo":153,"categoryName":154,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000007","代码审查",{"categoryNo":96,"categoryName":97,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},[158,48,159,160,161,162,163,164,165,166,167,168,169,170],"review skill","code review skill","review","code review","session","state","developer","feedback","profile","with","session state","reviews","true",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":178,"publishedAt":53},"01M698ZAMH02NSGXMR533ETWYW","weather-skill","A skill that provides weather information based on reference data.","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fcontributing\u002Fsamples\u002Fenvironment_and_skills\u002Fskills_agent\u002Fskills\u002Fweather-skill\u002FSKILL.md",[177],{"categoryNo":96,"categoryName":97,"taxonomyType":21,"taxonomyTypeDesc":22},[179,180,181,182,183,184,185,186],"weather skill","weather","data","reference","speed","get","wind","information",{"skillNo":188,"name":173,"nameZh":6,"description":189,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":190,"categories":191,"keywords":193,"publishedAt":53},"01M698Z8QFDZ713E03589BHEG5","A skill that provides weather information based on reference data and scripts.","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fcontributing\u002Fsamples\u002Fenvironment_and_skills\u002Fskills\u002Fskills\u002Fweather-skill\u002FSKILL.md",[192],{"categoryNo":96,"categoryName":97,"taxonomyType":21,"taxonomyTypeDesc":22},[180,179,186,185,194,184,183,182,181],"scripts",{"skillNo":196,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":197,"categories":198,"keywords":200,"publishedAt":53},"01M698Z6P1NZFW6A6V342AWZPR","https:\u002F\u002Fgithub.com\u002Fgoogle\u002Fadk-python\u002Fblob\u002Fmain\u002Fcontributing\u002Fsamples\u002Fenvironment_and_skills\u002Flocal_environment_skill\u002Fskills\u002Fweather-skill\u002FSKILL.md",[199],{"categoryNo":96,"categoryName":97,"taxonomyType":21,"taxonomyTypeDesc":22},[179,180,182,186,181]]