icode

版本: v2.32.3

ICode 全流程编码工作流（步骤 0 + 1~6）

端到端编码工作流，将需求到交付拆解为严格步骤，每步可单独调用，方便你自行切换模型。本文档是路由器：内核规则内联，详细规则一律放 steps/*.md 与 references/*.md，需要时按路由表 Read（懒加载，省 token）。

先判适用性，再读流程：用户明确“不用 ICODE / Do not use ICODE”时，以下工作流不适用于本次请求；直接回答其普通问题，不套用 ICODE 专用术语、步骤或产物，也不附带工作流推荐。技能即使已被宿主加载，也不能覆盖用户退出意图；用户单独问 ICODE 概念时仅解释所问部分，不执行流程。

• 步骤 0（可选）：需求初稿对话，落档为 00_init.md；init --guide 派生新人指南
• 步骤 1~6：拟定计划 → 审查 → 定稿 → 编码 → 复检 → 终审

主流程步骤真源（防误用，唯一真源 = steps/ 目录，启动强制 Read）：步骤编号 / 产物文件名 / completed_steps 合法值一律以 steps/*.md 实时清单为准（ls steps/*.md 完整列出，含主流程与辅助入口 log / doc / docx / limit / status / install / list / bak / verify / learn / study / crosscheck，及精简全流程入口 fast）——本块仅示意，steps/ 演进后以目录为准，勿依赖写死。/icode start / /icode fast / /icode plan 进入第一步先 ls steps/*.md 核对，不按"编码→测试→部署"直觉推断

• 当前主流程示意（以 ls steps/*.md 为准）：00_init → 01_plan → 02_review → 03_merge → 04_code → 05_deepcheck → 06_audit → 07_readme → 08_patch；不存在 03_code / 04_test / 05_deploy（测试验证在 04_code 子段，部署/回归归 07_readme / 08_patch / verify）
• 辅助独立步骤（doc / docx / log / limit / status / install / list / bak / verify / learn / study / crosscheck）不参与 16 推进；fast 为精简全流程（非辅助独立步骤）——参与 16 但各步缩略（见命令表 fast 行）
• 强制：产物命名 + completed_steps 写号对照 ls steps/*.md 实时结果（如入口含 log → 可写 "log"），不在清单 → 停下核对，禁止自造产物占位；steps/ 目录与本文档不一致时以 steps/ 目录为准

通用约定（对话语言）

AI 对用户的回复一律使用中文（提示 / 解释 / 报告 / 追问 / 总结 / 决策说明 / 输出行）。工程内容保持原样、不翻译：代码、标识符、产物文件名、命令、日志原文、报错原文、设备输出、配置字段值。仅当用户明确要求英文回复时切换。

适用所有 /icode 命令的会话交互与步骤内对用户的询问/报告；产物文件正文遵循既有中文风格撰写。

Python 解释器解析（跨平台硬规则）

skill 内所有 python3 tools/... 形式的命令，执行前必须按平台解析解释器：Linux/macOS 用 python3；Windows 用 py -3（已设 ICODE_PYTHON_BIN 时以它为准）。本文档与 steps/*.md 中保留 python3 写法是跨平台通用形式，不逐处改写，执行时按本规则解析。

Windows 上裸 python / python3 常解析到 %LOCALAPPDATA%\Microsoft\WindowsApps 的应用执行别名（假 stub），表现为退出码 0、无任何输出。出现这种"静默成功"一律视为失败：改用 py -3 重跑同一命令，不得据此判定步骤完成，也不得把空输出当作通过证据。可用性判定：py -3 -c "import sys; print(sys.executable)" 有真实路径输出即可用。