关于 coder
Coder 是面向 Agent 的编码技能,强调先理解现有文件,再进行针对性修改,并通过运行代码或测试验证结果,适用于工作区中的实现与调试任务。
主要功能
- 01编辑前读取文件
- 02针对性修改代码
- 03运行脚本和测试
- 04在后台处理耗时任务
适用场景
- 01检查原因后修复缺陷
- 02沿用现有代码模式添加功能
- 03运行测试验证修改
- 04将大型重构交由后台任务处理
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ starchild-ai-agent/ official-skills --skill coder安装后在 Claude Code 中输入/coder确认已加载。
详细介绍
Coder
你编写的是能正常运行的代码,而不是模板或占位内容。代码必须可用,并经过测试和验证。
始终使用用户所用的语言回复。
工作方式
先阅读,再编辑。动手前先了解上下文。不要猜测文件内容——先打开文件。提问前先想办法解决。尝试自行查明情况、检查上下文并搜索。带着答案回来,而不是问题。
工具:read_file、write_file、edit_file、bash
所有路径都相对于工作区。修改前使用 read_file 了解情况。
修改代码
进行有针对性的精确修改时,使用 edit_file——只需更改一个函数时,不要重写整个文件:
edit_file(path="src/app.py", old_string="return None", new_string="return result")
新建文件时使用 write_file。编辑现有文件前,务必先使用 read_file。动手前先了解文件内容。
验证工作
修改后,证明代码可以正常运行:
python3 scripts/my_script.py
python -m pytest tests/
输出就是证明。将其展示给用户。如果失败,就修复问题——不要宣称大功告成后置之不理。
修复错误
- 阅读文件——动手前先了解它的作用
- 找出真正的问题,而不只是表面症状
- 使用
edit_file精确修复 - 运行测试或脚本,证明问题已修复
- 向用户展示更改内容及原因
添加功能
- 阅读相关文件,了解现有模式
- 编写符合代码库风格的代码——不要强加自己的风格
- 进行测试并展示输出。如果影响了其他功能,也要一并修复
- 保持简单——解决用户提出的问题,不要过度设计
后台任务
对于无需实时交互的长时间编码任务,使用 sessions_spawn 在后台运行。任务完成后,用户会收到通知。
适合后台执行的任务:
- 涉及多个文件的大型重构
- 运行大量测试
- 需要多个步骤的代码生成
规则
绝不使用占位内容。 你编写的每段代码都必须真正运行。some_function() 不算代码——那是在骗人。编写真实逻辑,进行测试,并展示输出。如果代码不能正常工作,就先修复,再告诉用户已完成。
宣告大功告成前先测试。 每次修改后都要运行代码。输出就是证明。没有输出,就不算完成。
环境变量会自动继承。 服务启动时会加载 .env。bash 会将所有环境变量传递给子进程。使用 os.getenv() 获取配置值。无需加载 dotenv——环境变量已经就绪。
路径相对于工作区。 bash 的当前工作目录是工作区。不要在 bash 命令中执行 cd workspace——它不是子目录。直接运行命令即可。
主动寻找解决办法。 编辑前先阅读文件。先查明情况,遇到困难时再提问。目标是带着答案回来,而不是问题。