context-view 是 CocoPlus 提供的一个技能,用于显示 CocoContext 组织标准文件。
用途 该技能的目标是展示 CocoContext 组织标准文件的内容,帮助开发者查看和了解组织内定义的标准与规范。
主要能力
- 支持通过参数指定要查看的文件名,例如 $context view approved-models 或 $context view approved-models.md。
- 如果未提供文件名,会先运行 $context list 输出状态表格,然后提示用户输入要查看的文件名。
- 读取并显示文件的完整内容。
- 在内容之后输出文件路径、行数和最后修改日期,并提示可通过 $context add 更新文件。
- 如果指定的文件不存在,会输出错误并列出可用文件,然后停止。
使用方式
- 预检查:检查 .cocoplus/ 目录是否存在。如果不存在,输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
- 解析目标文件:
- 如果提供了文件名参数,先规范化(去除 .md 后缀再追加 .md),然后读取 .cocoplus/context/<file-name>.md。如果未找到,输出错误并列出可用文件,然后停止。
- 如果未提供参数,先运行 $context list 输出状态表格,然后提示“Which context file would you like to view? Enter the name (e.g., approved-models):”,等待用户输入后读取所选文件。
- 显示文件:读取文件并显示完整内容。之后输出分隔线、文件路径、行数、最后修改日期,并提示运行 $context add 更新文件。
适用场景 适用于需要查看 CocoContext 组织标准文件的开发者,尤其是在需要了解文件内容、行数和最后修改时间以评估文件时效性的场景。
限制
- 需要 .cocoplus/ 目录已初始化,否则无法使用。
- 文件必须位于 .cocoplus/context/ 目录下,且为 .md 格式。
- 如果文件不存在,只能列出可用文件,无法查看不存在的内容。
- 该技能不提供编辑或更新文件的功能,仅用于查看。