# ICODE — 有据可查的 AI 编码工作流。 > ICODE 为 Claude Code、Codex 与 CodeBuddy 提供工单驱动的 AI 编码工作流：分步设计、自行换模型后的代码审查、证据化验证与断点续接。 计划、审查、编码、验证，留在同一张可续接的工单里。 Claude Code · Codex · CodeBuddy 本页构建源码版本: v2.32.1 [Website](https://ayukyo.github.io/icode-skill/) ## 六步推进，每一步都有据可查 先定边界，再做实现；每一步留下判断依据。 ### 拟定计划 / plan 把想法变成可检查的实现方案。 - 输入: 目标、限制与现有代码。 - 产物: 01\_plan.md：范围、方案与验证计划。 - 检查点: 明确不做什么、风险在哪里；仅设计请求在此停止。 [查看步骤规则 ↗](https://github.com/ayukyo/icode-skill/blob/main/steps/01_plan.md) ### 审查设计 / review 在动手前找出设计的缺口。 - 输入: 计划与相关源码、接口合同。 - 产物: 02\_review.md：问题、风险与建议。 - 检查点: 让建议能追溯到设计或代码依据，不凭印象放行。 [查看步骤规则 ↗](https://github.com/ayukyo/icode-skill/blob/main/steps/02_review.md) ### 合并定稿 / merge 把审查意见收敛成实施依据。 - 输入: 计划、审查意见与已确认取舍。 - 产物: 03\_plan\_final.md：吸纳意见后的定稿。 - 检查点: 未决问题与范围变更要处理或明确保留。 [查看步骤规则 ↗](https://github.com/ayukyo/icode-skill/blob/main/steps/03_merge.md) ### 编码实施 / code 按定稿实施，让修改与计划对应。 - 输入: 定稿方案与当前代码基线。 - 产物: 源码修改、测试与实际执行记录。 - 检查点: 遵守授权范围，记录执行结果；不能把计划当完成。 [查看步骤规则 ↗](https://github.com/ayukyo/icode-skill/blob/main/steps/04_code.md) ### 深度复检 / deepcheck 回看实现与相关调用链，查漏补缺。 - 输入: 源码变更、设计依据与执行记录。 - 产物: 05\_deepcheck.md 及覆盖记录。 - 检查点: 检查边界、回归和证据缺口；发现问题先修复复测。 [查看步骤规则 ↗](https://github.com/ayukyo/icode-skill/blob/main/steps/05_deepcheck.md) ### 最终审计 / audit 核对交付结论有没有证据支撑。 - 输入: 设计、代码变更和已有验证证据。 - 产物: 06\_audit.md：交付结论及未验证事项。 - 检查点: 区分已验证、待验证与阻塞，不把报告等同设备实测。 [查看步骤规则 ↗](https://github.com/ayukyo/icode-skill/blob/main/steps/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 ``` --listen 或 --test 单独使用时检查设备现有版本，不隐式编译或部署；部署必须明确选择。<target> 需替换为项目的测试目标。 ### 文档与知识交付 从工程文档到 Word、PPT 和可复用知识，按目标选择交付形式。 ``` 使用 ICODE 为本项目整理一份面向新人的使用文档。 ``` ``` /icode doc /icode docx /icode ppt /icode study ``` 生成成功不等于视觉验收通过；纯文本模型不能直接检查图片，需保留视觉复核边界。 ### 工单管理与续接 查看状态、待验证事项，或在本地工作台管理和续接工单。 ``` /icode status --pending ``` ``` /icode list /icode ui 续接已绑定的 ICODE 工单，先核对状态和执行回执，再从中断点继续。 ``` 官网不连接本机 UI，不读取工单；跨会话续接仍保持原授权范围和停止点。 ## 让开发过程不止于一段对话 ### 说目标，不必背命令 点名 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 命令。 [完整中文文档](https://github.com/ayukyo/icode-skill/blob/main/README.zh-CN.md) ## 从一句话开始，也可以精确到一步 ### 只做设计 ``` 使用 ICODE 给这个模块增加重试，先出方案，不改代码。 ``` ### 开发完整流程 ``` /icode start 给计算器增加取模功能并补充测试 ``` ### 监听现有设备版本 ``` /icode verify --listen ``` ### 自行换模型后独立复评 ``` /icode crosscheck ``` ### 查看待验证事项 ``` /icode status --pending ``` ### 中断后续接工单 ``` 续接已绑定的 ICODE 工单，先核对状态和执行回执，再从中断点继续；保持原范围和停止点。 ``` ### 打开本地工作台 ``` /icode ui ``` 门禁与报告帮助核验，不保证代码没有缺陷。工具缺失、未执行验证和证据不足应明确保留；宿主、模型与真实设备表现需要各自验证。 ## 版本笔记 ### v2.32.1 / 2026-10-08 修复 Word 兼容渲染器的自动安装、哈希校验与同步后登记保留；公开发行加入真实渲染验收。当前渲染配方覆盖 Ubuntu 兼容的 Linux x86\_64，其他平台仍明确待补。 ### v2.32.0 / 2026-09-20 自然语言入口：点名 ICODE 并描述目标和限制，复用已有命令与门禁。日期为本条公开说明的审阅日期，不是版本发布日期。 静态官网，无登录、无追踪。不会读取或上传你的 ICODE 工单。 [MIT](https://github.com/ayukyo/icode-skill/blob/main/LICENSE)