CoreCoder - 编码代理 Skill#

基于 CoreCoder 架构的编码代理，实现 Claude Code 的 7 个核心架构模式。

触发条件#

当用户要求：

• 编写/修改代码
• 修复 bug
• 代码重构
• 代码审查
• 项目结构分析

架构模式#

本 skill 实现 CoreCoder 的 7 个核心模式：

1. 搜索替换编辑#

使用 edit 工具进行精确的代码修改，而非整文件重写。

• 先读取文件理解上下文
• 定位需要修改的具体位置
• 使用最小化的 edit 操作

2. 并行工具执行#

多个独立的文件操作可以并行执行：

• 同时读取多个文件
• 同时搜索多个模式
• 批量修改不相关的代码

3. 三层上下文压缩#

• Layer 1: 只读取相关代码片段，不读取整个文件
• Layer 2: 使用 read 的 offset/limit 参数分页读取
• Layer 3: 对长文件先搜索关键位置，再精确定位读取

4. 子代理隔离#

复杂任务拆分为独立子任务：

• 每个子任务在独立上下文中执行
• 避免主会话上下文污染
• 子任务完成后汇总结果

5. 危险命令拦截#

执行前检查：

• rm -rf / del /f → 拒绝，改用移动到 _bak_
• format / diskpart → 拒绝
• 注册表操作 → 拒绝
• 批量文件操作 → 先 dry-run

6. 会话持久化#

• 每次编码任务记录到 memory/YYYY-MM-DD.md
• 记录：修改了哪些文件、为什么修改、结果如何
• 支持后续查询和回溯

7. 动态系统提示#

根据任务类型动态调整：

• 读取项目结构 → 理解技术栈
• 读取相关文档 → 理解业务逻辑
• 读取已有代码 → 理解编码风格

工作流程#

标准编码流程#

text

1. 理解需求
   - 读取相关文件
   - 搜索相关代码
   - 理解项目结构

2. 制定方案
   - 列出修改点
   - 评估影响范围
   - 确认方案（如需要）

3. 执行修改
   - 使用 edit 工具精确修改
   - 并行处理独立修改
   - 危险操作前确认

4. 验证结果
   - 读取修改后的文件
   - 检查语法正确性
   - 运行测试（如有）

5. 记录结果
   - 更新 memory 日志
   - 提交 git（如适用）

子代理执行模式#

对于复杂任务，使用 sessions_spawn：

text

sessions_spawn:
  task: |
    ## 编码任务
    [具体任务描述]

    ## 上下文
    [相关文件路径、项目结构]

    ## 要求
    - 使用 edit 工具精确修改
    - 修改前先读取理解
    - 危险操作前确认
    - 完成后汇报修改清单
  mode: run
  label: corecoder-task

工具使用#

工具用途示例read读取文件/代码read("src/main.py", offset=1, limit=50)``edit精确修改edit("src/main.py", old="x=1", new="x=2")``write创建新文件write("src/new.py", content="...")``exec执行命令exec("python test.py")``sessions_spawn子任务复杂任务拆分

安全规则#

1. 不删除文件：只移动到 _bak_
2. 不修改系统文件：只在工作目录内操作
3. 危险命令需确认：批量操作前先 dry-run
4. 记录所有修改：写入 memory 日志

示例#

示例 1：修复 bug#

用户： main.py 第 42 行有个 typo，halper 应该是 helper

执行：

1. read("main.py", offset=40, limit=5) → 确认位置
2. edit("main.py", old="from utils import halper", new="from utils import helper")
3. read("main.py", offset=40, limit=5) → 验证修改
4. 记录到 memory

示例 2：重构代码#

用户： 把 utils.py 里的重复代码提取成函数

执行：

1. read("utils.py") → 理解全貌
2. 识别重复模式
3. 制定重构方案
4. edit 提取函数
5. edit 替换调用点
6. 验证无语法错误
7. 记录修改

示例 3：复杂任务（使用子代理）#

用户： 给整个项目添加类型注解

执行：

text

sessions_spawn:
  task: "扫描项目所有 .py 文件，添加类型注解..."
  mode: run
  label: type-annotation-task

注意事项#

• 优先使用 edit 而非 write（保留文件历史）
• 大文件使用 offset/limit 分页读取
• 修改前先 read 理解上下文
• 复杂任务用子代理，避免主会话阻塞