1. 项目概述为什么我们需要一个“项目上下文管理器”如果你和我一样经常使用像 OpenClaw 这类 AI 助手进行深度、长期的创作或开发工作你肯定遇到过这个痛点聊着聊着项目就“丢了”。我说的“丢”不是文件不见了而是“上下文”断了。你可能在同一个主会话里同时推进着三四个项目——一个在写 Python 爬虫一个在规划产品原型还有一个在整理读书笔记。聊到一半你切出去处理了个临时问题或者干脆就是第二天重新打开助手想继续昨晚的爬虫项目。这时你发现你需要花好几分钟甚至重新上传文件、复述一遍背景才能让助手“回忆”起你昨天做到哪一步了。更糟的是如果讨论过程中产生了一些关键决策、待办事项或者临时的代码片段它们都散落在冗长的聊天记录里像珍珠掉进了沙堆下次想找出来复用难上加难。这就是project-context-manager这个 OpenClaw skill 要解决的核心问题长期、多项目协作下的上下文管理与状态恢复。它不是一个花哨的 UI 或者一个试图读心术的黑盒而是一套基于文件系统的、朴实但极其有效的“项目管理约定”和工作流。它的目标很简单让你和 AI 助手之间的每一次长线协作都像打开一个专业的 IDE 项目一样拥有清晰的结构、可追溯的进度和随时可恢复的“断点”。它把一次性的、线性的聊天对话升级成了一个可持久化、可分支、可归档的“项目工作空间”。简单来说这个 skill 为你和 AI 助手建立了一套共同遵守的“项目语言”。当你启动一个长期任务时它会帮你初始化一个结构化的项目文件夹当你需要暂停时它会帮你把当前的讨论焦点、待办事项、关键结论固化到特定的 Markdown 文件中当你想回来继续时它能立刻带你回到上次的“断点”无缝衔接。这尤其适合软件开发、内容创作、学术研究、复杂问题拆解等需要多轮深度交互的场景。如果你经常觉得和 AI 的对话“聊完就忘”、“难以承接”那么这个工具很可能就是你工作流中缺失的那块拼图。2. 核心设计思路文件即上下文约定优于配置在深入使用细节之前理解project-context-manager的设计哲学至关重要。这决定了你是否能用好它以及它是否能真正融入你的工作流。它的核心思路可以概括为两点“文件即上下文”和“约定优于配置”。2.1 为什么是“文件”而不是“记忆”许多 AI 应用或插件试图在后台通过复杂的向量数据库或记忆机制来维护上下文。这听起来很智能但也带来了不确定性你永远不知道它“记住”了什么又“忘记”了什么它的记忆是黑盒无法直接查看和编辑一旦会话重置或切换这些记忆就可能丢失。project-context-manager反其道而行之它认为最可靠、最透明、最可控的“记忆”载体就是你本地硬盘上的文件。所有关键的上下文信息——项目目标、当前进度、待办事项、关键决策、甚至是用于恢复对话的“系统提示词”——都被要求以 Markdown 文件的形式保存在一个结构清晰的项目目录里。这样做有几个巨大的优势绝对可控与可移植性文件在你手里。你可以用任何文本编辑器查看、修改、备份它们。你可以把整个项目文件夹压缩发给同事或者放到另一个设备上上下文完整无损。人类与AI可共同读写Markdown 是一种对人友好、对机器也易于解析的格式。你既可以自己编辑这些文件来更新进度AI 助手也可以根据你们的对话自动更新这些文件的内容。状态持久化不依赖会话只要文件在项目的“状态”就在。无论你关闭 OpenClaw、重启电脑还是过了一周再打开只要加载这个项目目录你就能立刻回到工作现场。便于版本管理你可以用 Git 来管理整个项目文件夹。每一次重要的进度更新或决策记录都可以是一次 commit。这为长期项目提供了天然的版本历史。所以这个 skill 本质上是一个“基于文件系统的上下文协议执行者”。它定义了一套文件应该怎么命名、放在哪里、包含什么内容然后确保 AI 助手在项目模式下严格地读取和更新这些文件。2.2 “约定优于配置”的具体体现为了让这套机制足够轻量、易用skill 采用了“约定优于配置”的原则。这意味着它提供了一套推荐的最佳实践和默认结构你只需要遵循就能获得绝大部分功能无需进行繁琐的配置。固定的核心文件它建议每个项目都包含几个核心文件如00_恢复入口.md、00_文档总索引与当前进度.md等。这些文件名和位置是约定好的skill 会直接去寻找它们。轻量级注册表为了管理多个项目它使用一个简单的 JSON 文件如projects-registry.json作为项目注册表。你不需要配置复杂的数据库只需维护这个 JSON 文件列出你的项目路径和名称。明确的操作口令进入、退出、恢复、固化项目都通过几句自然语言口令触发如“恢复项目”、“固化当前状态”。这些口令是约定好的交互方式简单直接。这种设计极大地降低了使用门槛。你不需要理解背后复杂的逻辑只需要记住几个简单的口令和文件结构就能获得强大的项目管理能力。当然这套约定也是可扩展的你可以根据自己的习惯在理解其原理后调整模板和流程。3. 核心能力与工作流全解析了解了设计思路我们来看这个 skill 具体能做什么。它的所有功能都围绕一个核心工作流展开项目的生命周期管理。我们可以把这个生命周期拆解为几个关键环节每个环节都对应着 skill 的一项或多项核心能力。3.1 项目初始化从零搭建一个“可管理”的项目当你开始一个全新的、预计会长期进行或需要多轮讨论的任务时就应该为其“初始化”一个项目。这是整个工作流的起点。典型场景“我想开发一个个人财务跟踪的 CLI 工具预计需要设计数据模型、编写核心逻辑、做数据可视化几个阶段想和 AI 一步步讨论实现。”你的操作在 OpenClaw 中你可以直接说“帮我建一个长期项目用来开发个人财务CLI工具。” 或者说“给‘财务CLI工具开发’这个任务建立项目结构。”Skill 的内部运作与你的实操创建项目根目录Skill 会首先询问你希望把这个项目文件夹创建在什么位置例如~/Documents/MyProjects/。你需要提供一个路径。填充项目模板接着skill 会调用其自带的scripts/init_project.py脚本或类似逻辑将templates/目录下的所有模板文件复制到你指定的新目录中。这包括00_恢复入口.md: 这是最重要的文件里面包含了用于让 AI 助手恢复项目上下文的核心提示词和指令。初始化时它会包含项目名称、简要描述等占位符等待后续填充。00_文档总索引与当前进度.md: 项目的“主页”用于记录项目概述、最终目标、当前阶段、下一步待办TODO列表。01_项目会话与恢复机制说明.md: 给未来的你或协作者看的说明文档解释这个文件夹的结构和如何恢复工作。99_关键决策记录.md: 用于记录在讨论过程中做出的所有重要设计决策、取舍原因。checkpoints/和session-backups/目录用于存放阶段性的快照和会话备份。更新项目注册表skill 会自动或提示你手动将新项目的路径和名称添加到本地的projects-registry.json文件中。这样这个新项目就被纳入了统一管理。实操心得初始化时的关键一步初始化完成后千万不要跳过“立即进入项目”这一步。你应该紧接着说“现在进入这个项目”或“恢复这个项目”。这样skill 会引导 AI 助手读取刚创建的00_恢复入口.md并根据里面的指令将对话上下文切换到“项目协作模式”。助手会开始依据00_文档总索引与当前进度.md中的内容来理解项目背景并等待你的进一步指令。如果你初始化完就直接开始聊别的项目上下文并没有被真正“激活”。3.2 项目进入与恢复一键回到工作现场这是 skill 最常用的功能。当你处理完其他事情想继续之前某个项目时就需要“恢复”或“进入”该项目。典型场景昨天你和助手讨论了财务CLI工具的数据模型设计并约定今天实现核心计算逻辑。今天你打开 OpenClaw。你的操作直接说“恢复项目。” 或 “进入项目。”Skill 的内部运作与你的实操读取注册表Skill 会去查找预设位置如工作空间根目录的projects-registry.json文件。扫描与验证它遍历注册表中列出的所有项目路径检查每个路径是否存在以及核心文件如00_恢复入口.md是否有效。列表展示将所有有效的项目以列表形式呈现给你通常包括项目名称和路径。用户选择你需要从列表中选择你想要进入的那个项目例如“个人财务CLI工具”。加载恢复入口Skill 引导 AI 助手读取你选中项目下的00_恢复入口.md文件。这个文件里的指令会“告诉”助手“现在你正在处理XXX项目你的角色是XXX当前进度是XXX接下来应该关注XXX。” 同时助手也会加载00_文档总索引与当前进度.md来了解最新情况。上下文切换完成此时AI 助手的“大脑”已经完全切换到了该项目的上下文中。它记得之前的设计决策来自99_关键决策记录.md清楚当前的待办事项并准备好从上次的断点继续工作。你可以直接说“我们昨天设计了数据模型今天开始写计算收入的函数吧。” 助手能立刻理解。注意事项恢复的本质“恢复项目”并不是在“回忆”聊天历史而是在根据文件重建一个高度结构化的、精准的上下文。因此即使你清空了聊天记录只要项目文件在你依然可以完美恢复。这也意味着你需要保持项目文件的更新特别是00_文档总索引与当前进度.md里的 TODO 列表和当前阶段描述这是恢复后助手行动的依据。3.3 项目状态固化保存关键决策与进度在项目推进过程中会不断产生新的进展、做出的决策、产生的代码片段。如果这些信息只停留在聊天记录里它们就无法被下一次“恢复”有效利用。因此需要定期“固化”项目状态。典型场景经过几轮讨论你们确定了财务CLI工具使用 SQLite 作为本地数据库并完成了数据库连接层的代码。你的操作在觉得达到一个阶段性节点时对助手说“固化当前项目状态。” 或 “更新恢复文件并保存当前断点。”Skill 的内部运作与你的实操总结当前进展AI 助手会基于刚刚结束的对话轮次提炼出关键信息我们刚才做了什么得出了什么结论产生了什么有价值的产出如代码块、文案更新核心文件更新进度文件将提炼出的“已完成事项”从00_文档总索引与当前进度.md的 TODO 列表中移到“已完成”部分并可能细化或新增下一步的 TODO。记录关键决策如果本次对话做出了重要选择比如“选用 SQLite 而非 JSON 文件存储”助手会将这个决策及其理由整理成一段清晰的记录追加到99_关键决策记录.md中。保存产出物生成的代码、配置片段等可能会被建议保存到项目目录下新建的对应文件中如database.py并在进度文件中加以说明。可选创建检查点在一些重大里程碑你可以要求“创建一个检查点”。这可能会将整个项目目录打包备份到checkpoints/下或者保存一份当前的完整会话记录到session-backups/。这提供了更粗粒度的时间旅行能力。实操心得固化时机的选择不要等到项目结束才固化。养成“讨论告一段落就固化”的习惯。例如每完成一个功能模块的设计、每解决一个复杂的技术难题、每产生一份重要的文档草稿后都执行一次固化操作。这能保证你的项目文件始终反映最新、最完整的进度避免信息遗漏。你可以把“固化状态”当作是项目开发中的一次“保存”或“提交”。3.4 项目退出从项目模式回到普通聊天当你需要暂时中断项目工作去进行一些临时性的、不相关的查询或聊天时就需要“退出”项目模式。你的操作直接说“退出项目。” 或 “回到普通模式。”Skill 的内部运作这很简单。Skill 会引导 AI 助手清除当前的项目上下文即不再主动引用项目文件夹内的那些特定文件并将对话模式切换回普通的、无状态的问答模式。此时助手不再“记得”项目里的 TODO 和决策就像关闭了一个专属的工作空间回到了公共大厅。注意事项退出前先固化一个非常好的实践是在退出项目前先执行一次“固化状态”。这样可以确保你在项目中的所有最新工作都已保存到文件。否则退出后刚才最后一段对话中的宝贵内容可能就只留在了易失的聊天记录里。3.5 接管已有项目目录将旧项目纳入管理你很可能已经有一些正在进行中的、文件夹里堆满了资料的项目。project-context-manager允许你将这些现有目录“接管”过来为其补全管理所需的结构从而享受同样的上下文管理能力。你的操作上传或指向一个已有目录然后对助手说“这是我的项目目录‘旧营销方案分析’帮我接管。” 或 “把这个目录纳入项目管理。”Skill 的内部运作与你的实操检查目录Skill 会检查该目录下是否已存在部分核心文件比如你自己建的README.md或notes.txt。补充缺失结构它会将缺失的模板文件如00_恢复入口.md、99_关键决策记录.md等复制到该目录中但会避免覆盖已有的文件。引导初始化接着它会引导你一起基于现有目录的内容来初始化00_恢复入口.md和00_文档总索引与当前进度.md。例如它可能会问你“这个项目的核心目标是什么”、“根据现有文件我们当前进展到哪一步了”然后将你的回答整理进模板。注册项目最后将这个已有目录的路径添加到项目注册表中。这个过程相当于为你混乱的旧项目文件夹“赋能”给它装上了一个标准化的“仪表盘”和“导航系统”。4. 项目结构与文件详解每一个文件的作用要真正驾驭这个 skill你需要理解它推荐的项目结构中每一个文件和目录存在的意义。这能帮助你在必要时手动调整或排查问题。你的项目文件夹/ ├── 00_恢复入口.md # 【核心】项目上下文的“总开关” ├── 00_文档总索引与当前进度.md # 【核心】项目的“实时仪表盘” ├── 01_项目会话与恢复机制说明.md # 给人类看的说明书 ├── 99_关键决策记录.md # 项目的“设计决策日志” ├── checkpoints/ # 重大版本快照可选 ├── session-backups/ # 原始会话备份可选 └── 你的其他项目文件... # 代码、文档、数据等4.100_恢复入口.md项目的灵魂文件这是最重要的文件没有之一。它的内容是一段精心编写的、给 AI 助手看的“系统提示词”。当你执行“恢复项目”时助手读到的就是它。一个简化示例# 项目恢复入口个人财务CLI工具 ## 项目状态激活 **当前模式**项目协作模式。请严格遵循以下指令。 ## 你的角色 你是专注于Python后端开发的专家助手正在与用户协作开发一个命令行个人财务跟踪工具。 ## 核心上下文来源 1. 首要参考00_文档总索引与当前进度.md 中的项目概述、目标和 **【当前进度】**。 2. 决策依据99_关键决策记录.md 中记录的所有历史决策。 3. 本项目目录下的所有文件.py, .md, .sql等均为可用资源。 ## 当前阶段与行动指南 - **阶段**核心功能开发阶段。 - **上一轮进展**已完成数据库连接层 (database.py) 和收入/支出数据模型定义。 - **本轮焦点**根据 00_文档总索引与当前进度.md 中【下一步TODO】列表的第一项开始工作。 - **工作方式**每次回复应紧扣项目目标优先推进TODO项。所有代码修改应指向本项目目录下的具体文件。重要讨论结论需建议用户“固化状态”。 ## 固化与退出 - 当用户说“固化状态”时协助更新 00_文档总索引与当前进度.md 和 99_关键决策记录.md。 - 当用户说“退出项目”时结束本段提示词的约束回到普通对话模式。它的作用身份设定告诉助手在这个项目里应该扮演什么角色财务专家、代码助手、写作教练等。上下文锚定明确指出核心信息来自哪几个文件防止助手“瞎猜”或使用过时的记忆。行动规范规定助手应该如何工作例如紧盯TODO列表建议固化状态。指令绑定将“固化”、“退出”等自然语言口令与具体的文件操作关联起来。注意事项维护恢复入口随着项目演进你的目标或助手的角色可能需要微调。你可以手动编辑这个文件。例如从“开发”阶段进入“测试”阶段后你可以把“你的角色”部分从“开发专家”改为“测试与调试专家”并更新“行动指南”。这能让恢复后的助手行为更贴合当前需求。4.200_文档总索引与当前进度.md项目的实时仪表盘这个文件是项目的“活页手册”由你和助手共同维护始终保持最新。典型结构# 项目个人财务CLI工具 **创建日期**2023-10-27 **最后更新**2023-10-28 [由助手更新] ## 1. 项目概述 开发一个本地命令行工具用于跟踪个人每日收入、支出生成月度报表并进行简单的消费分类分析。 ## 2. 终极目标 - V1.0实现基础的增删改查(CRUD)和月度总结。 - V2.0增加消费类别自动归类、可视化图表导出。 ## 3. 当前进度 (【重点阅读区域】) **当前阶段**核心功能开发阶段 (第二阶段) **最近进展** - [x] 项目初始化与需求确认 (2023-10-27) - [x] 技术选型与架构设计确定使用Python SQLite Click库 (2023-10-27) - [x] 数据库连接层与核心数据模型 (models.py) 实现 (2023-10-28) - [ ] **【进行中】** 收入/支出记录的核心业务逻辑层 (service.py) ## 4. 下一步 TODO (【行动依据】) 1. [高优先级] 实现 service.py 中的 add_transaction(amount, category, date, note) 函数。 2. [高优先级] 实现 get_monthly_summary(year, month) 函数。 3. [中优先级] 设计并实现主命令行界面 (cli.py) 的骨架。 4. [低优先级] 编写初步的单元测试。 ## 5. 项目文件索引 - database.py: SQLite数据库连接与初始化。 - models.py: 数据表模型定义Transaction表。 - service.py: (待实现) 核心业务逻辑。 - cli.py: (待实现) 命令行交互入口。 - requirements.txt: 项目依赖。 ## 6. 待澄清问题 - 消费分类是预定义固定列表还是允许用户自定义它的作用进度跟踪清晰的“已完成/进行中”列表让你和助手一眼就知道项目在哪。任务驱动“下一步TODO”列表是恢复项目后助手立即开始工作的行动清单。你们可以一起从上到下攻克。信息聚合项目概述、文件索引、待澄清问题都集中在这里是项目的总百科。实操心得如何写好TODO把TODO写得具体、可执行。避免“完善功能”这种模糊描述而是写成“实现XX函数的YY异常处理”。这样当助手恢复上下文后它能立刻理解要做什么并给出更精准的帮助。4.399_关键决策记录.md项目的设计日志这个文件记录所有“我们为什么这么做”的决策对于长期项目和团队协作尤其宝贵。示例记录## 决策记录 ### 2023-10-27: 数据存储方案选择 **问题**个人财务数据是存储在本地JSON文件还是SQLite数据库中 **选项** 1. JSON文件简单无需额外依赖但并发读写差查询能力弱。 2. SQLite轻量级数据库支持SQL查询事务安全是Python标准库一部分。 **决策**选择SQLite。 **理由** 1. 数据关系简单但未来可能变复杂如多账户、标签SQLite更易扩展。 2. 需要经常进行按月汇总、按类别筛选等查询SQL查询比手动解析JSON更高效可靠。 3. sqlite3模块是Python内置不增加额外依赖符合工具“开箱即用”的定位。 **记录人**与助手讨论后共同决定。它的作用避免重复争论当几周后你忘了为什么选SQLite时翻看这里就能立刻明白。保持一致性确保项目不同阶段的设计遵循同一套原则。知识传承如果你是项目负责人这份记录能帮助新加入的协作者或未来的你快速理解项目脉络。4.4 其他文件与目录01_项目会话与恢复机制说明.md这是一份静态文档用于向你自己或他人解释这个文件夹为什么长这样以及如何使用这套机制。在项目初始化后通常不需要频繁改动。checkpoints/建议在这里存放项目重大里程碑的压缩包或快照。例如在完成V1.0所有核心功能后可以将整个项目目录除checkpoints本身外打包成v1.0-core-functions.zip存于此。这提供了额外的保险。session-backups/你可以选择将一些重要的原始对话记录导出为文本文件存于此。虽然结构化文件是主要上下文但原始对话有时包含有用的思维过程。5. 项目注册表与多项目管理当你拥有多个项目时一个统一的“入口”就变得必要。project-context-manager通过一个轻量级的项目注册表Project Registry来实现这一点。5.1 注册表是什么它通常是一个位于你工作空间根目录下的 JSON 文件例如你的工作区/projects-registry.json。内容示例{ projects: [ { name: 个人财务CLI工具, path: /Users/liuboyang/Documents/Projects/finance-cli, description: 开发用于跟踪个人收支的命令行工具, lastAccessed: 2023-10-28 }, { name: AI写作助手Prompt优化研究, path: /Users/liuboyang/Documents/Research/prompt-optimization, description: 系统化测试和优化用于内容创作的AI提示词, lastAccessed: 2023-10-25 }, { name: 家庭网络升级方案, path: /Users/liuboyang/Documents/Plans/home-network, description: 规划Mesh组网、NAS选型及智能家居网络隔离, lastAccessed: 2023-10-20 } ] }5.2 Skill 如何与注册表交互列表展示当你说“恢复项目”时skill 会读取这个 JSON 文件将projects数组里的每一项项目名和描述呈现给你选择。路径验证在你选择后skill 会检查path字段指向的目录是否存在以及核心文件是否完好。如果路径失效它会提示你该项目可能已被移动或删除。自动更新当你通过 skill “初始化新项目”或“接管已有目录”时skill 通常会自动向这个注册表文件添加新条目。同样当你“退出项目”时它可能会更新该项目的lastAccessed时间戳。5.3 如何手动维护注册表虽然 skill 会尝试自动维护但了解手动维护很有必要尤其是在项目文件夹被移动或者你想清理旧项目时。添加项目直接用文本编辑器打开projects-registry.json按照格式添加一个新的对象到projects数组中即可。确保path是绝对路径或相对于注册表文件的正确相对路径。移除项目直接从projects数组中删除对应的对象条目。注意这只是从注册表列表中移除并不会删除你的项目文件夹本身。修改项目你可以修改name、description或更新path如果项目搬家了。注意事项注册表的路径确保projects-registry.json文件放在一个固定的、不会被轻易移动或删除的位置并且这个位置被 OpenClaw 或你的助手环境所知晓通常需要在 skill 配置或环境变量中设置。如果注册表文件本身丢了skill 就无法列出你的项目了。6. 常见问题与排查技巧实录在实际使用中你可能会遇到一些小问题。以下是我在长期使用中积累的一些常见情况和解决方法。6.1 问题执行“恢复项目”后助手好像没进入状态还在聊普通话题。可能原因1项目注册表路径错误或文件丢失。排查检查 OpenClaw 或 skill 的设置确认projects-registry.json的预期路径是否正确。直接去那个路径下看看文件是否存在。解决如果文件丢失尝试从备份恢复或手动重建一个。如果路径错误修正配置。可能原因2项目目录下的00_恢复入口.md文件内容为空或格式严重错误。排查打开你选择的那个项目文件夹检查00_恢复入口.md。它应该包含有效的 Markdown 和给助手的明确指令。解决可以手动编辑该文件或者更简单的方法退出当前会话然后重新对该项目目录执行一次“接管已有项目目录”操作。skill 会尝试修复或重新初始化核心文件注意备份原有文件。可能原因3AI 助手的上下文长度有限而00_恢复入口.md加上00_文档总索引与当前进度.md的内容太长导致核心指令被截断。排查检查这两个文件的大小。如果它们加起来超过了几千字取决于模型就可能出问题。解决精简文件内容。00_恢复入口.md只保留最核心的角色和指令。00_文档总索引与当前进度.md中的历史记录可以适当归档只保留最近的关键进展和当前TODO。6.2 问题我想让助手关注项目里的一个特定文件但它好像没看到。可能原因00_恢复入口.md中“核心上下文来源”部分可能没有明确指示助手去读取项目目录下的所有文件或者助手的能力限制导致它无法主动遍历目录。解决最可靠的方法是在对话中直接提及并引用该文件。例如“请查看我们项目目录下的design-sketches.md文件中的第三点方案然后基于它进行讨论。” 或者你可以把该文件的关键内容复制到当前的对话中。同时你可以修改00_恢复入口.md在“核心上下文来源”里加上一句“本项目目录下的所有相关文件均可作为参考依据。”6.3 问题“固化状态”时助手更新的内容不符合我的预期。可能原因1对话历史中的信息不够明确导致助手总结提炼时出现偏差。解决在触发“固化状态”前可以先用一两句话帮助手梳理一下“我们来总结一下刚才的进展我们确定了使用Pandas来处理数据并且你提供了数据清洗函数的初步代码对吗” 得到助手确认后再执行固化。这相当于给助手一个明确的总结方向。可能原因200_文档总索引与当前进度.md中的 TODO 列表格式不标准助手难以解析。解决保持 TODO 列表的格式简洁一致。使用- [ ]表示未完成- [x]表示已完成。每个 TODO 项尽量是一句清晰的陈述句。这能提高助手自动更新的准确性。可能原因3这是AI的固有局限性它可能无法完美理解所有对话的细微之处。解决将“固化状态”视为一个半自动的过程。助手更新文件后你一定要亲自检查一下00_文档总索引与当前进度.md和99_关键决策记录.md的更新结果。如果有不准确或遗漏的地方手动修改一下。这是人机协作中必要的质量把关环节。6.4 问题项目文件越来越多感觉有点乱。解决这是正常现象。建议建立子目录进行分类管理。例如项目文件夹/ ├── docs/ # 存放设计文档、需求说明等 ├── src/ # 存放源代码 ├── data/ # 存放测试数据或生成的数据 ├── notes/ # 存放临时性的讨论笔记或参考资料 └── 核心管理文件依然在根目录只要核心的00_*.md文件在根目录skill 就能正常工作。你的其他文件可以按任何逻辑组织。6.5 高级技巧定制你自己的项目模板如果你发现默认的模板文件不完全符合你的工作习惯完全可以进行定制。找到 skill 安装目录下的templates/文件夹。复制里面的模板文件到你自己的一个“自定义模板”目录。按照你的喜好修改这些模板文件的内容。例如你可以在00_恢复入口.md中定义更详细的角色指令或者在00_文档总索引与当前进度.md中增加“风险与障碍”章节。下次初始化新项目时不要使用 skill 的默认命令。你可以手动创建项目文件夹然后把你自定义的模板文件复制进去再手动编辑00_恢复入口.md中的项目名称和描述最后手动将该目录添加到projects-registry.json中。这套系统的强大之处就在于它的灵活性和基于文件的透明性。你越了解它就越能把它改造得适合自己的工作流。