# 上下文层 ## ctx CLI 命令 `ctx` CLI 管理域和任务。可用命令： * `ctx` \-- 显示帮助和可用命令 * `ctx new [name]` \-- 创建一个新任务（如果需要，则提示输入域；如果未指定 `name`，则提示输入任务名称） * `ctx import` \-- 将任务从任何域作为符号链接导入到 `.ctxlayer/` （当配置为空时设置为活动状态） * `ctx status` \-- 显示活动域和任务，以及 git 跟踪信息 * `ctx set` \-- 设置活动域和任务（交互式） * `ctx git [args...]` \-- 在活动任务目录中运行 git * `ctx drop task [name]` \-- 从 `.ctxlayer/` 中删除任务符号链接。如果未指定“name”，则提示任务 * `ctx drop domain [name]` \-- 从 `.ctxlayer/` 中删除域目录。如果未指定“name”，则提示输入域 * `ctx 删除任务` \-- 从上下文层永久删除任务。任务提示 * `ctx删除域` \--从上下文层永久删除域。提示输入域名配置位于当前工作目录中的“.ctxlayer/config.yaml”，有两个字段：活动域：<域名> active-task: # 如果没有活动任务，则可以省略域全局存储在“~/.agents/ctxlayer/domains/”中。每个域都包含任务文件夹，每个任务文件夹都有“docs/”和“data/”子目录。 **要访问哪个任务：** 默认情况下，使用 `config.yaml` 中的 **active** 域和任务（运行 `ctx status` 来获取它们）。当用户在提示中明确指定域和任务时（例如“在上下文层，域 A，任务 B，使用文档 1 和 2”），请改用它。您只能通过 `.ctxlayer///` 文件夹中的符号链接访问它们。如果请求的任务未链接（`.ctxlayer///` 处没有符号链接），建议用户首先运行 `ctx import`。以下所有操作均适用于此已解决的任务。 ## 文档操作文档操作是用户请求的读写操作，其目的是记录某些内容或访问以前记录的信息。所有文档操作都在已解决任务的“docs/”文件夹中执行。 ### 文档约定文档以编号的 Markdown 文件的形式存储在已解决任务的“docs/”文件夹中。以下是编写和阅读文档的约定： * **前缀：** 基于现有文件的两位递增数字（`01`、`02`、`03`、...） * **分隔符：** 单破折号 * **名称：** 描述性烤肉串案例摘要 * **扩展名：** `.md` **示例：** `01-initial-research.md`、`02-feature-implementation.md`、`03-architecture-diagram.md` 从语义上讲，每个文件都是涵盖一个主题的独立文档。 docs 文件夹用作任务的运行报告和日志。编写或阅读文档时必须遵循文档约定。 ### 阅读文档当用户要求阅读引用其名称的文档时，例如“文档号 N”，将其解析为已解析任务的 `docs/` 文件夹中前缀为 `NN-.md` 的文件（例如文档 1 → `01-initial-research.md`）。 ### 编写文档当用户要求编写文档时，在已解决任务的“docs/”文件夹中创建一个新的编号 Markdown 文件，并将内容写入 Markdown 文件。要获取下一个前缀编号，请列出现有文件，确定最大前缀编号，然后将其加 1。 ## 数据操作任务的“data/”文件夹包含参考资料：示例数据、配置片段、外部存储库以及实施期间可用作参考的任何其他内容。 ### 访问数据文件夹如果用户请求访问上下文层中非文档的内容，则可以理解他们想要访问已解析任务的“data/”文件夹中的信息。如果用户明确提及数据文件夹，例如“数据文件夹”、“上下文层的数据文件夹”、“上下文层数据”，将其解析到已解析任务的“data/”文件夹。 ### 将存储库添加到数据中当用户要求“将存储库添加到上下文层”或“将存储库克隆为上下文层上下文”时，请不要运行常规的“git clone”。相反，从域根 (`~/.agents/ctxlayer/domains//`) 运行 `git submodule add /data/` 将存储库添加到任务的数据文件夹中。这使域存储库保持轻量级并通过子模块引用进行版本控制。 ## Git 操作当用户在上下文层或任务上下文上请求任何 git 操作（例如，状态、添加、提交、推送、拉取）时，请通过“ctx git ”执行它们，而不是直接运行“git”。例如： >“将所有更改提交到上下文层” 被理解为请求总结已解决任务中的更改，撰写描述性提交消息，并通过 `ctx git add -A 提交更改。 && ctx git commit -a -m "<描述性提交消息>"`。

ctx层

包含技能