icm-architect 是一个面向 Claude/Claude Code 的“技能包”，用于把任意流程、想法、问题或已有文件夹重构成 ICM（Interpretable Context Methodology）工作区。它的核心思想是用可解释的文件夹结构替代复杂的多 Agent 编排代码：通过编号文件夹表达执行顺序，通过层级结构表达上下文范围，通过 Markdown 文件保存状态、契约和路由信息。该仓库提供方法说明、参考文档和模板，帮助开发者为 AI Agent 设计可导航、可审计、可迁移的工作空间。
适用领域
AI Agent 工程 / Claude Skills / 知识管理 / 工作流设计 / 文件系统架构 / Prompt Engineering / 上下文工程 / 项目结构重构 / AI 辅助软件开发
配置难度
中等。安装本身很简单，复制到 Claude skills 目录即可；真正的难点在于理解 ICM 方法论、抽象业务流程、设计稳定的目录层级，以及长期维护 Markdown 状态和路由文件。熟悉 Claude Code、知识库管理和工作流建模的开发者会更容易上手。
商业价值
该项目的商业价值主要在于提升 AI Agent 工作流的可解释性、可维护性和团队协作效率。对于咨询、软件交付、研发管理、知识库治理、客户项目管理等场景，它可以帮助团队把隐性的流程和上下文固化为文件结构，让 Claude 更稳定地执行任务，也让人类可以审计和接管。它不直接提供商业化产品能力，但可以作为企业内部 AI 工作区规范、Agent 项目模板或知识管理方法的基础。
01
技术亮点
- 提出一种轻量级 Agent 架构思路：用文件夹结构和 Markdown 状态替代复杂编排代码。
- 强调可解释性，人类可以直接打开目录查看系统状态。
- 提供 Build 和 Restructure 两种模式，既能从零设计，也能改造已有目录。
- 内置五种通用结构形态：Pipeline、Umbrella、Record library、Knowledge bundle、Context map。
- 适合 Claude Code 场景，安装方式简单，不需要运行服务或额外依赖。
- 通过 walk test 验证结构是否足以让无记忆 Agent 定位、行动并汇报。
- MIT 许可证，便于二次修改、团队内部使用或集成到自己的工作流。
- 对中国开发者而言，适合用于整理 AI 编程项目、知识库、交付流程和团队协作文档。
02
目标用户
- 使用 Claude Code 的开发者
- 希望为 AI Agent 设计可维护工作区的团队
- AI Agent / LLM 应用开发者
- 需要整理大型文档库、知识库、Obsidian Vault 或代码仓库的用户
- 做流程自动化、运营流程设计、咨询交付流程设计的人
- 关注上下文工程和可解释 Agent 架构的研究者
- 希望减少多 Agent 框架复杂度的小团队或独立开发者
03
配置要求
- 需要 Claude Code 或支持 Claude Skills 的 Claude 应用环境。
- 需要将技能目录放置在 Claude 可识别的 skills 路径下。
- 如果用于 Claude apps，需要手动打包或压缩为 .skill 文件。
- 仓库本身不是传统软件包，没有 npm、pip、Docker 等依赖安装流程。
- 使用效果依赖 Claude 对 SKILL.md、references 和 templates 的读取与执行能力。
- 若用于重构已有目录，需要 Claude 对目标目录有读取权限；若要实际迁移文件，还需要写入权限。
- 建议目标工作区使用 Markdown 文档承载状态、契约、上下文和路由信息。
04
适用场景
- 把一个业务流程设计成适合 Claude 执行的文件夹工作区
- 为软件开发流程搭建 Pipeline 式 AI 工作空间，例如需求、设计、实现、测试、发布
- 把已有项目目录、文档库或知识库重构成 ICM 结构
- 为客户管理、咨询记录、会议纪要等场景创建 Record library
- 把组织架构、项目组合或多条业务线建模成 Umbrella 工作区
- 把散乱的 Markdown 知识库整理成可导航的 Knowledge bundle
- 为单个 Claude Agent 提供可解释的状态、上下文和任务路由机制
- 用 walk test 验证一个 Agent 是否能在无记忆状态下仅依靠文件完成定位、执行和汇报
05
部署与配置
- 如果使用 Claude Code，将该仓库文件夹复制到 ~/.claude/skills/icm-architect/。
- 也可以将其复制到具体项目内的 .claude/skills/icm-architect/，使技能仅在该项目中可用。
- 在 Claude Code 中向 Claude 提出类似“ICM this”、“structure this for agents”或“build me a workspace for X”的请求。
- 如果使用 Claude 桌面或网页应用，需要将该技能打包为 icm-architect.skill。
- 可使用 Claude skill-creator packager 构建技能包，或将该文件夹内容压缩后上传。
- 在 Claude 应用中进入 Settings → Capabilities，上传 icm-architect.skill。
- 上传后即可让 Claude 使用该技能对流程、想法、文件夹、仓库或知识库进行 ICM 化设计或重构。
06
风险与注意事项
- 该项目更像方法论和 Claude Skill，而不是可直接运行的软件框架，期望使用 API 或 SDK 的开发者可能会失望。
- 强依赖 Claude Skills/Claude Code 生态，如果团队主要使用其他 LLM 工具，需要自行迁移方法。
- README 中提到的论文链接年份为 2603，可能是占位、未来日期或非标准引用，需要自行核实可信度。
- ICM 方法对团队文档纪律要求较高，如果文件命名、状态更新和目录维护不一致，结构会逐渐失效。
- 对于高度动态、强实时、多服务协同的 Agent 系统，纯文件结构可能不足以替代完整编排框架。
- 仓库语言字段为空，说明不是传统代码项目，自动化测试、CI、版本兼容性等工程信号较少。
- 对于中文团队，模板和说明大概率以英文为主，可能需要本地化翻译和改写。
2026-07-25
第26名
新收录 · github_search
