icm-architect的10条黄金不变量:新手也能读懂的Agent工作区设计法则
【免费下载链接】icm-architectClaude skill: design any process, idea, or problem into an ICM workspace (folder structure as agent architecture), or restructure an existing folder into one项目地址https://gitcode.com/gh_mirrors/ic/icm-architect点击查看免费下载icm-architect是一款 Claude skill它能把任何流程、想法或问题设计成一个ICM 工作区Interpretable Context Methodology可解释上下文方法论——用文件夹结构当 Agent 架构或者把一个现有的文件夹、仓库改造成这样的结构。对新手来说最难的不是让 AI 干活而是让它知道该读什么、写到哪去。icm-architect 给出的答案是 10 条不变量invariants任何工作区无论形态如何都必须遵守这 10 条法则。本文带你逐条读懂它。先搞懂为什么文件夹可以当架构传统做法是写一套编排代码orchestration code来调度多个 AgentICM 的思路则反过来——把编排写进目录结构里编号文件夹负责排顺序01_做完了才轮到02_层级结构负责圈定上下文当前步骤只读自己需要的文件纯 Markdown 文件负责记录状态进度就看得见官方用了一个很形象的比喻工作区是一座图书馆路由文件是目录卡——小而稳定指向一切、几乎不存内容一个图书管理员单一模型走进大楼问题决定它走向哪个书架。这就是 README.md 中描述的核心理念。10条黄金不变量逐条拆解 以下 10 条全部来自 SKILL.md 的 The invariants 章节。构建或改造工作区时每一条都要强制执行。法则 1一个文件夹只做一件事每个文件夹要么完成一个步骤要么存放一类东西并在自己内部放一个文件说明自己的用途。结构本身就是文档——不需要另开一个 wiki。法则 2小而稳定的入口文件根目录放一个CLAUDE.md或其他 Agent 的AGENTS.md只回答三个问题我在哪一切都在哪任务 X 该去哪找——除此之外什么都不写。目标60 行以内。它只负责路由绝不存内容。可直接参考模板 assets/templates/CLAUDE.md。法则 3编号即顺序用01_、02_……表示流程顺序。重命名文件夹 重排流水线这正是编号的妙处。想调整步骤先后改名就行不用改任何代码。法则 4每个工作文件夹都有显式合同每个工作文件夹放一份CONTEXT.md四段式写清段落回答什么Inputs读什么输入Process做什么过程Outputs写什么输出Human check人来检查什么这份阶段合同的完整模板见 assets/templates/stage-CONTEXT.md。法则 5工厂与产品分开存放参考材料规则、文风、schema、模板——每次运行都不变的和工作产物输出、草稿——每次运行都新的必须在结构上分开。工厂只配置一次产品是每次运行吐出来的东西。详见 references/core.md 的Configure the factory, not the product原则。法则 6每个输出都是可编辑面中间产物必须是普通人能打开、修改、保存的纯文本文件。在有人读完上一个输出之前流程不得往下走——这是 ICM 工作区里最核心的一条人工门禁。法则 7只加载当前步骤需要的东西执行某一步的 Agent 只读它的合同、参考材料和输入不读整个工作区。每步的健康区间是2000–8000 tokens。对比之下把所有东西塞进一个大 prompt 通常要 30k–50k tokens其中大部分与当前步骤无关。法则 8纯文本、可链接、可查询统一用Markdown YAML frontmatter链接[[wikilinks]]或相对路径让文件成为一张图frontmatter 标签让它可被查询。记住一条事实只住一个地方——链接永远好过复制。法则 9文件系统就是状态机当前状态靠扫描输出文件夹里存在什么就能推导出来自动生成的索引文件地图、日志由脚本重建绝不手工编辑——手改的索引一定会漂移。法则 10靠复制来新建新的工作单元 复制一个模板文件夹而不是面对空白页。模板统一放在_templates/或_system/文件夹里。模板本身就是 schema。选对形态5种骨架一套法则 ️10 条不变量之下icm-architect 提供 5 种经过实战检验的形态详见 references/forms.md形态适用场景Pipeline流水线同样的步骤反复运行每次都产出一份交付物Umbrella伞形多条流水线共享同一品牌/文风/参考层Record library记录库单元是会累积的记录客户、会话、人物Knowledge bundle知识包产品本身就是可导航的知识Context map上下文地图对象是一个组织团队、流程、数据及其连接它们可以自由组合、互相嵌套——因为不变量在每一层都递归成立。选形态前先问一个问题重复的工作单元是什么验收标准冷启动行走测试Walk Test工作区建好后怎么验证让一个没有任何记忆的 Agent 冷启动走一遍打开根目录能否在入口文件 最多两次读取内回答我在哪、当前任务去哪任选一个阶段它的合同是否写明了精确的输入路径、任务、输出和人工检查项能否仅凭扫描output/文件夹就说出流水线进度有没有路由文件偷装了内容有没有事实在两个地方各存了一份入口文件 一份合同 输入是否落在 2k–8k tokens 区间哪一步失败就修结构——不是多解释而是移动或拆分文件直到走得通为止。快速上手安装与常用触发词 ⚡Claude Code把整个文件夹复制到~/.claude/skills/icm-architect/或项目内的.claude/skills/icm-architect/然后对 Claude 说ICM this / structure this for agentsbuild me a workspace for XClaude 应用上传打包好的icm-architect.skillSettings → Capabilities。两种工作模式一句话区分Build从零描述的流程搭建与Restructure审计现有文件夹、把每个文件归类为 catalog / contract / factory / product / dead 五类给出迁移地图、批准后再迁移。所有可复制的起步模板都在 assets/templates/ 里。新手避坑清单 ⚠️别过度设计爬升阶梯是聊天 → 保存的 prompt/skill → 文件夹 单 Agent只有当下一级真的被自动化且反复发生时才往上走。知道 ICM 的边界实时多 Agent 协作、高并发多用户、流程中途自动分支这些确实需要框架代码。ICM 服务的是顺序执行、人工审核、可重复的工作——也就是大多数知识工作。警惕的腐化模式两份手工维护的入口文件、schema 强制使用的命名与真实文件脱节、手改生成的索引、模式被自上而下宣布同一形状在三个独立地方出现才叫结构。写在最后10 条不变量看起来是规则本质是一套可解释性契约任何时刻打开任何一个文件夹你都能看清系统处于什么状态任何新来的协作方只需从上到下读完 CONTEXT 文件就能理解整条流水线。这正是 SKILL.md 的开头所承诺的——文件夹做编排一个 Agent 在正确的时刻读正确的文件就能顶替一个多 Agent 框架。把它贴在屏幕边上你的下一个 Agent 工作区就有了骨架。✅赞分享【免费下载链接】icm-architectClaude skill: design any process, idea, or problem into an ICM workspace (folder structure as agent architecture), or restructure an existing folder into one项目地址https://gitcode.com/gh_mirrors/ic/icm-architect点击查看免费下载相关推荐10个AI产品设计黄金法则打造用户爱不释手的智能应用在AI技术快速发展的今天如何设计出真正优秀的AI产品经过对数百个AI项目的深入分析我们总结出10个核心设计原则帮助你构建用户真正喜爱的AI应用。 1文档教程人工智能GNSS-SDR多系统兼容性GPS、Galileo、GLONASS、BeiDou信号并行处理GNSS SDR多系统兼容性GPS、Galileo、GLONASS、BeiDou信号并行处理 GNSS SDR是一款开源软件定义GNSS接收器支持GPS、G科研科学计算通信MambaOut与ViT对比参数效率与计算复杂度的优势分析MambaOut与ViT对比参数效率与计算复杂度的优势分析 MambaOut作为CVPR 2025的创新视觉模型通过精简的门控CNN架构重新定义了视觉任务中创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

小区物业管理软件系统排行榜五类数字化工具推荐

小区物业管理软件系统排行榜五类数字化工具推荐

小区物业管理软件系统排行榜:2026年值得关注的五类数字化工具推荐5年物业一线转系统落地,经常被问"到底用哪个系统好"。今天换个角度——不聊单个产品,而是从小区物业的实际需求出发,梳理2026年市面上五类主流的数字化工…

2026/10/11 14:10:20 阅读更多 →
有效使用Claude Code:从问答误区到工程级实战

有效使用Claude Code:从问答误区到工程级实战

放弃思考。直接用Claude Code把这条Issue给看了”。结果它真的打开了仓库、跑了测试、改了三行代码、还顺手给我提了一个测试用例。那一刻我才意识到,不是这工具差,是我根本没把它当成一个能执行的人,而是当成一个更聪明的百度。这种理解偏差…

2026/10/11 14:09:20 阅读更多 →
医务管理系统详细设计说明书:从文档到可落地设计基线

医务管理系统详细设计说明书:从文档到可落地设计基线

简介:《医务管理系统详细设计说明书》面向医疗信息化行业的系统分析师、架构师与开发人员,用于指导医院医务管理系统的设计与落地。文档围绕系统简述、参考资料、设计约束、总体结构与功能结构设计、系统架构图、版本说明与修改记录、安全与隐私保护、性…

2026/10/11 14:09:20 阅读更多 →

最新新闻

ClaudePrism 内置编辑器使用指南:LaTeX/BibTeX 语法高亮、实时错误检查、正则搜索与 Vim 模式

ClaudePrism 内置编辑器使用指南:LaTeX/BibTeX 语法高亮、实时错误检查、正则搜索与 Vim 模式

【免费下载链接】claude-prism An offline-first scientific writing workspace powered by Claude. LaTeX Python 100 scientific skills all running locally. 项目地址: https://gitcode.com/gh_mirrors/cl/claude-prism 点击查看 免费下载 ClaudePrism 内置编…

2026/10/11 15:01:52 阅读更多 →
成都一贯制民办学校怎么选?办学体系与寄宿管理的家长关注点

成都一贯制民办学校怎么选?办学体系与寄宿管理的家长关注点

成都一贯制民办学校怎么选?办学体系与寄宿管理的家长关注点 在成都青白江区为明学校选择民办学校时,家长们常常面临一个核心问题:一贯制民办学校的办学体系与寄宿管理究竟应该关注哪些维度?随着成都民办教育的发展,越来…

2026/10/11 15:01:52 阅读更多 →
LSTM-XGBoost混合模型实现工业时序预测与可解释性分析

LSTM-XGBoost混合模型实现工业时序预测与可解释性分析

简介:本资源是一份面向数据科学家与深度学习工程师的LSTM-XGBoost融合建模实战项目,聚焦多输入单输出时序回归预测难题,有效解决金融预测、工业监测与环境预报等场景中长期依赖建模与非线性特征协同学习的挑战。资源以1个91KB的Word文档&…

2026/10/11 15:01:52 阅读更多 →
中兴通讯招聘

中兴通讯招聘

欢迎联系

2026/10/11 15:01:52 阅读更多 →
Xsens MVN Analyze 惯性动捕数据接入人形机器人:TaoToken 统一 Key 的链路配置大纲

Xsens MVN Analyze 惯性动捕数据接入人形机器人:TaoToken 统一 Key 的链路配置大纲

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/11 15:01:52 阅读更多 →
Dify工作流实战:无代码拖拽搭建文本摘要器

Dify工作流实战:无代码拖拽搭建文本摘要器

1. 为什么"拖拽连线"能替代代码,这背后到底是什么在运行 先聊一个我自己的真实感受。最开始接触Dify工作流的时候,我第一反应和多数开发者一样:拖几个节点、连几条线,产出的东西真能和手写代码一样稳定吗?带…

2026/10/11 15:00:52 阅读更多 →

日新闻

流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南

流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南

简介:基于 ARIMA、LSTM、Transformer 等模型的流感时间序列预测 Python 源码,面向计算机相关专业课程设计与期末大作业学生,以及项目实战学习者。内容覆盖预处理、平稳性检验、定阶、残差分析、多模型对比预测的完整时序建模流程,…

2026/10/11 0:00:27 阅读更多 →
影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别 做影刀RPA自动化,十个新手有八个栽在"往输入框里填东西"这件事上:要么填不进去,要么填了一半,要么直接把原来内容追加在后面。这背后的根因&…

2026/10/11 0:00:27 阅读更多 →
影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容 1. 认识影刀:什么场景该用RPA采小说数据 起点中文网的页面结构相对稳定——分类榜单、书籍详情、章节内容三块独立页面,跳转链路清晰。这种场景非常适合影刀自动化&#x…

2026/10/11 0:00:27 阅读更多 →

周新闻

流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南

流感时间序列预测实战:ARIMA/LSTM全流程拆解与避坑指南

简介:基于 ARIMA、LSTM、Transformer 等模型的流感时间序列预测 Python 源码,面向计算机相关专业课程设计与期末大作业学生,以及项目实战学习者。内容覆盖预处理、平稳性检验、定阶、残差分析、多模型对比预测的完整时序建模流程,…

2026/10/11 0:00:27 阅读更多 →
影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程:键盘模拟输入实战——输入文本与模拟按键的区别 做影刀RPA自动化,十个新手有八个栽在"往输入框里填东西"这件事上:要么填不进去,要么填了一半,要么直接把原来内容追加在后面。这背后的根因&…

2026/10/11 0:00:27 阅读更多 →
影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程:阅文起点小说数据采集实战——书籍信息与章节内容 1. 认识影刀:什么场景该用RPA采小说数据 起点中文网的页面结构相对稳定——分类榜单、书籍详情、章节内容三块独立页面,跳转链路清晰。这种场景非常适合影刀自动化&#x…

2026/10/11 0:00:27 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/11 10:45:37 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/11 14:36:53 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/11 14:36:54 阅读更多 →