ICODE

Claude Code · Codex · CodeBuddy 开源工作流

有据可查的 AI 编码工作流。

计划、审查、编码、验证，留在同一张可续接的工单里。

  • Claude Code
  • Codex
  • CodeBuddy
开始使用 →工作流程 ↗

本页构建源码版本 · v2.32.1

六步推进，每一步都有据可查

先定边界，再做实现；每一步留下判断依据。

展开六步的输入、产物与检查点
  1. 拟定计划
  2. 审查设计
  3. 合并定稿
  4. 编码实施
  5. 深度复检
  6. 最终审计
01拟定计划plan

把想法变成可检查的实现方案。

输入
目标、限制与现有代码。
产物
01_plan.md：范围、方案与验证计划。
检查点
明确不做什么、风险在哪里；仅设计请求在此停止。
查看步骤规则 ↗
02审查设计review

在动手前找出设计的缺口。

输入
计划与相关源码、接口合同。
产物
02_review.md：问题、风险与建议。
检查点
让建议能追溯到设计或代码依据，不凭印象放行。
查看步骤规则 ↗
03合并定稿merge

把审查意见收敛成实施依据。

输入
计划、审查意见与已确认取舍。
产物
03_plan_final.md：吸纳意见后的定稿。
检查点
未决问题与范围变更要处理或明确保留。
查看步骤规则 ↗
04编码实施code

按定稿实施，让修改与计划对应。

输入
定稿方案与当前代码基线。
产物
源码修改、测试与实际执行记录。
检查点
遵守授权范围，记录执行结果；不能把计划当完成。
查看步骤规则 ↗
05深度复检deepcheck

回看实现与相关调用链，查漏补缺。

输入
源码变更、设计依据与执行记录。
产物
05_deepcheck.md 及覆盖记录。
检查点
检查边界、回归和证据缺口；发现问题先修复复测。
查看步骤规则 ↗
06最终审计audit

核对交付结论有没有证据支撑。

输入
设计、代码变更和已有验证证据。
产物
06_audit.md：交付结论及未验证事项。
检查点
区分已验证、待验证与阻塞，不把报告等同设备实测。
查看步骤规则 ↗
按需使用，不是额外必经步骤

可选前置 · init / log

复杂需求先整理，日志问题先核对设备与源码版本；按任务选择入口，不必强行经过所有命令。

独立验证 · verify

显式选择编译、部署、监听或测试，可独立或组合执行。只监听、测试时直接使用设备现有版本，不隐式编译或部署。

高级可选复评 · crosscheck

仅对已完成工单独立复评。可自行换 Agent 或模型，多轮结果单独保存；不改原工单历史或代码，不自动切换模型。

能做什么

按目标选择入口。展开查看命令与边界；示例不是执行证据。

开发与设计

工单驱动开发，也可以只要方案。把目标和停止点一起告诉 Agent。

更多用法与边界使用 ICODE 给这个模块增加重试，先出方案，不改代码。
/icode start 给计算器增加取模功能并补充测试
/icode plan

start 串联主线，plan 可单步使用；明确“只设计”时不得越过停止点。

日志与排障

先确认版本、时间窗口和证据来源，再分析异常与可能原因。

更多用法与边界使用 ICODE 分析这份异常日志，先定位原因，不修改代码。
/icode log

当前源码、部署版本、历史日志不是同一层证据；缺少现场数据时保留不确定性。

设计与代码复评

review 审查当前阶段设计；crosscheck 对已完成工单做独立、多轮复评。

更多用法与边界/icode review
/icode crosscheck

多模型代码审查时先自行切换 Agent/模型。ICODE 不会自动切换模型；crosscheck 不改原工单历史或代码。

构建与设备验证

按需选择动作，让验证记录对应实际执行。

更多用法与边界/icode verify --listen
/icode verify --build
/icode verify --build --deploy --listen
/icode verify --deploy --test <target>

--listen 或 --test 单独使用时检查设备现有版本，不隐式编译或部署；部署必须明确选择。<target> 需替换为项目的测试目标。

文档与知识交付

从工程文档到 Word、PPT 和可复用知识，按目标选择交付形式。

更多用法与边界使用 ICODE 为本项目整理一份面向新人的使用文档。
/icode doc
/icode docx
/icode ppt
/icode study

生成成功不等于视觉验收通过；纯文本模型不能直接检查图片，需保留视觉复核边界。

工单管理与续接

查看状态、待验证事项，或在本地工作台管理和续接工单。

更多用法与边界/icode status --pending
/icode list
/icode ui
续接已绑定的 ICODE 工单，先核对状态和执行回执，再从中断点继续。

官网不连接本机 UI，不读取工单；跨会话续接仍保持原授权范围和停止点。

了解 ICODE 如何保护工作边界

让开发过程不止于一段对话

说目标，不必背命令

点名 ICODE，说清想做什么、不要做什么。宿主 Agent 映射到原步骤，保留停止点和安全门禁。

工单驱动开发与断点续接

设计、代码与复检记录随工单保存。跨会话恢复时，先核对状态、执行回执和未完成事项，再续接已授权范围。

多模型代码审查

先在宿主中自行切换 Agent/模型，再用 /icode crosscheck 复评已完成工单。ICODE 不会自动切换模型；复评多轮独立保存，不改原工单历史或代码。

以证据记录验证

编译、部署、监听、测试显式组合，记录实际结果与证据缺口。仅监听或测试时，不隐式编译与部署。

本地工单工作台

可选 /icode ui 提供本地管理入口，仍通过已有步骤与门禁。不需要为官网上传工单。

适配已有工作方式

在 Claude Code、Codex 或 CodeBuddy 中使用。独立步骤可以换模型；Runtime 和额外模型服务不是自然语言入口的前提。

专题指南

交付的不只是代码，还有判断依据

设计依据

代码与测试

验证记录

未验证事项

通用计算器示意，非真实工单或测试结果。报告存在不代表设备已验证。

这些交付记录里有什么？

设计依据

为什么增加取模、输入限制是什么、审查意见如何处理。计划与定稿随工单保留。

代码与测试

变更哪些源码、覆盖哪些边界、运行了哪些命令。执行记录与实际修改对应。

验证记录

分别记录构建、部署与测试证据；带上实际版本和结果，不用“已完成”替代数据。

未验证事项

若未接入真实目标设备，就明确标为未验证。把后续验证条件与限制一并交付。

先安装，再在你的项目里开始

系统终端 · 先预检，再安装

git clone https://github.com/ayukyo/icode-skill ~/icode-skill
cd ~/icode-skill
./install.sh --dry-run --client all
./install.sh --client all
安装与使用须知

需要已配置的 AI 编码宿主及其模型访问。安装可能下载运行时和可选 MCP 依赖。all 默认安装 Claude Code 与 Codex；检测到 CodeBuddy 配置才追加它，也可单独使用 --client codebuddy。安装默认仅 Claude。

安装后 · 在宿主 Agent 的项目会话输入

/icode help
使用 ICODE 给这个模块增加重试，先出方案，不改代码。
安装与使用须知

重启或重新加载宿主技能；未触发时显式选用技能或输入 /icode。仅在点名 ICODE 或续接已绑定的 ICODE 工单时使用，不接管未指定 ICODE 的普通请求。这些是宿主 Agent 指令，不是系统 shell 命令。

完整中文文档 ↗
从一句话开始，也可以精确到一步

按目标选择入口。展开查看命令与边界；示例不是执行证据。

只做设计

使用 ICODE 给这个模块增加重试，先出方案，不改代码。

开发完整流程

/icode start 给计算器增加取模功能并补充测试

监听现有设备版本

/icode verify --listen

自行换模型后独立复评

/icode crosscheck

查看待验证事项

/icode status --pending

中断后续接工单

续接已绑定的 ICODE 工单，先核对状态和执行回执，再从中断点继续；保持原范围和停止点。

打开本地工作台

/icode ui

门禁与报告帮助核验，不保证代码没有缺陷。工具缺失、未执行验证和证据不足应明确保留；宿主、模型与真实设备表现需要各自验证。

版本笔记

v2.32.1

修复 Word 兼容渲染器的自动安装、哈希校验与同步后登记保留；公开发行加入真实渲染验收。当前渲染配方覆盖 Ubuntu 兼容的 Linux x86_64，其他平台仍明确待补。

v2.32.0

自然语言入口：点名 ICODE 并描述目标和限制，复用已有命令与门禁。日期为本条公开说明的审阅日期，不是版本发布日期。