forge-of-thought：AI Agent 工具实践指南

实际看forge-of-thought，先要确认它的用途：聊天会给你答案， Forge of Thought 是一个 AI 认知扩展：一个研讨会，您的想法将被锻造成您可以支持的决定，您和 AI 一起引发这个想法，直到它完整为止。软件开发里，依赖、接口和异常处理往往比主路径更影响采用。我会在隔离分支完成一个可回滚的小任务，检查安装步骤、接口契约、测试结果和错误信息。它适合需要可检查开发流程而非单次演示的工程师；采用前仍要看维护状态和试跑结果。

项目：锻造 渲染：自述文件 生成时间：2026-10-04 配方： recipes/readme.md v0.56 输入：

• CLAUDE.md
• projects/forge/10-intent.md v4.58
• .claude/agents/
• .claude/skills/forge/states/
• .claude/skills/
• 脚本/
• templates/ledger.md

思想熔炉 4.58

锤炼和塑造思想的工作坊。 · 发行说明

Forge of Thought 是一个有思想的人类的 AI 认知延伸， 校长：谁的思想正在被锻造。它需要一个原始的、 半成形的想法（流程重新设计、平台计划、 组织变革（D&D 活动）并将其调整为精确的、 为交付者提供独立的移交：团队、同事、 未来的你。它基于一个原则，机器携带 工作中所有非决定性的部分，以三种形式呈现。

• 它与你一起思考。它采访、探究、批评、 挑战和启发；它会提取您尚未提取的内容 阐明并列出了选项及其权衡。它 建议——你决定。
• 它使工作保持一致。 没有任何事情会被遗忘 聊天：思维存在于版本化、模板化的制品中， 决策、状态和历史保持秩序， 每个输出都保持一致性。
• 它承载着繁琐的工作。面向观众的输出（音调、 甲板，甚至这个 README）都是渲染：从 通过配方制作的人工制品，只要思维移动就会再生， 从来没有手写过两次。

从技术上讲，forge 是一个 git 存储库：斜杠命令和隔离的 克劳德·科德的代理人（挑战者角色和评论家镜头）， 模板以及约束它们的约定。这是一个地方 思想形成，文件链在项目结束时结束 需要它。今天，锻造厂有四件文物：一份简介、一份意图、一份 作业和解决方案设计；这就是链条的终点 现在，这是一个事实，而不是其目标。这里什么也没实现： 锻造指定。

时间紧迫？两页一页的注释简要说明了这一点： 对于 CTO 和 为 CEO。各有一句话 旁边的版本。

1.用AI更好，还是用它代替？

Forge of Thought 适合那些选择变得更好的人。失败 它存在的模式是为了删除：

• 思维分散在消亡的聊天会话中，带走他们的 与他们的背景。
• 交接的完整性取决于他们当天的心情 被写了。
• 同样的想法向每一位观众复述（一个演讲、一个演讲稿、一个 mail），每个版本都是手工重写的，并且与其他版本有所不同。
• 反馈和决策没有落脚点，所以同一个地面 争吵过两次。
• 在现实出现之前没有人攻击假设。

2. 你得到什么

• 版本化文档链从简短（您的想法放在 一起，经您批准）通过意图到 分层您的项目需求、要移交的作业以及 解决方案设计其中。
• 锻造意图的启发式访谈。
• 盲目的对抗性评审员，记录每一个判决。
• 从配方生成的特定于受众的渲染，包括 通过您自己的模板实际 PowerPoint 文件。
• 外部源不可更改地注册并仅用作 校长指挥。
• 文件和 git 中的所有内容：一切都不取决于聊天的记忆。

3. 快速入门

首先，每台机器一次：

# clone this repository          (you are looking at it)
# install Claude Code            (see Setup)
claude                           # always from the engine root
/setup                           # first run only - fills CLAUDE.local.md,
                                 # sets the model, Fable

开始一个新项目

/new-project my-idea
/forge intent
/save

带来现有项目

/import-project <project url>    # clones into projects/ - the commit
                                 # identity is git's, resolved from
                                 # your own configuration
/forge <project-slug>            # the slug is the repository's name;
                                 # select the project before any work -
                                 # the forge cannot guess it

每个项目都作为 git 存储库存在于 projects/<slug>/ 中 它自己的，引擎不跟踪；这就是你命名它的原因 首先。

4. 使用方法

流量

一个想法出现：你想要对团队的工作方式做出改变，或者 您的 D&D 桌上的活动正在成型。你把它放在一起作为 简短，单独或与锻造者交谈，无论形式如何 思想有。这是故意的粗糙。

然后你运行 /forge intent ，锻造厂开始询问。几天来 和会议的意图是从简报中形成的：你持有什么和 为什么，情况如何，你放弃了什么，什么仍然开放。 所有内容都存在于文件中，因此您可以随时关闭会话 几周后回来。

当你思考的时候，材料就到了。您下载的安全标准 通过/ingest进去等待；稍后你询问意图 对其进行验证，然后才使用它。某个主题需要的地方 外部接地，/research 存储耐用的音符。

当这个想法成立时，你可以让盲目的审稿人对其施加压力： 对文件质量的批评者，对文件质量的挑战者 物质。他们没有听到你的谈话，所以他们只阅读 写了什么。你一次检查他们发现的一件物品 并且每一个判决都会被记录下来。没有什么能阻挡你。

从意图出发，任务是为那些将要完成任务的人而提炼出来的。 采取行动，当解决方案设计说方法不明显时 想要的东西是如何实现的。对于每个观众来说，都有一个 渲染：团队的宣传，包括实际的 PowerPoint 的幻灯片 文件，一封邮件，这非常README。你迭代配方，组成如果 你喜欢通过类型采访，并且输出被重新生成 从它； README 以及每个版本的发行说明。 /save 和 /release 将其全部保存在 git 中。

实际情况如何

一旦一个真实项目的工作示例将出现在此处 发表。

5. 工作感受如何

伪造就像一组文件一样是一种工作方式，而这些 是这项工作的命名方法，你和克劳德的词汇 分享。

• 演练。 任何需要您决定的项目列表都是 每条消息只处理一个项目，按权重顺序，每个命题 以判决线结束 (a)ccept / (m)odify / (r)eject / (p)ark。您可以用 单个字母作为您的整个信息，并且判决已被执行 一个人在一轮结束时写下。
• 提出建议，永远不要决定。 克劳德批评、挑战、启发 并列出选项，然后您撰写； ?? 在您的末尾 消息询问克劳德对你刚才的事情的诚实意见 写的。
• 一步一步。 任何需要您同意的事情（书面、 提交、推送、重命名、新版本文档的诞生） 一步到位，有其具体的操作、目标和理由， 并遵守您的诺言。
• 启发式访谈。 克劳德提出问题，每个问题一个 消息，您尚未明确表达的内容。
• 分成几部分。 您可以将一个较长的想法作为多条消息发送 并用诸如“完成”之类的词结束它；直到那时，只有克劳德 确认，然后将这些片段作为一个输入。
• 早期草稿。早期草稿是描绘想法的工具 输出，而不是输出：具体的文本会激起人们的反应。
• 回想一下。 在写下任何内容之前，克劳德重申了内容 它理解了，所以写下的内容是确认而不是惊喜。
• 每轮一次写入。 工作对话是一轮：什么 已同意在对话中进行并在其时一次写入 最后，言出必行，字是write。
• 意图优先。 实质内容的改变涉及意图和 从那里沿着项目的整个链条传播；仅 措辞直接在下游固定。
• 移交。 文物的组成方式是您的选择， 人工制品：通过问题一起找到，或移交 在几句话中，在这种情况下，克劳德返回一个带有以下内容的提案： 它假设和选择的简短列表，并且没有任何内容在此基础上构建 在你做出判断之前。
• 推荐，不要推动。 每个选项都带有一个 建议及其理由，陈述一次；拒绝了 在没有新事实的情况下，不再对建议进行争论。

None 不是命令：您可以用一句话调用它们中的任何一个。

6. 角色

合作的长期规则：当不确定时，克劳德询问并 永远不会通过假设来填补空白；矛盾、差距或风险 发现立即被提出，作为一个问题指出什么不适合。 克劳德所带来的知识用简单的语言说明了是否是 已验证以及基于什么、未验证或假设。克劳德从不 单独引入一个新的约定、前缀或部分：它 提出建议，等待决定，然后将其写下来。很多 迭代是正常模式。批评和清单提供信息并 永不阻塞；只有校长发布。

伪造的一个实例为一位委托人服务，而接收者 通过文物进行合作；更多校长意味着更多 实例（请参阅计划的扩展）。

7. 文件链

flowchart LR
    B["00-brief"] --> I["10-intent"]
    I --> A["20-assignment"]
    I --> SD["40-solution-design"]
    A --> SD
    I --> RI(["renders: pitch, deck, summary …"])
    A --> RA(["renders: mail …"])
    A -.-> BRD["30-brd
business analysis"]
    BRD -.-> SD
    A -.-> RFP["an RFP"]
    I -.-> ART["an article"]
    ART -.-> RT(["render: a translation"])
    I -.-> ST["strategy"]
    SD -.-> IMP["implementation deck"]

    classDef built fill:#1f6feb,stroke:#1158c7,color:#ffffff
    classDef future fill:#c6dbfa,stroke:#1f6feb,color:#24292f
    classDef render fill:#2da44e,stroke:#1a7f37,color:#ffffff
    class B,I,A,SD built
    class BRD,RFP,ART,ST,IMP future
    class RI,RA,RT render

蓝色 = 链人工制品（浅色 = 尚未构建），绿色 = 渲染； 虚线箭头=尚不存在的增长。

添加一层是一个声明其输入的定义文件：什么都没有 重新编号并且现有的任何内容都不会被修改，这就是文件被重新编号的原因 数以十计。链和渲染之间的边界是 作者身份：链制品由主体组成，渲染由 由人工制品生成，如文章及其翻译 图表说明。

每个人工制品都有一个定义，通过 /forge <state> 进行定义 与人工制品的模板配对：定义说明了如何 找到了人工制品，模板就出来了。熔炉有这些 文物，没有其他：

项目在意图之下采用它所需的层：没有一个是 另一个条件，并且项目没有的层不是 失踪了。

摘要规则。 在校长批准之前，摘要是草稿 它像任何人工制品一样在那之后被改变；它永远不会被锁定。 三个来源同样合法：它完成于 室外并按其来时存储，在室外开始并完成 与克劳德一起，或者它从第一个词就诞生在锻造中。 /forge brief 是门。后来的每一个完整的思维都是作为 00-brief-<name>.md 相同规则下，每条简报均被收益采集 当校长这么说时，分类账就变成了单一意图 追踪多远。

简报将想法放在一起：校长想要什么以及 为什么，他选择从周围的发现中获取什么。它是 自由格式，具有最少的标题，没有必需的内容，也没有 IDs，并且 它保存的是需要处理的想法，而不是决定。很粗糙 目的，因为凿凿是意图的工作：必需的 结构会迫使过早的整洁，并进行短暂的抛光，直到 本来无事可做的意图已经太过分了。

意图是工作文件：综合当前 委托人持有的状态。它保留重要的位置 （POS），事实情况如何（FCT）以及被删除的内容 拒绝（REJ）及其原因，每个位置及其出处； 未决定的内容作为线程（THR）存在于它旁边的threads.md中， 该项目的一个文件。它说明了想要什么以及为什么，但没有 解决。 10-intent.md 存在是因为聊天上下文消失以及其他任何事情 有价值的内容必须存在于文件中：它是在以下情况下读取的文档： 几周后返回项目，而不是挖掘旧项目 对话。每轮都会重写以保持连贯性，从不 附加到，当没有线程阻塞时，现在就完成了 下一层；它永远不会完成。

该转让包含意图的范围内实质内容 接收者完整且精确，以便他们无需任何操作即可采取行动 房间里的校长：他们是谁，房间里的情况一定是真实的 结束，什么是他们要决定并带回来的，什么是他们不应该做的 以及故意保留的内容。其项目为要求 (REQ)、超出范围的项目 (OOS)、约束 (CON)、假设 (ASM)、可交付成果 (DEL)、开放性问题 (TBC) 和成功标准 （SCR）。它存在于三个阶段的联合通行证中：仅限问题 对于意图没有回答的问题，用地图重新塑造整体 每个项目的来源，以及逐组的演练。它是 形状如此，因为大多数物品都是源自意图的工艺品，并且 没有地图，人们只能看到那里有什么，而看不到缺少什么。

解决方案设计说明了如何实现想要的东西，如 该解决方案至今有效，并保持最新状态。任何人都可以阅读 个人或代理人实现解决方案，无需委托人 房间。它由零件 (SOL) 组成，每个零件都说明其用途， 它上面层的哪些项目实现了，它所依赖的选择 选择它的目的是什么、它的成本是什么、它在哪里 意识到；打开的是 TBC 及其所有者。它能容纳不能容纳的东西 解读事物本身：为什么、针对什么、以什么价格以及 零件如何配合。在路不明显的地方值得写， 选择是有代价的，或者两只手可以解决同样的问题 问题不同；校长说，不管是不是。

迭代：实质变化首先进入意图并传播 在链条中，尽早起草是一个合法的工具。

写入节奏：每轮写入一次工件，在 校长的确认，整轮有一个版本冲突。

收件人反馈没有自己的渠道：校长 对其进行处理，并通过/forge intent反馈结论。

渲染永远不会手动编辑：迭代的是它的配方。

渲染和配方。 渲染是特定于受众的输出 从链上生成；它不分配任何内容，也绝不是 真相。它的配方 recipes/<recipe>.md 保存输入、 受众、说明和输出模板在一个版本中 文件，/render <recipe> 重新生成它的输出。每个 渲染以它的出处作为前面的内容开始，引用了配方 及其输入。一个渲染器可以作为另一个渲染器的输入， 当引用的菜谱在其输入中声明它时。

从 Markdown 到幻灯片。 锻造厂生产的一切都是 降价。撰写食谱可以按流派为指导 （/recipe presentation）。输出分两步进行，每一步都有 它自己的命令。 /render 制作 Markdown，其中配方 在其 Format 部分中命名格式，即普通 .docx 或 .pptx 旁边是pandoc：便宜，每次都一样，还有美人鱼 图表以代码块的形式登陆。 /publish使设计 通过模型将文件写入published/：昂贵，由 仅主体，取自 Markdown，因为它位于磁盘上，从不 渲染并发送任何内容到任何地方。没有格式的菜谱 以 Markdown 结束。模板或参考文档的命名方式为 路径，通常是图书馆项目的文档，页面为A4 默认情况下。 Markdown 仍然是事实的来源，而所有其他 格式转换发生在伪造之外。

8.孤立的审稿人

评审者从一个干净的背景开始：他们看到项目的 只是文件，而不是工作对话，所以它们不能 说出了我们真正的意思。每种审稿人都有一个特征： 会话模型上的隔离代理，手动调用，生成 通过演练解决的不可变的过时报告。没有审稿人 一切都取决于克劳德自己的判断。

孤立并不是独立。审稿人分享作者的模型 家庭：家庭系统上看不到的东西，他们中没有人会看到 找到，所以他们的协议永远不会被视为验证。的 校准点位于锻造厂之外，由人工或由人工审核 不同的模范家庭，由校长酌情邀请。

评论家 ( /critique )

评论家评判的是文件的质量，而不是实质内容。 运行方式为/critique <lens> [artefact]；没有人工制品 读取整个链，并列出名单。

• clarity - 单独读取每个工件的歧义， 矛盾、重复、范围卫生和需求风格； 移交前适合。
• essence - 读取漂移链：提取每一层的精华 盲测并与上面的层进行比较；一秒即可贴合 层存在。

输出：结果 (FND) reviews/YYYY-MM-DD-critique-<lens>.md。其中一项发现 状态：

• open
• resolved
• rejected
• parked
• obsolete

挑战者 ( /challenge )

挑战者判断思想的实质，而不是记录 质量。运行方式为/challenge <persona> [artefact]；没有 artefact 它读取整个链，并列出名单。

• cto - CTO- 级同行评审员，挑战以下内容的实质内容： 校长的思维：假设、盲点、二阶 效果、组织现实。
• architect - 高级解决方案架构师，挑战如何 想要的东西都实现了：选择、价格、零件如何 适合什么，什么会先坏掉。

输出：挑战（CHL） challenges/YYYY-MM-DD-challenge-<persona>.md。挑战就在其中 其中：

• open
• accepted
• rejected
• parked
• obsolete

检查（ /check ）

检查验证机械是否符合惯例，决不 物质或质量。它作为 /check <check> [slug] 在 项目或发动机上；裸露它列出了名单。每张支票拥有 一关心，检查从不互相调用。

• light - 验证项目的簿记：前面的事项反对 历史伴侣，对照文件的分类表， 针对目录的依赖关系和资源索引；适合 一次保存。
• project - 验证项目的结构、IDs、语言、 不可变的、配方和渲染违反惯例。
• engine - 验证核心（CLAUDE.md、模板、技能、代理、 脚本）针对自身和伪造意图：每个 地位受到尊重，没有撤回任何内容，仍然在广告中，每个 反映的决定。
• single-source-of-truth - 验证每条规则、程序和 文件形状写在一个地方并在其他地方引用；的 诚实的扫描，设计昂贵，适合在专业之前或之后 在操作层上进行轮询，而不是在每个版本中进行轮询。
• history - 读取文档及其历史记录并报告 他们之间的划分不成立，提出了完整的每一步； 在清理文档时适合，而不是在保存或发布时适合。

输出：reviews/YYYY-MM-DD-check-<name>.md 中的结果（FND）， 仅当检查发现某些内容时才提交。他们的州是 调查结果指出：

• open
• resolved
• rejected
• parked
• obsolete

9. 命令

命令是入口点；每个功能的完整内容由以下内容打印 /man <command>.

/ingest 将文件或文本粘贴到对话中，存储 它在一个短的弹头下，尽可能地记录它的起源日期，而不需要 询问，并添加索引条目；然后它会询问来源的用途。 对于每个二进制文件，它都会询问一个问题，是否将其转换为 Markdown：如果是，则摘录是源，如果不是，则保留二进制文件 作为一个功能性的东西。个人问题之前停止命令 任何东西都被存储。未处理任何内容：已注册的源正在等待 对于校长来说。 /save 运行灯检查，建议单行 从该轮的历史记录中起草提交消息，以及 提交并推动您的确认；标签仅设置在您的 词。 /release 始终是一个存储库：它运行其检查并 与您解决他们的调查结果，重新生成 README 和 发行说明，告诉您其中发生了哪些重大变化，然后 保存时显示消息 release <intent version>: <one line>。

命令并不是唯一的门：同样的规则简单明了 谈话。

典型的旅程

• 您可以单独或与锻造厂一起将您的想法整理成摘要 (/forge brief).
• 你通过尽可能多的会议来塑造意图，回答 问题并解决未解决的问题（/forge intent）。
• 你让审稿人按他们的发现做出裁决，一 一次项（/challenge、/critique）。
• 您编写演示文稿并渲染它，包括 PowerPoint 文件（/recipe presentation、/render、/publish）。
• 你为那些将按照你的行动行事的人提炼出任务 项目（/forge assignment）。
• 如果方法不明显，你就写一个解决方案设计 (/forge solution-design).
• 您可以边走边保存 (/save)，并在某个状态值得时释放 标记（/release）。

10. 惯例

IDs. 每个项目都有一个 ID，其形式为 PREFIX.NNNN，所有前缀 三个字母。 IDs 是全局且稳定的，从未重新编号，并且 项目可以在组之间移动而不更改其 ID。物品有 编号为数十，每个新组从下一百个开始。 组是普通标题，没有 IDs，没有元数据，也没有生命周期， 最多两层深。

条款。 每项作业都有一个条款部分，列出了 它实际使用的前缀和术语，以便可以转发 没有口头传统；定义的术语在项目文本中大写。

语言。 熔炉规定了每个项目的一种输出语言： 链的工件（意图、分配、后面的层）被写入 使用项目的账本标题声明的语言（language， 缺席时使用英语）。内裤是个例外，可以放在任何地方 项目所使用的其他所有内容 （分类帐、决策、历史、评论、挑战、索引、研究、 食谱）始终是英文，符号如下：ID 前缀，shall， 状态字、前置键。渲染可以是任何语言 食谱声明。对话的语言是配置 实例并位于 CLAUDE.local.md 中。

需求风格。 作业的项目是用 应该和不应该，在完整正确的句子中，每个想法一个 项目，每项写一次；会、可以、应该、可能、可能和 MoSCoW 不使用措辞。没有优先顺序：一切都是 必要的，例外情况下带有注释“可选”。 建议而不是要求可测试性。一个项目不能依赖于 需要理解、同意或稍后测试的外部链接。安 说明性项目：

REQ.0010 平台记录每一个请求和每一个响应 通过网关，带有请求者的身份 用户和时间。

完整性胜过简洁性。作业包含完整的内容 意图范围内的实质内容：为简洁起见，没有遗漏任何内容 出于保真度的考虑，长度是任意的。留下一件事 仅作为显式委托、DEL 或 TBC 项才合法。 结构先于散文：叙事仅限于目的和 背景和目标。

边界。 分配分配，但它不解决： 执行交付的机器属于收件人。

版本控制。 整数表示已签署的版本：

• 0.1, 0.2, … 首次批准前草稿
• 1.0 已批准
• 1.1, 1.2, … 批准后变更，尚未批准 他们自己
• 2.0 下一个批准版本，包含自 1.0 以来的所有更改

前面的内容为version、date、status （草稿 | 已批准 | superseded) and last_change.

文档类型。 “文档”是指一个文件中的每个文件。 项目，“artefact”是为链上的文档保留的。

每个版本化文档都将其历史记录保存在仅附加的文件中 同伴<file>.history.md在它旁边，从来没有在它的身体里，与 前面的last_change源自最新记录。安 整数版本已获批准，其他版本均未获批准；一个食谱是 从未获得批准并保持 0.x。

账本 ledger.md 是唯一的事实来源 项目状态：可以自由重写并保持最新状态 每一次操作。

项目种类。 项目有一个种类，在标头中声明 它的账本：thought是链； library 是材料共享 跨项目，前缀为 lib-，没有链，只有 分类帐、来源和研究，其 README 的目录 成立。项目 slugs 在磁盘上为小写并用连字符连接，并显示 名称可能不同：系统自己的项目是forge，库是 lib-<name>.

11. 存储库布局

CLAUDE.md                  # the universal core: roles, rules, conventions
CLAUDE.local.md            # instance facts: who the principal is and
                           # the conversation language; gitignored
README.md                  # for humans — a render (/render readme)
RELEASE-NOTES.md           # release notes — a render (/render
                           # release-notes); the shape:
                           # templates/recipe-release-notes.md
CONTRIBUTING.md            # for a visitor who wants to say, ask or
                           # change something — a render (/render
                           # contributing)
logo.png                   # project avatar
LICENSE                    # CC BY 4.0 — the engine is published
                           # under attribution
scripts/                   # forge-save / forge-pull / forge-status
                           # / forge-clone / forge-branch (git),
                           # doc2md (document →
                           # Markdown), md2pptx (deck render →
                           # PowerPoint), md2docx (render → Word),
                           # each by pandoc or by a model,
                           # hook-walkthrough (the per-prompt hook
                           # of .claude/settings.json)
.claude/                   # skills (the commands, the reviewers'
                           # contracts and the walkthrough method),
                           # agents, settings
                           # (settings.local.json: the session
                           # model — gitignored)
templates/                 # canonical skeletons
projects/                  # gitignored (projects/*) except
                           # projects/forge — every other project is
                           # a git repository of its own, which the
                           # engine does not know
projects/<slug>/           # kind: thought — the chain
  .git/                               # the project's own repository
  README.md  RELEASE-NOTES.md         # renders of the project's own
                                      # recipes
  logo.png                            # optional project avatar
  00-brief.md  10-intent.md           # the trunk of every project
  NN-<layer>.md                       # layers below the intent, as
                                      # the project needs them
  threads.md                          # the project's open threads,
                                      # part of the intent
  00-brief-<name>.md                  # later briefs, one per whole
  <file>.history.md                   # history companion of a
                                      # versioned document, append-only
  <file>.history.archive.md           # a history table before the
                                      # log, immutable
  decisions.md  ledger.md             # ledger header carries kind:
  sources/00-INDEX.md                 # resource index (rewritten)
  sources/<name>.<ext>                # immutable external inputs, one
                                      # form each: <slug>.md extract of
                                      # a binary, or the binary itself
  sources/.gitignore                  # originals converted in place
  sources/<slug>/                     # bundle of related files = one
                                      # source, one ledger entry;
                                      # catalogued by its 00-INDEX.md
  research/00-INDEX.md                # resource index (rewritten)
  recipes/<recipe>.md                 # render recipes: inputs, audience,
                                      # instructions, template — iterated
  recipes/<recipe>.history.md         # the recipe's history
  renders/<recipe>.md                 # generated outputs, overwritten by
                                      # /render, provenance front-matter
  renders/<recipe>.pptx               # the plain file of a render, made
  renders/<recipe>.docx               # by /render through pandoc where
                                      # the recipe names a format
  published/<recipe>.pptx             # the designed file, made by
  published/<recipe>.docx             # /publish through a model
  reviews/YYYY-MM-DD-critique-<lens>.md  # immutable critique runs
  reviews/YYYY-MM-DD-check-<name>.md     # immutable check reports,
                                      # filed when a check finds
                                      # something
  challenges/YYYY-MM-DD-challenge-<persona>.md  # immutable peer reviews
  research/YYYY-MM-DD-<topic>.md      # immutable research notes
  CLAUDE.md                # optional project-specific polish; note
                           # that Claude Code's /export writes into
                           # the working directory — export outside
                           # the project or gitignore it
projects/lib-<name>/       # kind: library — material shared across
  .git/  ledger.md         # projects, no chain: only the ledger,
  README.md  logo.png      # sources and research; documents
  recipes/readme.md        # maintained by their owner; README =
  recipes/readme.history.md  # the catalogue, a render of its recipe
  sources/00-INDEX.md
  research/00-INDEX.md

12. 设置

先决条件

• git
• PowerShell 7 (pwsh)：脚本为 PowerShell，macOS 上需要 还有Linux
• Python 3（用于降价）
• 克劳德付费订阅

获取伪造品和克劳德密码

克隆这个存储库：它是引擎。然后安装克劳德代码：

# Windows
irm https://claude.ai/install.ps1 | iex

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# or
npm install -g @anthropic-ai/claude-code

首次运行时登录；用法与克劳德聊天来自同一池。 始终从引擎根启动 claude，以便 CLAUDE.md 和 CLAUDE.local.md 负载。

然后运行 /setup 一次。它从模板中填充 CLAUDE.local.md 与您进行简短的采访：首先是对话语言，然后是 校长是谁。该文件被 gitignored 并且从未提交。它 创建 .claude/settings.local.json ，会话模型设置为 《神鬼寓言》，最强的可用模型，整个锻造包括 盲目审稿人继续；它用一句话告诉你，并且 /model 或编辑该文件随时会更改它。权限 来自共享的 .claude/settings.json。

/setup 以你的 git 身份结束，这是 git 自己的。它问 对于您推送到的主机，每个主机都有一个名称和一个电子邮件，以及 提议将 includeIf 节写入您的 ~/.gitconfig：一 每个主机的身份，由 git 从远程的 URL 解析。和他们一起 它提供了一个全局守卫，user.useConfigOnly = true，以便 没有节的主机上的存储库会大声失败而不是提交 有默认值。如果您拒绝，它会打印供您申请的行 用手。熔炉本身在任何地方都没有设置身份，并且 /setup 永远不会覆盖现有文件。

您的项目

每个项目都是 projects/ 下的一个目录和一个 git 仓库 它自己的。 /new-project 创建文件； git init 在那 目录和遥控器（如果您需要的话）都是您的一次性行为， 并且提交身份是 git 的，从您自己的每个主机解析 配置。引入现有项目 /import-project <git-url>，将其克隆到 projects/<repository name> 至 scripts/forge-clone.ps1 和 报告 git 为其解析的身份。引擎忽略 projects/*，除了它自己的projects/forge，脚本发现 您的项目通过其 .git。没有存储库的项目是 报告为“不在 git 下”：事实，不是错误。

脚本先决条件

• doc2md.ps1 需要降价： pip install "markitdown[docx,pptx,pdf,xlsx,xls]".
• md2pptx.ps1 和 md2docx.ps1 各有两个引擎 (-引擎 pandoc | claude），每个引擎都有自己的需求。的 pandoc引擎，在/render后面，需要pandoc （https://pandoc.org/installing.html）。 claude 发动机，后面 /publish，需要document-skills插件，安装一次 交互式克劳德代码会话： /plugin marketplace add anthropics/skills，则 /plugin install document-skills@anthropic-agent-skills.
• 甲板模板由路径（-Template <file.potx>）命名，并且 同样适用于 Word 的参考文档（-Reference、.docx、 .dotx 或 .dotm），通常是库项目的文档。 没有，模型设计视觉效果和 pandoc 的内置 样式适用于 A4 页面（-PageSize Letter 表示 US Letter）。
• git 脚本除了 git 之外不需要任何东西。

保存和同步

有两扇门。 /save 运行灯光检查，然后提交并 推送当前分支，不进行渲染。 /release，来自 main 仅进行检查并与委托人解决调查结果 （对于项目，灯光和项目检查，对于发动机， 引擎检查），提供 critique essence 一次，重新渲染 README 和发行说明，然后与发行消息一起保存 并且，在经批准的专业中，标签为 v<major>。

下面是 scripts/ 中的脚本。为了克劳德，为了每一个 锻造的命令他们是 git 的唯一大门，阅读状态 包括在内。每个服务于引擎和每个项目存储库：一个裸露的 save 提交每个存储库自己的更改并推送到其中 它有一个遥控器。 main 是发布的线路，分支是 自愿：forge-branch 创建或切换分支，并合并 与 git 保持一致。每个存储库有一个远程，并且没有 URL 写在锻造厂的任何地方。

升级中

升级引擎为scripts/forge-pull.ps1，快进 main。您的项目未受其影响并且没有记录任何引擎 版本。

首先阅读 RELEASE-NOTES.md，需要采取行动行：他们说 新版本对您的项目和实例文件有何期望。 然后，逐个项目运行 /check light <slug> 并 /check project <slug>：他们一起衡量项目 现行惯例并报告不再符合的内容，什么都没有 否则。与 Claude 一起逐一查看调查结果并达成一致 迁移什么以及如何迁移；克劳德改变了你的诺言 会话，其间没有迁移工具。支票和 发行说明就是工具。

您离开的项目在原来的约定下仍然有效 写给；迁移它是你的决定，每个项目，永远不会 假设。

13. 脚本

该锻造厂运行于 Windows 之外。 scripts/ 是唯一平台绑定的 层并被编写为在 Linux 和 macOS 上运行不变： 跨平台 PowerShell 7，仅适用于 Windows，并且 外部工具（git、markitdown、pandoc、claude）已解决 来自 PATH。新脚本是用Python编写的，PowerShell 脚本会及时重写。

14. 计划的扩展

校长打算继续向下延伸发动机：想法 被锻造成他需要的程度。 BRD 层肯定会 来；旨在解决方案架构和集成；一个策略 如果证明有意义的话，分层是可能的。添加了哪些层， 以及按什么顺序开放，并且没有批准建设： 层的机制是在该层实际存在时设计的 采取了。一种新的人工制品被添加到引擎中 命令，/new-artefact <name>，这导致一切都是这样的 不需要什么，也不决定什么。

这些层是在同一个项目中由同一位负责人之手生长的。 接收者对作业所做的事情是他自己的工作： 任务变成了他的任务简介。链条永远不会跨越两个 主体，因此更多的主体意味着更多的实例，协调 通过 git.

独立挑战者，在不同的车型系列上运行 作者的，已计划；方向已定，机制已定 设计时采取。

projects/forge/ 是通过自己的流程运行的 Forge of Thought： 它的简介、意图、决定和分类帐。流程的改变是 仅在更新该意图且此 README 后才完成 重新渲染。

16.关于这个README

该文件是项目 projects/forge 的渲染：它永远不会 手动编辑并由 /render readme 重新生成 流程变化，由引擎的每一个/release进行。修复进入 配方或输入。出处前面的问题位于顶部 该文件是按设计保存的，对系统的更改记录在 projects/forge/.

最后更新：2026-10-04