Iterate Skill

一个可移植、可配置的 AI 编程助手技能：全自动多轮代码审查与修复。 A portable, configurable AI coding assistant skill: fully automated multi-round code review and fixing.

⭐ 如果这个项目对你有帮助，欢迎点亮 GitHub Star，让 iterate 被更多开发者看见。你的支持就是持续开源迭代最大的动力！

这是什么 / About This Project

iterate 是一个让 AI 编程助手具备多轮自主代码审查与修复能力的开源项目。你无需从任何"iterate"概念开始——它解决的是一个很具体的痛点：

AI 助手往往"说得多、做得浅"：一次对话只改几行、看过一个文件就不再管全局，也很少回头复核自己改坏的东西。/iterate 把这些琐碎但关键的收尾工作——逐项审查、分维度排查、修复、验证、再迭代——自动化，让 AI 真正像一位资深工程师一样把改动做完、做对。

它的运行机制可以概括为一条自闭合流水线：

定目标 → 多维度并行审查 → 原子修复 + 架构修复（需你批准）→ 验证 → 再审查 → 循环直到收敛 / 达轮数上限 → 输出总结

iterate 不是一个独立的工具，而是一套附着在现有 AI 助手之上的技能生态。 它不会替换你的 IDE 或 AI 工具，而是在你已有的工作流里，加一层"严格的代码把关"。整个生态由三个组件构成，共用同一套配置与审查维度：

组件	形态与位置	面向场景
Core Skill + CLI	可移植 AI 技能 `/iterate` + `iterate` 命令行（本仓库根目录）	在 Trae / Claude Code / Cursor / Copilot / Codex 等 25+ 助手的对话式界面里多轮迭代
iterate-harness	独立无头引擎，命令 `ih`（`harness/iterate-harness`，npm: `iterate-harness`）	在终端 / CI / Git 钩子里，脱离对话式助手运行同一套闭环
iterate-plugin	dsh 桌面客户端插件（`harness/iterate-plugin`，npm: `iterate-plugin`）	使用 dsh 桌面客户端，把 iterate 的收敛仪表盘、review 进度带进界面

三者的关系：skill（本仓库核心交付物）面向任意 AI 助手的对话式迭代；harness 面向无头 / CI 场景的同一闭环引擎实现；plugin 把 harness 的运行时体验接入 dsh。配置（iterate.config.yaml）与维度体系在三者间完全一致——理解其一即可举一反三。

其中，harness 与 plugin 也可脱离本仓库独立安装使用：

# iterate-harness：一键安装（npm 包装器，最简）
npm install -g iterate-harness

# 或脚本安装（oh / ohmo 已全面迁移为 ih）
curl -fsSL https://raw.githubusercontent.com/jingzhao-l/iterate-harness/main/scripts/install.sh | bash
ih iterate init && ih iterate review

# iterate-plugin：dsh 桌面插件的 GitHub 安装
dsh plugin --profile web add github:jingzhao-l/iterate-plugin#main

本文档接下来以 skill（本仓库根目录） 为核心，讲解最常用的对话式用法。harness 与 plugin 的详细文档见它们各自的 README（harness/iterate-harness/README.md、harness/iterate-plugin/README.md）。

30 秒了解 / At a Glance

Iterate Skill 让 AI 助手像一位严谨的资深工程师一样，对代码库进行多轮审查与修复。

能力	说明
9 维度并行审查	correctness、security、performance、architecture、style-tests、tech-debt、spec-compliance、frontend-backend、ui-ux
双轨修复	原子问题（≤20 行、单文件）自动修；架构问题经你批准后再修
Git 隔离	每轮在独立 `iterate/*` 分支或 worktree 中完成；merge/push 默认关闭，需显式开启
Secure-by-default	`push_per_round` 和 `auto_merge` 默认均为 `false`
命令白名单	配置时 + 个性化时双层校验，拒绝危险 shell 元字符
校验和验证	从 GitHub Release 更新时强制 SHA256 校验
多助手支持	Trae、Claude Code、Cursor、Windsurf、GitHub Copilot、Codex、Roo Code 等 25+ 工具
项目知识库	自动生成 `ITERATE.md` + `iterate.config.yaml`，支持漂移检测和增量刷新

3 分钟上手 / Quick Start

1. 安装技能

npx iterate-skill-installer

运行后会自动检测你已安装的 AI 编程工具，交互选择要安装到哪些助手。支持 --ai <name> 直接指定单个助手。安装器还会自动安装 iterate CLI（用于下面第 2 步的 iterate onboard 等命令），一条命令即可完成 skill + CLI 的安装。

2. 进入项目并完成 onboarding

cd /path/to/your-project
iterate onboard

iterate onboard 会生成本项目的知识库：

ITERATE.md：技术栈、模块地图、约定、禁区等
iterate.config.yaml：迭代目标、审查维度、验证命令等

3. 开始迭代

在 AI 助手对话中输入：

/iterate "提升代码质量，确保所有函数 ≤80 行且测试通过"

或在终端里直接启动 CLI：

iterate status      # 查看 onboarding 状态和漂移
iterate refresh     # 增量刷新 ITERATE.md
iterate personalize # 追加项目专属约束

安装 / Installation

推荐：npx 一键安装（适合绝大多数用户）

无需克隆仓库，无需手动配置 Python 环境，一条命令完成 skill 下载、校验、安装，并自动安装 iterate CLI：

# 自动检测已安装的 AI 助手并交互选择
npx iterate-skill-installer

# 仅安装到 Trae
npx iterate-skill-installer --ai trae

# 安装到指定项目目录
npx iterate-skill-installer --target /path/to/project

# 强制覆盖已安装的技能
npx iterate-skill-installer --ai trae --global --force

常用选项：

选项	说明
`--ai <name>`	仅安装到指定助手，如 `trae`、`claude`、`cursor`
`--target <path>`	项目级安装到指定目录
`--global`	安装到用户主目录（默认）
`--force`	覆盖已存在的 skill 文件
`--token <token>`	GitHub token，用于提高 API 速率限制
`-h, --help`	查看帮助
`-v, --version`	查看版本

安装器会安装 iterate CLI 到你的 PATH（优先 pipx 隔离安装，否则 pip install --user）。这是为了让 npx iterate-skill-installer 一条命令完成 "skill + CLI"，但安装器确实会在你的系统上放置一个可执行文件。若不希望自动安装 CLI，可改用下方的"手动复制 SKILL.md"或"源码脚本"方式。

安装器需要 Node.js 18+ 和 Python 3.10+。它会自动创建隔离的 Python 虚拟环境、安装依赖、调用 scripts/install.py 完成文件复制。下载 release 时强制校验 SHA256SUMS.txt，校验失败则拒绝安装。若 iterate 命令安装失败，仍可手动执行 pipx install . 或 pip install . 补装。

其他安装方式

如果你无法使用 npm，或者希望完全控制安装过程，可选用以下方式。

方式 A：本地安装 iterate CLI

通过 npx 一键安装时已自动安装 iterate CLI。若你未使用 npx，或希望手动/升级安装 CLI，可在此手动安装：

git clone https://github.com/jingzhao-l/iterate-skill.git
cd iterate-skill

# 推荐用 pipx 隔离安装
pipx install .

# 或直接用 pip
pip install .

# 验证
iterate --version

安装后可在任意项目目录使用 iterate onboard、iterate personalize、iterate status、iterate refresh、iterate reonboard。

方式 B：手动复制 skill 目录

⚠️ 必须复制整个 iterate/ 目录，而不是只复制 SKILL.md。 SKILL.md 运行时依赖同目录下的 config/、scripts/validate.py、templates/（按安装目录相对路径解析）。只拷一个文件会导致 /iterate 找不到配置与校验脚本而失败。

如果你不想用 npx 安装器，把整个 skill 目录复制到对应助手目录即可：

# 先在本地克隆或下载源码，得到含 SKILL.md、config/、scripts/、templates/ 的 iterate/ 目录
git clone https://github.com/jingzhao-l/iterate-skill.git
SKILL_DIR=$(pwd)/iterate-skill

# Trae
mkdir -p ~/.trae/skills/iterate
cp -R "$SKILL_DIR"/SKILL.md "$SKILL_DIR"/config "$SKILL_DIR"/scripts "$SKILL_DIR"/templates ~/.trae/skills/iterate/

# Claude Code
mkdir -p ~/.claude/skills/iterate
cp -R "$SKILL_DIR"/SKILL.md "$SKILL_DIR"/config "$SKILL_DIR"/scripts "$SKILL_DIR"/templates ~/.claude/skills/iterate/

# Cursor
mkdir -p ~/.cursor/skills/iterate
cp -R "$SKILL_DIR"/SKILL.md "$SKILL_DIR"/config "$SKILL_DIR"/scripts "$SKILL_DIR"/templates ~/.cursor/skills/iterate/

更多工具的路径请参考 SKILL.md 中的“工具映射表”。

方式 C：源码脚本（开发者）

git clone https://github.com/jingzhao-l/iterate-skill.git
cd iterate-skill

python scripts/install.py install --ai trae --global
python scripts/install.py update --ai trae --target /path/to/project
python scripts/install.py uninstall --ai trae --target /path/to/project --yes

全局安装 vs 项目级安装

安装范围	路径示例	效果
全局安装	`~/.trae/skills/iterate/`	所有项目首次调用 `/iterate` 都会触发 onboarding
项目级安装	`/project/.trae/skills/iterate/`	onboarding 完成后直接复用项目根目录的 `ITERATE.md`

建议：先在全局安装一次，让助手认识你；再在重要项目里做一次项目级安装，避免重复 onboarding。

为什么不推荐 skills.sh 安装？

本项目早期曾在 skills.sh / SkillHub 等平台分发。从 v2.1 起，推荐统一使用 npx iterate-skill-installer，原因如下：

一条命令完成：自动下载、SHA256 校验、环境准备、助手选择，无需手动克隆或复制文件。
版本一致：始终从 GitHub Release 安装，避免平台缓存导致的版本错乱。
跨助手统一：同一份安装逻辑支持 25+ AI 助手，而不是每个平台各自维护。
安全可验证：强制校验 SHA256SUMS.txt，校验失败则拒绝安装。

skills.sh 等市场页面仍会保留，用于展示和发现，但不再作为首选安装入口。

日常使用 / Daily Usage

在 AI 助手中

安装 skill 后，在支持该技能的 AI 工具中输入：

/iterate "你的目标"
/iterate "你的目标" 10
/iterate "你的目标" no-limit
/iterate "审查代码质量" review-only    # 纯审查模式：反复审查到零 findings，只读不改代码
/iterate "full health check" --dry-run # 纯审查别名：出审查报告 + meta-review 最终审查报告

首次调用会自动触发 onboarding（如果项目还没有 ITERATE.md）。

纯审查模式 / review-only（dry-run）：调用参数含 review-only 或 dry-run 时，本 skill 只做只读健康检查，绝不修改任何文件。它会反复并行审查直到某一轮 0 个新 findings（收敛），生成审查报告；随后再审查这份报告本身（meta-review，校验报告内部一致性），给出带 approved / needs_revision 判定的最终审查报告。适用于发布前体检、代码质量审计、不想让 AI 动代码的场景。

在终端中

# 交互式 onboarding（首次/非首次会自动分支）
iterate onboard

# 中途追加个性化约束
iterate personalize

# 查看 onboarding 状态和漂移检测
iterate status

# 增量刷新（保留 ITERATE.md 用户手写区）
iterate refresh

# 完整重新 onboarding（备份旧文件）
iterate reonboard

它如何工作 / How It Works

Onboarding（项目知识库初始化）

每次调用 /iterate 时，skill 会检查项目根目录是否存在 ITERATE.md。若不存在，触发 onboarding。

通道	适用场景	产出
AI Onboarding	希望 AI 根据项目目录结构/清单文件自动识别技术栈并生成	`ITERATE.md` + `iterate.config.yaml`
CLI Onboarding	希望 CLI 扫描后手动确认/调整技术栈与配置	同上

扫描仅读取文件/目录存在性和 README.md 等少量公开上下文文件，不会读取 .env、密钥、凭证或其他敏感文件内容。项目专属约束可通过 iterate personalize 补充。

ITERATE.md 分为两个区域：

：AI 维护区，刷新时会更新。
：用户维护区，手写约定、禁区、风险区，刷新时保留。

漂移检测

每次调用 /iterate 时，会重新计算 package.json、pyproject.toml 等 manifest 文件的 SHA-256 指纹：

无漂移 → 静默通过
有漂移 → 提示用户选择：继续 / 增量刷新 / 完整重新 onboarding

个性化配置

AI 扫描能发现技术栈和目录结构，但无法发现项目专属约束。iterate personalize 把这些知识沉淀下来：

类别	说明	存储位置
禁区	iterate 不得修改的文件/目录	`iterate.config.yaml`
风险区	改动需架构审批	`iterate.config.yaml`
已知意图	抑制误报	`iterate.config.yaml`
维度定制	为特定维度追加 focus	`iterate.config.yaml`
优先修复顺序	维度修复优先级	`iterate.config.yaml`
禁止的修复方式	不可使用的手法	`iterate.config.yaml`
项目约定与注意点	经验教训、已知陷阱	`ITERATE.md` 用户区
补充验证命令	项目特有验证命令	`iterate.config.yaml`

完整示例请参考 config/iterate.config.yaml。

核心流程

Step 0 — Onboarding Check
  └─ 定位项目根 → 检查 ITERATE.md → 漂移检测 →（缺失则触发 onboarding）

Setup
  └─ 提取 goal → 加载配置 → 读取项目上下文 → 创建隔离分支/worktree

Loop (round = 1 .. max_rounds)
  ├─ Phase 1: N 维度并行审查
  ├─ Phase 2: 原子问题自动修复
  ├─ Phase 3: 架构问题用户批准后执行
  ├─ Phase 4: 记录本轮结果
  └─ Phase 5: 验证 → merge（若 auto_merge=true）→ push（若 push_per_round=true）

Summary

详细流程请参考 SKILL.md。

配置参考 / Configuration

默认配置位于 config/iterate.config.yaml。项目级配置会递归覆盖 Master 配置的同名字段。

常用配置项：

配置项	类型	默认值	说明
`goal`	string	`"Improve code quality"`	迭代目标
`max_rounds`	int	`7`	最大轮数（上限 50）
`language`	string	`"en"`	输出语言：`zh` / `en`
`dimensions`	list	9 维度	启用的审查维度
`review.scope`	string	`"full"`	`full` 全量 / `changed-only` 增量
`atomic.max_lines`	int	`20`	原子问题最大行数
`git.target_branch`	string	`main`	合并目标分支
`git.push_per_round`	bool	`false`	每轮通过后是否 push
`git.auto_merge`	bool	`false`	验证后是否自动 merge
`validation.command_whitelist`	list	常用前缀	允许执行的命令前缀
`validation.commands`	object	示例	按语言分组的验证命令
`onboarding.drift_check`	bool	`true`	是否检查 manifest 漂移

示例：

goal: "提升代码质量，确保所有函数 ≤80 行且测试通过"
max_rounds: 7
language: zh

dimensions:
  - correctness
  - security
  - performance
  - architecture
  - style-tests
  - tech-debt
  - spec-compliance
  - frontend-backend
  - ui-ux

validation:
  command_whitelist:
    - "ruff"
    - "mypy"
    - "pytest"
    - "swift"
    - "npm run"
  commands:
    python:
      - "ruff check src/"
      - "mypy src/ --ignore-missing-imports"
      - "pytest tests/ -x -q --timeout=60"
    swift:
      - "swift build -c debug"
    typescript:
      - "npm run compile"

validation.commands 中的命令必须以 command_whitelist 中的前缀开头，否则会被拒绝。

常见问题 / FAQ

安装 / Installation

Q: 安装时提示要访问 GitHub 等国外网络，国内网络环境装不上怎么办？ A: 安装器通过 GitHub Release 下载并校验，确实需要能访问 GitHub 的网络。若网络受限，可改用不依赖 GitHub 的方式：

手动复制 SKILL.md 到对应助手目录（见"方式 B"）。
国内镜像渠道（ModelScope / SkillHub CN）已上架，可从中获取 skill 文件。
社区代理镜像下载后，再执行 python scripts/install.py install 本地安装。

Q: npx iterate-skill-installer 报 Python 或 Node 版本不符合？ A: 安装器要求 Node.js 18+ 和 Python 3.10+。请先升级系统 Python/Node，或在终端确认 python3 / node 在 PATH 中。安装器会优先使用 python3，再回退到 python。

Q: 安装器会自动安装 iterate CLI 到我的电脑上，我能不装吗？ A: 可以。npx iterate-skill-installer 会顺带安装 iterate CLI（优先 pipx，否则 pip install --user）以便直接运行 iterate onboard。若不希望自动安装 CLI，请改用"手动复制 SKILL.md"或"源码脚本"方式，仅复制 skill 文件即可。

Q: 安装到一半想取消，会留下半成品吗？ A: 不会。安装器在临时目录中完成下载、校验、解压，选中助手后才会写入助手目录；取消或失败时不会覆盖已安装的 skill。若已安装过，重装默认提示覆盖，需确认或加 --force。

使用 / Usage

Q: 这个 Skill 适合什么场景？不适合什么场景？ A: 适合多轮的代码审查与自动修复——例如压制技术债、多轮消除 lint/类型/测试问题、项目级重构。不适合单次简单改动（改一行、加个注释），这类需求直接用普通对话即可，无需 /iterate。

Q: 第一次使用为什么什么都不做？ A: 首次调用 /iterate 或运行 iterate onboard 前，项目还没有 ITERATE.md 与 iterate.config.yaml。首次使用时 skill 会先进行项目初始化（Onboarding）：AI 会明确告知"这是首次使用，将先初始化项目"，扫描代码库生成 ITERATE.md 与配置后再进入迭代。若你看到初始化提示而不是立刻审查，这是正常流程，不是失效；也可直接在项目根目录运行 iterate onboard 手动完成初始化。

Q: 处理大项目时感觉卡住，没有进度提示？ A: 大项目首轮要并行审查多个维度，可能耗时较长。为缓解"卡住"观感，skill 现在会在对话中持续输出进度：每轮开始显示 ▶ Round N/max、并行审查期间逐维度提示 ⏳ 正在审查 …、每轮结束显示 ✅ Round N complete。若仍觉慢，可通过以下方式提速：

在 iterate.config.yaml 中把 review.scope 设为 changed-only，只审查本轮改动。
按目录/模块拆分 reviewer 任务（见 SKILL.md 的 Reviewer Prompt 检查清单）。
适当降低 max_rounds，避免无谓的额外轮次。

Q: 运行时提示有漂移（drift）是什么意思？ A: 漂移检测会对比 package.json、pyproject.toml 等 manifest 文件的 SHA-256 指纹。若依赖或配置发生变化，说明项目状态与上次 onboarding 不一致，会提示你选择：继续 / 增量刷新（iterate refresh）/ 完整重新 onboarding（iterate reonboard）。

Q: 修改没有合并到主分支，也没推送到远程？ A: 这是安全默认行为：git.auto_merge 与 git.push_per_round 默认均为 false，改动保留在隔离的 iterate/* 分支或 worktree 中，由你 review 后决定是否合并/推送。如需自动合并推送，请在 iterate.config.yaml 中显式开启这两个选项。

Q: 我手动改了 iterate.config.yaml，为什么某些验证命令不生效？ A: validation.commands 中的命令必须以 validation.command_whitelist 中的前缀开头，否则会被拒绝。个性化添加的 extra_validation_commands 也只会接受 30+ 预批准工具前缀，拒绝 ;、|、& 等 shell 元字符——这是为了安全，防止项目配置被执行任意命令。

Q: 想增加一个新的验证工具（比如 sphinx），怎么办？ A: 严格白名单只接受预批准的工具前缀（这防止项目配置执行任意命令）。新增工具有两种安全方式：

操作者级环境变量（推荐，无需改源码）：在运行环境中设置 ITERATE_EXTRA_SAFE_COMMAND_PREFIXES=sphinx（逗号/空格分隔多个工具名）。该变量只能在系统层面设置，项目配置文件无法设置，因此不会破坏安全模型；含 ;、|、& 等元字符的条目会被直接丢弃（fail-closed）。
源码级扩展：在 iterate_cli/personalize.py 的 KNOWN_SAFE_COMMAND_PREFIXES 中追加工具名后重新安装。
或改用 validation.command_whitelist + validation.commands 直接配置（需通过 python scripts/validate.py config 校验）。

安全 / Security

Q: 这个 Skill 会读取我的密钥、.env 吗？ A: 不会。skill 及 onboarding 扫描仅读取 manifest 文件的存在性和 README.md / CLAUDE.md 等公开上下文文件，明确不读取 .env、*.key、secrets/、*.pem 等敏感文件。projectContext 也不会包含 API 密钥、密码、Token。

Q: 下载更新时安全吗？ A: 安全。scripts/install.py update 与 npx iterate-skill-installer 从 GitHub Release 下载预上传的 iterate-skill.tar.gz + SHA256SUMS.txt，下载后强制 SHA256 校验，缺失或不匹配则拒绝安装。

安全说明 / Security

高自主性：本 skill 会自主执行文件编辑、git 操作以及 validation.commands 中配置的命令。所有修改先在隔离分支/worktree 中进行，架构修复必须经用户批准。
Secure-by-default Git：push_per_round 和 auto_merge 默认均为 false；merge/push 为 opt-in，未显式开启时改动保留在迭代分支。回滚使用 git restore 等非破坏性命令。
双层命令白名单：
- 配置时校验命令前缀。
- 个性化添加 extra_validation_commands 时仅接受 30+ 预批准工具前缀，拒绝 ;、|、& 等 shell 元字符；命令加载/合并时也会重新校验，手工编辑的配置无法绕过白名单。
敏感文件：skill 及其 installer 不读取 .env、密钥、凭证等敏感文件；onboarding 扫描仅检查 manifest 等公开文件的存在性。
Update 安全：scripts/install.py update 与 npx iterate-skill-installer 从 GitHub Release 下载预上传的 iterate-skill.tar.gz + SHA256SUMS.txt，下载后强制 SHA256 校验，缺失或不匹配则拒绝安装。
安装器披露：npx iterate-skill-installer 会顺带把 iterate CLI 安装到 PATH（优先 pipx 隔离，否则 --user）。若不希望安装 CLI，请使用手动复制或源码脚本方式。

目录结构 / Directory Structure

iterate-skill/
├── SKILL.md                          # 核心技能文件
├── README.md                         # 本文件
├── LICENSE                           # MIT 许可证
├── CONTRIBUTING.md                   # 开源贡献指南
├── CHANGELOG.md                      # 版本变更记录
├── pyproject.toml                    # iterate CLI 包定义
├── npm-installer/                    # npx 一键安装器源码
│   ├── bin/cli.js
│   ├── lib/installer.js
│   └── package.json
├── config/
│   ├── iterate.config.yaml           # 默认配置（Master）
│   ├── config.schema.json            # 配置 JSON Schema
│   ├── dimensions.yaml               # 聚合版维度定义
│   └── dimensions/                   # 数据驱动的维度定义
├── examples/                         # 各语言项目示例
├── harness/                          # iterate 生态的两个工程化落地组件（monorepo）
│   ├── iterate-harness/              # 独立无头引擎（npm: iterate-harness，命令 ih）
│   │   ├── src/iterate_harness/      #   CLI / 引擎 / web / UI 源码
│   │   ├── frontend/                 #   终端 / web 前端界面
│   │   ├── npm/                      #   npm 包装器（ih）
│   │   └── scripts/                  #   安装脚本与 e2e 测试
│   └── iterate-plugin/               # dsh 桌面插件（npm: iterate-plugin）
│       ├── src/                      #   服务端逻辑（TypeScript，编译到 dist/）
│       ├── lib/                      #   客户端 UI 注入入口
│       └── cordis.patch.yml          #   dsh bundle 声明
├── templates/                        # 模板文件
├── iterate_cli/                      # onboarding CLI 源码
│   └── data/
│       └── ITERATE.template.md       # wheel 打包模板
├── scripts/
│   ├── install.py                    # 安装/卸载/配置/校验脚本
│   ├── validate.py                   # 配置与维度校验
│   └── requirements.txt              # 脚本依赖
├── tools/                            # 各 AI 助手专属实现示例
├── tests/                            # 单元测试
└── .github/workflows/                # CI / Release

贡献 / Contributing

欢迎提交 Issue 和 PR！

Fork 本仓库
创建功能分支：git checkout -b feat/your-feature
提交改动：git commit -m "feat: description"
推送分支：git push origin feat/your-feature
创建 Pull Request

请保持 SKILL.md 的中英双语结构，新增功能需补充配置示例。

iterate-skill

Installazione

README

Iterate Skill

这是什么 / About This Project

30 秒了解 / At a Glance

3 分钟上手 / Quick Start

1. 安装技能

2. 进入项目并完成 onboarding

3. 开始迭代

安装 / Installation

推荐：npx 一键安装（适合绝大多数用户）

其他安装方式

方式 A：本地安装 iterate CLI

方式 B：手动复制 skill 目录

方式 C：源码脚本（开发者）

全局安装 vs 项目级安装

为什么不推荐 skills.sh 安装？

日常使用 / Daily Usage

在 AI 助手中

在终端中

它如何工作 / How It Works

Onboarding（项目知识库初始化）

漂移检测

个性化配置

核心流程

配置参考 / Configuration

常见问题 / FAQ

安装 / Installation

使用 / Usage

安全 / Security

安全说明 / Security

目录结构 / Directory Structure

贡献 / Contributing

许可证 / License

Plugin correlati

archify

ipollowork

browserskill

Aegis