/icode-skill

name: icode
description: ICODE 端到端编码工作流，适配 Claude Code、Codex、CodeBuddy、WorkBuddy。用户调用 /icode、$icode，或说“使用 ICODE”“用 icode 帮我”“让 ICODE”“Use ICODE”完成开发、日志分析、设计/代码审查、证据验证、独立复评、文档/Word/PPT、学习、工单管理等任务时使用；也用于已绑定 ICODE 工单的续接。Use when users explicitly request ICODE for an AI coding workflow, ticket-based development, code review, log analysis, documentation, or evidence verification; also use to resume a bound ICODE ticket. 支持自然语言目标与限制，不要求背命令；能力咨询只解释不执行。保留全部 /icode 子命令，复用既有步骤与安全门禁，不接管未指定 ICODE 的普通请求。

**版本**: v2.42.0

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**：拟定计划 → 审查 → 定稿 → 编码 → 复检 → 终审

> **主流程步骤真源**：`/icode start` / `/icode fast` / `/icode plan` 进入第一步先 `ls steps/*.md`，按实时清单核对步骤编号、产物文件名及 `completed_steps`；不在清单则停下核对，禁止自造占位，本文与目录不一致时以目录为准。 > - 主流程示意：`00_init → 01_plan → 02_review → 03_merge → 04_code → 05_deepcheck → 06_audit → 07_readme → 08_patch`；不存在 `03_code` / `04_test` / `05_deploy`。测试在 code，部署/回归按 readme / patch / verify。 > - 辅助独立步骤不参与 1~6 推进；**fast 为精简全流程**，参与全部六步（见命令表）。

通用约定（对话语言）

DOCX/PPT 技术图可复用 SVG 图源；按对应步骤读取受限校验、PNG 兼容输出和实验双表示合同。PPT 使用 SVG 时同时准备同版本 DOCX 组件。生成、结构、消费者兼容和最终视觉验收分别记录，不因包内有 SVG 就报告原生矢量已验收。

**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)"` 有真实路径输出即可用。

自然语言入口

用户可直接说“使用 ICODE 给这个模块增加重试，先出方案，不改代码”或“用 ICODE 测设备现有版本，不编译、不部署”。由**当前宿主 Agent**理解意图，不新增模型调用或 Runtime 依赖；`/icode <自然语言>` 与原有 `/icode <子命令>` 并存。

**自然语言请求、命令混合描述或上下文续接时，先读 [references/natural_language_entry.md](references/natural_language_entry.md)**：区分咨询与执行 → 解析目标/工程工单/限制/停止点 → 回显简短路由 → 读取原步骤文件并执行原门禁。用户显式工单/路径优先于已绑定工单，均不得被“最新目录”覆盖；歧义先只读定位，仍不唯一才问。否定条件不得丢失，不因一句“继续”扩大已授权范围。

用户明确要求“按计划分阶段开发，每阶段验收确认后再继续”时，读取[阶段真源](references/serial_evidence_stages.md)，由宿主 AI 按各阶段目标选择并冻结既有流程与验收合同，再注册阶段绑定；续接按真实绑定识别当前阶段。不根据文件名、阶段编号或普通“继续”猜测启用，不增加新的公开指令。

裸 `/icode`、`/icode help` 和能力咨询只展示帮助，不建工单；帮助覆盖下表全部能力与上述参考文档的分类示例，用户要完整示例时展开，不能只给 start/plan/code。示例中的请求不是执行授权。普通未点名 ICODE 的新任务不强制接管。

调用命令

正式工单产物保存在 `.icode_output/.icode_output_N/`（N 自动递增）；非工单命令按各自行指定隔离目录。**详细语义一律以 `steps/*.md` 为准，下表只给路由与关键 flag**：

| 命令 | 一句话用途 + 关键 flag | 创建目录？ | |------|------|-----------| | `[辅助]` `/icode help` | 输出命令一览、自然语言分类示例与组合/续接用法（[入口与示例](references/natural_language_entry.md)） | 否 | | `[管理]` `/icode ui` | 启动/复用本地 ICODE 工作台；全局项目/工单管理、手动/默认30秒自动刷新、设置和受控步骤执行 | 否 | | `[辅助]` `/icode install [--client claude\|codex\|codebuddy\|workbuddy\|all] [--basic\|--preview]` | ICODE、宿主命令桥与 MCP 一键安装；`--basic` 跳过 MCP，`--preview` 零写入预览 | 否 | | `[入口]` `/icode log [零散信息...]` | 日志根因分析→转修复需求；版本基线门；TB 复用/批量/`--debug`/`--worktree`；对外简报 | ✅ 每次都新建（同 TB 单复用除外） | | `[入口]` `/icode init [--guide] [<需求或指南约束>]` | 常规：新建并产出 `00_init.md`；`--guide`：复用最新合格 init，刷新新人指南+审计 | 常规 ✅；guide 否 | | `[流程]` `/icode start <需求>` | 全流程：创建/复用目录 → 步骤1~6 串联；`--worktree` | ✅ 创建 / 复用 | | `[流程]` `/icode fast <需求>` | 精简全流程：plan→review(1轮无对抗)→merge→code→deepcheck(Reverse)→audit；`--worktree` | ✅ 创建 / 复用 | | `[流程]` `/icode plan <需求>` | 仅步骤1：拟定计划；`--worktree` | ✅ 创建 / 复用 | | `[流程]` `/icode review [N]` | 仅步骤2：多轮循环审查 + 独立质疑者对抗（N=软上限轮数，默认3） | 用最新目录 | | `[流程]` `/icode merge` | 仅步骤3：合并审查意见定稿 | 用最新目录 | | `[流程]` `/icode code` | 仅步骤4：落地编码实施（含 Code Review Fix 4 维度复检；O-6 用户自担验证豁免） | 用最新目录 | | `[流程]` `/icode deepcheck` | 仅步骤5：三阶段递进复检（Reverse→Fixed→Free；fast 只跑 Reverse） | 用最新目录 | | `[流程]` `/icode audit` | 仅步骤6：终极终审 + 统一修复 | 用最新目录 | | `[可选步骤7]` `/icode readme` | 一次性生成交付报告（自己看）+ `_brief.md` 跨领域简报（给其它模块/测试/产品） | 用最新目录 | | `[独立]` `/icode patch [问题或新需求...]` | 追加修改：轻量四段式；不改变 status；`--listen` 可在修改后自动监听 | 用最新目录 | | `[独立复评]` `/icode crosscheck [--ticket <id>\|<工单路径>]` | 用户自行换 Agent/模型后完整复评 completed 工单；项目内隔离、多轮追加、原工单与代码零回写 | 否（写 `.icode_output/.crosscheck/`） | | `[独立协作]` `/icode outsource [自然语言\|绝对 request.md]` | 同机 AI 发布/认领/交付/接入；人只转交入口，发起端按 requester/parent_ref 找回结果；[步骤](steps/outsource.md) | 否（独立共享 board，不写主工单状态） | | `[独立]` `/icode verify [--build] [--deploy] [--listen\|--test <target>] [自然语言]` / `/icode verify --plan [--ticket <id>]` | **分阶段构建/部署/监听/测试**：选项按顺序只执行各自阶段，可组合；无选项先识别自然语言意图。结果逐阶段记 `verification_runs`，不自动升级 delivery_verdict（[steps/verify.md](steps/verify.md)） | 否（无工单单独 build 只写工程构建报告；plan 只写派生报告） | | `[学习]` `/icode learn [--project <path>] [--ticket <id>] [--since <ISO-8601>]` | 从项目内观测生成复用/组合/增强/新建/工具化/no-action 建议，不直接创建或发布 Skill（[steps/learn.md](steps/learn.md)） | 否（写 `.icode_output/learn/` 派生报告） | | `[学习]` `/icode study [--ticket <id>] [--library <目录>] [主题]` | 从已写代码提炼通用技术文章，按卷/章保存在用户自己的知识库；源码溯源留在库外（[steps/study.md](steps/study.md)） | 否（写用户配置的知识库） | | `[工程]` `/icode doc [自然语言]` | 工程级知识库生成/维护（`project_docs/`+`module_docs/`）；doc_worklist 防中断丢进度 | 否（写全局） | | `[交付]` `/icode docx [自然语言]` | Markdown忠实转换、技术Word编写与修订；章节/文字/源码核对、复杂图示、排版、修订对照及最终页面检查（[步骤](steps/docx.md)） | 否（P0 同级；P1 默认 `.icode_output/docx/`，用户指定位置优先） | | `[配置]` `/icode limit [自然语言]` | 项目约束红线（主存+单 checkout 覆盖）；plan/log 前置硬基线 + `limit_checkpoint.md` 读留痕 | 否（写全局 limits/ + 工程根 limit.local/） | | `[交付]` `/icode ppt [自然语言]` | PPT 生成（4 类场景），8 套模板只换文字 | 否（写 `<工程根>/.icode_output/ppt/`） | | `[查询]` `/icode status` | 只读查状态；`--pending` 汇总验证债务；`--verdict` 可配 `--replacement`/`--dependency` 标注方向结论；`--scan` 批量扫证伪信号；`--validate` 产物集机器校验 | 否（仅 `--verdict` 写 metadata+索引；债务报告