用途:为 Ascend C 开发提供开发资料检索能力,强调“本地优先,在线兜底”,用于查询 API 用法、示例代码、兼容性信息、官方资料入口和文档来源定位。
主要能力:本地资源包含 1022 个 API 文档、587 个示例代码和实现参考;在线搜索为华为昇腾社区文档搜索,仅在本地资源不足时使用。资料查找优先级为 asc-devkit/docs/api/context/(本地 API 文档)、asc-devkit/examples/(示例代码)、asc-devkit/impl/(实现代码),最后才在线搜索,推荐版本 8.5.0。
API 变体注意事项:Ascend C 存在 240+ 个带数字后缀的 API 变体,同名 API 的不同变体功能可能完全不同,例如 Add.md 与 Add-25.md。需先列出所有变体:ls asc-devkit/docs/api/context/ | grep -iE "^APIName",再逐一确认函数签名、参数与功能;搜索特定关键词可用 grep -l "关键词" asc-devkit/docs/api/context/APIName*.md。
使用方式:可通过 Explore Agent(Task 工具,subagent_type=Explore)查找 API 文档、实现示例或类似算子参考实现。在线搜索使用 Python 脚本,例如:python skills/ascendc-docs-search/scripts/ascend_search_client.py "Ascend C 临时内存申请" --max_results 5;获取详细内容:python skills/ascendc-content_fetcher.py <URL>;依赖安装:pip install -r skills/ascendc-docs-search/requirements.txt。参数包括 keyword(必需,建议中文)、--max_results(1-10,默认 10)、--lang(zh/en,默认 zh)、--version(如 8.5.0)、--doc_type(DOC/API,默认 DOC)。
适用场景:查询 API 用法、查找示例代码与实现参考、了解技术点实现方式、遇到错误查找解决方案、方案走通后探索更优实现。
限制:当前环境为 A3 服务器、CANN 8.5.0,查阅资料时须确认 API/方法适用于当前环境;在线搜索仅用于本地检索不到、需要更详细官方说明或本地文档过旧不完整的情况。