安装命令
npx skills add https://github.com/agykit/agykit --skill 'Codebase Safety & Exploration'🇨🇳中文介绍
代码库安全与探索
此技能提供了一种系统化的方法，用于理解现有项目并确保更改是安全且无副作用的。
1. 项目入门（上下文获取）
在进行更改之前，先建立对项目的整体认知图。
1.1. 梳理结构
- 列出文件 ：在根目录运行
list_dir。 - 阅读文档 ：查找并阅读高级别文档，如
README.md、CONTRIBUTING.md、AGENTS.md或架构设计文档。
1.2. 识别技术栈与脚本
通过阅读特定语言的清单文件来识别构建系统和可用脚本：
- JavaScript/TypeScript ：
package.json（查找scripts、dependencies） - Python ：
pyproject.toml、requirements.txt或setup.py - Go ：
go.mod、Makefile - Rust ：
Cargo.toml - Java/Kotlin ：
pom.xml(Maven) 或 (Gradle)
目标 ：找到用于构建、测试和代码检查的具体命令。
1.3. 检查约定
- 路径别名 ：检查配置文件（例如
tsconfig.json、webpack.config.js）以理解导入别名（例如@/components）。 - 风格指南 ：如果可用，检查代码检查器配置（
.eslintrc、.pylintrc）。
2. 影响分析（编辑前）
在每次进行重大编辑（TargetFile）之前执行此分析。
2.1. 识别产物
确定 TargetFile 导出或定义了哪些内容（类、函数、常量、组件）。
2.2. 查找引用（使用情况扫描）
使用 grep_search 查找这些产物在何处被使用。
- 导入搜索 ：
grep_search(SearchPath=".", Query="import .* from .*TargetFileName")（根据语言调整语法，例如 Rust 使用use .*::TargetModule）。 - 符号搜索 ：搜索特定的函数或类名。
2.3. 风险分类
- 低风险 ：仅在一个位置使用（例如，私有辅助函数或叶子组件）。
- 高风险 ：在多个位置使用，是共享工具、核心业务逻辑或公共 API 的一部分。
- 策略 ：对于高风险项，优先选择扩展（可选参数/属性）而非更改现有行为。如果更改是破坏性的，考虑创建新版本（v2）。
3. 安全修改工作流
3.1. 预检查（基线）
在修改相关区域之前，运行项目的代码检查器或测试套件，以确保初始状态是干净的。
- 示例 ：
npm run lint或pytest specific/test_file.py
3.2. 应用更改
使用适当的文件操作工具执行您的编辑。
3.3. 后检查（验证）
- 静态分析 ：再次运行代码检查器/类型检查器。
- 逻辑验证 ：
- 如果存在测试，运行它们：
npm test -- specific/file或go test ./package/... - 如果没有测试，在可行且允许的情况下，考虑添加一个基本的单元测试。
- 如果存在测试，运行它们：
4. 最终交付
当向用户汇报时：
- 总结 ：列出修改过的文件。
- 影响范围 ：根据您的影响分析，明确说明系统的哪些其他部分可能会受到影响。
- 验证 ：确认代码检查/类型检查已通过。
每周安装量
0
代码仓库
首次出现
1970年1月1日
🇺🇸English
Codebase Safety & Exploration
This skill provides a systematic approach to understanding an existing project and ensuring that changes are safe and side-effect-free.
1. Project Onboarding (Context Acquisition)
Before making changes, establish a mental map of the project.
1.1. Map the Structure
- List Files : Run
list_diron the root directory. - Read Documentation : Locate and read high-level docs like
README.md,CONTRIBUTING.md,AGENTS.md, or architecture design docs.
1.2. Identify Tech Stack & Scripts
Identify the build system and available scripts by reading the manifest file specific to the language:
- JavaScript/TypeScript :
package.json(Look forscripts, )
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
