1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | icm-architect |
| 作者/维护者 | RinDig（GitHub 个人账号）；仓库 LICENSE 署名 Jake Van Clief，为该方法论学术论文作者之一 |
| 来源链接 | https://github.com/RinDig/icm-architect |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 332（GitHub API 实时查询） |
| Forks | 55（GitHub API 实时查询） |
| 最新版本 | 未发布正式 Release/Tag，单一持续演进版本 |
| 安装方式 | 复制文件夹到本地 skills 目录；或打包为 .skill 文件上传 |
2. 功能介绍与亮点
icm-architect 是一个纯 Markdown 方法论技能，把“多智能体编排”这件事从框架代码搬到文件系统：用编号文件夹表达执行顺序，用目录层级表达上下文范围，用纯文本文件承载状态，让一个 agent 在恰当的时刻读取恰当的文件，替代原本需要多智能体框架才能做到的协调。
技能提供两种模式：Build（从用户口述的流程中提炼结构，从五种范式——流水线、伞形组合、记录库、知识包、组织关系图——中选一种，搭建最小可用工作区）与 Restructure（审计一个已有的混乱文件夹，把每个文件归类为目录/契约/工厂/产物/废弃五类之一，提出迁移方案并在人工确认后执行）。全部产出都要通过“走读测试”验证：一个没有记忆的 agent 仅凭文件本身就能判断自己在哪、该做什么。
方法论出自真实学术论文《Interpretable Context Methodology: Folder Structure as Agent Architecture》（arXiv:2603.16021，Jake Van Clief 与 David McDermott），本仓库是该论文的技能化实现。文档诚实列出方法论边界——不适合实时多智能体协作、高并发场景与自动化中途分支——不做夸大宣传。仓库自带十条不变量说明、两份参考文档（core.md、forms.md）与六个可直接复制的模板文件。
3. 适用场景
固定分类：元技能与 Agent 增强。
- 把一个重复执行的多步骤工作流（如内容生产、研究报告、案例整理）整理成 agent 可反复运行的文件夹流水线
- 把散乱的笔记、项目文件或知识库重构成一个 agent 能够独立“走读”理解的结构化工作区
- 个人或小团队搭建“第二大脑”式的知识库，或把团队组织关系映射成可供 agent 查询的上下文图
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅——README 给出明确安装路径（
~/.claude/skills/icm-architect/或项目内.claude/skills/icm-architect/） - （附加事实：README 同时说明可打包为
.skill文件通过 Settings → Capabilities 上传到 Claude 桌面/网页应用，非本报告四个目标生态之一，仅供参考） - Codex：未验证——仓库未提及，技能内容为不含任何 Claude 专属工具调用的纯声明式 Markdown，理论上可直接复制安装，但未见直接证据
- OpenClaw：未验证——同上，无相关材料
- Hermes Agent：未验证——同上，无相关材料
5. 推荐理由
它把一个经过学术论证的方法论直接变成了可安装的技能：零代码执行、零外部依赖、复制文件夹即可用，对入门用户几乎没有门槛。文档不做自我宣传，反而主动写明方法论的失效场景，这在同类“元技能”里并不常见。更难得的是已有真实用户反馈——有人在 500 多个文件的真实工作区上实测过，也已有独立开发者基于同一方法论做出另一个复现实现，说明这套思路经受住了他人检验，而非作者自说自话。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 332 星、55 次 fork（创建约 10 天内取得，API 实时查询）；仓库收到 4 个来自 3 位不同具名用户的深度功能提案 issue（含一份 500+ 文件真实工作区实测记录）；同一方法论已催生至少一个独立第三方复现实现 |
| 可用性 | 9 | 安装仅需复制文件夹或打包上传，无需任何外部服务、API Key 或付费依赖；文档含 README、SKILL.md、两份参考文档与六个模板，覆盖完整；仓库处于创建后 10 天内的活跃早期阶段 |
| 安全性 | 9 | 纯 Markdown 方法论文档，逐项核查见下表 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① 是否执行 shell 命令 | 否，全仓库不含任何可执行脚本 |
| ② 运行时是否联网外发 | 否，纯本地文件读写建议，无网络请求 |
| ③ 是否要求 API key/凭据 | 否，不对接任何外部服务 |
| ④ 可疑指令/注入迹象 | 未发现，全文核查无异常指令 |
| ⑤ 作者/组织信誉 | 个人开发者，许可证署名与方法论论文作者之一一致，无刷星或操纵性措辞迹象 |
| ⑥ License 是否明确 | 明确，MIT |
| ⑦ 最近维护时间 | 创建于 2026-07-18，最近一次提交 2026-07-19，处于活跃早期阶段 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 icm-architect 的差异 |
|---|---|---|
| icm-architect | 单 agent 文件夹方法论 | 用文件系统结构本身承载编排与状态，零外部依赖、纯只读建议 |
| Agent Council（0xwilliamortiz/agents-council） | 多 CLI 实时会诊 | 同时调用本机已安装的多个 AI CLI（Codex CLI、Gemini CLI 等）各自作答再由主持人综合，走的是“实时多智能体协作”路线，需要 Node.js 环境与其他 CLI 工具，与 icm-architect 刻意回避的场景正相反 |
| icm-template（ktnCodes/icm-template） | 同方法论的静态模板 | 提供同一套 ICM 目录骨架的模型无关模板，但只是起始脚手架，不含 icm-architect 的访谈式搭建流程与“审计已有目录并给出迁移方案”的 Restructure 能力 |
8. 用户评价
该技能目前在第三方平台尚无公开长文评价，但 GitHub 仓库 issue 区有具体的真实使用记录：用户 jorgeccastro 提到曾对一个 500 多个文件的真实工作区运行过 Restructure 审计流程，确认它发现了真实的结构性问题，同时指出一类当前版本尚未覆盖的边界情况（外部路径引用）。另有用户 dubedad 两次提交结构层面的具体改进提案，显示出对方法论细节的深入使用。
9. 其他补充
项目目前仅提供英文文档；作者维护一个配套社区 Skool 频道（Clief Notes）供讨论该方法论。仓库创建仅 10 天，处于早期快速迭代阶段。
10. 安装使用方式
- Claude Code：将本仓库内容（
SKILL.md、references/、assets/templates/）复制到~/.claude/skills/icm-architect/（全局）或项目内.claude/skills/icm-architect/，之后对 Claude 说“ICM this”、“structure this for agents”或“build me a workspace for X”即可触发 - Claude 桌面/网页应用：用 skill-creator 打包出
.skill文件，通过 Settings → Capabilities 上传 - 安装后如未被识别，可按各平台惯例重新加载技能列表或重启客户端；具体是否需要重启因平台而异
11. 注意事项
- 仓库创建仅 10 天，长期维护记录尚待观察
- 纯文本方法论不做任何自动化执行，效果取决于使用者是否切实遵循人工确认关卡（走读测试）
- 作者在文档中明确写出方法论边界：不适合实时多智能体协作、高并发场景，以及需要运行时自动分支的场景
- 未在 Codex、OpenClaw、Hermes Agent 上得到直接验证